III. 软件安装与配置手册
---
> **本文档为 SafeMesh 系统的软件安装与配置手册**
> **适配系统版本**：V1.0.0
> **文档版本**：V1.0
> **发布日期**：2026 年 1 月 1 日
> **发布方**：EFFORT
---
# 文档修订记录
| 版本 | 日期 | 修订内容 | 角色标记 | 修订人 |
|---|
| v2.0 | 2023/10/20 | 操作与管理功能合并 | 👤⚙️ | 张工 |
# 1. 前言
## 1.1 文档目标
向用户提供软件分步安装、初始化配置和基础验证
- 指导完成软件安装、初始化配置与基础验证
## 1.2 目标读者
系统管理员/IT 工程师
## 1.3 文档范围
- 软件安装步骤
## 1.4 相关文档
- 前提文档 ：《系统概览与安装入门指南》（必读）
- 并行文档 ：《硬件连接与部署指南》
## 1.5 符号约定
- ⚠️ 表示关键注意事项
- ℹ️ 提示信息
- ▶️ 表示操作步骤开始
## 2. 安装前准备
## 2.1 系统推荐配置
- **服务器 CPU**：intel® Core™ i5-6400
- **服务器 RAM**：8G
- **服务器存储**：128G
- **服务器操作系统**：Windows 11 - 64bit
## 2.2 获取安装资源
- 向您的客户经理获取安装包
## 2.3 网络与安全配置
| 端口 | 协议 | 用途 | 防火墙要求 |
|---|
| 3000 | TCP | 服务端 | 允许入站/出站 |
| 3547 | UDP | MQTT通信 | 允许入站/出站 |
| 3548 | UDP | OTA升级 | 允许入站/出站 |
| 8012 | TCP | 客户端 | 允许入站/出站 |
| 8189 | TCP | 加密狗驱动 | 允许入站/出站 |
| 13306 | TCP | 数据库 | / |
⚠️ 以上端口为系统所必须使用的端口，请注意端口冲突
⚠️ 防火墙要求需用户手动配置
⚠️ 安装系统时，请关闭杀毒软件，或将软件添加至信任区:需要先创建目录，放入信任区，再安装软件到这个目录中。
- **网络稳定性要求**：建议延迟 <30ms，丢包率 0%，系统运行在丢包率高的网络中，会出现用户操作命令无法下发到设备的情况出现。
# 3. 软件安装流程
## 3.1 安装流程图解
## 3.2 权限与依赖检查
- 管理员权限验证
windows：在 cmd 命令行输入：
```html
whoami /groups | findstr "Administrators"
```
如果输出中包含 `Administrators`，说明这个用户有管理员权限。
linux：在命令行输入
```bash
whoami
```
如果输出为 root，说明有管理员权限。
- 依赖库安装清单
1. Nodejs
2. Mysql
3. Vikey
4. Microsoft Visual C++ Redistributable
ℹ️ 以上环境会在系统安装时自动安装，用户无需自行安装。
## 3.3 环境安装
▶️ **步骤 1**：**启动安装向导** 双击 infinite-win-1.0.19-x64.exe
▶️ **步骤 2**：点击 Next
[](http://13.222.61.26:6875/uploads/images/gallery/2026-03/bvajtpgbux80ovzq8xveemcno5nntg.png)
▶️ **步骤 3**：配置**安装路径，点击 Install**
▶️ **步骤 4**：完成安装，点击 Finish
## 3.4 服务安装
▶️ **步骤 1**：点击 Install System，等待安装完成。⚠️ 注意：没有弹出错误提示就代表着安装中，请耐心等待。
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/g05image.png)
[](http://13.222.61.26:6875/images/gallery/2026-01/mU5image.png)
# 4. 初始配置向导
▶️ **步骤 1**：点击 System Entry 即可**进入系统页面**。
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/UoZimage.png)
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/rvPimage.png)
# 5. 服务管理与验证
## 5.1 服务管理命令 （安装引导软件的主界面按钮操作方法及含义）
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/VIIimage.png)
| 按钮 | 含义 |
| [](http://13.222.61.26:6875/uploads/images/gallery/2026-03/image.png)
| 安装服务 |
|  | 重启系统 |
|  | 备份数据 |
|  | 导入备份的数据文件，重置版本 |
|  | 卸载系统 |
|  | 服务状态：绿色：正常运行；黄色：服务异常 |
|  | 端口状态：绿色：正常运行；红色：端口异常 |
|  | 加密狗驱动状态：绿色：正常运行；红色：加密狗驱动异常 |
|  | 点击打开系统页面 |
## **5.2 健康状态验证** （安装引导软件的主界面状态判断方法，以及相关故障的判断方法）
- 端口错误，点击进入查看解决方案
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/D1timage.png)
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/7R2image.png)
- 加密狗错误，点击进入查看解决方案
- 服务错误，点击进入查看解决方案
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/w6timage.png)
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/K8oimage.png)
# 6. 备份与重置
## 6.1 数据备份
▶️ **步骤 1**：点击 Backup System
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/QAOimage.png)
▶️ **步骤 2**：选择保存路径，等待保存成功
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/o8Wimage.png)
## 6.2 重置系统
▶️ **步骤 1**：点击 Restore System
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/7Juimage.png)
▶️ **步骤 2**：选择你希望重置的版本，点击打开。
▶️ **步骤 3**：等待重置完成
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/oXjimage.png)
## 6.3 卸载步骤
### 6.3.1 卸载服务
▶️ **步骤 1**：点击 Uninstall System，点击 yes
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/0Bfimage.png)
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/v12image.png)
▶️**步骤 2**：弹出卸载环境窗口，点击 cancel，将只会卸载服务，点击 Install System 可再次安装。
[](http://13.222.61.26:6875/uploads/images/gallery/2026-01/rSOimage.png)
⚠️ 注意：当前进度只是卸载了服务，点击 Install System 可再次安装。
### 6.3.2 卸载环境
▶️ **步骤 1**：在弹出的卸载窗口中点击 Next，等待卸载完成。
▶️ **步骤 2**：点击 Finish 完成卸载
⚠️ 注意：当前进度已完全卸载，双击点击安装向导 infinite-win-1.0.16-x64.exe 可再次安装
