45 lines
2.9 KiB
Markdown
45 lines
2.9 KiB
Markdown
<!-- gitea-wiki-mirror:start -->
|
||
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||
wiki_page: Deployment-and-Operations
|
||
wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Deployment-and-Operations.-
|
||
wiki_revision: 80ae5c8cea87c624fff63ce3e302aa7bf204811e
|
||
synchronized_at: 2026-08-31T16:07:03Z
|
||
<!-- gitea-wiki-mirror:end -->
|
||
|
||
# 部署与运维
|
||
|
||
## 当前线上拓扑
|
||
|
||
- 外部入口：`http://185.216.248.75:9527`，Nginx 同时承载 Admin 静态资源并反向代理 GoAuto API。
|
||
- GoAuto 服务监听：`127.0.0.1:8010`。
|
||
- 常驻服务：systemd `goauto.service`。
|
||
- 工作目录：`/home/goauto/current`，指向 `/home/goauto/releases/<发布标识>`。
|
||
- 服务配置：`/home/goauto/current/config/settings.yml`；敏感环境变量由 `/etc/goauto/goauto.env` 提供，不写入 Git、Wiki、工单或日志。
|
||
- Agent APK 私有目录：相对工作目录的 `var/goauto-agent-releases`；下载必须通过已认证接口。
|
||
|
||
## Agent HTTP 例外
|
||
|
||
服务端生产模式默认要求 Agent 使用 HTTPS。当前线上入口只有 HTTP，因此经 #181 用户明确确认，在 `/etc/goauto/goauto.env` 设置：
|
||
|
||
```text
|
||
GOAUTO_ALLOW_INSECURE_AGENT_HTTP=true
|
||
```
|
||
|
||
该开关只放宽全部 `/api/agent/v1/**`，包括注册、心跳、采集、采购、Agent 版本检查与下载；不放宽 Admin、PDD、SYB、OCR 或其他第三方地址的安全约束。HTTP 会明文传输 Device Token、任务内容、设备状态和执行结果。后续启用 HTTPS 后应删除该变量或设为 `false`。
|
||
|
||
`GOAUTO_TRUST_FORWARDED_PROTO=true` 只表示信任受控反向代理传入的 `X-Forwarded-Proto: https`，不能把实际 HTTP 请求视为加密链路，也不能替代上述显式 HTTP 开关。
|
||
|
||
## 发布与验证
|
||
|
||
1. 在本地完成服务端测试/构建和 Android 单测/APK 构建，记录提交、versionCode、SHA-256 与大小。
|
||
2. 创建新的 `/home/goauto/releases/<发布标识>`，复制服务端二进制、Web 静态资源和非敏感配置；保留旧发布目录用于回滚。
|
||
3. 原子切换 `/home/goauto/current` 后重启 `goauto.service`，确认 `systemctl is-active goauto.service` 为 `active`，并从外部入口验证 API。
|
||
4. 上传 APK 到 Admin Agent 版本并按需设为当前；服务端解析 Manifest，校验 versionCode 唯一性并保存 SHA-256。
|
||
5. 真机安装前确认设备没有运行中的任务。Android 系统安装确认仍由人工完成，Agent 不静默安装。
|
||
|
||
发布、重启、设置当前 Agent 版本和真机安装都属于高风险操作，必须有对应工单和人工确认。不得在部署过程中执行付款、创建订单或清理生产数据。
|
||
|
||
## 回滚
|
||
|
||
服务异常时把 `/home/goauto/current` 切回上一已验证发布目录并重启 `goauto.service`，随后复核服务状态和 Agent 接口。不要删除当前或历史 APK/发布目录来代替回滚；数据库变化如需回退必须单独评估。
|