Files
moyi-model-intelligence-hub/docs/11-server-test-deployment.md
T

308 lines
26 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 北京测试服务器部署手册
## 1. 已确认的环境与本次边界
| 项目 | 本次配置 |
| --- | --- |
| 应用服务器 | 阿里云轻量,北京,4 核 8 GiB,Ubuntu 24.04,70 GiB 系统盘 |
| 公网地址 | `39.96.90.106` |
| 私网地址 | 截图为 `172.17.24.125`;配置内网互通后再次核对 |
| 域名 | `moyi.soulofmodel.com`,不修改 `www` 或主域名原系统 |
| 数据库 | 现有北京 RDS PostgreSQL 15,新增独立数据库 `moyi_control` |
| 缓存 | 现有北京 Tair 标准架构,专用账号及 `moyi:test:` Key 前缀 |
| 对象存储 | 北京 OSS 可预留新 Bucket,本次 Java 部署暂不需要 OSS 密钥 |
这是内部测试发布,不是完整生产版。可验收登录、邀请码、目录、项目、Key 权限、同步/流式文本转发、人民币用量结算、限流、模型并发和调用审计。真实分组必须配置售价且调用者余额充足;V13 升级要求见 [流式与计费](16-streaming-chat-billing.md)。以下尚未完成:Java 真实 Tripo/Seedance 异步执行、OSS 文件保存、支付充值、分布式任务抢占和可靠重试。
真实供应商没有配置密钥时返回 503,不再返回 Mock 成功。只有明确绑定 `provider-mock` 的模型可以走 Mock;同步和流式文本已接入,真实异步供应商仍返回 501。已有种子目录和价格只是联调数据,实际模型 ID/能力须由供应商控制台核验后修改。
注意更正早期说明:当前登录会话和任务状态保存于 PostgreSQL;Tair 已实现的是按 Key 限流、按 API Key 并发租约、按上游分组并发租约,不是已完成的 MQ、幂等或异步调度平台。不需要现在购买 MQ。
## 2. 你需要在阿里云完成的配置
### 网络互通,先确认对旧系统的影响
1. 确认新服务器、RDS、Tair 在同一阿里云账号和北京地域。
2. 轻量控制台的“内网互通”中关联 RDS/Tair 所属 VPC;如属于不同 VPC,分别设置。
3. **首次在该地域开通内网互通可能导致该地域所有轻量服务器停机约 1 分钟**,包括现有小程序服务器。先检查是否已开通,在维护时间执行,不要为本项目随意取消旧连接。
4. 开通后重新核对新服务器私网 IP,把它以 `/32` 加入 RDS、Tair 的新增白名单分组 `moyi-test`。保留旧系统的白名单,不要覆盖或放行 `0.0.0.0/0`。
5. 不要为了连接方便给 RDS/Tair 开公网地址;同地域不等于已内网互通。
依据:[阿里云轻量内网互通](https://help.aliyun.com/zh/simple-application-server/user-guide/manage-service-interconnection/)。
### 防火墙和网段
- SSH 22 是远程维护端口。开发团队网络可能变化,本次测试可以像现有服务器一样配置 TCP 22、来源 `0.0.0.0/0`,但必须配合每人独立账号、个人 SSH 公钥、禁用密码登录和禁止 root 直登;不要共用 root 密码或私钥。长期建议改为只允许公司 VPN/堡垒机出口 IP。
- SSH 隧道模式不需要开放 80/443/8080。HTTPS 模式开放 80、443;内部测试阶段建议也仅允许测试人员公网 IP。
- Java 8787、数据库端口、6379 不发布到公网;8080 始终只绑定 `127.0.0.1`。
- 不只依赖 UFW:Docker 发布端口的流量可能绕过 UFW,阿里云防火墙来源限制必须配置。[Docker 官方说明](https://docs.docker.com/engine/install/ubuntu/)
- 当前服务器在 `172.17.*` 私网,而 Docker 默认桥接网络也可能使用 `172.17.0.0/16`。安装前后查看 `ip route`;若重叠,先调整 Docker 地址池/默认桥接网段,再启动。不要直接覆盖已有 `/etc/docker/daemon.json`。
- 本 Compose 显式使用 `10.253.240.0/24`,但这只是待确认候选值。须确保不与服务器、RDS、Tair、现有 Docker/VPC 路由重叠;必要时修改 `MOYI_DOCKER_SUBNET`。脚本会检查该子网与已解析的 RDS/Tair 地址是否重叠,不代替完整路由审查。
### 团队 SSH 访问(22 端口)
完成下述密钥登录与 sudo 验证后,再配置阿里云控制台:`轻量应用服务器 → 防火墙 → 添加规则`,填写协议 TCP、端口 22、来源 `0.0.0.0/0`,备注“团队 SSH 远程维护”。已有相同规则无需重复添加。初始化期间可以使用控制台远程连接,或暂时只允许维护人员当前公网 IP。这只允许网络连接,不能替代 SSH 身份认证。[阿里云防火墙说明](https://help.aliyun.com/zh/simple-application-server/user-guide/manage-the-firewall-of-a-server)
每位成员先在自己的电脑执行 `ssh-keygen -t ed25519`,设置私钥口令;已有密钥时不要覆盖。只把 `.pub` 文件内容交给管理员,私钥留在个人电脑。
服务器上逐位成员创建账号和公钥。以下示例仅针对新账号,账号名替换为真实值;若账号已存在,先检查其权限,不要覆盖已有公钥文件:
```bash
# 使用当前已验证的管理员会话执行;先不要关闭当前窗口
sudo adduser moyi-dev1
sudo install -d -m 700 -o moyi-dev1 -g moyi-dev1 /home/moyi-dev1/.ssh
sudo nano /home/moyi-dev1/.ssh/authorized_keys
```
在文件中粘贴该成员完整的公钥,单个公钥占一行,保存退出,再执行:
```bash
sudo chown moyi-dev1:moyi-dev1 /home/moyi-dev1/.ssh/authorized_keys
sudo chmod 600 /home/moyi-dev1/.ssh/authorized_keys
```
`adduser` 设置的是本机账号密码,后续禁用 SSH 密码登录不影响 sudo 使用该密码验证。不要创建没有可用密码的账号后,仅加入 sudo 组就假定可以管理服务器。
仅对负责部署和运维的成员执行 `sudo usermod -aG sudo moyi-dev1`。sudo 和 Docker 组都可能赋予接近 root 的能力,不要默认授予所有开发者。
成员开新窗口,用 `ssh -o PreferredAuthentications=publickey moyi-dev1@39.96.90.106` 验证密钥登录,运维成员还需在新会话执行 `sudo -k` 和 `sudo whoami`,输入自己的本机账号密码后应显示 `root`。首次连接核对主机指纹与控制台获得的指纹一致。至少一个非 root 管理员完成以上验证,再执行 SSH 加固。
保留当前管理员会话和控制台救援入口。检查并备份原 SSH 配置后,用 `sudoedit /etc/ssh/sshd_config.d/00-moyi-team.conf` 添加以下配置;文件已存在时先读取并合并,不覆盖其他用途的配置:
```text
PermitRootLogin no
PasswordAuthentication no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
AuthenticationMethods publickey
```
OpenSSH 通常取最先读到的配置,不能假设较大数字文件名会覆盖云镜像设置。运行 `sudo /usr/sbin/sshd -t` 检查语法,再用 `sudo /usr/sbin/sshd -T` 核对上述五项实际值;有 Match 条件时,还需使用 `-T -C user=成员账号,host=客户端主机名,addr=客户端公网IP,laddr=服务器地址,lport=22` 按真实连接分别核对。不是期望值时停止,排查 Include 顺序和 Match 条件,不要直接重载。[Ubuntu SSH 配置说明](https://ubuntu.com/server/docs/how-to/security/openssh-server/)
全部检查通过后执行 `sudo systemctl reload ssh`,再开新窗口验证密钥登录及 sudo,成功后才关闭旧会话、放宽防火墙来源。保留阿里云控制台救援入口。成员退出项目时撤销其公钥和账号访问,必要时结束已有会话;不要影响其他成员。22 对公网开放会收到扫描,需维护系统安全更新、查看登录日志,可补充 `fail2ban`;长期再迁移到 VPN/堡垒机白名单。
### 当前部署节点:先检查,再安装
以下命令在目标 MOYI 服务器的远程终端执行,不是在 Windows PowerShell 执行。只读取状态,不安装软件、不调整 SSH、不修改路由:
```bash
whoami
cat /etc/os-release
ip -br -4 addr
ip -4 route
free -h
df -h /
sudo ss -lntp
sudo ufw status
sudo /usr/sbin/sshd -T | grep -E '^(port|permitrootlogin|passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|authenticationmethods) '
if command -v docker >/dev/null 2>&1; then
sudo docker version
sudo docker compose version
sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
sudo docker network ls
else
printf '%s\n' 'Docker is not installed'
fi
```
提供这些检查结果及 RDS/Tair 内网地址、实际端口、VPC 和 TLS 状态,确认专用库/账号与白名单是否完成。密码、私钥、完整 `.env` 和 Docker 环境变量不要发送。若地址或资源名称涉及其他业务,可先脱敏。
先确认 Docker 已有容器、网段、宿主机端口与旧服务不冲突,再安装 Docker/Compose、上传并校验发布包、填写 `.env.cloud`、检查 RDS/Tair 连接。宿主机不需要单独安装 Nginx、Java、Node、PostgreSQL 或 Redis;前端容器已经包含 Nginx。
各节点验收:基础环境及 SSH 可管理 → RDS/Tair 连通及鉴权 → 容器就绪及隧道访问 → 域名 HTTPS → 登录、Key 权限、Mock 请求、审计导出及真实同步调用。没有实际执行服务器命令和验收前,不将本地构建或文档完成视为已部署。
### RDS PostgreSQL 15
1. 在现有 RDS 实例创建专用数据库 `moyi_control` 和专用账号 `moyi_app`,**不在小程序库里直接添加本项目的表**。
2. 确保 `moyi_app` 在这个库中有连接、建表、建索引和读写权限。PG15 中需确认 `public` schema 的 CREATE 权限或让该账号拥有新库;不能只授予 SELECT/INSERT。
3. 新数据库第一次启动由 Flyway 自动建表。配置关闭自动 baseline,非空未受 Flyway 管理的库会拒绝迁移,不要为绕过错误而启用 baseline。
4. 数据库修改前创建 RDS 备份,并核对可恢复性;不调整原系统账号、权限或数据库。
5. 提供内网地址、实际端口、库名和账号。密码只填写服务器 `.env.cloud`。若启用数据库 TLS,按 RDS 配置 JDBC 参数及 CA 校验,不默认假设端口/TLS。
### Tair 标准架构
1. 新建本项目专用账号,保留旧系统账号与密码。不要重置共享实例的默认密码。
2. 使用内网地址、标准架构连接,按实例实际情况填写 TLS、端口、账号和密码。
3. 无需创建表。使用 `moyi:test:` 前缀;支持 ACL Key 规则时,限制为此命名空间。可使用受支持的独立逻辑 DB,但它不等于独立实例或资源隔离。
4. 网关需要 PING、Lua 脚本执行以及 INCR、PTTL、PEXPIRE、TIME、ZADD、ZCARD、ZREM、ZREMRANGEBYSCORE 等操作。只读账号不够。预检查仅验证 TCP,应用就绪检查再验证连接与鉴权,Mock 模型调用才验证真实 Lua 权限。
5. **不要执行 FLUSHDB、FLUSHALL,不要修改共享实例的全局配置。** 共享实例的内存、CPU、驱逐策略仍共享,测试流量要有限额。
### 域名和 DV 证书
1. 在 `soulofmodel.com` 的当前 DNS 托管处添加 A 记录:主机记录 `moyi`,值 `39.96.90.106`,TTL 默认 10 分钟。不修改 `www`、`@`、MX 或 DNS 服务器。
2. 申请覆盖 **`moyi.soulofmodel.com`** 的单域名 DV 证书即可。DV 满足当前企业测试的 HTTPS 需求,OV/EV 主要增加组织身份核验,不是当前必需项。[阿里云选型说明](https://help.aliyun.com/zh/ssl-certificate/functions-and-features)
3. 使用证书控制台给出的 DNS 验证记录,不删除原业务验证记录;下载 **Nginx 格式**证书。
4. 将包含完整链的 PEM 和对应私钥放到服务器 `infra/moyi/certs/fullchain.pem`、`privkey.pem`,私钥权限 600。不要发到聊天或 Git。
5. 现有域名已备案并接入阿里云时,子域名通常无需单独备案;仍需核对主体、服务内容和页面备案信息。备案不是模型供应商授权或 AI 服务合规的替代。[子域名备案说明](https://help.aliyun.com/zh/icp-filing/basic-icp-service/support/for-the-record-domain-faq/)
### OSS 本次可以后置
可先创建北京私有 Bucket,例如自定义的 `moyi-test-assets-*`;名称须全局唯一。Java 的结果文件落盘尚未完成,本次不需要创建或提供 AccessKey,更不要为赶部署设置公共读写。后续接入时再配置仅目标 Bucket 的 RAM 权限、签名 URL、生命周期和测试/生产隔离。
## 3. 部署包与服务器初始化
发布压缩包位于开发机 `artifacts/moyi-test-<版本>.tar.gz`,旁边有 `.sha256`。包内包含已编译的 Java 21 JAR、Vue 静态文件、运行时 Dockerfile、Compose、环境变量模板、Nginx、部署脚本和逐文件校验清单。
它不是离线 Docker 镜像包。服务器不用安装 Java/Maven/Node,但首次需访问镜像仓库下载 `eclipse-temurin:21-jre-alpine` 和 `nginx:1.27-alpine`。若网络不可用,应由开发机/CI 构建并推送阿里云 ACR 或交付 `docker save` 镜像包;不要使用来源不明的镜像代理。运行时镜像地址可以通过环境模板改为已同步的可信镜像地址。
将压缩包及 SHA256 文件通过 SCP/SFTP 上传到服务器同一目录。下面操作在服务器执行;`<版本>` 替换成实际文件名中的版本:
```bash
sha256sum -c moyi-test-<版本>.tar.gz.sha256
sudo mkdir -p /opt/moyi/releases/<版本>
sudo tar -xzf moyi-test-<版本>.tar.gz -C /opt/moyi/releases/<版本>
cd /opt/moyi/releases/<版本>/infra/moyi
sudo bash install-docker-ubuntu.sh
sudo python3 deploy.py verify
sudo python3 deploy.py init
sudo nano .env.cloud
```
安装脚本仅针对 Ubuntu 24.04,使用 Docker 官方 APT 源。发现已有 Docker 时不覆盖安装;发现冲突包时停止,不自动卸载。仓库不可达时报错停止,再单独配置可信来源,不会关闭 TLS 校验。不要为执行安装脚本更改现有服务器上的 Nginx、UFW 或其他应用。
`init` 自动生成随机管理员初始密码、密码 Pepper 和供应商凭证加密密钥,配置文件权限 600;已存在配置时拒绝覆盖。账号仍是已约定的 `adimin`,**云端不使用 `admin123`**。初始密码在服务器 `.env.cloud` 中查看,不会打印到日志。
### 超级管理员与登录注册
- 首次初始化创建唯一的 `super_admin`(超级管理员);`admin`(平台管理员)可以管理日常业务,但不能任免管理员。
- 从旧版升级时,`ADMIN_ACCOUNT` 对应的正常管理员自动升为超级管理员,账号、原密码和现有会话保留。其他管理员不会自动升级。
- 已存在超级管理员时,`ADMIN_ACCOUNT` 必须与其账号一致,否则启动拒绝继续;不要通过改账号创建第二个超级管理员。数据库唯一索引也会阻止第二个超级管理员。
- 用户通过邀请码注册,角色固定为普通用户;注册成功即登录。超级管理员进入“管理端 → 用户与额度”,点击用户行,再通过“调整角色”授予或撤销平台管理员身份。不能在此处降级自己或创建第二个超级管理员。角色变化写入审计,降级后原会话的管理接口权限立即失效。
- 查找当前初始账号与密码:在服务器运行 `sudo nano /opt/moyi/releases/20260911-151010-8cd7e410/infra/moyi/.env.cloud`,仅查看 `ADMIN_ACCOUNT`、`ADMIN_PASSWORD` 后退出,不要把文件或密码发送到聊天。升级后使用实际版本目录。
- `ADMIN_PASSWORD` 只在首次建号时使用,后续修改它不会重置数据库里的密码。本版本未提供自助密码找回;不要重新运行 `init`、删除用户或更换 Pepper 来恢复登录。
- 超级管理员密码不强制最小位数或字符组合,但不能为空、全为空白或保留模板占位值。普通用户注册仍要求至少 8 位;密码 Pepper 和供应商凭证加密密钥仍要求至少 32 个字符,这些不是登录密码。
## 4. 环境变量怎么填
| 分类 | 变量 | 本次要求 |
| --- | --- | --- |
| RDS | `MOYI_DB_URL`、`MOYI_DB_USERNAME`、`MOYI_DB_PASSWORD` | 必填;新建 PostgreSQL 数据库 |
| Tair | `MOYI_REDIS_HOST/PORT/USERNAME/PASSWORD/DATABASE/SSL` | 地址、密码必填,其他按实例信息 |
| 隔离 | `MOYI_REDIS_KEY_PREFIX`、`MOYI_DOCKER_SUBNET` | 专用前缀,网段不冲突 |
| 安全 | `AUTH_PASSWORD_PEPPER`、`CREDENTIAL_ENCRYPTION_KEY`、`ADMIN_PASSWORD` | init 已生成;升级必须保留 |
| HTTPS | `MOYI_DOMAIN` | 已预填 `moyi.soulofmodel.com`;证书另放 certs |
| 容量 | `DB_POOL_*`、`GATEWAY_*`、`TASK_*`、`JAVA_OPTS` | 先用测试默认值,不代表已压测容量 |
| 供应商 | `DEEPSEEK_*`、`KIMI_*`、`ZHIPU_*` | 首次可空,在管理端配置更直观;环境密钥优先级更高 |
| 后置 | `OSS_*`、`TRIPO_API_KEY`、`VOLCENGINE_API_KEY` | 预留,不注入本次 Java 服务,留空 |
密码包含 `$`、`#` 或空格时用单引号包住,例如 `MOYI_REDIS_PASSWORD='实际密码'`。若密码本身包含单引号,按 Compose dotenv 转义规则处理。**不要 `source .env.cloud`,不要把完整 `docker compose config` 输出发到聊天**,其中可能含真实密钥。使用 `deploy.py check` 只输出检查结论。
旧的 `MOYI_REDIS_URL` 已改为分离字段,避免用户名/密码的 URL 编码问题。旧云配置升级时逐项补齐,不直接复制覆盖。Cookie 安全属性由模式决定,不再通过随意设置公网 HTTP 来降低安全性。
## 5. 启动方式二选一
### A. 暂无证书:SSH 隧道内部测试
```bash
sudo python3 deploy.py check --mode tunnel --network
sudo python3 deploy.py up --mode tunnel --accept-migrations
sudo python3 deploy.py smoke --mode tunnel --login
```
在你自己的电脑打开一个终端并保持连接(替换 `SSH用户名`,不要默认假设是 root):
```powershell
ssh -N -L 8080:127.0.0.1:8080 SSH用户名@39.96.90.106
```
浏览器访问 `http://localhost:8080`。无需开放公网 8080,登录流量通过 SSH 加密。若电脑 8080 已占用,应同时调整配置中的本地端口和 CORS,或选择另一个转发端口后同步 CORS。
### B. 域名和证书就绪:HTTPS 测试
```bash
sudo chmod 600 certs/privkey.pem
sudo python3 deploy.py check --mode https --network
sudo python3 deploy.py up --mode https --accept-migrations
sudo python3 deploy.py smoke --mode https --login
```
通过阿里云防火墙允许的测试人员访问 `https://moyi.soulofmodel.com`,模型 API 使用 `https://moyi.soulofmodel.com/v1`。HTTPS 模式自动开启 Secure Cookie;证书错误时拒绝启动。不要关闭客户端证书校验。
`up` 先编译运行时镜像,再启动后端、检查 RDS/Tair 就绪、校验 Nginx,最后启动前端。数据库迁移必须明确带 `--accept-migrations`;配置错指其他库仍可能造成改动,执行前须核对并备份。后端不会对公网发布端口。
## 6. 查看状态、测试与排障
```bash
sudo python3 deploy.py status
sudo python3 deploy.py logs
sudo python3 deploy.py smoke
sudo python3 deploy.py stop
```
成功启动后会保存模式,后续命令默认沿用;第一次启动失败时请显式带 `--mode`。`stop` 只停止容器,不删数据库、缓存或镜像。
验收顺序:
1. 登录与退出、刷新恢复会话;管理员创建邀请码,普通用户注册。
2. 创建个人/项目 Key,编辑模型权限,禁用 Key 后访问被拒绝。
3. 用明确标记 Mock 的文本模型检查 Tair Lua 限流和并发,再配置一个真实同步供应商、小额验证请求与响应。
4. 查看调用记录输入输出、错误、按 Key 筛选及导出;测试数据也可能含个人信息,仅管理员可访问,注意日志留存与脱敏。
5. 同步和流式文本调用都应返回成功并写入用量记录;真实 3D/视频异步执行器尚未接入,仍返回 501,模型广场会标记为“异步执行器待接入”。
`smoke` 默认不调用任何付费模型;`--login` 会使用初始管理员凭据验证 Cookie 并产生登录审计。如已修改管理员密码,不再使用初始凭据进行该测试。
常见失败:
- RDS/Tair TCP 不通:检查 VPC 内网互通、私网 IP、白名单和网段冲突;不要改成全网白名单。
- 后端 unhealthy:通过 logs 检查数据库账号权限、Flyway、Tair TLS/密码。`/health` 是基本状态,容器就绪依据 `/actuator/health/readiness`,外部不能访问 actuator。
- 镜像下载失败:检查服务器到官方镜像仓库的连接,下一步交付 ACR/离线镜像;不要重复更换应用端口。
- 页面能开但登录失败:检查所用模式和浏览器域名,HTTPS 模式不能用 IP HTTP 登录。
- 真实模型 503:先在管理端配置正确供应商 Key、Base URL、上游模型 ID,不是服务器配置不足。上游响应会安全归类为 `UPSTREAM_AUTH_FAILED`、`UPSTREAM_CREDIT_INSUFFICIENT`、`UPSTREAM_RATE_LIMITED` 或 `UPSTREAM_PROVIDER_ERROR`;不要把上游原始响应写入客户端日志。
## 7. 证书更新、升级与回退
本包提供有效期检查及安全重载,**不自动购买、签发或续期证书**。开启阿里云证书到期通知,续签后替换服务器 `certs/fullchain.pem`、`privkey.pem`,执行:
```bash
sudo python3 deploy.py check --mode https
sudo python3 deploy.py reload-tls --mode https
```
检查会提示 30 天内到期,证书不足 1 天有效期时拒绝;`nginx -t` 成功后才 reload。保留旧证书备份以便更新失败时恢复。
升级时每个版本解压到独立 `releases/<版本>` 目录,**保留相同 Compose 项目名**,安全复制旧 `.env.cloud` 和证书到新版本,并补齐新增配置项。不要重新生成 Pepper/加密密钥,否则会影响密码校验和供应商凭据解密。预编译发布包需将旧环境中的 `MOYI_IMAGE_TAG` 改为新 `release-manifest.json` 的 `release` 值,并使用 `Dockerfile.runtime`。
执行新版本 `check`、备份 RDS 后再 `up`。构建失败时旧容器仍运行;数据库迁移及后端更新后发生的失败不能承诺自动回退。只有确认旧程序与新数据库结构兼容,才能回到旧版本目录用相同项目名启动;不兼容时需从 RDS 备份恢复到另一个测试库并重新验证。禁止用 `docker system prune`、`down -v`、删除旧库等方式“修复”发布失败。
### 从 20260911 版本升级角色功能
1. 先为 `moyi_control` 确认可恢复备份。该库与其他业务库共用 RDS,回退不能恢复整个共享实例覆盖其他系统。
2. 校验新压缩包 SHA256,解压到新的版本目录;在新目录运行 `python3 deploy.py verify`。
3. 将旧版本的 `.env.cloud` 和 `certs/fullchain.pem`、`certs/privkey.pem` 安全复制到新目录。保留原文件,配置和私钥权限为 `600`、证书目录为 `700`;不要重新运行 `init`。
4. 只把新目录 `.env.cloud` 的 `MOYI_IMAGE_TAG` 改为新发布清单中的 `release` 值。保留 `ADMIN_ACCOUNT`、所有密码、Pepper、加密密钥、Compose 项目名、已验证的镜像源和网络配置。
5. 在新目录执行 `python3 deploy.py check --mode https --network`,核对目标确实是 `moyi_control` 后执行 `python3 deploy.py up --mode https --accept-migrations`。
6. 执行 `python3 deploy.py smoke --mode https --login`;新版会检查初始账号的角色确实是超级管理员,再验证管理接口。浏览器刷新后使用原账号、原密码登录。
V9 迁移扩展角色约束、增加超级管理员唯一索引,应用启动时升级指定账号。旧程序只识别 `admin`,**V9 启用后不能直接切回旧版 JAR**;需要兼容新版角色的修复版本,或由维护人员将升级前备份恢复到独立测试库后验证回退。不要手工修改 Flyway 历史或删除唯一索引。
### 修改已存在的超级管理员账号和密码
`ADMIN_ACCOUNT` / `ADMIN_PASSWORD` 只用于初始化和启动校验,修改环境变量本身不会更新已有密码。不要先修改账号环境变量再重启,避免触发唯一超级管理员保护。
单机 Docker Compose 部署可使用 `infra/moyi/admin_credentials.py`。它依赖服务器 Python 3.11+、Docker Compose 和 PostgreSQL 客户端;通过运行版本的 `deploy.py` 解析配置,不在命令行或日志中输出密码。将该脚本放在发布目录外,例如 `/opt/moyi/tools/admin_credentials.py`,避免改动已有发布包的校验文件。
```bash
sudo python3 /opt/moyi/tools/admin_credentials.py --deployment-dir /opt/moyi/releases/<当前版本>/infra/moyi --account MLKJAdmin --database moyi_control --mode https
sudo python3 /opt/moyi/tools/admin_credentials.py --deployment-dir /opt/moyi/releases/<当前版本>/infra/moyi --account MLKJAdmin --database moyi_control --mode https --apply
```
第一条只检查;第二条须在交互式 SSH 中单独执行,隐藏输入两次新密码。没有密码最低长度要求,拒绝空白、控制字符、开发默认密码和部署配置占位符。脚本会:
1. 核对唯一活跃超级管理员、目标库、账号占用、运行容器的发布目录与数据库/加密配置。
2. 保存修改前后的环境配置,调用 Compose 验证只有管理员账号和密码发生变化。
3. 短暂停止后端,将当前专用数据库导出到 `/opt/moyi/backups/owner-reset-*`,保留环境密钥;备份和配置仅 root 可读。
4. 在同一数据库事务中修改原账号及 PBKDF2 哈希、撤销该账号旧会话、记录审计,不新建用户、不改变用户 ID、角色、显示名称或业务关联。
5. 原子替换环境文件,使用现有镜像重建后端,重载容器 Nginx 并验证新超级管理员登录。账号匹配不区分大小写,数据库内使用小写规范形式。
执行前应暂停平台测试,维护期间不要并行修改 `.env.cloud`、发布或启动其他后端实例。密码只在服务器输入,不写进源码、发布包、Shell 历史。工具不会重新构建镜像或修改数据库迁移文件。
若数据库修改前失败,工具尝试启动原后端;若数据库事务已尝试提交后失败,不自动还原数据库或旧配置,以免状态不一致。保留工具输出的私有恢复目录,使用相同账号和密码重跑工具完成配置同步及验收。不要盲目恢复整个共享 RDS 实例、切回旧版程序或旧环境配置。成功后将恢复目录保存在受控位置,不提交 Git。
## 8. 还需提供的信息
- RDS 内网地址、端口、新库和账号名、所属 VPC;Tair 内网地址、端口、账号、TLS 状态及 VPC。
- DNS A 记录是否完成,DV 证书是否已签发并上传到服务器。
- SSH 登录用户名、端口以及你已配置的密钥连接方式;不要发送密码或私钥。
密码/模型 Key 只由你填写 `.env.cloud` 或管理端。未获得这些信息和服务器访问授权前,本包只能在本机完成构建与配置测试,不能宣称已部署到云服务器。