部署与运行

本文说明巡维智联平台的基础部署和运行要求。

环境要求

  • Go 1.24+
  • Node.js + pnpm
  • Windows 或 Linux
  • SQLite 数据文件写入权限

目录建议

1
2
3
4
5
6
7
deploy-root/
├─ bin/
│  └─ xwzl-platform.exe
├─ web/
│  └─ dist/
├─ data/
└─ output/

说明：

  • data/ 保存数据库和授权相关文件。
  • output/ 保存巡检输出和报表文件。

Windows 开发运行

后端：

1
go run cmd/server/main.go

前端：

1
2
cd web
pnpm.cmd dev --host 127.0.0.1 --port 3000

默认访问：

1
http://localhost:5000

生产构建

构建后端：

1
go build -o bin/xwzl-platform.exe cmd/server/main.go

构建前端：

1
2
cd web
pnpm.cmd build

启动：

1
.\bin\xwzl-platform.exe

Docker 部署

1
2
3
docker compose up -d
docker compose logs -f
docker compose ps

常用环境变量

变量名 说明
PROJECT_ENV 运行环境，建议生产设置为 PROD
ADMIN_SECRET_KEY 超级管理员密钥
ADMIN_IP_WHITELIST 超级管理员入口 IP 白名单
WORKSPACE_PATH 工作目录根路径，生产环境建议显式设置

Windows 示例：

1
2
3
4
$env:PROJECT_ENV='PROD'
$env:ADMIN_SECRET_KEY='YourStrongSecretKey123!'
$env:WORKSPACE_PATH='C:\deploy\device-inspector'
.\bin\xwzl-platform.exe

授权迁移

授权绑定运行环境。迁移到新机器、变更部署目录或复制整包到其他路径运行，都可能触发授权环境不匹配。

处理步骤：

  1. 在新环境查看当前机器码。
  2. 在 /super-admin 生成绑定新机器码的授权码。
  3. 在授权页面激活新授权码。