# 使用手册

文档版本	内容修订	修订人	修订日期
V1.0	添加使用手册基本内容	王垚	2023-11-24

# 程序入口

服务管理程序安装完成后的默认端口为 1280，你可以通过访问安装设备的 IP 地址加 1280 端口来访问，在浏览器中输入对应的地址即可，例如：http://127.0.0.1:1280

初次打开页面显示内容可能如下：

# 安装运行环境

点击右上角运行环境查看当前的所有运行环境。

点击添加运行环境可以增加一个新的运行环境。

选择适合于当前操作系统的 .interp 运行环境文件，等待上传完成后就可以使用了。

需要注意的是，当上传的运行环境和当前操作系统架构不一致时，会在备注区域提示“架构不适配”。

# 删除运行环境

在操作系统中安装的运行环境不允许删除。

在服务管理程序中安装的有一个删除按钮，点击删除按钮即可删除运行环境。

# 安装服务

安装服务有两种方案，一种方案是从云端仓库直接下载，另一种是从本地上传。

# 云端下载

点击服务仓库即可查看所有公开的服务。

在可下载服务里面选择需要的服务，可以直接点击安装，也可以从这里下载云端程序到本地。

如果需要安装特定的版本，则可以从右侧选择对应的版本后，再进行安装。

点击安装后会弹出确认窗口，点击确定即可安装。

安装时会弹出安装进度，等待进度结束后即可安装成功。

安装结束后回到首页即可看到刚刚安装的应用。

# 本地安装

本地安装通过上传服务按钮进行添加，本地上传时，需要注意，选择适用于本系统架构的服务。

本地服务插件的安装包后缀名为 .msvc，在实际项目中，可以根据需要将服务插件文件通过本地网络、U盘、光盘等形式传输到内网设备中，之后通过这种方式安装。

# 更新服务

# 云端更新

点击服务仓库，进入管理页面。

选择需要升级到服务，点击升级按钮即可更新服务。

也可以通过右侧顶部到版本选择功能，选择一个更低的版本，进行降级。

如果选择了相同的版本，则会重装该版本的服务。

# 本地更新

本地更新通过服务的操作功能进行，先将鼠标移动到操作按钮上，在弹出的菜单中选择更新程序。

在弹出的文件选择窗口中选择对应的服务，点击确定后等待上传进度完成即可更新。

⚠️注意：在本地更新时需要选择同一个类型的服务，如果选择不同类型的服务，会更新失败，更新失败效果如下。

# 删除服务

# 云端删除

点击服务仓库进入管理页面。

选择对应的服务后点击删除服务按钮即可。

⚠️注意：删除服务按钮仅会删除本地服务，不会删除云端版本。

# 本地删除

本地删除通过操作面板，点击删除服务按钮即可。

# 批量删除

如果有多个服务需要删除，可以通过服务面板右上角的选框选中后，点击顶部的删除按钮即可。

# 启动/停止/重启服务

# 单个操作

单个操作通过服务的操作面板进行控制。

# 批量操作

批量操作通过服务卡片右上角选框，选中后通过顶部菜单进行控制。

# 配置服务

选择服务操作面板，之后点击配置服务即可进入配置页面。

在这里即可配置服务的属性，最常见的配置就是运行环境，在运行环境选框里面选择合适的运行环境。

如果服务声明的有其它配置项，则可以在顶部选择服务相关的配置项目。

在编辑完配置后点击右下角报错即可，配置变更后，服务会自动重启，以加载新的配置项。

# 查看服务

如果服务声明了主页，则可以通过服务卡片上的访问功能查看。

# 备份服务

备份服务可以通过选中服务卡片后，点击备份即可，选中多个服务，这些服务将会打包放到同一个备份文件中。

# 恢复服务

恢复服务可以选择恢复到相同类型的设备上，也可以选择恢复到不同类型的设备上，只不过恢复到不同类型的设备上时，可能需要考虑到服务本身的跨平台性。

恢复服务一般同于相同平台的恢复，例如一个项目配置完成后，导出一份备份文件，上传到三思配置平台上，之后如果遇到项目现场的设备损坏等情况，可以通过合同号找到对应的备份文件，将备份文件下载下来后，到一个同类型的电脑上，安装好服务管理后，通过恢复按钮上传备份文件即可。

在弹出的文件选择窗口中选择备份文件，选择后等待文件上传完成即可。

# 查看日志

通过点击服务卡片的详情功能就可以查看最近的事实日志。

点击右上角的下载日志功能即可下载当前服务的日志文件。

# 网络终端

通过右上角终端功能即可打开网络终端。

在网络终端页面输入需要访问的目标设备连接信息，之后点击连接即可。

连接成功后即可看到终端页面。

如果需要断开连接，点击右上角断开连接，或者直接输入 exit 命令即可。

# 文件传输

如果需要通过终端进行文件的传输功能，需要在服务端安装 lrzsz 服务。

lrzsz 是一个基于 UNIX/Linux 操作系统的文件传输程序，用于在 UNIX/Linux 服务器与其他操作系统之间进行文件的上传和下载。它是 rz 和 sz 命令的组合，分别用于接收（Receive）和发送（Send）文件。

rz（接收）: 允许从客户端（如Windows、Mac）向 UNIX/Linux 服务器上传文件。
sz（发送）: 允许将文件从 UNIX/Linux 服务器发送到客户端。

# 在 UNIX/Linux 上安装

大多数 UNIX/Linux 发行版已经预装了 lrzsz。如果没有，可以使用包管理器安装：

Debian/Ubuntu
```
sudo apt-get install lrzsz
```
RedHat/CentOS
```
sudo yum install lrzsz
```
Fedora
```
sudo dnf install lrzsz
```

# 在 Windows 上安装

Windows 用户通常通过一个终端仿真器（如 PuTTY 或 SecureCRT）来连接 UNIX/Linux 服务器。这些程序一般内置对 rz 和 sz 命令的支持。

# 在 macOS 上安装

在 macOS 上，可以通过 Homebrew 安装 lrzsz:

brew install lrzsz

# 使用方法

# 上传文件（rz）

在 UNIX/Linux 终端输入 rz 命令。
选择要上传的文件。
文件将被上传到当前工作目录。

# 下载文件（sz）

在 UNIX/Linux 终端输入 sz 命令后跟文件名。
```
sz filename
```
选择保存位置。
文件将被下载到指定位置。

# 注意事项

在某些情况下，需要在服务器和客户端之间调整字符集设置，以确保文件名和内容不会因编码问题而出错。

← 部署手册常见问题 →