III. 软件安装与配置手册

--- > **本文档为 SafeMesh 系统的软件安装与配置手册** > **适配系统版本**：V1.0.0 > **文档版本**：V1.0 > **发布日期**：2026 年 1 月 1 日 > **发布方**：EFFORT --- # 文档修订记录

版本号	修订日期	修订内容摘要	修订人	审核人
V1.0	2026-1-1	初始发布	JLJ	Shyne

# 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 安装流程图解 ![whiteboard_exported_image.png](http://13.222.61.26:6875/uploads/images/gallery/2025-12/gthwhiteboard-exported-image.png) ## 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 ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/B7Lq6msbhp7mocgccxpgnnchdv7n9e.png) ▶️ **步骤 2**：点击 Next [![BVAjtpgbux80ovzq8xveemcno5nntg.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/bvajtpgbux80ovzq8xveemcno5nntg.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/bvajtpgbux80ovzq8xveemcno5nntg.png) ▶️ **步骤 3**：配置**安装路径，点击 Install** ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/npVkdakbnrjlotgdrxpq1qcmveknmb.png) ▶️ **步骤 4**：完成安装，点击 Finish ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/Pw0nuaxb4xrmo1lomxztszcv9oenhg.png) ## 3.4 服务安装 ▶️ **步骤 1**：点击 Install System，等待安装完成。⚠️ 注意：没有弹出错误提示就代表着安装中，请耐心等待。 [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/g05image.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/g05image.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/mU5image.png)](http://13.222.61.26:6875/images/gallery/2026-01/mU5image.png) # 4. 初始配置向导 ▶️ **步骤 1**：点击 System Entry 即可**进入系统页面**。 [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/UoZimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/UoZimage.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/rvPimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/rvPimage.png) # 5. 服务管理与验证 ## 5.1 服务管理命令（安装引导软件的主界面按钮操作方法及含义） [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/VIIimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/VIIimage.png)

按钮	含义
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/4O5image.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/4O5image.png)	安装服务
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/w7oimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/w7oimage.png)	重启系统
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/UReimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/UReimage.png)	备份数据
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/kGDimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/kGDimage.png)	导入备份的数据文件，重置版本
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/nO6image.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/nO6image.png)	卸载系统
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/3Cximage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/3Cximage.png)	服务状态：绿色：正常运行；黄色：服务异常
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/1FUimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/1FUimage.png)	端口状态：绿色：正常运行；红色：端口异常
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/479image.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/479image.png)	加密狗驱动状态：绿色：正常运行；红色：加密狗驱动异常
[![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-03/scaled-1680-/L5Bimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-03/L5Bimage.png)	点击打开系统页面

## 5.2 健康状态验证 - 端口错误，点击进入查看解决方案 [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/D1timage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/D1timage.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/7R2image.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/7R2image.png) - 加密狗错误，点击进入查看解决方案 ![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/1Uaimage.png) ![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/babimage.png) - 服务错误，点击进入查看解决方案 [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/w6timage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/w6timage.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/K8oimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/K8oimage.png) # 6. 备份与重置 ## 6.1 数据备份 ▶️ **步骤 1**：点击 Backup System [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/QAOimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/QAOimage.png) ▶️ **步骤 2**：选择保存路径，等待保存成功 ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/C1at6ipbapd5oj3fsxx3mhccvl1nth.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/o8Wimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/o8Wimage.png) ## 6.2 重置系统 ▶️ **步骤 1**：点击 Restore System [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/7Juimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/7Juimage.png) ▶️ **步骤 2**：选择你希望重置的版本，点击打开。 ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/hpQewmobnwjfoe1aqxltducs2kwnkg.png) ▶️ **步骤 3**：等待重置完成 [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/oXjimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/oXjimage.png) ## 6.3 卸载步骤 ### 6.3.1 卸载服务 ▶️ **步骤 1**：点击 Uninstall System，点击 yes [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/0Bfimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/0Bfimage.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/v12image.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/2025-12/HZylovsbaimfod3dwx9dh4cqk9cnzk.png) [![image.png](http://13.222.61.26:6875/uploads/images/gallery/2026-01/scaled-1680-/rSOimage.png)](http://13.222.61.26:6875/uploads/images/gallery/2026-01/rSOimage.png) ⚠️ 注意：当前进度只是卸载了服务，点击 Install System 可再次安装。 ### 6.3.2 卸载环境 ▶️ **步骤 1**：在弹出的卸载窗口中点击 Next，等待卸载完成。 ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/wAYefzobtfovorjj1x6omscnarmnic.png) ▶️ **步骤 2**：点击 Finish 完成卸载 ![](http://13.222.61.26:6875/uploads/images/gallery/2025-12/EpWt1dzbxy1oognoexu4chcwucjnhc.png) ⚠️ 注意：当前进度已完全卸载，双击点击安装向导 infinite-win-1.0.16-x64.exe 可再次安装