Skip to main content

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 安装流程图解

image.png

3.2 权限与依赖检查

  • 管理员权限验证

windows:在 cmd 命令行输入:

whoami /groups | findstr "Administrators"

如果输出中包含 Administrators,说明这个用户有管理员权限。

linux:在命令行输入

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

BVAjtpgbux80ovzq8xveemcno5nntg.png

▶️ 步骤 3:配置安装路径,点击 Install

▶️ 步骤 4:完成安装,点击 Finish

3.4 服务安装

▶️ 步骤 1:点击 Install System,等待安装完成。⚠️ 注意:没有弹出错误提示就代表着安装中,请耐心等待。

image.png

image.png

4. 初始配置向导

▶️ 步骤 1:点击 System Entry 即可进入系统页面

image.png

image.png

5. 服务管理与验证

5.1 服务管理命令 (安装引导软件的主界面按钮操作方法及含义)

image.png

按钮 含义
安装服务
重启系统
备份数据
导入备份的数据文件,重置版本
卸载系统
服务状态:绿色:正常运行;黄色:服务异常
端口状态:绿色:正常运行;红色:端口异常
加密狗驱动状态:绿色:正常运行;红色:加密狗驱动异常
点击打开系统页面

5.2 健康状态验证 (安装引导软件的主界面状态判断方法,以及相关故障的判断方法)

  • 端口错误,点击进入查看解决方案

image.png

image.png

  • 加密狗错误,点击进入查看解决方案

image.png

image.png

  • 服务错误,点击进入查看解决方案

image.png

image.png

6. 备份与重置

6.1 数据备份

▶️ 步骤 1:点击 Backup System

image.png

▶️ 步骤 2:选择保存路径,等待保存成功

image.png

6.2 重置系统

▶️ 步骤 1:点击 Restore System

image.png

▶️ 步骤 2:选择你希望重置的版本,点击打开。

▶️ 步骤 3:等待重置完成

image.png

6.3 卸载步骤

6.3.1 卸载服务

▶️ 步骤 1:点击 Uninstall System,点击 yes

image.png

image.png

▶️步骤 2:弹出卸载环境窗口,点击 cancel,将只会卸载服务,点击 Install System 可再次安装。

image.png

⚠️ 注意:当前进度只是卸载了服务,点击 Install System 可再次安装。

6.3.2 卸载环境

▶️ 步骤 1:在弹出的卸载窗口中点击 Next,等待卸载完成。

▶️ 步骤 2:点击 Finish 完成卸载

⚠️ 注意:当前进度已完全卸载,双击点击安装向导 infinite-win-1.0.16-x64.exe 可再次安装