更新离线部署脚本
This commit is contained in:
parent
5fefa8a154
commit
edf64443b8
BIN
build/3588AdminBackend-离线部署包-20260225.tar.gz
Normal file
BIN
build/3588AdminBackend-离线部署包-20260225.tar.gz
Normal file
Binary file not shown.
67
build/3588AdminBackend-离线部署包-20260225/README-离线安装.txt
Normal file
67
build/3588AdminBackend-离线部署包-20260225/README-离线安装.txt
Normal file
@ -0,0 +1,67 @@
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 3588AdminBackend 离线部署包 - 快速安装指南 ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
|
||||
【系统要求】
|
||||
- Ubuntu 22.04.5 LTS (x86_64)
|
||||
- root 权限
|
||||
|
||||
【重要说明】
|
||||
✓ 本部署包已包含静态编译的二进制文件
|
||||
✓ 目标机器无需安装 Go 运行时
|
||||
✓ 无需互联网连接（纯离线安装）
|
||||
✓ 二进制文件在 Windows 上交叉编译生成
|
||||
|
||||
【安装步骤】
|
||||
|
||||
1. 上传部署包到 Ubuntu 服务器
|
||||
scp -r 3588AdminBackend-离线部署包-20260225.tar.gz user@ubuntu-server:/tmp/
|
||||
|
||||
2. 解压部署包
|
||||
tar -xzf 3588AdminBackend-离线部署包-20260225.tar.gz
|
||||
cd 3588AdminBackend-离线部署包-20260225/
|
||||
|
||||
3. 执行安装
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
4. 修改配置
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
重点修改:
|
||||
- agent_token: 修改为安全的随机字符串
|
||||
- listen: 如需外部访问改为 "0.0.0.0:18080"
|
||||
|
||||
5. 启动服务
|
||||
sudo 3588admin start
|
||||
|
||||
6. 验证安装
|
||||
sudo 3588admin status
|
||||
|
||||
【常用命令】
|
||||
3588admin start - 启动服务
|
||||
3588admin stop - 停止服务
|
||||
3588admin status - 查看状态
|
||||
3588admin restart - 重启服务
|
||||
3588admin upgrade - 升级服务
|
||||
3588admin uninstall - 卸载服务
|
||||
3588admin check - 检查环境
|
||||
|
||||
【快捷命令】
|
||||
3588admin-start - 启动服务
|
||||
3588admin-stop - 停止服务
|
||||
3588admin-status - 查看状态
|
||||
|
||||
【文件位置】
|
||||
安装目录: /opt/3588admin
|
||||
配置文件: /opt/3588admin/config/managerd.json
|
||||
日志文件: /opt/3588admin/logs/managerd.log
|
||||
|
||||
【问题排查】
|
||||
1. 查看日志: tail -f /opt/3588admin/logs/managerd.log
|
||||
2. 检查配置: python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
3. 检查端口: sudo netstat -tlnp | grep managerd
|
||||
|
||||
【防火墙】
|
||||
sudo ufw allow 18080/tcp # HTTP API
|
||||
sudo ufw allow 35688/udp # UDP 发现
|
||||
|
||||
6
build/3588AdminBackend-离线部署包-20260225/VERSION
Normal file
6
build/3588AdminBackend-离线部署包-20260225/VERSION
Normal file
@ -0,0 +1,6 @@
|
||||
3588AdminBackend 离线部署包
|
||||
版本: 1.0.0
|
||||
构建时间: 2026-02-25 17:58:38
|
||||
Go版本: go version go1.26.0 windows/amd64
|
||||
目标系统: Ubuntu 22.04.5 LTS x86_64
|
||||
构建主机: DESKTOP-P5Q39KV (Windows)
|
||||
BIN
build/3588AdminBackend-离线部署包-20260225/bin/managerd
Normal file
BIN
build/3588AdminBackend-离线部署包-20260225/bin/managerd
Normal file
Binary file not shown.
@ -0,0 +1,8 @@
|
||||
{
|
||||
"listen": "0.0.0.0:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
"agent_token": "CHANGE_ME",
|
||||
"concurrency": 5
|
||||
}
|
||||
@ -0,0 +1,371 @@
|
||||
# 设备端远程管理接口清单表（V1：对外 rk3588-agent；对内 media-server）
|
||||
|
||||
> 目标：供管理端（Go）与设备端联调对照。
|
||||
>
|
||||
> 约定：
|
||||
> - 对外：`rk3588-agent` HTTP 端口默认 `9100`（可配置），UDP 发现端口默认 `35688`。
|
||||
> - 对内：`media-server` 继续提供现有 `/api/*`（默认 9000），由 agent 本机调用。
|
||||
|
||||
---
|
||||
|
||||
## 0. 通用规范
|
||||
|
||||
### 0.1 基础 URL
|
||||
- Agent Base: `http://<device_ip>:<agent_port>`
|
||||
- Media-server Base（仅 agent 使用）: `http://127.0.0.1:<media_port>`
|
||||
|
||||
### 0.2 鉴权（agent 对外）
|
||||
- Header：`X-RK-Token: <token>`
|
||||
- **必须鉴权**：所有写接口（PUT/POST 会改变设备状态或写盘）
|
||||
- **读接口**：默认可不鉴权；若 `agent.require_token_for_read=true` 则也必须鉴权
|
||||
|
||||
### 0.3 统一响应格式
|
||||
- 成功（通用）：`{"ok":true}`
|
||||
- 失败（通用）：`{"error":"<message>"}`（与现有 `ErrorJson()` 风格一致）
|
||||
|
||||
### 0.4 统一错误码/HTTP 状态（agent 对外）
|
||||
agent 不要求返回结构化 error_code（保持 `{"error":...}`），但**要求 HTTP 状态码语义稳定**：
|
||||
|
||||
| 场景 | HTTP | error.message 示例 |
|
||||
|---|---:|---|
|
||||
| 未鉴权/Token 错误/缺失 | 401 | `unauthorized` |
|
||||
| JSON 解析失败 / 字段缺失 / 校验失败 | 400 | `invalid json: ...` / `validation failed: ...` |
|
||||
| 资源不存在 | 404 | `not found` |
|
||||
| 方法不允许 | 405 | `method not allowed` |
|
||||
| 冲突（如 node_id 不唯一等） | 409 | `... not unique ...` |
|
||||
| 写盘失败/内部异常/reload 崩溃性失败 | 500 | `internal error: ...` |
|
||||
| 上传过大 | 413（推荐）或 400 | `payload too large` |
|
||||
|
||||
### 0.5 端口与协议
|
||||
- UDP 发现：`35688/udp`（可配置）
|
||||
- Agent HTTP：`9100/tcp`（默认，可配置）
|
||||
- Media-server HTTP：`9000/tcp`（默认，可配置）
|
||||
|
||||
---
|
||||
|
||||
## 1. UDP 发现协议（Option A）
|
||||
|
||||
### 1.1 Discover 请求（manager → broadcast）
|
||||
**发送目标**：同网段广播地址 `255.255.255.255:35688` 或各网卡广播地址
|
||||
|
||||
**数据格式**：两行 UTF-8 文本
|
||||
|
||||
Line1（固定魔法串）：
|
||||
```
|
||||
RK3588SYS_DISCOVERY_V1
|
||||
```
|
||||
|
||||
Line2（JSON）：
|
||||
```json
|
||||
{"type":"discover","req_id":"<uuid>","reply_port":0}
|
||||
```
|
||||
|
||||
字段：
|
||||
- `type`: 固定 `discover`
|
||||
- `req_id`: 管理端生成 UUID，用于匹配回复
|
||||
- `reply_port`: 保留字段（V1 可固定 0）
|
||||
|
||||
### 1.2 Discover 回复（device → manager 单播）
|
||||
**发送目标**：请求报文 source ip:source port
|
||||
|
||||
两行文本：
|
||||
|
||||
Line1：
|
||||
```
|
||||
RK3588SYS_DISCOVERY_V1
|
||||
```
|
||||
|
||||
Line2（JSON）：
|
||||
```json
|
||||
{
|
||||
"type":"discover_reply",
|
||||
"req_id":"<uuid>",
|
||||
"device_id":"rk3588-...",
|
||||
"device_name":"rk3588-cam-01",
|
||||
"hostname":"rk3588",
|
||||
"ip":"10.0.0.21",
|
||||
"agent_port":9100,
|
||||
"media_port":9000,
|
||||
"version":"0.0.0-dev",
|
||||
"git_sha":"e5894c2",
|
||||
"uptime_sec":12345
|
||||
}
|
||||
```
|
||||
|
||||
字段说明：
|
||||
- `device_id`: 稳定唯一（优先 `/etc/machine-id`，否则 MAC/序列号；最后 fallback 生成并落盘）
|
||||
- `device_name`: 可配置的人类可读名称（agent 配置 `device_name`）
|
||||
- `agent_port`: agent HTTP 端口
|
||||
- `media_port`: media-server HTTP 端口（用于调试/展示；管理端可不直连）
|
||||
|
||||
---
|
||||
|
||||
## 2. 设备信息（agent 对外）
|
||||
|
||||
### 2.1 `GET /v1/info`
|
||||
用途：设备列表/详情页展示、联调确认端口/版本/配置路径。
|
||||
|
||||
**Auth**：读接口（见 0.2）
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{
|
||||
"device_id":"rk3588-...",
|
||||
"device_name":"rk3588-cam-01",
|
||||
"hostname":"rk3588",
|
||||
"ip":"10.0.0.21",
|
||||
"agent_port":9100,
|
||||
"media_port":9000,
|
||||
"version":"0.0.0-dev",
|
||||
"git_sha":"e5894c2",
|
||||
"config_path":"/etc/rk3588sys/config.json",
|
||||
"last_good_path":"/etc/rk3588sys/config.json.last_good.json",
|
||||
"uptime_sec":12345
|
||||
}
|
||||
```
|
||||
|
||||
失败：401/500 + `{"error":"..."}`
|
||||
|
||||
---
|
||||
|
||||
## 3. 配置下发（agent 对外）
|
||||
|
||||
### 3.1 `PUT /v1/config`
|
||||
用途：管理端上传完整 root config（可含 templates/instances），agent 原子写盘后触发 `media-server` reload。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Headers：
|
||||
- `Content-Type: application/json`
|
||||
- `X-RK-Token: ...`
|
||||
|
||||
Body：root config JSON
|
||||
|
||||
agent 处理步骤（必须满足）：
|
||||
1) 解析 JSON（语法有效即可；语义校验交由 media-server reload）
|
||||
2) 原子写入 `config_path`
|
||||
3) 调用 media-server：`POST /api/config/reload`
|
||||
4) 若 reload 失败：调用 media-server：`POST /api/config/rollback`，并返回 500（包含 reload/rollback 错误信息）
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{"ok":true}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 400：JSON 解析失败
|
||||
- 500：写盘失败 / reload 失败（已尝试 rollback）
|
||||
|
||||
---
|
||||
|
||||
## 4. 模型管理（agent 对外）
|
||||
|
||||
### 4.1 `PUT /v1/models/{name}`
|
||||
用途：上传模型文件并落盘，维护 manifest，返回可引用的 `path`。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Path params：
|
||||
- `name`: string（建议仅允许 `[A-Za-z0-9._-]`，超出则 400）
|
||||
|
||||
Headers：
|
||||
- `Content-Type: application/octet-stream`
|
||||
- `Content-Length: <n>`（必须）
|
||||
- `X-RK-Token: ...`
|
||||
- `X-Model-Sha256: <hex>`（可选；若存在必须匹配实际 sha256，否则 400）
|
||||
|
||||
Body：二进制文件（建议限制扩展名白名单 `.rknn`；V1 可由 name 或内容类型控制）
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{
|
||||
"ok": true,
|
||||
"name": "yolov5s-640",
|
||||
"sha256": "...",
|
||||
"path": "/opt/rk3588sys/models/files/yolov5s-640__abcd.rknn",
|
||||
"size": 12345678
|
||||
}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 400：缺 Content-Length / name 非法 / sha256 不匹配
|
||||
- 413（推荐）或 400：超过 `max_upload_mb`
|
||||
- 500：写盘失败/manifest 更新失败
|
||||
|
||||
### 4.2 `GET /v1/models`
|
||||
用途：列出设备端已有模型。
|
||||
|
||||
**Auth**：读接口（见 0.2）
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{
|
||||
"items": [
|
||||
{
|
||||
"name": "yolov5s-640",
|
||||
"sha256": "...",
|
||||
"path": "/opt/rk3588sys/models/files/...",
|
||||
"size": 123,
|
||||
"mtime_ms": 1730000000000
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
失败：500 + `{"error":"..."}`
|
||||
|
||||
---
|
||||
|
||||
## 5. 业务图热更新/回滚（agent 对外）
|
||||
|
||||
### 5.1 `POST /v1/media-server/reload`
|
||||
用途：触发本机 media-server `POST /api/config/reload`。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Response 200：`{"ok":true}`
|
||||
|
||||
失败：500 + `{"error":"..."}`
|
||||
|
||||
### 5.2 `POST /v1/media-server/rollback`
|
||||
用途：触发本机 media-server `POST /api/config/rollback`。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Response 200：`{"ok":true}`
|
||||
|
||||
失败：500 + `{"error":"..."}`
|
||||
|
||||
### 5.3 `PUT /v1/media-server/configs/{name}`
|
||||
用途：上传 media-server 配置文件到 `agent.media_server_process.configs_dir`。
|
||||
|
||||
批量上传：对不同文件名重复调用该接口即可。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Headers：
|
||||
- `Content-Type: application/json`
|
||||
- `X-RK-Token: ...`
|
||||
|
||||
Path params：
|
||||
- `name`: string（仅允许 `[A-Za-z0-9._-]`，禁止 `/`、`\\`、`..`；若无 `.json` 后缀则自动追加）
|
||||
|
||||
Body：media-server 配置 JSON
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{
|
||||
"ok": true,
|
||||
"name": "cam1.json",
|
||||
"path": "/opt/rk3588sys/configs/cam1.json",
|
||||
"size": 1234,
|
||||
"mtime_ms": 1730000000000
|
||||
}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 400：name 非法 / Content-Type 非 application/json / JSON 无效 / 空 body
|
||||
- 401：unauthorized
|
||||
- 413：超过 `max_upload_mb`
|
||||
- 501：`configs_dir` 未配置
|
||||
- 500：写盘失败
|
||||
|
||||
## 6. 主程序进程控制（agent 对外）
|
||||
|
||||
> 说明：该能力用于“启动/重启/关闭主程序（media-server）并选择加载哪个配置文件”。
|
||||
>
|
||||
> agent 启动 media-server 时会显式传入：`--config <resolved_config_path>`，因此不依赖 media-server 内部默认配置。
|
||||
>
|
||||
> 路径说明：
|
||||
> - `agent.media_server_process` 下的 `exec_path/work_dir/configs_dir/pid_file` 支持绝对或相对路径；若为相对路径，则以 agent 启动参数 `--config <agent_config_path>` 的**配置文件所在目录**为基准解析。
|
||||
> - `agent.config_path` 建议使用**绝对路径**；若使用相对路径：
|
||||
> - `PUT /v1/config` 写盘时，以 **agent 进程当前工作目录（CWD）** 为基准；
|
||||
> - 通过 `/v1/media-server/start|restart`（缺省 config）启动时，会把该相对路径原样传给 media-server，最终以 **media_server_process.work_dir** 为基准解析。
|
||||
|
||||
### 6.1 `POST /v1/media-server/start`
|
||||
用途：启动本机 media-server（若已运行则幂等返回 ok；若已运行但 config 不同则 409）。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Body（可选，JSON）：
|
||||
```json
|
||||
{"config":"cam1"}
|
||||
```
|
||||
|
||||
说明：若请求 body 非空，则必须带 `Content-Type: application/json`；若 body 为空，可不带该 header。
|
||||
|
||||
`config` 解析规则：
|
||||
- 为空/缺省：使用 `agent.config_path`
|
||||
- 非空：只允许文件名/配置名（禁止包含 `/`、`\\`、`..`）；若不带扩展名自动补 `.json`；最终从 `agent.media_server_process.configs_dir` 下解析为 `<configs_dir>/<config>.json`
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{"ok":true,"running":true,"pid":1234,"config_path":"/etc/rk3588sys/config.json"}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 400：config 不合法 / config 文件不存在
|
||||
- 409：已运行但 config 不同（提示使用 restart）
|
||||
- 501：未启用进程控制（agent 配置 `agent.media_server_process.enable=false` 或未配置）
|
||||
- 500：启动失败 / 写 pidfile 失败
|
||||
|
||||
### 6.2 `POST /v1/media-server/restart`
|
||||
用途：重启本机 media-server（可切换 config）。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Body（可选，JSON）：
|
||||
```json
|
||||
{"config":"cam1"}
|
||||
```
|
||||
|
||||
说明：若请求 body 非空，则必须带 `Content-Type: application/json`；若 body 为空，可不带该 header。
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{"ok":true,"running":true,"pid":1234,"config_path":"/home/orangepi/Desktop/OrangePi3588Media/configs/cam1.json"}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 400：config 不合法 / config 文件不存在
|
||||
- 501：未启用进程控制
|
||||
- 500：停止/启动失败
|
||||
|
||||
### 6.3 `POST /v1/media-server/stop`
|
||||
用途：停止本机 media-server（未运行也返回 ok）。
|
||||
|
||||
**Auth**：必须（401）
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{"ok":true,"running":false,"pid":1234,"config_path":"/etc/rk3588sys/config.json"}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 501：未启用进程控制
|
||||
- 500：停止失败
|
||||
|
||||
### 6.4 `GET /v1/media-server/status`
|
||||
用途：查询本机 media-server 是否在运行（以 agent 的 pidfile 记录为准）。
|
||||
|
||||
**Auth**：读接口（见 0.2）
|
||||
|
||||
Response 200：
|
||||
```json
|
||||
{"ok":true,"running":true,"pid":1234,"config_path":"/etc/rk3588sys/config.json"}
|
||||
```
|
||||
|
||||
失败：
|
||||
- 501：未启用进程控制
|
||||
- 500：读取 pidfile/进程存活检测失败
|
||||
|
||||
## 7. 只读代理接口（agent 对外，推荐管理端统一走 agent）
|
||||
|
||||
### 7.1 `GET /v1/graphs`
|
||||
代理 media-server：`GET /api/graphs`
|
||||
|
||||
### 7.2 `GET /v1/graphs/{name}`
|
||||
代理 media-server：`GET /api/graphs/{name}`
|
||||
|
||||
### 7.3 `GET /v1/logs/recent?limit=200`
|
||||
代理 media-server：`GET /api/logs/recent?limit=...`
|
||||
196
build/3588AdminBackend-离线部署包-20260225/docs/Readme.md
Normal file
196
build/3588AdminBackend-离线部署包-20260225/docs/Readme.md
Normal file
@ -0,0 +1,196 @@
|
||||
# PRD ③ 管理端后端（Go managerd）V1
|
||||
|
||||
## 1. 目标与运行方式
|
||||
|
||||
- 提供本机 HTTP API 给 React UI 使用。
|
||||
- 负责 UDP 广播发现（Option A），维护设备缓存与在线状态。
|
||||
- 通过设备端 `rk3588-agent` 完成配置/模型等运维操作，并可通过 agent 代理读取 graphs/logs。
|
||||
- 支持批量任务（并发、进度、失败原因）并通过 SSE 推送。
|
||||
|
||||
运行：单可执行 `managerd`，默认监听 `127.0.0.1:18080`（可配置）。
|
||||
|
||||
## 2. 外部依赖与约束
|
||||
|
||||
- Go 版本：>= 1.22（建议）
|
||||
- 标准库优先；Web 框架可选 `chi`/`gin`（建议 chi + net/http）。
|
||||
- 不需要数据库（V1 用内存 + 可选本地 JSON 持久化）。
|
||||
|
||||
## 3. 模块划分
|
||||
|
||||
### 3.1 Discovery
|
||||
|
||||
- 向所有可用网卡的广播地址发送 UDP discover。
|
||||
- 监听本地 UDP socket 收集 replies（时间窗默认 1200ms）。
|
||||
- 去重规则：按 `device_id` 去重，以最新 reply 为准。
|
||||
|
||||
### 3.2 Device Registry
|
||||
|
||||
- 内存缓存：
|
||||
- `device_id -> {ip, agent_port, media_port, device_name, version, git_sha, last_seen_ms, online}`
|
||||
- 定时刷新（可配置间隔）：对 online 设备拉取 `GET /v1/graphs`（agent 代理），更新摘要。
|
||||
- Offline 规则：超过 `offline_after_ms`（如 10000ms）未见到，则标记离线。
|
||||
|
||||
### 3.3 Device Client
|
||||
|
||||
- 统一超时：connect 1s、overall 3s（可配置）。
|
||||
- 统一错误包装：返回 `error_code + message + device_id`。
|
||||
- Token：
|
||||
- 全局默认 token（V1）
|
||||
- 可预留 per-device token（P1）
|
||||
|
||||
### 3.4 Templates/Config Builder
|
||||
|
||||
- 模板库来源：
|
||||
- V1：managerd 内置（embed）或本地 `templates/` 目录读取
|
||||
- 返回前端表单 schema：V1 允许手工维护（避免解析占位符带来的不确定性）。
|
||||
- 生成 root config：基于模板与 params，产出 `{global,templates,instances}`。
|
||||
|
||||
### 3.5 Task Runner
|
||||
|
||||
- 任务类型：
|
||||
- `config_apply`（对 N 台设备下发 config）
|
||||
- `reload`
|
||||
- `rollback`
|
||||
- `model_upload`（V1 可先做单设备；批量后续）
|
||||
- 并发控制：默认 5（可配置）。
|
||||
- 状态：`pending/running/success/failed`（逐设备与整体）。
|
||||
- 推送：SSE `GET /api/tasks/:id/events`。
|
||||
|
||||
## 4. managerd 对前端 API 规格（V1）
|
||||
|
||||
### 4.1 Discovery
|
||||
|
||||
#### `POST /api/discovery/search`
|
||||
|
||||
Request:
|
||||
|
||||
```json
|
||||
{ "timeout_ms": 1200 }
|
||||
```
|
||||
|
||||
Response:
|
||||
|
||||
```json
|
||||
{ "items": [ {"device_id":"...","ip":"...","agent_port":9100,"media_port":9000,"device_name":"...","version":"...","git_sha":"..."} ] }
|
||||
```
|
||||
|
||||
### 4.2 Devices
|
||||
|
||||
#### `GET /api/devices`
|
||||
|
||||
Response:
|
||||
|
||||
```json
|
||||
{ "items": [ {"device_id":"...","online":true,"last_seen_ms":0,"ip":"...","agent_port":9100,"media_port":9000,"device_name":"...","version":"...","git_sha":"...","graphs":[...]} ] }
|
||||
```
|
||||
|
||||
#### `GET /api/devices/:id`
|
||||
|
||||
Response：包含 `info`、`graphs_summary`、`last_seen`。
|
||||
|
||||
### 4.3 Device actions（代理调用）
|
||||
|
||||
以下全部通过 agent：
|
||||
|
||||
- `POST /api/devices/:id/reload` → agent `POST /v1/media-server/reload`
|
||||
- `POST /api/devices/:id/rollback` → agent `POST /v1/media-server/rollback`
|
||||
- `GET /api/devices/:id/graphs` → agent `GET /v1/graphs`
|
||||
- `GET /api/devices/:id/graphs/:name` → agent `GET /v1/graphs/{name}`
|
||||
- `GET /api/devices/:id/logs?limit=200` → agent `GET /v1/logs/recent?limit=200`
|
||||
|
||||
### 4.4 Config apply
|
||||
|
||||
#### `POST /api/devices/:id/config/apply`
|
||||
|
||||
Request:
|
||||
|
||||
```json
|
||||
{ "config": { } }
|
||||
```
|
||||
|
||||
Behavior：调用 agent `PUT /v1/config`。
|
||||
|
||||
### 4.5 Model upload
|
||||
|
||||
#### `POST /api/devices/:id/models/upload`
|
||||
|
||||
Request：`multipart/form-data`，字段：
|
||||
|
||||
- `name`: string
|
||||
- `file`: binary
|
||||
|
||||
Behavior：读取文件流，转发为 agent `PUT /v1/models/{name}`（raw body）。
|
||||
|
||||
### 4.6 Templates
|
||||
|
||||
- `GET /api/templates`
|
||||
- `GET /api/templates/:name`
|
||||
|
||||
### 4.7 Tasks
|
||||
|
||||
#### `POST /api/tasks`
|
||||
|
||||
Request:
|
||||
|
||||
```json
|
||||
{
|
||||
"type": "config_apply",
|
||||
"device_ids": ["..."],
|
||||
"payload": { "config": {} }
|
||||
}
|
||||
```
|
||||
|
||||
Response:
|
||||
|
||||
```json
|
||||
{ "task_id": "..." }
|
||||
```
|
||||
|
||||
#### `GET /api/tasks/:id/events` (SSE)
|
||||
|
||||
Event `device_update` data:
|
||||
|
||||
```json
|
||||
{ "device_id":"...","status":"running|success|failed","progress":0.0,"error":"" }
|
||||
```
|
||||
|
||||
## 5. 错误处理规范（managerd → 前端）
|
||||
|
||||
- 成功：2xx + `{"ok":true}` 或正常业务 JSON
|
||||
- 失败：4xx/5xx +
|
||||
|
||||
```json
|
||||
{ "error": { "code": "...", "message": "...", "device_id": "...", "detail": "..." } }
|
||||
```
|
||||
|
||||
建议错误码：
|
||||
|
||||
- `DISCOVERY_FAILED`
|
||||
- `DEVICE_NOT_FOUND`
|
||||
- `DEVICE_OFFLINE`
|
||||
- `DEVICE_HTTP_ERROR`
|
||||
- `DEVICE_TIMEOUT`
|
||||
- `TASK_NOT_FOUND`
|
||||
- `VALIDATION_ERROR`
|
||||
|
||||
## 6. 配置文件（managerd）建议
|
||||
|
||||
`managerd.json`：
|
||||
|
||||
```json
|
||||
{
|
||||
"listen": "127.0.0.1:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
"agent_token": "CHANGE_ME",
|
||||
"concurrency": 5
|
||||
}
|
||||
```
|
||||
|
||||
## 7. 验收标准
|
||||
|
||||
1. Search 可发现设备并更新 registry；离线判断正确。
|
||||
2. 可通过 agent 读取 graphs/logs（`GET /v1/graphs`、`GET /v1/logs/recent`）。
|
||||
3. 单设备 `config/apply`、`reload`、`rollback` 可用，错误可定位。
|
||||
4. 批量 `config_apply` 任务可并发执行并通过 SSE 输出逐台结果。
|
||||
592
build/3588AdminBackend-离线部署包-20260225/docs/离线部署文档.md
Normal file
592
build/3588AdminBackend-离线部署包-20260225/docs/离线部署文档.md
Normal file
@ -0,0 +1,592 @@
|
||||
# 3588AdminBackend 离线部署文档
|
||||
|
||||
> **目标环境**: Ubuntu 22.04.5 LTS (离线环境，无法连接互联网)
|
||||
> **部署方式**: 在 Windows 上交叉编译，上传安装包到 Ubuntu 进行离线部署
|
||||
> **版本**: V2.1 (Windows 构建版)
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [部署概述](#1-部署概述)
|
||||
2. [准备环境（Windows）](#2-准备环境windows)
|
||||
3. [构建步骤（Windows）](#3-构建步骤windows)
|
||||
4. [离线安装（Ubuntu）](#4-离线安装ubuntu)
|
||||
5. [验证与启动](#5-验证与启动)
|
||||
6. [常见问题排查](#6-常见问题排查)
|
||||
|
||||
---
|
||||
|
||||
## 1. 部署概述
|
||||
|
||||
### 1.1 项目简介
|
||||
|
||||
3588AdminBackend 是 Orange Pi 3588 媒体服务器的后台管理端，提供以下功能：
|
||||
|
||||
- 设备发现与注册管理
|
||||
- 设备配置下发与批量任务管理
|
||||
- 代理调用设备端 API
|
||||
- SSE 实时任务进度推送
|
||||
|
||||
### 1.2 技术栈
|
||||
|
||||
| 组件 | 版本 | 说明 |
|
||||
|------|------|------|
|
||||
| Go | 1.23+ | **编译环境（仅 Windows 构建机需要）** |
|
||||
| chi | v5.2.3 | Web 框架（已静态编译到二进制） |
|
||||
| cors | v1.2.2 | CORS 中间件（已静态编译到二进制） |
|
||||
| uuid | v1.6.0 | UUID 生成库（已静态编译到二进制） |
|
||||
|
||||
> **注意**: Go 编译生成的是**静态链接的二进制文件**，目标机器（Ubuntu 生产环境）**不需要**安装 Go 运行时，只需要 Linux 内核即可运行。
|
||||
|
||||
### 1.3 部署流程概览
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────────┐
|
||||
│ Windows（构建环境） │
|
||||
│ ┌──────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 1. 安装 Go 1.23+ │ │
|
||||
│ │ 2. 运行 build-windows.ps1 │ │
|
||||
│ │ 3. 生成 3588AdminBackend-离线部署包-YYYYMMDD.tar.gz │ │
|
||||
│ └──────────────────────────────────────────────────────────────┘ │
|
||||
└──────────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼ (上传到 Ubuntu 服务器)
|
||||
┌──────────────────────────────────────────────────────────────────────┐
|
||||
│ Ubuntu（生产环境） │
|
||||
│ ┌──────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 无需 Go 运行时！直接运行编译好的静态二进制文件 │ │
|
||||
│ │ - tar -xzf 3588AdminBackend-离线部署包-*.tar.gz │ │
|
||||
│ │ - sudo ./scripts/3588admin install │ │
|
||||
│ │ - sudo ./scripts/3588admin start │ │
|
||||
│ └──────────────────────────────────────────────────────────────┘ │
|
||||
└──────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 准备环境（Windows）
|
||||
|
||||
### 2.1 系统要求
|
||||
|
||||
- **操作系统**: Windows 10/11 或 Windows Server 2019+
|
||||
- **磁盘空间**: 至少 1GB 可用空间
|
||||
- **Go 版本**: 1.23.3 或更高
|
||||
- **网络**: 可访问互联网（下载 Go 依赖）
|
||||
|
||||
### 2.2 安装 Go 编译环境
|
||||
|
||||
1. **下载 Go 安装包**
|
||||
- 访问 https://go.dev/dl/
|
||||
- 下载 `go1.23.3.windows-amd64.msi`
|
||||
|
||||
2. **安装 Go**
|
||||
- 双击 MSI 文件，按向导安装
|
||||
- 默认安装到 `C:\Program Files\Go\`
|
||||
- 安装程序会自动配置 PATH
|
||||
|
||||
3. **验证安装**
|
||||
```powershell
|
||||
# 打开 PowerShell 或 CMD
|
||||
go version
|
||||
# 输出: go version go1.23.3 windows/amd64
|
||||
```
|
||||
|
||||
### 2.3 准备项目源码
|
||||
|
||||
将项目源码复制到 Windows 机器上，例如：
|
||||
```
|
||||
C:\Users\YourName\3588AdminBackend\
|
||||
```
|
||||
|
||||
目录结构应包含：
|
||||
```
|
||||
3588AdminBackend/
|
||||
├── cmd/
|
||||
│ └── managerd/
|
||||
├── internal/
|
||||
├── scripts/
|
||||
│ └── deploy/
|
||||
│ ├── 3588admin # 管理脚本
|
||||
│ ├── 3588admin.service # Systemd 服务
|
||||
│ └── build-windows.ps1 # Windows 构建脚本
|
||||
├── templates/
|
||||
├── go.mod
|
||||
└── go.sum
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 构建步骤（Windows）
|
||||
|
||||
### 3.1 运行构建脚本
|
||||
|
||||
打开 PowerShell，进入项目目录：
|
||||
|
||||
```powershell
|
||||
# 进入项目目录
|
||||
cd C:\Users\YourName\3588AdminBackend\scripts\deploy
|
||||
|
||||
# 执行构建脚本
|
||||
.\build-windows.ps1
|
||||
```
|
||||
|
||||
或一行命令：
|
||||
```powershell
|
||||
& "C:<Users>YourName<3588AdminBackend<scripts>deploy<build-windows.ps1"
|
||||
```
|
||||
|
||||
### 3.2 构建输出
|
||||
|
||||
构建完成后，会在 `build\` 目录下生成：
|
||||
```
|
||||
3588AdminBackend-离线部署包-YYYYMMDD.tar.gz
|
||||
```
|
||||
|
||||
构建输出示例：
|
||||
```
|
||||
========== 3588AdminBackend Windows 构建 ==========
|
||||
项目目录: C:<Users>YourName<3588AdminBackend
|
||||
构建目录: C:<Users>YourName<3588AdminBackend<build
|
||||
Go 版本: go version go1.23.3 windows/amd64
|
||||
|
||||
[1/6] 清理旧构建...
|
||||
[2/6] 创建目录结构...
|
||||
[3/6] 交叉编译 Linux AMD64 版本...
|
||||
编译成功
|
||||
[4/6] 复制配置文件...
|
||||
[5/6] 复制部署脚本...
|
||||
[6/6] 复制文档...
|
||||
|
||||
打包...
|
||||
|
||||
========== 构建完成 ==========
|
||||
|
||||
输出文件:
|
||||
3588AdminBackend-离线部署包-20260225.tar.gz (12.34 MB)
|
||||
|
||||
部署包位置: C:<Users>YourName<3588AdminBackend<build<3588AdminBackend-离线部署包-20260225.tar.gz
|
||||
|
||||
使用说明:
|
||||
1. 将 3588AdminBackend-离线部署包-20260225.tar.gz 上传到 Ubuntu 服务器
|
||||
2. 解压并运行: sudo ./scripts/3588admin install
|
||||
```
|
||||
|
||||
### 3.3 手动打包（如不使用脚本）
|
||||
|
||||
如果 PowerShell 脚本执行失败，可以手动操作：
|
||||
|
||||
```powershell
|
||||
# 1. 进入项目目录
|
||||
cd C:<Users>YourName<3588AdminBackend
|
||||
|
||||
# 2. 交叉编译 Linux 版本
|
||||
$env:GOOS = "linux"
|
||||
$env:GOARCH = "amd64"
|
||||
go build -ldflags="-s -w" -o managerd-linux-amd64 .\cmd\managerd
|
||||
|
||||
# 3. 创建部署目录
|
||||
mkdir build<3588admin-deploy<bin
|
||||
mkdir build<3588admin-deploy<config
|
||||
mkdir build<3588admin-deploy<scripts
|
||||
|
||||
# 4. 复制文件
|
||||
copy managerd-linux-amd64 build<3588admin-deploy<bin<managerd
|
||||
copy scripts>deploy<3588admin build<3588admin-deploy<scripts<
|
||||
copy scripts>deploy<3588admin.service build<3588admin-deploy<scripts<
|
||||
copy managerd.json build<3588admin-deploy<config<managerd.json.example
|
||||
|
||||
# 5. 打包
|
||||
cd build
|
||||
tar -czf 3588AdminBackend-离线部署包-$(Get-Date -Format 'yyyyMMdd').tar.gz 3588admin-deploy<
|
||||
```
|
||||
|
||||
### 3.4 上传到 Ubuntu 服务器
|
||||
|
||||
使用 SCP、FTP 或任何文件传输工具将部署包上传到 Ubuntu：
|
||||
|
||||
```powershell
|
||||
# 使用 scp（如果 Windows 有 OpenSSH）
|
||||
scp .\build<3588AdminBackend-离线部署包-*.tar.gz user@ubuntu-server:/tmp/
|
||||
|
||||
# 或使用 WinSCP、FileZilla 等图形化工具
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 离线安装（Ubuntu）
|
||||
|
||||
> **环境**: Ubuntu 22.04.5 LTS，无网络连接
|
||||
|
||||
### 4.1 解压部署包
|
||||
|
||||
```bash
|
||||
# 进入上传目录
|
||||
cd /tmp
|
||||
|
||||
# 解压
|
||||
tar -xzf 3588AdminBackend-离线部署包-*.tar.gz
|
||||
|
||||
# 进入部署目录
|
||||
cd 3588AdminBackend-离线部署包-*/
|
||||
|
||||
# 查看内容
|
||||
ls -la
|
||||
```
|
||||
|
||||
### 4.2 执行安装
|
||||
|
||||
```bash
|
||||
# 检查环境（可选但推荐）
|
||||
sudo ./scripts/3588admin check
|
||||
|
||||
# 执行安装
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
# 或指定自定义安装目录
|
||||
# sudo ./scripts/3588admin install /usr/local/3588admin
|
||||
```
|
||||
|
||||
安装脚本会自动完成：
|
||||
|
||||
- 检查 root 权限
|
||||
- 复制文件到安装目录
|
||||
- 设置执行权限
|
||||
- 创建配置文件
|
||||
- 创建命令快捷方式（`3588admin-start`, `3588admin-stop`, `3588admin-status`）
|
||||
- 安装 Systemd 服务（可选）
|
||||
|
||||
### 4.3 配置 Systemd 服务（可选但推荐）
|
||||
|
||||
```bash
|
||||
# 复制服务文件
|
||||
sudo cp /opt/3588admin/scripts/3588admin.service /etc/systemd/system/
|
||||
|
||||
# 重新加载 systemd
|
||||
sudo systemctl daemon-reload
|
||||
|
||||
# 设置开机自启
|
||||
sudo systemctl enable 3588admin
|
||||
|
||||
# 启动服务
|
||||
sudo systemctl start 3588admin
|
||||
|
||||
# 查看状态
|
||||
sudo systemctl status 3588admin
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 验证与启动
|
||||
|
||||
### 5.1 修改配置文件
|
||||
|
||||
```bash
|
||||
# 编辑配置文件
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
```
|
||||
|
||||
**关键配置项说明**：
|
||||
|
||||
```json
|
||||
{
|
||||
"listen": "0.0.0.0:18080", // HTTP API 监听地址（0.0.0.0 允许外部访问）
|
||||
"discovery_port": 35688, // UDP 发现端口
|
||||
"discovery_timeout_ms": 1200, // 发现超时时间
|
||||
"offline_after_ms": 10000, // 设备离线判定时间
|
||||
"agent_token": "CHANGE_ME", // !!! 必须修改 !!! 与设备端通信的 Token
|
||||
"concurrency": 5 // 批量任务并发数
|
||||
}
|
||||
```
|
||||
|
||||
**配置建议**：
|
||||
|
||||
- `listen`: 如果前端通过本地访问，保持 `127.0.0.1:18080`；如果需要外部访问，改为 `0.0.0.0:18080`
|
||||
- `agent_token`: **必须修改为安全的随机字符串**，与设备端配置的 token 保持一致
|
||||
|
||||
### 5.2 启动服务
|
||||
|
||||
**方式1: 使用管理脚本（推荐）**
|
||||
|
||||
```bash
|
||||
# 启动
|
||||
sudo 3588admin start
|
||||
|
||||
# 查看状态
|
||||
sudo 3588admin status
|
||||
|
||||
# 停止
|
||||
sudo 3588admin stop
|
||||
|
||||
# 重启
|
||||
sudo 3588admin restart
|
||||
```
|
||||
|
||||
**方式2: 使用快捷命令**
|
||||
|
||||
```bash
|
||||
# 启动
|
||||
sudo 3588admin-start
|
||||
|
||||
# 查看状态
|
||||
sudo 3588admin-status
|
||||
|
||||
# 停止
|
||||
sudo 3588admin-stop
|
||||
```
|
||||
|
||||
**方式3: 使用 Systemd**
|
||||
|
||||
```bash
|
||||
sudo systemctl start 3588admin
|
||||
sudo systemctl status 3588admin
|
||||
```
|
||||
|
||||
### 5.3 验证服务
|
||||
|
||||
```bash
|
||||
# 检查进程
|
||||
ps aux | grep managerd
|
||||
|
||||
# 检查端口监听
|
||||
sudo netstat -tlnp | grep 18080
|
||||
# 或
|
||||
sudo ss -tlnp | grep 18080
|
||||
|
||||
# 测试 API
|
||||
curl http://127.0.0.1:18080/api/devices
|
||||
|
||||
# 查看日志
|
||||
tail -f /opt/3588admin/logs/managerd.log
|
||||
```
|
||||
|
||||
### 5.4 防火墙配置
|
||||
|
||||
```bash
|
||||
# 开放 HTTP API 端口（如需外部访问）
|
||||
sudo ufw allow 18080/tcp
|
||||
|
||||
# 开放 UDP 发现端口（必须）
|
||||
sudo ufw allow 35688/udp
|
||||
|
||||
# 重新加载防火墙
|
||||
sudo ufw reload
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 常见问题排查
|
||||
|
||||
### 6.1 Windows 构建失败
|
||||
|
||||
**问题**: 执行 `build-windows.ps1` 提示权限不足
|
||||
|
||||
**解决**:
|
||||
```powershell
|
||||
# 以管理员身份运行 PowerShell
|
||||
# 右键点击 PowerShell -> 以管理员身份运行
|
||||
|
||||
# 或修改执行策略（临时）
|
||||
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
|
||||
.\build-windows.ps1
|
||||
```
|
||||
|
||||
**问题**: `tar` 命令不存在
|
||||
|
||||
**解决**: Windows 10/11 内置 tar，如果找不到，使用 7-Zip 或其他工具手动打包。
|
||||
|
||||
### 6.2 Ubuntu 上启动失败
|
||||
|
||||
**问题**: 执行 start 命令提示启动失败
|
||||
|
||||
**排查步骤**:
|
||||
|
||||
```bash
|
||||
# 1. 检查二进制文件架构是否匹配
|
||||
file /opt/3588admin/bin/managerd
|
||||
# 应输出: ELF 64-bit LSB executable, x86-64
|
||||
|
||||
# 2. 直接运行查看错误信息
|
||||
/opt/3588admin/bin/managerd -config /opt/3588admin/config/managerd.json
|
||||
|
||||
# 3. 检查配置文件格式
|
||||
python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
```
|
||||
|
||||
### 6.3 端口被占用
|
||||
|
||||
**问题**: 提示端口 18080 已被占用
|
||||
|
||||
**解决**:
|
||||
|
||||
```bash
|
||||
# 查找占用端口的进程
|
||||
sudo lsof -i :18080
|
||||
# 或
|
||||
sudo netstat -tlnp | grep 18080
|
||||
|
||||
# 修改配置文件使用其他端口
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
# 修改 "listen" 为 "127.0.0.1:18081" 或其他端口
|
||||
```
|
||||
|
||||
### 6.4 无法发现设备
|
||||
|
||||
**问题**: 设备发现功能不工作
|
||||
|
||||
**排查**:
|
||||
|
||||
```bash
|
||||
# 检查 UDP 端口监听
|
||||
sudo netstat -ulnp | grep 35688
|
||||
|
||||
# 检查防火墙
|
||||
sudo ufw status | grep 35688
|
||||
|
||||
# 检查网络接口是否有权限发送广播
|
||||
# 可能需要以 root 运行
|
||||
|
||||
# 检查设备端是否配置了正确的发现端口和 token
|
||||
```
|
||||
|
||||
### 6.5 权限问题
|
||||
|
||||
**问题**: 提示 Permission denied
|
||||
|
||||
**解决**:
|
||||
|
||||
```bash
|
||||
# 修复权限
|
||||
sudo chmod +x /opt/3588admin/bin/managerd
|
||||
sudo chmod +x /opt/3588admin/scripts/3588admin
|
||||
|
||||
# 确保以 root 运行
|
||||
sudo 3588admin start
|
||||
```
|
||||
|
||||
### 6.6 日志查看
|
||||
|
||||
```bash
|
||||
# 实时查看日志
|
||||
tail -f /opt/3588admin/logs/managerd.log
|
||||
|
||||
# 查看最近 100 行
|
||||
tail -n 100 /opt/3588admin/logs/managerd.log
|
||||
|
||||
# 搜索错误信息
|
||||
grep -i error /opt/3588admin/logs/managerd.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### A. 目录结构参考
|
||||
|
||||
**Windows 构建机**：
|
||||
```
|
||||
C:<Users>YourName<3588AdminBackend<
|
||||
├── build< # 构建输出
|
||||
│ └── 3588AdminBackend-离线部署包-20260225<
|
||||
│ ├── bin<
|
||||
│ │ └── managerd # Linux 静态二进制文件
|
||||
│ ├── config<
|
||||
│ ├── scripts<
|
||||
│ │ └── 3588admin # 管理脚本
|
||||
│ ├── docs<
|
||||
│ └── README-离线安装.txt
|
||||
├── scripts>deploy<
|
||||
│ ├── 3588admin
|
||||
│ ├── 3588admin.service
|
||||
│ └── build-windows.ps1 # Windows 构建脚本
|
||||
├── cmd<
|
||||
├── internal<
|
||||
└── go.mod
|
||||
```
|
||||
|
||||
**Ubuntu 生产环境**：
|
||||
```
|
||||
/opt/3588admin/
|
||||
├── bin/
|
||||
│ └── managerd # 主程序（Windows 交叉编译生成）
|
||||
├── config/
|
||||
│ └── managerd.json # 配置文件
|
||||
├── logs/
|
||||
│ └── managerd.log # 运行日志
|
||||
├── scripts/
|
||||
│ ├── 3588admin # 统一管理脚本
|
||||
│ └── 3588admin.service # 服务文件（复制用）
|
||||
└── systemd/ # （如安装服务）
|
||||
```
|
||||
|
||||
### B. 管理脚本命令速查
|
||||
|
||||
```bash
|
||||
# 环境检查
|
||||
sudo 3588admin check
|
||||
|
||||
# 安装
|
||||
sudo 3588admin install [目录]
|
||||
|
||||
# 启动/停止/重启
|
||||
sudo 3588admin start
|
||||
sudo 3588admin stop
|
||||
sudo 3588admin restart
|
||||
|
||||
# 查看状态
|
||||
sudo 3588admin status
|
||||
|
||||
# 升级
|
||||
sudo 3588admin upgrade [目录]
|
||||
|
||||
# 卸载
|
||||
sudo 3588admin uninstall [目录]
|
||||
|
||||
# 帮助
|
||||
3588admin help
|
||||
```
|
||||
|
||||
### C. 升级步骤
|
||||
|
||||
```bash
|
||||
# 1. 停止服务
|
||||
sudo 3588admin stop
|
||||
# 或
|
||||
sudo systemctl stop 3588admin
|
||||
|
||||
# 2. 备份配置
|
||||
cp /opt/3588admin/config/managerd.json ~/managerd.json.bak
|
||||
|
||||
# 3. 在 Windows 上重新构建新版本
|
||||
# 运行 build-windows.ps1
|
||||
|
||||
# 4. 上传到 Ubuntu 并执行升级
|
||||
sudo ./scripts/3588admin upgrade
|
||||
|
||||
# 5. 验证升级
|
||||
sudo 3588admin status
|
||||
```
|
||||
|
||||
### D. 完全卸载
|
||||
|
||||
```bash
|
||||
# 方式1: 使用管理脚本
|
||||
sudo 3588admin uninstall
|
||||
|
||||
# 方式2: 手动卸载
|
||||
sudo 3588admin stop
|
||||
sudo systemctl stop 3588admin 2>/dev/null || true
|
||||
sudo systemctl disable 3588admin 2>/dev/null || true
|
||||
sudo rm -f /etc/systemd/system/3588admin.service
|
||||
sudo rm -rf /opt/3588admin
|
||||
sudo rm -f /usr/local/bin/3588admin*
|
||||
sudo systemctl daemon-reload
|
||||
|
||||
echo "卸载完成"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 2.1 (Windows 构建版)
|
||||
**最后更新**: 2026-02-25
|
||||
**适用版本**: 3588AdminBackend V1.0+
|
||||
845
build/3588AdminBackend-离线部署包-20260225/scripts/3588admin
Normal file
845
build/3588AdminBackend-离线部署包-20260225/scripts/3588admin
Normal file
@ -0,0 +1,845 @@
|
||||
#!/bin/bash
|
||||
# 3588AdminBackend 统一管理脚本
|
||||
# 提供安装、状态、升级、卸载等功能
|
||||
|
||||
set -e
|
||||
|
||||
# 颜色定义
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m'
|
||||
|
||||
# 配置
|
||||
APP_NAME="managerd"
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
DEFAULT_INSTALL_DIR="/opt/3588admin"
|
||||
INSTALL_DIR="${DEFAULT_INSTALL_DIR}"
|
||||
PID_FILE="$INSTALL_DIR/$APP_NAME.pid"
|
||||
|
||||
# 显示帮助
|
||||
cmd_help() {
|
||||
cat << EOF
|
||||
3588AdminBackend 管理脚本
|
||||
|
||||
用法: $0 <命令> [选项]
|
||||
|
||||
命令:
|
||||
install [目录] 安装服务 (默认: /opt/3588admin)
|
||||
status 查看服务状态
|
||||
start 启动服务
|
||||
stop 停止服务
|
||||
restart 重启服务
|
||||
upgrade [目录] 升级服务 (保留配置)
|
||||
uninstall [目录] 卸载服务 (自动备份配置)
|
||||
check 检查环境是否满足运行要求
|
||||
help 显示此帮助信息
|
||||
|
||||
示例:
|
||||
$0 install # 安装到默认目录
|
||||
$0 install /usr/local/3588 # 安装到指定目录
|
||||
$0 status # 查看服务状态
|
||||
$0 upgrade # 升级到当前目录下的新版本
|
||||
$0 uninstall # 卸载并备份配置
|
||||
$0 check # 检查系统环境
|
||||
|
||||
快捷命令 (安装后可用):
|
||||
3588admin-start 启动服务
|
||||
3588admin-stop 停止服务
|
||||
3588admin-status 查看状态
|
||||
EOF
|
||||
}
|
||||
|
||||
# 检查 root 权限
|
||||
check_root() {
|
||||
if [ "$EUID" -ne 0 ]; then
|
||||
echo -e "${RED}错误: 请使用 sudo 运行此命令${NC}"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# 获取安装目录
|
||||
get_install_dir() {
|
||||
if [ -n "$1" ]; then
|
||||
INSTALL_DIR="$1"
|
||||
fi
|
||||
PID_FILE="$INSTALL_DIR/$APP_NAME.pid"
|
||||
}
|
||||
|
||||
# 环境检查
|
||||
cmd_check() {
|
||||
echo "========== 3588AdminBackend 环境检查 =========="
|
||||
echo ""
|
||||
|
||||
PASS=0
|
||||
FAIL=0
|
||||
WARN=0
|
||||
|
||||
check_pass() {
|
||||
echo -e "${GREEN}✓${NC} $1"
|
||||
((PASS++))
|
||||
}
|
||||
|
||||
check_fail() {
|
||||
echo -e "${RED}✗${NC} $1"
|
||||
((FAIL++))
|
||||
}
|
||||
|
||||
check_warn() {
|
||||
echo -e "${YELLOW}⚠${NC} $1"
|
||||
((WARN++))
|
||||
}
|
||||
|
||||
# 1. 检查操作系统
|
||||
echo "[系统信息]"
|
||||
echo " 主机名: $(hostname)"
|
||||
if [ -f /etc/os-release ]; then
|
||||
. /etc/os-release
|
||||
echo " 操作系统: $NAME $VERSION"
|
||||
if [[ "$NAME" == *"Ubuntu"* ]] && [[ "$VERSION_ID" == "22.04" ]]; then
|
||||
check_pass "Ubuntu 22.04 detected"
|
||||
else
|
||||
check_warn "非 Ubuntu 22.04，可能兼容但未经测试"
|
||||
fi
|
||||
else
|
||||
check_warn "无法检测操作系统版本"
|
||||
fi
|
||||
|
||||
# 2. 检查架构
|
||||
echo ""
|
||||
echo "[硬件信息]"
|
||||
ARCH=$(uname -m)
|
||||
echo " 架构: $ARCH"
|
||||
if [ "$ARCH" = "x86_64" ]; then
|
||||
check_pass "x86_64 架构"
|
||||
elif [ "$ARCH" = "aarch64" ]; then
|
||||
check_warn "ARM64 架构，请使用 ARM64 版本二进制"
|
||||
else
|
||||
check_warn "未知架构: $ARCH"
|
||||
fi
|
||||
|
||||
echo " CPU: $(nproc) 核"
|
||||
echo " 内存: $(free -h | awk '/^Mem:/ {print $2}')"
|
||||
|
||||
# 3. 检查网络工具
|
||||
echo ""
|
||||
echo "[网络工具]"
|
||||
if command -v curl >/dev/null 2>&1; then
|
||||
check_pass "curl 已安装"
|
||||
else
|
||||
check_warn "curl 未安装"
|
||||
fi
|
||||
|
||||
if command -v netstat >/dev/null 2>&1 || command -v ss >/dev/null 2>&1; then
|
||||
check_pass "网络工具(netstat/ss)已安装"
|
||||
else
|
||||
check_warn "建议安装 net-tools 或 iproute2"
|
||||
fi
|
||||
|
||||
# 4. 检查端口占用
|
||||
echo ""
|
||||
echo "[端口检查]"
|
||||
PORT_18080=false
|
||||
PORT_35688=false
|
||||
|
||||
if command -v ss >/dev/null 2>&1; then
|
||||
PORT_18080=$(ss -tln 2>/dev/null | grep -q ':18080 ' && echo true || echo false)
|
||||
PORT_35688=$(ss -uln 2>/dev/null | grep -q ':35688 ' && echo true || echo false)
|
||||
elif command -v netstat >/dev/null 2>&1; then
|
||||
PORT_18080=$(netstat -tln 2>/dev/null | grep -q ':18080 ' && echo true || echo false)
|
||||
PORT_35688=$(netstat -uln 2>/dev/null | grep -q ':35688 ' && echo true || echo false)
|
||||
fi
|
||||
|
||||
if [ "$PORT_18080" = true ]; then
|
||||
check_warn "端口 18080 已被占用"
|
||||
else
|
||||
check_pass "端口 18080 可用"
|
||||
fi
|
||||
|
||||
if [ "$PORT_35688" = true ]; then
|
||||
check_warn "端口 35688 已被占用"
|
||||
else
|
||||
check_pass "端口 35688 可用"
|
||||
fi
|
||||
|
||||
# 5. 检查防火墙
|
||||
echo ""
|
||||
echo "[防火墙]"
|
||||
if command -v ufw >/dev/null 2>&1; then
|
||||
UFW_STATUS=$(ufw status 2>/dev/null | grep -i status | awk '{print $2}')
|
||||
echo " UFW 状态: $UFW_STATUS"
|
||||
elif command -v firewall-cmd >/dev/null 2>&1; then
|
||||
check_warn "检测到 firewalld，请手动配置端口"
|
||||
else
|
||||
echo " 未检测到防火墙"
|
||||
fi
|
||||
|
||||
# 6. 检查磁盘空间
|
||||
echo ""
|
||||
echo "[磁盘空间]"
|
||||
DISK_AVAIL=$(df -BG /opt 2>/dev/null | tail -1 | awk '{print $4}' | tr -d 'G')
|
||||
if [ -z "$DISK_AVAIL" ]; then
|
||||
DISK_AVAIL=$(df -BG / 2>/dev/null | tail -1 | awk '{print $4}' | tr -d 'G')
|
||||
fi
|
||||
|
||||
if [ -n "$DISK_AVAIL" ] && [ "$DISK_AVAIL" -ge 1 ]; then
|
||||
check_pass "磁盘空间充足 (${DISK_AVAIL}G 可用)"
|
||||
else
|
||||
check_warn "磁盘空间不足 (${DISK_AVAIL:-0}G 可用，建议至少 1GB)"
|
||||
fi
|
||||
|
||||
# 7. 检查权限
|
||||
echo ""
|
||||
echo "[权限检查]"
|
||||
if [ "$EUID" -eq 0 ]; then
|
||||
check_pass "当前为 root 用户"
|
||||
else
|
||||
check_warn "当前非 root 用户，安装需要 root 权限"
|
||||
fi
|
||||
|
||||
# 8. 检查 Python
|
||||
echo ""
|
||||
echo "[其他工具]"
|
||||
if command -v python3 >/dev/null 2>&1; then
|
||||
check_pass "Python3 已安装 ($(python3 --version))"
|
||||
else
|
||||
check_warn "Python3 未安装 (用于配置验证)"
|
||||
fi
|
||||
|
||||
# 总结
|
||||
echo ""
|
||||
echo "========== 检查总结 =========="
|
||||
echo -e "通过: ${GREEN}$PASS${NC} 警告: ${YELLOW}$WARN${NC} 失败: ${RED}$FAIL${NC}"
|
||||
echo ""
|
||||
|
||||
if [ $FAIL -gt 0 ]; then
|
||||
echo -e "${RED}环境检查未通过，请解决上述问题后再安装${NC}"
|
||||
exit 1
|
||||
elif [ $WARN -gt 0 ]; then
|
||||
echo -e "${YELLOW}环境基本满足，但有一些警告需要注意${NC}"
|
||||
return 0
|
||||
else
|
||||
echo -e "${GREEN}环境检查全部通过，可以安装${NC}"
|
||||
return 0
|
||||
fi
|
||||
}
|
||||
|
||||
# 安装
|
||||
cmd_install() {
|
||||
check_root
|
||||
get_install_dir "$1"
|
||||
|
||||
local CURRENT_DIR="$SCRIPT_DIR"
|
||||
local BASE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
|
||||
|
||||
echo "========== 3588AdminBackend 离线安装 =========="
|
||||
echo "安装目录: $INSTALL_DIR"
|
||||
echo ""
|
||||
|
||||
# 检查安装目录
|
||||
if [ -d "$INSTALL_DIR" ] && [ "$(ls -A $INSTALL_DIR 2>/dev/null)" ]; then
|
||||
echo -e "${YELLOW}警告: 安装目录 $INSTALL_DIR 已存在且不为空${NC}"
|
||||
read -p "是否覆盖? (y/N): " -n 1 -r
|
||||
echo
|
||||
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
||||
echo "安装已取消"
|
||||
exit 1
|
||||
fi
|
||||
# 备份现有配置
|
||||
if [ -f "$INSTALL_DIR/config/managerd.json" ]; then
|
||||
local BACKUP_FILE="$INSTALL_DIR/config/managerd.json.bak.$(date +%Y%m%d%H%M%S)"
|
||||
echo "备份现有配置到: $BACKUP_FILE"
|
||||
cp "$INSTALL_DIR/config/managerd.json" "$BACKUP_FILE"
|
||||
fi
|
||||
fi
|
||||
|
||||
# 1. 安装依赖包
|
||||
if [ -d "$BASE_DIR/deps" ] && [ "$(ls -A $BASE_DIR/deps/*.deb 2>/dev/null)" ]; then
|
||||
echo "[1/5] 安装依赖包..."
|
||||
cd "$BASE_DIR/deps"
|
||||
for pkg in *.deb; do
|
||||
echo " 安装: $pkg"
|
||||
dpkg -i "$pkg" 2>/dev/null || true
|
||||
done
|
||||
apt-get install -f -y 2>/dev/null || true
|
||||
else
|
||||
echo "[1/5] 跳过依赖包安装 (无依赖包)"
|
||||
fi
|
||||
|
||||
# 2. 创建安装目录
|
||||
echo "[2/5] 创建安装目录..."
|
||||
mkdir -p "$INSTALL_DIR"
|
||||
|
||||
echo " 复制二进制文件..."
|
||||
mkdir -p "$INSTALL_DIR/bin"
|
||||
cp "$BASE_DIR/bin/managerd" "$INSTALL_DIR/bin/" 2>/dev/null || {
|
||||
echo -e "${RED}错误: 未找到 managerd 二进制文件${NC}"
|
||||
echo "请确保在打包前已编译"
|
||||
exit 1
|
||||
}
|
||||
|
||||
echo " 复制配置文件..."
|
||||
mkdir -p "$INSTALL_DIR/config"
|
||||
if [ -f "$BASE_DIR/config/managerd.json" ]; then
|
||||
cp "$BASE_DIR/config/managerd.json" "$INSTALL_DIR/config/"
|
||||
elif [ -f "$BASE_DIR/config/managerd.json.example" ]; then
|
||||
cp "$BASE_DIR/config/managerd.json.example" "$INSTALL_DIR/config/"
|
||||
fi
|
||||
|
||||
# 复制模板文件
|
||||
if [ -d "$BASE_DIR/templates" ]; then
|
||||
echo " 复制模板文件..."
|
||||
cp -r "$BASE_DIR/templates" "$INSTALL_DIR/"
|
||||
fi
|
||||
|
||||
# 3. 设置权限
|
||||
echo "[3/5] 设置权限..."
|
||||
chmod +x "$INSTALL_DIR/bin/managerd"
|
||||
mkdir -p "$INSTALL_DIR/logs" || {
|
||||
echo -e "${RED}错误: 无法创建日志目录 $INSTALL_DIR/logs${NC}"
|
||||
exit 1
|
||||
}
|
||||
chmod 755 "$INSTALL_DIR/logs" || {
|
||||
echo -e "${RED}错误: 无法设置日志目录权限${NC}"
|
||||
exit 1
|
||||
}
|
||||
|
||||
# 4. 初始化配置文件
|
||||
echo "[4/5] 初始化配置文件..."
|
||||
if [ ! -f "$INSTALL_DIR/config/managerd.json" ]; then
|
||||
cat > "$INSTALL_DIR/config/managerd.json" << 'EOF'
|
||||
{
|
||||
"listen": "0.0.0.0:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
"agent_token": "CHANGE_ME",
|
||||
"concurrency": 5
|
||||
}
|
||||
EOF
|
||||
echo -e " ${GREEN}已创建默认配置文件${NC}"
|
||||
echo -e " ${YELLOW}⚠️ 请编辑 $INSTALL_DIR/config/managerd.json 修改配置（特别是 agent_token）${NC}"
|
||||
else
|
||||
echo " 配置文件已存在，保留现有配置"
|
||||
fi
|
||||
|
||||
# 5. 复制管理脚本
|
||||
echo "[5/5] 安装管理脚本..."
|
||||
mkdir -p "$INSTALL_DIR/scripts"
|
||||
cp "$CURRENT_DIR/3588admin" "$INSTALL_DIR/scripts/"
|
||||
chmod +x "$INSTALL_DIR/scripts/3588admin"
|
||||
|
||||
# 创建快捷方式
|
||||
ln -sf "$INSTALL_DIR/scripts/3588admin" /usr/local/bin/3588admin-start 2>/dev/null || true
|
||||
ln -sf "$INSTALL_DIR/scripts/3588admin" /usr/local/bin/3588admin-stop 2>/dev/null || true
|
||||
ln -sf "$INSTALL_DIR/scripts/3588admin" /usr/local/bin/3588admin-status 2>/dev/null || true
|
||||
ln -sf "$INSTALL_DIR/scripts/3588admin" /usr/local/bin/3588admin 2>/dev/null || true
|
||||
|
||||
# 安装 Systemd 服务
|
||||
if [ -f "$CURRENT_DIR/3588admin.service" ]; then
|
||||
echo "[可选] 安装 Systemd 服务..."
|
||||
cp "$CURRENT_DIR/3588admin.service" /etc/systemd/system/
|
||||
sed -i "s|/opt/3588admin|$INSTALL_DIR|g" /etc/systemd/system/3588admin.service
|
||||
systemctl daemon-reload
|
||||
echo " 已安装 Systemd 服务"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo -e "${GREEN}========== 安装完成 ==========${NC}"
|
||||
echo "安装目录: $INSTALL_DIR"
|
||||
echo ""
|
||||
echo "使用命令:"
|
||||
echo " 3588admin start - 启动服务"
|
||||
echo " 3588admin stop - 停止服务"
|
||||
echo " 3588admin status - 查看状态"
|
||||
echo " 3588admin restart - 重启服务"
|
||||
echo " 3588admin upgrade - 升级服务"
|
||||
echo " 3588admin uninstall - 卸载服务"
|
||||
echo ""
|
||||
echo -e "${YELLOW}重要提示:${NC}"
|
||||
echo " 1. 请先编辑配置文件: $INSTALL_DIR/config/managerd.json"
|
||||
echo " 2. 务必修改 agent_token 为安全的随机字符串"
|
||||
echo ""
|
||||
echo -e "${YELLOW}防火墙配置:${NC}"
|
||||
echo " 默认监听 0.0.0.0:18080，如需外部访问，请开放防火墙端口:"
|
||||
echo " sudo ufw allow 18080/tcp # HTTP API 端口"
|
||||
echo " sudo ufw allow 35688/udp # UDP 设备发现端口"
|
||||
echo " sudo ufw reload"
|
||||
}
|
||||
|
||||
# 启动服务
|
||||
cmd_start() {
|
||||
get_install_dir "$1"
|
||||
|
||||
local BIN_PATH="$INSTALL_DIR/bin/$APP_NAME"
|
||||
local CONFIG_PATH="$INSTALL_DIR/config/managerd.json"
|
||||
local LOG_DIR="$INSTALL_DIR/logs"
|
||||
|
||||
echo "========== 启动 3588AdminBackend =========="
|
||||
echo "应用目录: $INSTALL_DIR"
|
||||
echo "配置文件: $CONFIG_PATH"
|
||||
echo ""
|
||||
|
||||
# 检查二进制文件
|
||||
if [ ! -f "$BIN_PATH" ]; then
|
||||
echo -e "${RED}错误: 未找到二进制文件: $BIN_PATH${NC}"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 检查配置文件
|
||||
if [ ! -f "$CONFIG_PATH" ]; then
|
||||
echo -e "${RED}错误: 配置文件不存在: $CONFIG_PATH${NC}"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 验证 JSON 格式
|
||||
if command -v python3 &> /dev/null; then
|
||||
if ! python3 -m json.tool "$CONFIG_PATH" > /dev/null 2>&1; then
|
||||
echo -e "${RED}错误: 配置文件 JSON 格式不正确${NC}"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# 创建日志目录
|
||||
if [ ! -d "$LOG_DIR" ]; then
|
||||
mkdir -p "$LOG_DIR" 2>/dev/null || {
|
||||
echo -e "${RED}错误: 无法创建日志目录: $LOG_DIR${NC}"
|
||||
echo "请检查权限或手动创建: sudo mkdir -p $LOG_DIR"
|
||||
exit 1
|
||||
}
|
||||
fi
|
||||
|
||||
# 检查日志目录是否可写
|
||||
if [ ! -w "$LOG_DIR" ]; then
|
||||
echo -e "${RED}错误: 日志目录不可写: $LOG_DIR${NC}"
|
||||
echo "请修复权限: sudo chmod 755 $LOG_DIR"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 检查是否已在运行
|
||||
if [ -f "$PID_FILE" ]; then
|
||||
local PID=$(cat "$PID_FILE")
|
||||
if ps -p "$PID" > /dev/null 2>&1; then
|
||||
echo -e "${YELLOW}警告: $APP_NAME 已在运行 (PID: $PID)${NC}"
|
||||
exit 1
|
||||
else
|
||||
rm -f "$PID_FILE"
|
||||
fi
|
||||
fi
|
||||
|
||||
# 启动服务
|
||||
echo "正在启动 $APP_NAME..."
|
||||
nohup "$BIN_PATH" "$CONFIG_PATH" >> "$LOG_DIR/$APP_NAME.log" 2>&1 &
|
||||
local PID=$!
|
||||
echo $PID > "$PID_FILE"
|
||||
|
||||
# 等待启动
|
||||
sleep 2
|
||||
if ps -p "$PID" > /dev/null 2>&1; then
|
||||
echo ""
|
||||
echo -e "${GREEN}✅ 启动成功!${NC}"
|
||||
echo " PID: $PID"
|
||||
echo " 日志: $LOG_DIR/$APP_NAME.log"
|
||||
echo ""
|
||||
echo "查看日志: tail -f $LOG_DIR/$APP_NAME.log"
|
||||
else
|
||||
echo ""
|
||||
echo -e "${RED}❌ 启动失败${NC}"
|
||||
echo ""
|
||||
echo "可能的错误原因:"
|
||||
echo " 1. 端口 18080 被占用"
|
||||
echo " 2. 配置文件格式错误"
|
||||
echo " 3. 权限不足"
|
||||
echo ""
|
||||
echo "尝试直接运行查看详细错误:"
|
||||
echo " sudo $BIN_PATH $CONFIG_PATH"
|
||||
echo ""
|
||||
echo "或检查日志:"
|
||||
if [ -f "$LOG_DIR/$APP_NAME.log" ]; then
|
||||
echo " tail -20 $LOG_DIR/$APP_NAME.log"
|
||||
fi
|
||||
rm -f "$PID_FILE"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# 停止服务
|
||||
cmd_stop() {
|
||||
get_install_dir "$1"
|
||||
|
||||
echo "========== 停止 3588AdminBackend =========="
|
||||
|
||||
if [ -f "$PID_FILE" ]; then
|
||||
local PID=$(cat "$PID_FILE")
|
||||
if ps -p "$PID" > /dev/null 2>&1; then
|
||||
echo "正在停止 $APP_NAME (PID: $PID)..."
|
||||
kill "$PID"
|
||||
|
||||
echo -n "等待进程结束"
|
||||
for i in {1..10}; do
|
||||
if ! ps -p "$PID" > /dev/null 2>&1; then
|
||||
echo ""
|
||||
echo -e "${GREEN}✅ 已停止${NC}"
|
||||
rm -f "$PID_FILE"
|
||||
return 0
|
||||
fi
|
||||
echo -n "."
|
||||
sleep 1
|
||||
done
|
||||
echo ""
|
||||
|
||||
echo "强制结束进程..."
|
||||
kill -9 "$PID" 2>/dev/null || true
|
||||
rm -f "$PID_FILE"
|
||||
echo -e "${GREEN}✅ 已强制停止${NC}"
|
||||
else
|
||||
echo -e "${YELLOW}ℹ️ 进程不存在 (PID: $PID)${NC}"
|
||||
rm -f "$PID_FILE"
|
||||
fi
|
||||
else
|
||||
# 尝试查找进程
|
||||
local PID=$(pgrep -f "^$INSTALL_DIR/bin/$APP_NAME" | head -1)
|
||||
if [ -n "$PID" ]; then
|
||||
echo "发现运行中的进程 (PID: $PID)，尝试停止..."
|
||||
kill "$PID" 2>/dev/null || true
|
||||
sleep 2
|
||||
if ! ps -p "$PID" > /dev/null 2>&1; then
|
||||
echo -e "${GREEN}✅ 已停止${NC}"
|
||||
else
|
||||
kill -9 "$PID" 2>/dev/null || true
|
||||
echo -e "${GREEN}✅ 已强制停止${NC}"
|
||||
fi
|
||||
else
|
||||
echo -e "${YELLOW}ℹ️ $APP_NAME 未在运行${NC}"
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
# 重启服务
|
||||
cmd_restart() {
|
||||
cmd_stop "$@"
|
||||
sleep 1
|
||||
cmd_start "$@"
|
||||
}
|
||||
|
||||
# 查看状态
|
||||
cmd_status() {
|
||||
get_install_dir "$1"
|
||||
|
||||
local BIN_PATH="$INSTALL_DIR/bin/$APP_NAME"
|
||||
local CONFIG_PATH="$INSTALL_DIR/config/managerd.json"
|
||||
local LOG_DIR="$INSTALL_DIR/logs"
|
||||
|
||||
echo "========== 3588AdminBackend 状态 =========="
|
||||
echo ""
|
||||
echo "基本信息:"
|
||||
echo " 应用目录: $INSTALL_DIR"
|
||||
echo " 二进制文件: $BIN_PATH"
|
||||
echo " 配置文件: $CONFIG_PATH"
|
||||
echo " 日志目录: $LOG_DIR"
|
||||
|
||||
# 检查二进制文件
|
||||
if [ -f "$BIN_PATH" ]; then
|
||||
echo -e " 二进制状态: ${GREEN}✅ 存在${NC}"
|
||||
else
|
||||
echo -e " 二进制状态: ${RED}❌ 不存在${NC}"
|
||||
fi
|
||||
|
||||
# 检查配置文件
|
||||
if [ -f "$CONFIG_PATH" ]; then
|
||||
echo -e " 配置文件: ${GREEN}✅ 存在${NC}"
|
||||
if command -v python3 &> /dev/null; then
|
||||
local LISTEN=$(python3 -c "import json; print(json.load(open('$CONFIG_PATH')).get('listen', 'N/A'))" 2>/dev/null)
|
||||
local DISCOVERY_PORT=$(python3 -c "import json; print(json.load(open('$CONFIG_PATH')).get('discovery_port', 'N/A'))" 2>/dev/null)
|
||||
echo " 监听地址: $LISTEN"
|
||||
echo " 发现端口: $DISCOVERY_PORT (UDP)"
|
||||
fi
|
||||
else
|
||||
echo -e " 配置文件: ${RED}❌ 不存在${NC}"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "运行状态:"
|
||||
|
||||
# 检查进程
|
||||
if [ -f "$PID_FILE" ]; then
|
||||
local PID=$(cat "$PID_FILE")
|
||||
if ps -p "$PID" > /dev/null 2>&1; then
|
||||
echo -e " 进程状态: ${GREEN}🟢 运行中${NC}"
|
||||
echo " PID: $PID"
|
||||
|
||||
if command -v ps &> /dev/null; then
|
||||
echo ""
|
||||
echo "进程详情:"
|
||||
ps -p "$PID" -o pid,pcpu,pmem,cmd --no-headers 2>/dev/null | while read line; do
|
||||
echo " $line"
|
||||
done
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "网络监听:"
|
||||
if command -v ss &> /dev/null; then
|
||||
ss -tlnp 2>/dev/null | grep "$PID" | head -3 | while read line; do
|
||||
echo " $line"
|
||||
done
|
||||
elif command -v netstat &> /dev/null; then
|
||||
netstat -tlnp 2>/dev/null | grep "$PID/" | head -3 | while read line; do
|
||||
echo " $line"
|
||||
done
|
||||
fi
|
||||
|
||||
# API 测试
|
||||
if command -v curl &> /dev/null; then
|
||||
echo ""
|
||||
echo "API 测试:"
|
||||
local HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "http://127.0.0.1:18080/api/devices" 2>/dev/null || echo "000")
|
||||
if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "401" ]; then
|
||||
echo -e " ${GREEN}✅ HTTP API 响应正常 (HTTP $HTTP_CODE)${NC}"
|
||||
elif [ "$HTTP_CODE" = "000" ]; then
|
||||
echo -e " ${YELLOW}⚠️ 无法连接 HTTP API${NC}"
|
||||
else
|
||||
echo " ℹ️ HTTP API 响应: $HTTP_CODE"
|
||||
fi
|
||||
fi
|
||||
else
|
||||
echo -e " 进程状态: ${RED}🔴 未运行 (PID 文件存在但进程不存在)${NC}"
|
||||
fi
|
||||
else
|
||||
local PID=$(pgrep -f "^$BIN_PATH" | head -1)
|
||||
if [ -n "$PID" ]; then
|
||||
echo -e " 进程状态: ${YELLOW}🟡 运行中 (无 PID 文件，PID: $PID)${NC}"
|
||||
else
|
||||
echo -e " 进程状态: ${BLUE}⚫ 未运行${NC}"
|
||||
fi
|
||||
fi
|
||||
|
||||
# 日志信息
|
||||
echo ""
|
||||
echo "日志信息:"
|
||||
if [ -d "$LOG_DIR" ]; then
|
||||
local NEWEST_LOG=$(ls -t "$LOG_DIR"/*.log 2>/dev/null | head -1)
|
||||
if [ -n "$NEWEST_LOG" ]; then
|
||||
echo " 最新日志 ($NEWEST_LOG):"
|
||||
tail -n 3 "$NEWEST_LOG" | while read line; do
|
||||
echo " $line"
|
||||
done
|
||||
else
|
||||
echo " 无日志文件"
|
||||
fi
|
||||
else
|
||||
echo " 日志目录不存在"
|
||||
fi
|
||||
}
|
||||
|
||||
# 升级服务
|
||||
cmd_upgrade() {
|
||||
check_root
|
||||
get_install_dir "$1"
|
||||
|
||||
local SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
local BACKUP_DIR="/root/3588admin-backup-$(date +%Y%m%d%H%M%S)"
|
||||
|
||||
echo "========== 3588AdminBackend 升级 =========="
|
||||
echo "安装目录: $INSTALL_DIR"
|
||||
echo "备份目录: $BACKUP_DIR"
|
||||
echo ""
|
||||
|
||||
# 检查安装目录是否存在
|
||||
if [ ! -d "$INSTALL_DIR" ]; then
|
||||
echo -e "${RED}错误: 安装目录不存在: $INSTALL_DIR${NC}"
|
||||
echo "请先运行安装命令"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 确认
|
||||
read -p "确定要升级 3588AdminBackend? (y/N): " -n 1 -r
|
||||
echo
|
||||
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
||||
echo "升级已取消"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# 1. 停止服务
|
||||
echo "[1/5] 停止服务..."
|
||||
cmd_stop "$@" 2>/dev/null || true
|
||||
sleep 2
|
||||
|
||||
# 2. 备份
|
||||
echo "[2/5] 备份现有数据..."
|
||||
mkdir -p "$BACKUP_DIR"
|
||||
|
||||
if [ -f "$INSTALL_DIR/config/managerd.json" ]; then
|
||||
cp "$INSTALL_DIR/config/managerd.json" "$BACKUP_DIR/"
|
||||
echo " 已备份配置文件"
|
||||
fi
|
||||
|
||||
if [ -d "$INSTALL_DIR/logs" ]; then
|
||||
cp -r "$INSTALL_DIR/logs" "$BACKUP_DIR/"
|
||||
echo " 已备份日志文件"
|
||||
fi
|
||||
|
||||
if [ -f "$INSTALL_DIR/bin/managerd" ]; then
|
||||
cp "$INSTALL_DIR/bin/managerd" "$BACKUP_DIR/managerd.old"
|
||||
echo " 已备份旧版本二进制"
|
||||
fi
|
||||
|
||||
# 3. 更新二进制文件
|
||||
echo "[3/5] 更新二进制文件..."
|
||||
local BASE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
|
||||
if [ -f "$BASE_DIR/bin/managerd" ]; then
|
||||
cp "$BASE_DIR/bin/managerd" "$INSTALL_DIR/bin/managerd"
|
||||
chmod +x "$INSTALL_DIR/bin/managerd"
|
||||
echo -e " ${GREEN}已更新二进制文件${NC}"
|
||||
else
|
||||
echo -e "${YELLOW}警告: 未找到新的二进制文件${NC}"
|
||||
fi
|
||||
|
||||
# 4. 更新脚本
|
||||
echo "[4/5] 更新脚本..."
|
||||
cp "$SCRIPT_DIR/3588admin" "$INSTALL_DIR/scripts/"
|
||||
chmod +x "$INSTALL_DIR/scripts/3588admin"
|
||||
echo " 已更新管理脚本"
|
||||
|
||||
# 5. 启动服务
|
||||
echo "[5/5] 启动服务..."
|
||||
cmd_start "$@"
|
||||
|
||||
echo ""
|
||||
echo -e "${GREEN}========== 升级完成 ==========${NC}"
|
||||
echo "备份位置: $BACKUP_DIR"
|
||||
}
|
||||
|
||||
# 卸载服务
|
||||
cmd_uninstall() {
|
||||
check_root
|
||||
get_install_dir "$1"
|
||||
|
||||
echo "========== 3588AdminBackend 卸载 =========="
|
||||
echo "安装目录: $INSTALL_DIR"
|
||||
echo ""
|
||||
|
||||
# 确认
|
||||
read -p "确定要完全卸载 3588AdminBackend? 此操作不可恢复! (y/N): " -n 1 -r
|
||||
echo
|
||||
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
||||
echo "卸载已取消"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# 1. 停止服务
|
||||
echo "[1/4] 停止服务..."
|
||||
cmd_stop "$@" 2>/dev/null || true
|
||||
|
||||
# 停止 systemd 服务
|
||||
if systemctl is-active --quiet 3588admin 2>/dev/null; then
|
||||
systemctl stop 3588admin
|
||||
fi
|
||||
if systemctl is-enabled --quiet 3588admin 2>/dev/null; then
|
||||
systemctl disable 3588admin
|
||||
fi
|
||||
|
||||
# 2. 删除 systemd 服务文件
|
||||
echo "[2/4] 删除 Systemd 服务..."
|
||||
if [ -f "/etc/systemd/system/3588admin.service" ]; then
|
||||
rm -f "/etc/systemd/system/3588admin.service"
|
||||
systemctl daemon-reload
|
||||
echo " 已删除 systemd 服务"
|
||||
fi
|
||||
|
||||
# 3. 删除快捷方式
|
||||
echo "[3/4] 删除快捷方式..."
|
||||
rm -f /usr/local/bin/3588admin-start
|
||||
rm -f /usr/local/bin/3588admin-stop
|
||||
rm -f /usr/local/bin/3588admin-status
|
||||
rm -f /usr/local/bin/3588admin
|
||||
echo " 已删除命令快捷方式"
|
||||
|
||||
# 4. 备份并删除安装目录
|
||||
echo "[4/4] 删除安装文件..."
|
||||
local BACKUP_DIR=""
|
||||
if [ -d "$INSTALL_DIR" ]; then
|
||||
if [ -f "$INSTALL_DIR/config/managerd.json" ]; then
|
||||
BACKUP_DIR="/root/3588admin-backup-$(date +%Y%m%d%H%M%S)"
|
||||
mkdir -p "$BACKUP_DIR"
|
||||
cp "$INSTALL_DIR/config/managerd.json" "$BACKUP_DIR/"
|
||||
echo " 配置已备份到: $BACKUP_DIR/"
|
||||
fi
|
||||
|
||||
rm -rf "$INSTALL_DIR"
|
||||
echo " 已删除安装目录: $INSTALL_DIR"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo -e "${GREEN}========== 卸载完成 ==========${NC}"
|
||||
if [ -n "$BACKUP_DIR" ]; then
|
||||
echo "配置文件备份: $BACKUP_DIR/managerd.json"
|
||||
fi
|
||||
}
|
||||
|
||||
# 主函数
|
||||
main() {
|
||||
# 如果没有参数，显示帮助
|
||||
if [ $# -eq 0 ]; then
|
||||
cmd_help
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# 解析命令
|
||||
COMMAND="$1"
|
||||
shift
|
||||
|
||||
case "$COMMAND" in
|
||||
install)
|
||||
cmd_install "$@"
|
||||
;;
|
||||
status)
|
||||
cmd_status "$@"
|
||||
;;
|
||||
start)
|
||||
cmd_start "$@"
|
||||
;;
|
||||
stop)
|
||||
cmd_stop "$@"
|
||||
;;
|
||||
restart)
|
||||
cmd_restart "$@"
|
||||
;;
|
||||
upgrade)
|
||||
cmd_upgrade "$@"
|
||||
;;
|
||||
uninstall)
|
||||
cmd_uninstall "$@"
|
||||
;;
|
||||
check)
|
||||
cmd_check "$@"
|
||||
;;
|
||||
help|--help|-h)
|
||||
cmd_help
|
||||
;;
|
||||
*)
|
||||
# 兼容快捷方式调用
|
||||
# 如果是通过快捷方式调用，脚本名就是命令
|
||||
SCRIPT_NAME=$(basename "$0")
|
||||
case "$SCRIPT_NAME" in
|
||||
3588admin-start)
|
||||
cmd_start "$@"
|
||||
;;
|
||||
3588admin-stop)
|
||||
cmd_stop "$@"
|
||||
;;
|
||||
3588admin-status)
|
||||
cmd_status "$@"
|
||||
;;
|
||||
*)
|
||||
echo -e "${RED}错误: 未知命令 '$COMMAND'${NC}"
|
||||
echo ""
|
||||
cmd_help
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
main "$@"
|
||||
@ -0,0 +1,31 @@
|
||||
[Unit]
|
||||
Description=3588AdminBackend Service
|
||||
Documentation=https://github.com/your-org/3588AdminBackend
|
||||
After=network.target network-online.target
|
||||
Wants=network-online.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=root
|
||||
Group=root
|
||||
WorkingDirectory=/opt/3588admin
|
||||
ExecStart=/opt/3588admin/bin/managerd /opt/3588admin/config/managerd.json
|
||||
ExecReload=/bin/kill -HUP $MAINPID
|
||||
KillMode=process
|
||||
KillSignal=SIGTERM
|
||||
Restart=on-failure
|
||||
RestartSec=5
|
||||
StartLimitInterval=60s
|
||||
StartLimitBurst=3
|
||||
|
||||
# 资源限制（根据需要调整）
|
||||
# LimitNOFILE=65535
|
||||
# LimitNPROC=4096
|
||||
|
||||
# 安全设置
|
||||
NoNewPrivileges=false
|
||||
ProtectSystem=false
|
||||
ProtectHome=false
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
@ -0,0 +1,16 @@
|
||||
{
|
||||
"name": "test-template",
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"fps": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"body": {
|
||||
"global": {
|
||||
"fps": "{{fps}}"
|
||||
}
|
||||
}
|
||||
}
|
||||
430
docs/离线部署文档.md
430
docs/离线部署文档.md
@ -1,17 +1,17 @@
|
||||
# 3588AdminBackend 离线部署文档
|
||||
|
||||
> **目标环境**: Ubuntu 22.04.5 LTS (离线环境，无法连接互联网)
|
||||
> **部署方式**: 通过光盘/USB等介质拷贝安装包进行离线部署
|
||||
> **版本**: V2.0 (整合版)
|
||||
> **部署方式**: 在 Windows 上交叉编译，上传安装包到 Ubuntu 进行离线部署
|
||||
> **版本**: V2.1 (Windows 构建版)
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [部署概述](#1-部署概述)
|
||||
2. [准备环境（有网络）](#2-准备环境有网络)
|
||||
3. [打包步骤](#3-打包步骤)
|
||||
4. [离线安装（生产环境）](#4-离线安装生产环境)
|
||||
2. [准备环境（Windows）](#2-准备环境windows)
|
||||
3. [构建步骤（Windows）](#3-构建步骤windows)
|
||||
4. [离线安装（Ubuntu）](#4-离线安装ubuntu)
|
||||
5. [验证与启动](#5-验证与启动)
|
||||
6. [常见问题排查](#6-常见问题排查)
|
||||
|
||||
@ -32,241 +32,218 @@
|
||||
|
||||
| 组件 | 版本 | 说明 |
|
||||
|------|------|------|
|
||||
| Go | 1.23+ | **编译环境（仅构建机需要）** |
|
||||
| Go | 1.23+ | **编译环境（仅 Windows 构建机需要）** |
|
||||
| chi | v5.2.3 | Web 框架（已静态编译到二进制） |
|
||||
| cors | v1.2.2 | CORS 中间件（已静态编译到二进制） |
|
||||
| uuid | v1.6.0 | UUID 生成库（已静态编译到二进制） |
|
||||
|
||||
> **注意**: Go 编译生成的是**静态链接的二进制文件**，目标机器（生产环境）**不需要**安装 Go 运行时，只需要 Linux 内核即可运行。
|
||||
> **注意**: Go 编译生成的是**静态链接的二进制文件**，目标机器（Ubuntu 生产环境）**不需要**安装 Go 运行时，只需要 Linux 内核即可运行。
|
||||
|
||||
### 1.3 部署流程概览
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────────┐
|
||||
│ 联网机器（构建环境） │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
|
||||
│ │ 安装 Go 1.23 │ -> │ 编译二进制 │ -> │ 打包部署包 │ │
|
||||
│ │ 下载依赖 │ │ managerd │ │ (包含静态二进制文件) │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────────────┘ │
|
||||
│ Windows（构建环境） │
|
||||
│ ┌──────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 1. 安装 Go 1.23+ │ │
|
||||
│ │ 2. 运行 build-windows.ps1 │ │
|
||||
│ │ 3. 生成 3588AdminBackend-离线部署包-YYYYMMDD.tar.gz │ │
|
||||
│ └──────────────────────────────────────────────────────────────┘ │
|
||||
└──────────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼ (拷贝到光盘/USB)
|
||||
▼ (上传到 Ubuntu 服务器)
|
||||
┌──────────────────────────────────────────────────────────────────────┐
|
||||
│ 离线机器（生产环境） │
|
||||
│ Ubuntu（生产环境） │
|
||||
│ ┌──────────────────────────────────────────────────────────────┐ │
|
||||
│ │ 无需 Go 运行时！直接运行编译好的静态二进制文件 │ │
|
||||
│ │ - ./scripts/3588admin install │ │
|
||||
│ │ - ./scripts/3588admin start │ │
|
||||
│ │ - tar -xzf 3588AdminBackend-离线部署包-*.tar.gz │ │
|
||||
│ │ - sudo ./scripts/3588admin install │ │
|
||||
│ │ - sudo ./scripts/3588admin start │ │
|
||||
│ └──────────────────────────────────────────────────────────────┘ │
|
||||
└──────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 准备环境（有网络）
|
||||
|
||||
> **说明**: 此步骤需要在有网络连接的机器上执行，用于下载所有必要的依赖包和编译二进制文件。
|
||||
## 2. 准备环境（Windows）
|
||||
|
||||
### 2.1 系统要求
|
||||
|
||||
- **操作系统**: Ubuntu 22.04+ / Debian 12+ / CentOS 8+ (x86_64 或 ARM64)
|
||||
- **网络**: 可访问互联网
|
||||
- **磁盘空间**: 至少 2GB 可用空间
|
||||
- **操作系统**: Windows 10/11 或 Windows Server 2019+
|
||||
- **磁盘空间**: 至少 1GB 可用空间
|
||||
- **Go 版本**: 1.23.3 或更高
|
||||
- **网络**: 可访问互联网（下载 Go 依赖）
|
||||
|
||||
### 2.2 安装 Go 编译环境
|
||||
|
||||
```bash
|
||||
# 下载 Go 1.23.3 (根据你的架构选择)
|
||||
# 方式1: AMD64 架构
|
||||
wget https://go.dev/dl/go1.23.3.linux-amd64.tar.gz
|
||||
1. **下载 Go 安装包**
|
||||
- 访问 https://go.dev/dl/
|
||||
- 下载 `go1.23.3.windows-amd64.msi`
|
||||
|
||||
# 方式2: ARM64 架构 (如使用 ARM 服务器)
|
||||
wget https://go.dev/dl/go1.23.3.linux-arm64.tar.gz
|
||||
2. **安装 Go**
|
||||
- 双击 MSI 文件，按向导安装
|
||||
- 默认安装到 `C:\Program Files\Go\`
|
||||
- 安装程序会自动配置 PATH
|
||||
|
||||
# 解压到 /usr/local
|
||||
sudo tar -C /usr/local -xzf go1.23.3.linux-amd64.tar.gz
|
||||
3. **验证安装**
|
||||
```powershell
|
||||
# 打开 PowerShell 或 CMD
|
||||
go version
|
||||
# 输出: go version go1.23.3 windows/amd64
|
||||
```
|
||||
|
||||
# 配置环境变量
|
||||
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
|
||||
source ~/.bashrc
|
||||
### 2.3 准备项目源码
|
||||
|
||||
# 验证安装
|
||||
go version
|
||||
# 输出: go version go1.23.3 linux/amd64
|
||||
将项目源码复制到 Windows 机器上，例如：
|
||||
```
|
||||
C:\Users\YourName\3588AdminBackend\
|
||||
```
|
||||
|
||||
### 2.3 克隆/准备项目源码
|
||||
|
||||
```bash
|
||||
# 创建工作目录
|
||||
mkdir -p ~/3588admin-build
|
||||
cd ~/3588admin-build
|
||||
|
||||
# 如果有 Git 仓库，克隆代码
|
||||
git clone <你的仓库地址> 3588AdminBackend
|
||||
cd 3588AdminBackend
|
||||
|
||||
# 如果没有 Git，直接复制项目源码到此目录
|
||||
# cp -r /path/to/3588AdminBackend/* .
|
||||
目录结构应包含：
|
||||
```
|
||||
|
||||
### 2.4 下载 Go 模块依赖
|
||||
|
||||
```bash
|
||||
# 设置 GOPROXY 加速下载（可选，推荐）
|
||||
export GOPROXY=https://goproxy.cn,direct
|
||||
|
||||
# 下载所有依赖到本地
|
||||
cd ~/3588admin-build/3588AdminBackend
|
||||
go mod download
|
||||
|
||||
# 验证依赖完整性
|
||||
go mod verify
|
||||
```
|
||||
|
||||
### 2.5 编译项目
|
||||
|
||||
```bash
|
||||
# 进入项目目录
|
||||
cd ~/3588admin-build/3588AdminBackend
|
||||
|
||||
# 编译 Linux AMD64 版本（生产环境是 x86_64）
|
||||
GOOS=linux GOARCH=amd64 go build -o managerd-linux-amd64 ./cmd/managerd
|
||||
|
||||
# 如需 ARM64 版本（可选）
|
||||
# GOOS=linux GOARCH=arm64 go build -o managerd-linux-arm64 ./cmd/managerd
|
||||
|
||||
# 验证编译结果
|
||||
ls -lh managerd-linux-amd64
|
||||
file managerd-linux-amd64
|
||||
3588AdminBackend/
|
||||
├── cmd/
|
||||
│ └── managerd/
|
||||
├── internal/
|
||||
├── scripts/
|
||||
│ └── deploy/
|
||||
│ ├── 3588admin # 管理脚本
|
||||
│ ├── 3588admin.service # Systemd 服务
|
||||
│ └── build-windows.ps1 # Windows 构建脚本
|
||||
├── templates/
|
||||
├── go.mod
|
||||
└── go.sum
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 打包步骤
|
||||
## 3. 构建步骤（Windows）
|
||||
|
||||
### 3.1 使用构建脚本（推荐）
|
||||
### 3.1 运行构建脚本
|
||||
|
||||
```bash
|
||||
cd ~/3588admin-build/3588AdminBackend/scripts/deploy
|
||||
打开 PowerShell，进入项目目录：
|
||||
|
||||
```powershell
|
||||
# 进入项目目录
|
||||
cd C:\Users\YourName\3588AdminBackend\scripts\deploy
|
||||
|
||||
# 执行构建脚本
|
||||
./build-offline-package.sh
|
||||
.\build-windows.ps1
|
||||
```
|
||||
|
||||
构建完成后，会在 `build/` 目录下生成：
|
||||
- `3588AdminBackend-离线部署包-YYYYMMDD.tar.gz`
|
||||
- `3588AdminBackend-离线部署包-YYYYMMDD.tar.gz.sha256`
|
||||
|
||||
### 3.2 手动打包
|
||||
|
||||
如果需要手动打包，按照以下步骤：
|
||||
|
||||
```bash
|
||||
cd ~/3588admin-build
|
||||
mkdir -p 3588admin-deploy/{bin,config,scripts,docs}
|
||||
|
||||
# 1. 复制编译好的二进制文件
|
||||
cp 3588AdminBackend/managerd-linux-amd64 3588admin-deploy/bin/managerd
|
||||
|
||||
# 2. 复制配置文件
|
||||
cp 3588AdminBackend/managerd.json 3588admin-deploy/config/managerd.json.example
|
||||
|
||||
# 3. 复制模板文件（如果程序需要读取外部模板）
|
||||
cp -r 3588AdminBackend/templates 3588admin-deploy/ 2>/dev/null || echo "无外部模板目录"
|
||||
|
||||
# 4. 复制文档
|
||||
cp 3588AdminBackend/Readme.md 3588admin-deploy/docs/
|
||||
cp 3588AdminBackend/docs/*.md 3588admin-deploy/docs/ 2>/dev/null || true
|
||||
|
||||
# 5. 复制管理脚本
|
||||
cp 3588AdminBackend/scripts/deploy/3588admin 3588admin-deploy/scripts/
|
||||
chmod +x 3588admin-deploy/scripts/3588admin
|
||||
|
||||
# 6. 复制 Systemd 服务文件
|
||||
cp 3588AdminBackend/scripts/deploy/3588admin.service 3588admin-deploy/scripts/
|
||||
|
||||
# 7. 创建版本信息
|
||||
cat > 3588admin-deploy/VERSION << EOF
|
||||
3588AdminBackend 离线部署包
|
||||
版本: 1.0.0
|
||||
构建时间: $(date '+%Y-%m-%d %H:%M:%S')
|
||||
目标系统: Ubuntu 22.04.5 LTS x86_64
|
||||
EOF
|
||||
|
||||
# 8. 打包
|
||||
tar -czf 3588AdminBackend-离线部署包-$(date +%Y%m%d).tar.gz 3588admin-deploy/
|
||||
或一行命令：
|
||||
```powershell
|
||||
& "C:<Users>YourName<3588AdminBackend<scripts>deploy<build-windows.ps1"
|
||||
```
|
||||
|
||||
### 3.3 最终包结构
|
||||
### 3.2 构建输出
|
||||
|
||||
构建完成后，会在 `build\` 目录下生成：
|
||||
```
|
||||
3588admin-deploy/
|
||||
├── bin/
|
||||
│ └── managerd # 主程序二进制文件
|
||||
├── config/
|
||||
│ └── managerd.json.example # 配置文件示例
|
||||
├── scripts/
|
||||
│ ├── 3588admin # ⭐ 统一管理脚本（整合版）
|
||||
│ └── 3588admin.service # Systemd 服务文件
|
||||
├── docs/ # 文档
|
||||
│ ├── Readme.md
|
||||
│ └── 离线部署文档.md
|
||||
├── templates/ # 模板文件（如需要）
|
||||
└── VERSION # 版本信息
|
||||
3588AdminBackend-离线部署包-YYYYMMDD.tar.gz
|
||||
```
|
||||
|
||||
构建输出示例：
|
||||
```
|
||||
========== 3588AdminBackend Windows 构建 ==========
|
||||
项目目录: C:<Users>YourName<3588AdminBackend
|
||||
构建目录: C:<Users>YourName<3588AdminBackend<build
|
||||
Go 版本: go version go1.23.3 windows/amd64
|
||||
|
||||
[1/6] 清理旧构建...
|
||||
[2/6] 创建目录结构...
|
||||
[3/6] 交叉编译 Linux AMD64 版本...
|
||||
编译成功
|
||||
[4/6] 复制配置文件...
|
||||
[5/6] 复制部署脚本...
|
||||
[6/6] 复制文档...
|
||||
|
||||
打包...
|
||||
|
||||
========== 构建完成 ==========
|
||||
|
||||
输出文件:
|
||||
3588AdminBackend-离线部署包-20260225.tar.gz (12.34 MB)
|
||||
|
||||
部署包位置: C:<Users>YourName<3588AdminBackend<build<3588AdminBackend-离线部署包-20260225.tar.gz
|
||||
|
||||
使用说明:
|
||||
1. 将 3588AdminBackend-离线部署包-20260225.tar.gz 上传到 Ubuntu 服务器
|
||||
2. 解压并运行: sudo ./scripts/3588admin install
|
||||
```
|
||||
|
||||
### 3.3 手动打包（如不使用脚本）
|
||||
|
||||
如果 PowerShell 脚本执行失败，可以手动操作：
|
||||
|
||||
```powershell
|
||||
# 1. 进入项目目录
|
||||
cd C:<Users>YourName<3588AdminBackend
|
||||
|
||||
# 2. 交叉编译 Linux 版本
|
||||
$env:GOOS = "linux"
|
||||
$env:GOARCH = "amd64"
|
||||
go build -ldflags="-s -w" -o managerd-linux-amd64 .\cmd\managerd
|
||||
|
||||
# 3. 创建部署目录
|
||||
mkdir build<3588admin-deploy<bin
|
||||
mkdir build<3588admin-deploy<config
|
||||
mkdir build<3588admin-deploy<scripts
|
||||
|
||||
# 4. 复制文件
|
||||
copy managerd-linux-amd64 build<3588admin-deploy<bin<managerd
|
||||
copy scripts>deploy<3588admin build<3588admin-deploy<scripts<
|
||||
copy scripts>deploy<3588admin.service build<3588admin-deploy<scripts<
|
||||
copy managerd.json build<3588admin-deploy<config<managerd.json.example
|
||||
|
||||
# 5. 打包
|
||||
cd build
|
||||
tar -czf 3588AdminBackend-离线部署包-$(Get-Date -Format 'yyyyMMdd').tar.gz 3588admin-deploy<
|
||||
```
|
||||
|
||||
### 3.4 上传到 Ubuntu 服务器
|
||||
|
||||
使用 SCP、FTP 或任何文件传输工具将部署包上传到 Ubuntu：
|
||||
|
||||
```powershell
|
||||
# 使用 scp（如果 Windows 有 OpenSSH）
|
||||
scp .\build<3588AdminBackend-离线部署包-*.tar.gz user@ubuntu-server:/tmp/
|
||||
|
||||
# 或使用 WinSCP、FileZilla 等图形化工具
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 离线安装（生产环境）
|
||||
## 4. 离线安装（Ubuntu）
|
||||
|
||||
> **环境**: Ubuntu 22.04.5 LTS，无网络连接
|
||||
|
||||
### 4.1 准备介质
|
||||
|
||||
将打包好的文件拷贝到光盘/USB，然后挂载到生产环境：
|
||||
### 4.1 解压部署包
|
||||
|
||||
```bash
|
||||
# 插入光盘后挂载（通常会自动挂载）
|
||||
# 或者手动挂载光盘
|
||||
sudo mkdir -p /mnt/cdrom
|
||||
sudo mount /dev/cdrom /mnt/cdrom
|
||||
|
||||
# 或者挂载 USB
|
||||
# sudo mount /dev/sdb1 /mnt/usb
|
||||
|
||||
# 查看内容
|
||||
ls /mnt/cdrom/
|
||||
```
|
||||
|
||||
### 4.2 解压部署包
|
||||
|
||||
```bash
|
||||
# 创建临时目录
|
||||
mkdir -p ~/3588admin-install
|
||||
cd ~/3588admin-install
|
||||
|
||||
# 从光盘复制部署包
|
||||
cp /mnt/cdrom/3588AdminBackend-离线部署包-*.tar.gz .
|
||||
# 进入上传目录
|
||||
cd /tmp
|
||||
|
||||
# 解压
|
||||
tar -xzf 3588AdminBackend-离线部署包-*.tar.gz
|
||||
|
||||
# 进入部署目录
|
||||
cd 3588admin-deploy
|
||||
cd 3588AdminBackend-离线部署包-*/
|
||||
|
||||
# 查看内容
|
||||
ls -la
|
||||
```
|
||||
|
||||
### 4.3 执行安装
|
||||
### 4.2 执行安装
|
||||
|
||||
```bash
|
||||
# 检查环境（推荐）
|
||||
# 检查环境（可选但推荐）
|
||||
sudo ./scripts/3588admin check
|
||||
|
||||
# 使用安装脚本（推荐）
|
||||
sudo ./scripts/3588admin install /opt/3588admin
|
||||
# 执行安装
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
# 或者指定自定义安装路径
|
||||
# 或指定自定义安装目录
|
||||
# sudo ./scripts/3588admin install /usr/local/3588admin
|
||||
```
|
||||
|
||||
@ -279,31 +256,7 @@ sudo ./scripts/3588admin install /opt/3588admin
|
||||
- 创建命令快捷方式（`3588admin-start`, `3588admin-stop`, `3588admin-status`）
|
||||
- 安装 Systemd 服务（可选）
|
||||
|
||||
### 4.4 手动安装（如不使用管理脚本）
|
||||
|
||||
```bash
|
||||
# 1. 创建安装目录
|
||||
sudo mkdir -p /opt/3588admin
|
||||
|
||||
# 2. 复制文件
|
||||
sudo cp -r ~/3588admin-install/3588admin-deploy/* /opt/3588admin/
|
||||
|
||||
# 3. 设置权限
|
||||
sudo chmod +x /opt/3588admin/bin/managerd
|
||||
sudo chmod +x /opt/3588admin/scripts/3588admin
|
||||
sudo mkdir -p /opt/3588admin/logs
|
||||
|
||||
# 4. 创建配置文件
|
||||
sudo cp /opt/3588admin/config/managerd.json.example /opt/3588admin/config/managerd.json
|
||||
|
||||
# 5. 创建快捷方式（可选）
|
||||
sudo ln -sf /opt/3588admin/scripts/3588admin /usr/local/bin/3588admin-start
|
||||
sudo ln -sf /opt/3588admin/scripts/3588admin /usr/local/bin/3588admin-stop
|
||||
sudo ln -sf /opt/3588admin/scripts/3588admin /usr/local/bin/3588admin-status
|
||||
sudo ln -sf /opt/3588admin/scripts/3588admin /usr/local/bin/3588admin
|
||||
```
|
||||
|
||||
### 4.5 配置 Systemd 服务（可选但推荐）
|
||||
### 4.3 配置 Systemd 服务（可选但推荐）
|
||||
|
||||
```bash
|
||||
# 复制服务文件
|
||||
@ -337,7 +290,7 @@ sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
```json
|
||||
{
|
||||
"listen": "127.0.0.1:18080", // HTTP API 监听地址
|
||||
"listen": "0.0.0.0:18080", // HTTP API 监听地址（0.0.0.0 允许外部访问）
|
||||
"discovery_port": 35688, // UDP 发现端口
|
||||
"discovery_timeout_ms": 1200, // 发现超时时间
|
||||
"offline_after_ms": 10000, // 设备离线判定时间
|
||||
@ -389,12 +342,6 @@ sudo systemctl start 3588admin
|
||||
sudo systemctl status 3588admin
|
||||
```
|
||||
|
||||
**方式4: 直接运行**
|
||||
|
||||
```bash
|
||||
sudo /opt/3588admin/bin/managerd -config /opt/3588admin/config/managerd.json
|
||||
```
|
||||
|
||||
### 5.3 验证服务
|
||||
|
||||
```bash
|
||||
@ -430,7 +377,25 @@ sudo ufw reload
|
||||
|
||||
## 6. 常见问题排查
|
||||
|
||||
### 6.1 启动失败
|
||||
### 6.1 Windows 构建失败
|
||||
|
||||
**问题**: 执行 `build-windows.ps1` 提示权限不足
|
||||
|
||||
**解决**:
|
||||
```powershell
|
||||
# 以管理员身份运行 PowerShell
|
||||
# 右键点击 PowerShell -> 以管理员身份运行
|
||||
|
||||
# 或修改执行策略（临时）
|
||||
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
|
||||
.\build-windows.ps1
|
||||
```
|
||||
|
||||
**问题**: `tar` 命令不存在
|
||||
|
||||
**解决**: Windows 10/11 内置 tar，如果找不到，使用 7-Zip 或其他工具手动打包。
|
||||
|
||||
### 6.2 Ubuntu 上启动失败
|
||||
|
||||
**问题**: 执行 start 命令提示启动失败
|
||||
|
||||
@ -448,7 +413,7 @@ file /opt/3588admin/bin/managerd
|
||||
python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
```
|
||||
|
||||
### 6.2 端口被占用
|
||||
### 6.3 端口被占用
|
||||
|
||||
**问题**: 提示端口 18080 已被占用
|
||||
|
||||
@ -465,7 +430,7 @@ sudo nano /opt/3588admin/config/managerd.json
|
||||
# 修改 "listen" 为 "127.0.0.1:18081" 或其他端口
|
||||
```
|
||||
|
||||
### 6.3 无法发现设备
|
||||
### 6.4 无法发现设备
|
||||
|
||||
**问题**: 设备发现功能不工作
|
||||
|
||||
@ -484,7 +449,7 @@ sudo ufw status | grep 35688
|
||||
# 检查设备端是否配置了正确的发现端口和 token
|
||||
```
|
||||
|
||||
### 6.4 权限问题
|
||||
### 6.5 权限问题
|
||||
|
||||
**问题**: 提示 Permission denied
|
||||
|
||||
@ -499,24 +464,6 @@ sudo chmod +x /opt/3588admin/scripts/3588admin
|
||||
sudo 3588admin start
|
||||
```
|
||||
|
||||
### 6.5 配置文件错误
|
||||
|
||||
**问题**: 提示配置文件解析失败
|
||||
|
||||
**排查**:
|
||||
|
||||
```bash
|
||||
# 验证 JSON 格式
|
||||
python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
|
||||
# 检查是否有注释（JSON 不支持注释）
|
||||
# 如有注释需要删除
|
||||
|
||||
# 从示例重新创建
|
||||
cp /opt/3588admin/config/managerd.json.example /opt/3588admin/config/managerd.json.new
|
||||
# 然后手动迁移配置
|
||||
```
|
||||
|
||||
### 6.6 日志查看
|
||||
|
||||
```bash
|
||||
@ -536,12 +483,32 @@ grep -i error /opt/3588admin/logs/managerd.log
|
||||
|
||||
### A. 目录结构参考
|
||||
|
||||
安装完成后的目录结构：
|
||||
**Windows 构建机**：
|
||||
```
|
||||
C:<Users>YourName<3588AdminBackend<
|
||||
├── build< # 构建输出
|
||||
│ └── 3588AdminBackend-离线部署包-20260225<
|
||||
│ ├── bin<
|
||||
│ │ └── managerd # Linux 静态二进制文件
|
||||
│ ├── config<
|
||||
│ ├── scripts<
|
||||
│ │ └── 3588admin # 管理脚本
|
||||
│ ├── docs<
|
||||
│ └── README-离线安装.txt
|
||||
├── scripts>deploy<
|
||||
│ ├── 3588admin
|
||||
│ ├── 3588admin.service
|
||||
│ └── build-windows.ps1 # Windows 构建脚本
|
||||
├── cmd<
|
||||
├── internal<
|
||||
└── go.mod
|
||||
```
|
||||
|
||||
**Ubuntu 生产环境**：
|
||||
```
|
||||
/opt/3588admin/
|
||||
├── bin/
|
||||
│ └── managerd # 主程序
|
||||
│ └── managerd # 主程序（Windows 交叉编译生成）
|
||||
├── config/
|
||||
│ └── managerd.json # 配置文件
|
||||
├── logs/
|
||||
@ -590,10 +557,13 @@ sudo systemctl stop 3588admin
|
||||
# 2. 备份配置
|
||||
cp /opt/3588admin/config/managerd.json ~/managerd.json.bak
|
||||
|
||||
# 3. 执行升级（在新的部署包中）
|
||||
# 3. 在 Windows 上重新构建新版本
|
||||
# 运行 build-windows.ps1
|
||||
|
||||
# 4. 上传到 Ubuntu 并执行升级
|
||||
sudo ./scripts/3588admin upgrade
|
||||
|
||||
# 4. 验证升级
|
||||
# 5. 验证升级
|
||||
sudo 3588admin status
|
||||
```
|
||||
|
||||
@ -617,6 +587,6 @@ echo "卸载完成"
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 2.0 (整合版)
|
||||
**文档版本**: 2.1 (Windows 构建版)
|
||||
**最后更新**: 2026-02-25
|
||||
**适用版本**: 3588AdminBackend V1.0+
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
{
|
||||
"listen": "127.0.0.1:18080",
|
||||
"listen": "0.0.0.0:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
|
||||
@ -296,15 +296,21 @@ cmd_install() {
|
||||
# 3. 设置权限
|
||||
echo "[3/5] 设置权限..."
|
||||
chmod +x "$INSTALL_DIR/bin/managerd"
|
||||
mkdir -p "$INSTALL_DIR/logs"
|
||||
chmod 755 "$INSTALL_DIR/logs"
|
||||
mkdir -p "$INSTALL_DIR/logs" || {
|
||||
echo -e "${RED}错误: 无法创建日志目录 $INSTALL_DIR/logs${NC}"
|
||||
exit 1
|
||||
}
|
||||
chmod 755 "$INSTALL_DIR/logs" || {
|
||||
echo -e "${RED}错误: 无法设置日志目录权限${NC}"
|
||||
exit 1
|
||||
}
|
||||
|
||||
# 4. 初始化配置文件
|
||||
echo "[4/5] 初始化配置文件..."
|
||||
if [ ! -f "$INSTALL_DIR/config/managerd.json" ]; then
|
||||
cat > "$INSTALL_DIR/config/managerd.json" << 'EOF'
|
||||
{
|
||||
"listen": "127.0.0.1:18080",
|
||||
"listen": "0.0.0.0:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
@ -354,8 +360,12 @@ EOF
|
||||
echo -e "${YELLOW}重要提示:${NC}"
|
||||
echo " 1. 请先编辑配置文件: $INSTALL_DIR/config/managerd.json"
|
||||
echo " 2. 务必修改 agent_token 为安全的随机字符串"
|
||||
echo " 3. 如需监听外部地址，修改 listen 配置项"
|
||||
echo " 4. 确保防火墙开放 discovery_port (默认 35688/UDP)"
|
||||
echo ""
|
||||
echo -e "${YELLOW}防火墙配置:${NC}"
|
||||
echo " 默认监听 0.0.0.0:18080，如需外部访问，请开放防火墙端口:"
|
||||
echo " sudo ufw allow 18080/tcp # HTTP API 端口"
|
||||
echo " sudo ufw allow 35688/udp # UDP 设备发现端口"
|
||||
echo " sudo ufw reload"
|
||||
}
|
||||
|
||||
# 启动服务
|
||||
@ -392,7 +402,20 @@ cmd_start() {
|
||||
fi
|
||||
|
||||
# 创建日志目录
|
||||
mkdir -p "$LOG_DIR"
|
||||
if [ ! -d "$LOG_DIR" ]; then
|
||||
mkdir -p "$LOG_DIR" 2>/dev/null || {
|
||||
echo -e "${RED}错误: 无法创建日志目录: $LOG_DIR${NC}"
|
||||
echo "请检查权限或手动创建: sudo mkdir -p $LOG_DIR"
|
||||
exit 1
|
||||
}
|
||||
fi
|
||||
|
||||
# 检查日志目录是否可写
|
||||
if [ ! -w "$LOG_DIR" ]; then
|
||||
echo -e "${RED}错误: 日志目录不可写: $LOG_DIR${NC}"
|
||||
echo "请修复权限: sudo chmod 755 $LOG_DIR"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 检查是否已在运行
|
||||
if [ -f "$PID_FILE" ]; then
|
||||
@ -407,7 +430,7 @@ cmd_start() {
|
||||
|
||||
# 启动服务
|
||||
echo "正在启动 $APP_NAME..."
|
||||
nohup "$BIN_PATH" -config "$CONFIG_PATH" >> "$LOG_DIR/$APP_NAME.log" 2>&1 &
|
||||
nohup "$BIN_PATH" "$CONFIG_PATH" >> "$LOG_DIR/$APP_NAME.log" 2>&1 &
|
||||
local PID=$!
|
||||
echo $PID > "$PID_FILE"
|
||||
|
||||
@ -423,6 +446,19 @@ cmd_start() {
|
||||
else
|
||||
echo ""
|
||||
echo -e "${RED}❌ 启动失败${NC}"
|
||||
echo ""
|
||||
echo "可能的错误原因:"
|
||||
echo " 1. 端口 18080 被占用"
|
||||
echo " 2. 配置文件格式错误"
|
||||
echo " 3. 权限不足"
|
||||
echo ""
|
||||
echo "尝试直接运行查看详细错误:"
|
||||
echo " sudo $BIN_PATH $CONFIG_PATH"
|
||||
echo ""
|
||||
echo "或检查日志:"
|
||||
if [ -f "$LOG_DIR/$APP_NAME.log" ]; then
|
||||
echo " tail -20 $LOG_DIR/$APP_NAME.log"
|
||||
fi
|
||||
rm -f "$PID_FILE"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
@ -9,7 +9,7 @@ Type=simple
|
||||
User=root
|
||||
Group=root
|
||||
WorkingDirectory=/opt/3588admin
|
||||
ExecStart=/opt/3588admin/bin/managerd -config /opt/3588admin/config/managerd.json
|
||||
ExecStart=/opt/3588admin/bin/managerd /opt/3588admin/config/managerd.json
|
||||
ExecReload=/bin/kill -HUP $MAINPID
|
||||
KillMode=process
|
||||
KillSignal=SIGTERM
|
||||
|
||||
@ -1,541 +0,0 @@
|
||||
# 3588AdminBackend 部署脚本使用说明
|
||||
|
||||
> 本目录包含 3588AdminBackend 的统一管理脚本，支持离线环境下的安装、升级、卸载和日常运维。
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [快速开始](#快速开始)
|
||||
2. [脚本清单](#脚本清单)
|
||||
3. [详细使用指南](#详细使用指南)
|
||||
4. [典型使用场景](#典型使用场景)
|
||||
5. [常见问题](#常见问题)
|
||||
|
||||
---
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 第一次部署（离线环境）
|
||||
|
||||
```bash
|
||||
# 1. 挂载光盘/USB 后进入目录
|
||||
cd /mnt/cdrom/3588admin-deploy
|
||||
|
||||
# 2. 检查环境
|
||||
sudo ./scripts/3588admin check
|
||||
|
||||
# 3. 执行安装
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
# 4. 修改配置
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
# 5. 启动服务
|
||||
sudo 3588admin start
|
||||
|
||||
# 6. 查看状态
|
||||
sudo 3588admin status
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 脚本清单
|
||||
|
||||
| 脚本 | 用途 | 执行位置 |
|
||||
|------|------|----------|
|
||||
| `3588admin` | **统一管理脚本**（安装/状态/升级/卸载/启动/停止） | 目标机器 |
|
||||
| `build-offline-package.sh` | 构建离线部署包 | 联网机器 |
|
||||
| `3588admin.service` | Systemd 服务文件 | 安装时复制 |
|
||||
|
||||
---
|
||||
|
||||
## 详细使用指南
|
||||
|
||||
### 3588admin 管理脚本
|
||||
|
||||
**3588admin** 是统一的管理脚本，整合了过去分散的多个脚本功能。
|
||||
|
||||
#### 命令概览
|
||||
|
||||
```bash
|
||||
3588admin <命令> [选项]
|
||||
```
|
||||
|
||||
| 命令 | 说明 | 示例 |
|
||||
|------|------|------|
|
||||
| `install [目录]` | 安装服务 | `sudo 3588admin install` |
|
||||
| `status` | 查看服务状态 | `sudo 3588admin status` |
|
||||
| `start` | 启动服务 | `sudo 3588admin start` |
|
||||
| `stop` | 停止服务 | `sudo 3588admin stop` |
|
||||
| `restart` | 重启服务 | `sudo 3588admin restart` |
|
||||
| `upgrade [目录]` | 升级服务（保留配置） | `sudo 3588admin upgrade` |
|
||||
| `uninstall [目录]` | 卸载服务（自动备份配置） | `sudo 3588admin uninstall` |
|
||||
| `check` | 检查环境是否满足要求 | `sudo 3588admin check` |
|
||||
| `help` | 显示帮助信息 | `3588admin help` |
|
||||
|
||||
#### install - 安装服务
|
||||
|
||||
**语法**:
|
||||
```bash
|
||||
sudo 3588admin install [安装目录]
|
||||
```
|
||||
|
||||
**参数**:
|
||||
- `安装目录`: 可选，默认为 `/opt/3588admin`
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 默认安装到 /opt/3588admin
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
# 自定义安装目录
|
||||
sudo ./scripts/3588admin install /usr/local/3588admin
|
||||
```
|
||||
|
||||
**安装流程**:
|
||||
1. 检查 root 权限
|
||||
2. 安装依赖包（如有）
|
||||
3. 创建安装目录
|
||||
4. 复制二进制文件、配置、脚本
|
||||
5. 设置执行权限
|
||||
6. 创建命令快捷方式（`3588admin-start` 等）
|
||||
7. 安装 Systemd 服务（可选）
|
||||
|
||||
**安装后操作**:
|
||||
```bash
|
||||
# 编辑配置文件
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
# 特别注意修改:
|
||||
# - agent_token: 改为安全的随机字符串
|
||||
# - listen: 如需外部访问改为 "0.0.0.0:18080"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### status - 查看状态
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 方式1: 使用快捷命令（推荐）
|
||||
sudo 3588admin-status
|
||||
|
||||
# 方式2: 直接执行
|
||||
sudo 3588admin status
|
||||
```
|
||||
|
||||
**显示内容**:
|
||||
- 基本信息（目录、配置文件路径）
|
||||
- 二进制文件状态
|
||||
- 配置文件内容和监听地址
|
||||
- 进程状态（运行/停止）
|
||||
- CPU/内存使用情况
|
||||
- 网络端口监听状态
|
||||
- HTTP API 连通性测试
|
||||
- 最新日志
|
||||
|
||||
---
|
||||
|
||||
#### start - 启动服务
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 方式1: 使用快捷命令（推荐）
|
||||
sudo 3588admin-start
|
||||
|
||||
# 方式2: 直接执行
|
||||
sudo 3588admin start
|
||||
```
|
||||
|
||||
**功能**:
|
||||
- 检查配置文件是否存在且格式正确
|
||||
- 检查服务是否已在运行
|
||||
- 后台启动服务并记录 PID
|
||||
- 显示启动结果
|
||||
|
||||
---
|
||||
|
||||
#### stop - 停止服务
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 方式1: 使用快捷命令（推荐）
|
||||
sudo 3588admin-stop
|
||||
|
||||
# 方式2: 直接执行
|
||||
sudo 3588admin stop
|
||||
```
|
||||
|
||||
**功能**:
|
||||
- 优雅停止（发送 SIGTERM，等待最多 10 秒）
|
||||
- 强制结束（如优雅停止失败）
|
||||
- 清理 PID 文件
|
||||
|
||||
---
|
||||
|
||||
#### restart - 重启服务
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
sudo 3588admin restart
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### upgrade - 升级服务
|
||||
|
||||
**用途**: 升级到新版本（保留配置）
|
||||
|
||||
**语法**:
|
||||
```bash
|
||||
sudo 3588admin upgrade [安装目录]
|
||||
```
|
||||
|
||||
**参数**:
|
||||
- `安装目录`: 可选，默认为 `/opt/3588admin`
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 升级流程
|
||||
# 1. 停止服务
|
||||
# 2. 备份现有数据和配置
|
||||
# 3. 更新二进制文件
|
||||
# 4. 更新脚本
|
||||
# 5. 启动服务
|
||||
|
||||
sudo ./scripts/3588admin upgrade
|
||||
```
|
||||
|
||||
**升级前准备**:
|
||||
1. 在新的部署包中确认 `bin/managerd` 是新版本
|
||||
2. 执行升级命令
|
||||
|
||||
**回滚方法**:
|
||||
```bash
|
||||
# 如升级后有问题，快速回滚
|
||||
sudo 3588admin stop
|
||||
sudo cp /root/3588admin-backup-xxx/managerd.old /opt/3588admin/bin/managerd
|
||||
sudo 3588admin start
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### uninstall - 卸载服务
|
||||
|
||||
**用途**: 完全卸载 3588AdminBackend
|
||||
|
||||
**语法**:
|
||||
```bash
|
||||
sudo 3588admin uninstall [安装目录]
|
||||
```
|
||||
|
||||
**参数**:
|
||||
- `安装目录`: 可选，默认为 `/opt/3588admin`
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 默认卸载
|
||||
sudo ./scripts/3588admin uninstall
|
||||
|
||||
# 卸载自定义目录
|
||||
sudo ./scripts/3588admin uninstall /usr/local/3588admin
|
||||
```
|
||||
|
||||
**卸载内容**:
|
||||
- 停止服务
|
||||
- 删除 Systemd 服务
|
||||
- 删除命令快捷方式
|
||||
- 删除安装目录（会自动备份配置）
|
||||
|
||||
**注意**: 卸载前会自动备份 `managerd.json` 到 `/root/3588admin-backup-YYYYMMDDhhmmss/`
|
||||
|
||||
---
|
||||
|
||||
#### check - 环境检查
|
||||
|
||||
**用途**: 检查目标系统是否满足运行要求
|
||||
|
||||
**执行环境**: 目标 Ubuntu 22.04 服务器
|
||||
|
||||
**检查项**:
|
||||
- 操作系统版本
|
||||
- CPU 架构
|
||||
- 端口占用情况（18080/TCP, 35688/UDP）
|
||||
- 防火墙配置
|
||||
- 磁盘空间
|
||||
- 必要工具
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 安装前检查
|
||||
sudo ./scripts/3588admin check
|
||||
```
|
||||
|
||||
**输出示例**:
|
||||
```
|
||||
========== 3588AdminBackend 环境检查 ==========
|
||||
|
||||
[系统信息]
|
||||
主机名: server01
|
||||
操作系统: Ubuntu 22.04.5 LTS
|
||||
✓ Ubuntu 22.04 detected
|
||||
|
||||
[硬件信息]
|
||||
架构: x86_64
|
||||
✓ x86_64 架构
|
||||
CPU: 4 核
|
||||
内存: 7.7Gi
|
||||
|
||||
[端口检查]
|
||||
✓ 端口 18080 可用
|
||||
✓ 端口 35688 可用
|
||||
|
||||
...
|
||||
|
||||
========== 检查总结 ==========
|
||||
通过: 12 警告: 0 失败: 0
|
||||
✓ 环境检查全部通过，可以安装
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### build-offline-package.sh
|
||||
|
||||
**用途**: 在联网机器上构建完整的离线部署包
|
||||
|
||||
**执行环境**: 有网络的 Linux 机器（Ubuntu/Debian/CentOS）
|
||||
|
||||
**前置条件**:
|
||||
- Go 1.23+ 已安装
|
||||
- 项目源码完整
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 在项目目录下执行
|
||||
cd scripts/deploy
|
||||
./build-offline-package.sh
|
||||
|
||||
# 输出位置: build/3588AdminBackend-离线部署包-YYYYMMDD.tar.gz
|
||||
```
|
||||
|
||||
**输出内容**:
|
||||
```
|
||||
build/3588AdminBackend-离线部署包-20260225/
|
||||
├── bin/managerd # 编译好的二进制
|
||||
├── config/ # 配置文件
|
||||
├── scripts/ # 部署脚本
|
||||
│ ├── 3588admin # 统一管理脚本 ⭐
|
||||
│ └── 3588admin.service # Systemd 服务文件
|
||||
├── systemd/ # 服务文件
|
||||
├── docs/ # 文档
|
||||
├── VERSION # 版本信息
|
||||
└── README-离线安装.txt # 快速安装指南
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3588admin.service
|
||||
|
||||
**用途**: Systemd 服务配置文件
|
||||
|
||||
**使用方法**:
|
||||
```bash
|
||||
# 通常由 install 命令自动安装
|
||||
# 如需手动安装:
|
||||
sudo cp scripts/3588admin.service /etc/systemd/system/
|
||||
sudo systemctl daemon-reload
|
||||
|
||||
# 管理服务
|
||||
sudo systemctl start 3588admin # 启动
|
||||
sudo systemctl stop 3588admin # 停止
|
||||
sudo systemctl restart 3588admin # 重启
|
||||
sudo systemctl status 3588admin # 查看状态
|
||||
sudo systemctl enable 3588admin # 开机自启
|
||||
sudo systemctl disable 3588admin # 禁用自启
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 典型使用场景
|
||||
|
||||
### 场景1: 首次部署
|
||||
|
||||
> **说明**: 以下流程在联网机器上构建部署包，然后拷贝到离线生产环境安装。目标机器**不需要** Go 运行时。
|
||||
|
||||
```bash
|
||||
# ========== 在联网机器上（构建环境）==========
|
||||
cd 3588AdminBackend/scripts/deploy
|
||||
|
||||
# 构建离线部署包（包含编译好的静态二进制文件）
|
||||
./build-offline-package.sh
|
||||
|
||||
# 输出: build/3588AdminBackend-离线部署包-YYYYMMDD.tar.gz
|
||||
|
||||
# 复制到光盘/USB/ISO，然后挂载到生产服务器
|
||||
|
||||
# ========== 在生产服务器上（离线环境）==========
|
||||
# 解压部署包
|
||||
tar -xzf 3588AdminBackend-离线部署包-*.tar.gz
|
||||
cd 3588AdminBackend-离线部署包-*/
|
||||
|
||||
# 检查环境（无需 Go 运行时）
|
||||
sudo ./scripts/3588admin check
|
||||
|
||||
# 安装（无需 Go 运行时）
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
# 修改配置
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
# 启动服务
|
||||
sudo 3588admin start
|
||||
sudo 3588admin status
|
||||
```
|
||||
|
||||
### 场景2: 日常运维
|
||||
|
||||
```bash
|
||||
# 查看状态
|
||||
sudo 3588admin status
|
||||
|
||||
# 查看日志
|
||||
tail -f /opt/3588admin/logs/managerd.log
|
||||
|
||||
# 重启服务
|
||||
sudo 3588admin restart
|
||||
|
||||
# 或者使用 systemctl
|
||||
sudo systemctl restart 3588admin
|
||||
```
|
||||
|
||||
### 场景3: 版本升级
|
||||
|
||||
```bash
|
||||
# 1. 在新的部署包中执行升级
|
||||
sudo ./scripts/3588admin upgrade
|
||||
|
||||
# 2. 验证升级
|
||||
sudo 3588admin status
|
||||
|
||||
# 3. 如出现问题，查看日志
|
||||
tail -n 50 /opt/3588admin/logs/managerd.log
|
||||
```
|
||||
|
||||
### 场景4: 修改配置
|
||||
|
||||
```bash
|
||||
# 1. 停止服务
|
||||
sudo 3588admin stop
|
||||
|
||||
# 2. 修改配置
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
# 3. 验证配置格式
|
||||
python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
|
||||
# 4. 启动服务
|
||||
sudo 3588admin start
|
||||
```
|
||||
|
||||
### 场景5: 完全卸载
|
||||
|
||||
```bash
|
||||
# 1. 备份配置（可选）
|
||||
cp /opt/3588admin/config/managerd.json ~/managerd-backup.json
|
||||
|
||||
# 2. 执行卸载
|
||||
sudo 3588admin uninstall
|
||||
|
||||
# 3. 确认删除
|
||||
ls /opt/3588admin # 应提示不存在
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q1: 执行脚本时提示 "Permission denied"
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
chmod +x scripts/3588admin
|
||||
sudo ./scripts/3588admin install
|
||||
```
|
||||
|
||||
### Q2: 安装后命令找不到（3588admin-start 等）
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
# 检查是否创建了快捷方式
|
||||
ls -la /usr/local/bin/3588admin-*
|
||||
|
||||
# 如未创建，重新执行安装
|
||||
sudo 3588admin install
|
||||
|
||||
# 或者使用完整路径
|
||||
sudo /opt/3588admin/scripts/3588admin start
|
||||
```
|
||||
|
||||
### Q3: 如何查看更详细的日志？
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
# 实时查看日志
|
||||
tail -f /opt/3588admin/logs/managerd.log
|
||||
|
||||
# 查看最近100行
|
||||
tail -n 100 /opt/3588admin/logs/managerd.log
|
||||
|
||||
# 搜索错误
|
||||
grep -i error /opt/3588admin/logs/managerd.log
|
||||
```
|
||||
|
||||
### Q4: 服务启动后立即退出
|
||||
|
||||
**排查**:
|
||||
```bash
|
||||
# 1. 查看日志
|
||||
tail /opt/3588admin/logs/managerd.log
|
||||
|
||||
# 2. 检查配置格式
|
||||
python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
|
||||
# 3. 检查端口占用
|
||||
sudo netstat -tlnp | grep 18080
|
||||
```
|
||||
|
||||
### Q5: 如何修改监听端口？
|
||||
|
||||
**解决**:
|
||||
```bash
|
||||
# 1. 停止服务
|
||||
sudo 3588admin stop
|
||||
|
||||
# 2. 编辑配置
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
# 修改 "listen" 为 "127.0.0.1:18081" 或其他端口
|
||||
|
||||
# 3. 启动服务
|
||||
sudo 3588admin start
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 文件说明
|
||||
|
||||
```
|
||||
scripts/
|
||||
├── deploy/ # 部署脚本目录
|
||||
│ ├── Manual.md # 本文档
|
||||
│ ├── 3588admin # 统一管理脚本 ⭐
|
||||
│ ├── build-offline-package.sh # 构建离线包
|
||||
│ └── 3588admin.service # Systemd服务
|
||||
└── dev-run.sh # 开发运行脚本
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**维护者**: 运维团队
|
||||
**最后更新**: 2026-02-25
|
||||
**版本**: 2.0 (整合版)
|
||||
@ -69,7 +69,7 @@ else
|
||||
# 创建默认配置示例
|
||||
cat > "$PACKAGE_DIR/config/managerd.json.example" << 'EOF'
|
||||
{
|
||||
"listen": "127.0.0.1:18080",
|
||||
"listen": "0.0.0.0:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
|
||||
217
scripts/deploy/build-windows.ps1
Normal file
217
scripts/deploy/build-windows.ps1
Normal file
@ -0,0 +1,217 @@
|
||||
# 3588AdminBackend Windows 构建脚本
|
||||
# 在 Windows 上交叉编译 Linux 版本并打包
|
||||
|
||||
# 配置
|
||||
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
|
||||
$ProjectDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
|
||||
$BuildDir = "$ProjectDir\build"
|
||||
$PackageName = "3588AdminBackend-离线部署包-$(Get-Date -Format 'yyyyMMdd')"
|
||||
$PackageDir = "$BuildDir\$PackageName"
|
||||
|
||||
Write-Host "========== 3588AdminBackend Windows 构建 ==========" -ForegroundColor Green
|
||||
Write-Host "项目目录: $ProjectDir"
|
||||
Write-Host "构建目录: $BuildDir"
|
||||
Write-Host ""
|
||||
|
||||
# 检查 Go
|
||||
$GoVersion = go version 2>$null
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Host "错误: 未找到 Go 命令，请先安装 Go" -ForegroundColor Red
|
||||
exit 1
|
||||
}
|
||||
Write-Host "Go 版本: $GoVersion"
|
||||
Write-Host ""
|
||||
|
||||
# 清理旧构建
|
||||
Write-Host "[1/6] 清理旧构建..."
|
||||
if (Test-Path $BuildDir) {
|
||||
Remove-Item -Recurse -Force $BuildDir
|
||||
}
|
||||
New-Item -ItemType Directory -Path $PackageDir -Force | Out-Null
|
||||
|
||||
# 创建目录结构
|
||||
Write-Host "[2/6] 创建目录结构..."
|
||||
New-Item -ItemType Directory -Path "$PackageDir\bin" -Force | Out-Null
|
||||
New-Item -ItemType Directory -Path "$PackageDir\config" -Force | Out-Null
|
||||
New-Item -ItemType Directory -Path "$PackageDir\scripts" -Force | Out-Null
|
||||
New-Item -ItemType Directory -Path "$PackageDir\docs" -Force | Out-Null
|
||||
New-Item -ItemType Directory -Path "$PackageDir\systemd" -Force | Out-Null
|
||||
|
||||
# 编译项目
|
||||
Write-Host "[3/6] 交叉编译 Linux AMD64 版本..."
|
||||
cd $ProjectDir
|
||||
|
||||
$env:GOOS = "linux"
|
||||
$env:GOARCH = "amd64"
|
||||
$env:GOTOOLCHAIN = "local"
|
||||
|
||||
go build -ldflags="-s -w" -o "$PackageDir\bin\managerd" ./cmd/managerd
|
||||
|
||||
if ($LASTEXITCODE -ne 0 -or -not (Test-Path "$PackageDir\bin\managerd")) {
|
||||
Write-Host "错误: 编译失败" -ForegroundColor Red
|
||||
exit 1
|
||||
}
|
||||
|
||||
Write-Host " 编译成功" -ForegroundColor Green
|
||||
|
||||
# 复制配置文件
|
||||
Write-Host "[4/6] 复制配置文件..."
|
||||
if (Test-Path "$ProjectDir\managerd.json") {
|
||||
Copy-Item "$ProjectDir\managerd.json" "$PackageDir\config\managerd.json.example"
|
||||
} else {
|
||||
@"
|
||||
{
|
||||
"listen": "0.0.0.0:18080",
|
||||
"discovery_port": 35688,
|
||||
"discovery_timeout_ms": 1200,
|
||||
"offline_after_ms": 10000,
|
||||
"agent_token": "CHANGE_ME",
|
||||
"concurrency": 5
|
||||
}
|
||||
"@ | Out-File -FilePath "$PackageDir\config\managerd.json.example" -Encoding UTF8
|
||||
}
|
||||
|
||||
# 复制模板文件（如果有）
|
||||
if (Test-Path "$ProjectDir\templates") {
|
||||
Write-Host " 复制模板文件..."
|
||||
Copy-Item -Recurse "$ProjectDir\templates" "$PackageDir\"
|
||||
}
|
||||
|
||||
# 复制脚本
|
||||
Write-Host "[5/6] 复制部署脚本..."
|
||||
Copy-Item "$ScriptDir\3588admin" "$PackageDir\scripts\"
|
||||
Copy-Item "$ScriptDir\3588admin.service" "$PackageDir\systemd\"
|
||||
|
||||
# 修复换行符为 LF（Unix 格式）
|
||||
$scriptContent = Get-Content "$PackageDir\scripts\3588admin" -Raw
|
||||
$scriptContent = $scriptContent -replace "`r`n", "`n"
|
||||
Set-Content -Path "$PackageDir\scripts\3588admin" -Value $scriptContent -NoNewLine
|
||||
|
||||
$serviceContent = Get-Content "$PackageDir\systemd\3588admin.service" -Raw
|
||||
$serviceContent = $serviceContent -replace "`r`n", "`n"
|
||||
Set-Content -Path "$PackageDir\systemd\3588admin.service" -Value $serviceContent -NoNewLine
|
||||
|
||||
# 复制文档
|
||||
Write-Host "[6/6] 复制文档..."
|
||||
if (Test-Path "$ProjectDir\docs") {
|
||||
Get-ChildItem "$ProjectDir\docs\*.md" -ErrorAction SilentlyContinue | ForEach-Object {
|
||||
Copy-Item $_.FullName "$PackageDir\docs\"
|
||||
}
|
||||
}
|
||||
if (Test-Path "$ProjectDir\Readme.md") {
|
||||
Copy-Item "$ProjectDir\Readme.md" "$PackageDir\docs\"
|
||||
}
|
||||
if (Test-Path "$ProjectDir\API_Device_RemoteMgmt_InterfaceTable.md") {
|
||||
Copy-Item "$ProjectDir\API_Device_RemoteMgmt_InterfaceTable.md" "$PackageDir\docs\"
|
||||
}
|
||||
|
||||
# 创建版本信息
|
||||
@"
|
||||
3588AdminBackend 离线部署包
|
||||
版本: 1.0.0
|
||||
构建时间: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')
|
||||
Go版本: $GoVersion
|
||||
目标系统: Ubuntu 22.04.5 LTS x86_64
|
||||
构建主机: $env:COMPUTERNAME (Windows)
|
||||
"@ | Out-File -FilePath "$PackageDir\VERSION" -Encoding UTF8
|
||||
|
||||
# 创建快速安装说明
|
||||
@"
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 3588AdminBackend 离线部署包 - 快速安装指南 ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
|
||||
【系统要求】
|
||||
- Ubuntu 22.04.5 LTS (x86_64)
|
||||
- root 权限
|
||||
|
||||
【重要说明】
|
||||
✓ 本部署包已包含静态编译的二进制文件
|
||||
✓ 目标机器无需安装 Go 运行时
|
||||
✓ 无需互联网连接（纯离线安装）
|
||||
✓ 二进制文件在 Windows 上交叉编译生成
|
||||
|
||||
【安装步骤】
|
||||
|
||||
1. 上传部署包到 Ubuntu 服务器
|
||||
scp -r $PackageName.tar.gz user@ubuntu-server:/tmp/
|
||||
|
||||
2. 解压部署包
|
||||
tar -xzf $PackageName.tar.gz
|
||||
cd $PackageName/
|
||||
|
||||
3. 执行安装
|
||||
sudo ./scripts/3588admin install
|
||||
|
||||
4. 修改配置
|
||||
sudo nano /opt/3588admin/config/managerd.json
|
||||
|
||||
重点修改:
|
||||
- agent_token: 修改为安全的随机字符串
|
||||
- listen: 如需外部访问改为 "0.0.0.0:18080"
|
||||
|
||||
5. 启动服务
|
||||
sudo 3588admin start
|
||||
|
||||
6. 验证安装
|
||||
sudo 3588admin status
|
||||
|
||||
【常用命令】
|
||||
3588admin start - 启动服务
|
||||
3588admin stop - 停止服务
|
||||
3588admin status - 查看状态
|
||||
3588admin restart - 重启服务
|
||||
3588admin upgrade - 升级服务
|
||||
3588admin uninstall - 卸载服务
|
||||
3588admin check - 检查环境
|
||||
|
||||
【快捷命令】
|
||||
3588admin-start - 启动服务
|
||||
3588admin-stop - 停止服务
|
||||
3588admin-status - 查看状态
|
||||
|
||||
【文件位置】
|
||||
安装目录: /opt/3588admin
|
||||
配置文件: /opt/3588admin/config/managerd.json
|
||||
日志文件: /opt/3588admin/logs/managerd.log
|
||||
|
||||
【问题排查】
|
||||
1. 查看日志: tail -f /opt/3588admin/logs/managerd.log
|
||||
2. 检查配置: python3 -m json.tool /opt/3588admin/config/managerd.json
|
||||
3. 检查端口: sudo netstat -tlnp | grep managerd
|
||||
|
||||
【防火墙】
|
||||
sudo ufw allow 18080/tcp # HTTP API
|
||||
sudo ufw allow 35688/udp # UDP 发现
|
||||
|
||||
"@ | Out-File -FilePath "$PackageDir\README-离线安装.txt" -Encoding UTF8
|
||||
|
||||
# 打包（使用 tar，Windows 10/11 内置）
|
||||
Write-Host ""
|
||||
Write-Host "打包..."
|
||||
cd $BuildDir
|
||||
|
||||
# 创建 tar.gz 包（使用正斜杠避免 Windows 路径问题）
|
||||
$PackageNameUnix = $PackageName -replace '\\', '/'
|
||||
tar -czf "$PackageName.tar.gz" "$PackageNameUnix"
|
||||
|
||||
if ($LASTEXITCODE -eq 0 -and (Test-Path "$PackageName.tar.gz")) {
|
||||
Write-Host ""
|
||||
Write-Host "========== 构建完成 ==========" -ForegroundColor Green
|
||||
Write-Host ""
|
||||
Write-Host "输出文件:"
|
||||
Get-ChildItem "$PackageName.tar.gz" | ForEach-Object {
|
||||
$size = [math]::Round($_.Length / 1MB, 2)
|
||||
Write-Host " $($_.Name) ($size MB)"
|
||||
}
|
||||
Write-Host ""
|
||||
Write-Host "部署包位置: $BuildDir\$PackageName.tar.gz" -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
Write-Host "使用说明:"
|
||||
Write-Host "1. 将 $PackageName.tar.gz 上传到 Ubuntu 服务器"
|
||||
Write-Host "2. 解压并运行: sudo ./scripts/3588admin install"
|
||||
Write-Host ""
|
||||
} else {
|
||||
Write-Host "错误: 打包失败" -ForegroundColor Red
|
||||
exit 1
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user