安装部署

本文介绍如何在 Windows 和 Linux 环境下安装并运行巡维智联平台。

环境要求

安装包目录结构

发布包解压后的目录结构如下：

1
2
3
4
5
6
7
8
9
10
11
12

xwzl-platform/
├── bin/
│   ├── xwzl-platform-{os}-amd64    # 主程序
│   └── xwzl-updater-{os}-amd64     # 更新工具
├── config/
│   └── config.yaml.example         # 配置文件示例
├── data/                           # 数据目录（数据库、授权文件）
├── logs/                           # 日志目录
├── web/
│   └── dist/                       # 前端静态文件
├── start-service.cmd               # 启动脚本（Windows）
└── stop-service.cmd                # 停止脚本（Windows）

Windows 安装

1. 下载并解压

下载 xwzl-platform-vX.X.X-windows-amd64.zip，解压到目标目录，例如：

1

D:\xwzl-platform\

2. 启动服务

方式一：使用启动脚本

双击 start-service.cmd，或在 PowerShell 中执行：

1

.\start-service.cmd

方式二：直接运行

1

.\bin\xwzl-platform-windows-amd64.exe

方式三：带环境变量启动（推荐生产环境）

1
2
3

$env:PROJECT_ENV = 'PROD'
$env:WORKSPACE_PATH = 'C:\xwzl-platform'
.\bin\xwzl-platform-windows-amd64.exe

3. 访问系统

启动成功后，浏览器访问：

1

http://localhost:5000

默认管理员账号：

{tip} 首次登录后请立即修改默认密码。

4. 停止服务

双击 stop-service.cmd，或关闭运行中的命令行窗口即可。

Linux 安装

1. 下载并解压

下载 xwzl-platform-vX.X.X-linux-amd64.zip，解压到目标目录：

1
2

unzip xwzl-platform-v*-linux-amd64.zip -d /opt/xwzl-platform
cd /opt/xwzl-platform

2. 添加执行权限

1

chmod +x bin/xwzl-platform-linux-amd64 bin/xwzl-updater-linux-amd64

3. 启动服务

方式一：直接运行

1

./bin/xwzl-platform-linux-amd64

方式二：后台运行

1

nohup ./bin/xwzl-platform-linux-amd64 > /dev/null 2>&1 &

方式三：配置为 systemd 服务（推荐）

创建服务文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

sudo tee /etc/systemd/system/xwzl-platform.service << 'EOF'
[Unit]
Description=XWZL Platform
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/xwzl-platform
Environment=PROJECT_ENV=PROD
Environment=WORKSPACE_PATH=/opt/xwzl-platform
ExecStart=/opt/xwzl-platform/bin/xwzl-platform-linux-amd64
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

启动并设为开机自启：

1
2

sudo systemctl daemon-reload
sudo systemctl enable --now xwzl-platform

常用管理命令：

1
2
3
4
5
6
7
8
9
10
11

# 查看状态
sudo systemctl status xwzl-platform

# 查看日志
sudo journalctl -u xwzl-platform -f

# 停止服务
sudo systemctl stop xwzl-platform

# 重启服务
sudo systemctl restart xwzl-platform

4. 访问系统

同 Windows 章节，浏览器访问 http://服务器IP:5000，使用默认账号登录。

配置文件说明

安装包内附 config/config.yaml，包含服务端口、SNMP 默认参数等配置项。默认配置开箱即用，无需修改。

如需更改端口，将示例文件复制为 config/config.yaml 并修改 server.port：

1
2
3

server:
  port: 5000
  host: 0.0.0.0

不需要更改端口时，无须创建或修改配置文件。

常见问题

启动后页面 404

检查 web/dist/index.html 是否存在，以及 WORKSPACE_PATH 是否设置正确。

端口 5000 被占用

• Windows：

1
2

netstat -ano | findstr :5000
taskkill /PID <PID> /F

• Linux：

1
2

ss -tlnp | grep 5000
kill <PID>

或修改 config/config.yaml 中的 server.port 为其他端口。

数据文件位置

数据库文件位于 data/device_inspector.db（SQLite）。如启动后发现数据不一致，通常是 WORKSPACE_PATH 未设置导致程序读取了不同目录下的数据库。