26 KiB
北京测试服务器部署手册
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 升级要求见 流式与计费。以下尚未完成:Java 真实 Tripo/Seedance 异步执行、OSS 文件保存、支付充值、分布式任务抢占和可靠重试。
真实供应商没有配置密钥时返回 503,不再返回 Mock 成功。只有明确绑定 provider-mock 的模型可以走 Mock;真实异步供应商返回 501。已有种子目录和价格只是联调数据,实际模型 ID/能力须由供应商控制台核验后修改。
注意更正早期说明:当前登录会话和任务状态保存于 PostgreSQL;Tair 已实现的是按 Key 限流、按 API Key 并发租约、按上游分组并发租约,不是已完成的 MQ、幂等或异步调度平台。不需要现在购买 MQ。
2. 你需要在阿里云完成的配置
网络互通,先确认对旧系统的影响
- 确认新服务器、RDS、Tair 在同一阿里云账号和北京地域。
- 轻量控制台的“内网互通”中关联 RDS/Tair 所属 VPC;如属于不同 VPC,分别设置。
- 首次在该地域开通内网互通可能导致该地域所有轻量服务器停机约 1 分钟,包括现有小程序服务器。先检查是否已开通,在维护时间执行,不要为本项目随意取消旧连接。
- 开通后重新核对新服务器私网 IP,把它以
/32加入 RDS、Tair 的新增白名单分组moyi-test。保留旧系统的白名单,不要覆盖或放行0.0.0.0/0。 - 不要为了连接方便给 RDS/Tair 开公网地址;同地域不等于已内网互通。
依据:阿里云轻量内网互通。
防火墙和网段
- 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 官方说明
- 当前服务器在
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 身份认证。阿里云防火墙说明
每位成员先在自己的电脑执行 ssh-keygen -t ed25519,设置私钥口令;已有密钥时不要覆盖。只把 .pub 文件内容交给管理员,私钥留在个人电脑。
服务器上逐位成员创建账号和公钥。以下示例仅针对新账号,账号名替换为真实值;若账号已存在,先检查其权限,不要覆盖已有公钥文件:
# 使用当前已验证的管理员会话执行;先不要关闭当前窗口
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
在文件中粘贴该成员完整的公钥,单个公钥占一行,保存退出,再执行:
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 添加以下配置;文件已存在时先读取并合并,不覆盖其他用途的配置:
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 配置说明
全部检查通过后执行 sudo systemctl reload ssh,再开新窗口验证密钥登录及 sudo,成功后才关闭旧会话、放宽防火墙来源。保留阿里云控制台救援入口。成员退出项目时撤销其公钥和账号访问,必要时结束已有会话;不要影响其他成员。22 对公网开放会收到扫描,需维护系统安全更新、查看登录日志,可补充 fail2ban;长期再迁移到 VPN/堡垒机白名单。
当前部署节点:先检查,再安装
以下命令在目标 MOYI 服务器的远程终端执行,不是在 Windows PowerShell 执行。只读取状态,不安装软件、不调整 SSH、不修改路由:
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
- 在现有 RDS 实例创建专用数据库
moyi_control和专用账号moyi_app,不在小程序库里直接添加本项目的表。 - 确保
moyi_app在这个库中有连接、建表、建索引和读写权限。PG15 中需确认publicschema 的 CREATE 权限或让该账号拥有新库;不能只授予 SELECT/INSERT。 - 新数据库第一次启动由 Flyway 自动建表。配置关闭自动 baseline,非空未受 Flyway 管理的库会拒绝迁移,不要为绕过错误而启用 baseline。
- 数据库修改前创建 RDS 备份,并核对可恢复性;不调整原系统账号、权限或数据库。
- 提供内网地址、实际端口、库名和账号。密码只填写服务器
.env.cloud。若启用数据库 TLS,按 RDS 配置 JDBC 参数及 CA 校验,不默认假设端口/TLS。
Tair 标准架构
- 新建本项目专用账号,保留旧系统账号与密码。不要重置共享实例的默认密码。
- 使用内网地址、标准架构连接,按实例实际情况填写 TLS、端口、账号和密码。
- 无需创建表。使用
moyi:test:前缀;支持 ACL Key 规则时,限制为此命名空间。可使用受支持的独立逻辑 DB,但它不等于独立实例或资源隔离。 - 网关需要 PING、Lua 脚本执行以及 INCR、PTTL、PEXPIRE、TIME、ZADD、ZCARD、ZREM、ZREMRANGEBYSCORE 等操作。只读账号不够。预检查仅验证 TCP,应用就绪检查再验证连接与鉴权,Mock 模型调用才验证真实 Lua 权限。
- 不要执行 FLUSHDB、FLUSHALL,不要修改共享实例的全局配置。 共享实例的内存、CPU、驱逐策略仍共享,测试流量要有限额。
域名和 DV 证书
- 在
soulofmodel.com的当前 DNS 托管处添加 A 记录:主机记录moyi,值39.96.90.106,TTL 默认 10 分钟。不修改www、@、MX 或 DNS 服务器。 - 申请覆盖
moyi.soulofmodel.com的单域名 DV 证书即可。DV 满足当前企业测试的 HTTPS 需求,OV/EV 主要增加组织身份核验,不是当前必需项。阿里云选型说明 - 使用证书控制台给出的 DNS 验证记录,不删除原业务验证记录;下载 Nginx 格式证书。
- 将包含完整链的 PEM 和对应私钥放到服务器
infra/moyi/certs/fullchain.pem、privkey.pem,私钥权限 600。不要发到聊天或 Git。 - 现有域名已备案并接入阿里云时,子域名通常无需单独备案;仍需核对主体、服务内容和页面备案信息。备案不是模型供应商授权或 AI 服务合规的替代。子域名备案说明
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 上传到服务器同一目录。下面操作在服务器执行;<版本> 替换成实际文件名中的版本:
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 隧道内部测试
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):
ssh -N -L 8080:127.0.0.1:8080 SSH用户名@39.96.90.106
浏览器访问 http://localhost:8080。无需开放公网 8080,登录流量通过 SSH 加密。若电脑 8080 已占用,应同时调整配置中的本地端口和 CORS,或选择另一个转发端口后同步 CORS。
B. 域名和证书就绪:HTTPS 测试
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. 查看状态、测试与排障
sudo python3 deploy.py status
sudo python3 deploy.py logs
sudo python3 deploy.py smoke
sudo python3 deploy.py stop
成功启动后会保存模式,后续命令默认沿用;第一次启动失败时请显式带 --mode。stop 只停止容器,不删数据库、缓存或镜像。
验收顺序:
- 登录与退出、刷新恢复会话;管理员创建邀请码,普通用户注册。
- 创建个人/项目 Key,编辑模型权限,禁用 Key 后访问被拒绝。
- 用明确标记 Mock 的文本模型检查 Tair Lua 限流和并发,再配置一个真实同步供应商、小额验证请求与响应。
- 查看调用记录输入输出、错误、按 Key 筛选及导出;测试数据也可能含个人信息,仅管理员可访问,注意日志留存与脱敏。
- Java 流式调用仍返回 501;真实 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,不是服务器配置不足。
7. 证书更新、升级与回退
本包提供有效期检查及安全重载,不自动购买、签发或续期证书。开启阿里云证书到期通知,续签后替换服务器 certs/fullchain.pem、privkey.pem,执行:
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 版本升级角色功能
- 先为
moyi_control确认可恢复备份。该库与其他业务库共用 RDS,回退不能恢复整个共享实例覆盖其他系统。 - 校验新压缩包 SHA256,解压到新的版本目录;在新目录运行
python3 deploy.py verify。 - 将旧版本的
.env.cloud和certs/fullchain.pem、certs/privkey.pem安全复制到新目录。保留原文件,配置和私钥权限为600、证书目录为700;不要重新运行init。 - 只把新目录
.env.cloud的MOYI_IMAGE_TAG改为新发布清单中的release值。保留ADMIN_ACCOUNT、所有密码、Pepper、加密密钥、Compose 项目名、已验证的镜像源和网络配置。 - 在新目录执行
python3 deploy.py check --mode https --network,核对目标确实是moyi_control后执行python3 deploy.py up --mode https --accept-migrations。 - 执行
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,避免改动已有发布包的校验文件。
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 中单独执行,隐藏输入两次新密码。没有密码最低长度要求,拒绝空白、控制字符、开发默认密码和部署配置占位符。脚本会:
- 核对唯一活跃超级管理员、目标库、账号占用、运行容器的发布目录与数据库/加密配置。
- 保存修改前后的环境配置,调用 Compose 验证只有管理员账号和密码发生变化。
- 短暂停止后端,将当前专用数据库导出到
/opt/moyi/backups/owner-reset-*,保留环境密钥;备份和配置仅 root 可读。 - 在同一数据库事务中修改原账号及 PBKDF2 哈希、撤销该账号旧会话、记录审计,不新建用户、不改变用户 ID、角色、显示名称或业务关联。
- 原子替换环境文件,使用现有镜像重建后端,重载容器 Nginx 并验证新超级管理员登录。账号匹配不区分大小写,数据库内使用小写规范形式。
执行前应暂停平台测试,维护期间不要并行修改 .env.cloud、发布或启动其他后端实例。密码只在服务器输入,不写进源码、发布包、Shell 历史。工具不会重新构建镜像或修改数据库迁移文件。
若数据库修改前失败,工具尝试启动原后端;若数据库事务已尝试提交后失败,不自动还原数据库或旧配置,以免状态不一致。保留工具输出的私有恢复目录,使用相同账号和密码重跑工具完成配置同步及验收。不要盲目恢复整个共享 RDS 实例、切回旧版程序或旧环境配置。成功后将恢复目录保存在受控位置,不提交 Git。
8. 还需提供的信息
- RDS 内网地址、端口、新库和账号名、所属 VPC;Tair 内网地址、端口、账号、TLS 状态及 VPC。
- DNS A 记录是否完成,DV 证书是否已签发并上传到服务器。
- SSH 登录用户名、端口以及你已配置的密钥连接方式;不要发送密码或私钥。
密码/模型 Key 只由你填写 .env.cloud 或管理端。未获得这些信息和服务器访问授权前,本包只能在本机完成构建与配置测试,不能宣称已部署到云服务器。