Files
trojanZ/迁移实施记录-2026-07-26.md
T

19 KiB
Raw Blame History

Trojan、Nginx、Caddy 与 Gitea 迁移实施记录

实施日期:2026-07-26

1. 服务器与域名

服务器 Trojan 与管理后台 Gitea 宿主机 SSH Git SSH
43.154.35.111 www.hk.chermack.top git.hk.chermack.top 22 2222
43.159.139.193 www.us.chermack.top git.us.chermack.top 22 2222

2. 最终架构

flowchart LR
  U[客户端] -->|HTTP :80| N[Nginx]
  U -->|HTTPS :443 / SNI| N
  N -->|www.* HTTP| W[Trojan 管理后台 :8081]
  N -->|www.* TLS 透传| T[Trojan :8443]
  T -->|非 Trojan 流量回落| W
  N -->|git.* HTTP| C1[Caddy :8080]
  N -->|git.* TLS 透传| C2[Caddy :9443]
  C1 --> G[Gitea :3000]
  C2 --> G
  U -->|Git SSH :2222| G

公网 80/443 只由宿主机 Nginx 监听。Trojan 客户端和 Trojan 管理后台继续共用 www.* 域名,不新增 panel 域名:Nginx 将 www.* 的 TLS 按 SNI 透传到 Trojan;Trojan 对非 Trojan TLS 流量回落到本机管理后台。

3. 迁移前备份与检查

在变更前检查原容器和配置:

docker ps
docker inspect trojan
docker exec trojan cat /usr/local/etc/trojan/config.json
docker exec trojan systemctl cat trojan-web.service

已创建的备份目录:

/root/trojan-gitea-migration-backup-20260726-004630  # 香港
/root/trojan-gitea-migration-backup-20260726-014435  # 美国
/root/gitea-pre-reset-20260726-012207                # 香港 Gitea 重置前

香港服务器另保留了迁移前 Trojan 镜像快照。

4. Trojan 端口调整

容器内 Trojan 配置调整为:

{
  "local_port": 8443,
  "remote_port": 8081
}

管理后台 systemd unit 调整为:

ExecStart=/usr/local/bin/trojan web --host 127.0.0.1 --port 8081

重载和启动命令:

docker exec trojan systemctl daemon-reload
docker exec trojan systemctl enable trojan-web
docker exec trojan systemctl restart trojan
docker exec trojan systemctl restart trojan-web

预期监听:Trojan 为 0.0.0.0:8443,管理后台为 127.0.0.1:8081。这两个端口不应对公网开放。

5. Nginx 统一入口

安装并启用:

apt-get update
apt-get install -y nginx libnginx-mod-stream
systemctl enable --now nginx
nginx -t

443 使用 stream 和 ssl_preread 按 SNI 分流。香港示例(美国替换为 www.us.chermack.top 与 git.us.chermack.top):

map $ssl_preread_server_name $tls_backend {
    www.hk.chermack.top  127.0.0.1:8443;
    git.hk.chermack.top  127.0.0.1:9443;
    default              127.0.0.1:8443;
}
server {
    listen 443;
    proxy_pass $tls_backend;
    ssl_preread on;
}

80 的 www.* 虚拟主机反向代理到 127.0.0.1:8081,并将 /.well-known/acme-challenge/ 转发到 127.0.0.1:8082;git.* 反向代理到 Caddy 127.0.0.1:8080。

每次配置改动后:

nginx -t && systemctl reload nginx

6. Gitea 与 Caddy

/opt/gitea 使用 Docker Compose 运行:

  • Gitea 1.27.0:127.0.0.1:3000->3000,2222->22;
  • PostgreSQL 16:仅 Docker 内网;
  • Caddy:127.0.0.1:8080->80、127.0.0.1:9443->443,反向代理到 Gitea。
cd /opt/gitea
docker compose up -d
docker compose ps

Caddy 管理 git.* 的 HTTPS 证书和自动续期;Nginx 对 Git 的 443 流量仅做 TLS 透传。Gitea 初始化时应填写:

ROOT_URL: https://git.<地区>.chermack.top/
SSH 域名: git.<地区>.chermack.top
SSH 端口: 2222

香港 Gitea 曾按授权清空数据并重新初始化;再次重置前必须先备份 /opt/gitea/gitea 和 /opt/gitea/postgres。

7. 美国服务器 SSH 端口处理

美国服务器原 OpenSSH 监听 22、2222、2223,与 Gitea Git SSH 的 2222 冲突。已保留宿主机 SSH 22,移除宿主机的 2222/2223 监听,并将 2222 留给 Gitea。

变更前备份:

/etc/ssh/sshd_config.pre-gitea-20260726-014417

安全操作:

sshd -t
systemctl reload ssh
ss -ltnp | grep sshd

修改 SSH 配置时必须保持一条现有的 22 端口会话,验证完成后再断开。

8. Trojan 证书续期

Trojan 的 www.* 证书由容器内 acme.sh 管理;Caddy 管理 git.* 和后续增加的 minio.*。2026-10-24 已修正续期:宿主机真实 systemd 调度,使用现有 8082 文件服务完成 webroot 验证。原 standalone 方案与该常驻服务冲突,已废弃。完整过程见第 16 节。

docker exec trojan /root/.acme.sh/acme.sh --issue \
  --server letsencrypt --webroot /var/lib/trojan-acme-webroot \
  -d www.hk.chermack.top --keylength ec-256
docker exec trojan systemctl restart trojan

美国服务器替换为 www.us.chermack.top。上面的 --issue 用于初次签发或迁移验证方式;常规检查使用宿主机 trojan-certificate-renew.service 调用 --renew --ecc --webroot,按 acme.sh 的续期时间执行,避免频繁强制签发。不要依赖容器内的 .timer 或未运行的 cron。

9. 重启后不可用:原因与永久修复

现象

香港服务器重启后,Nginx、Trojan 容器、Gitea、Caddy 都自动启动,但:

docker exec trojan systemctl is-active trojan       # inactive
docker exec trojan systemctl is-active trojan-web   # inactive

此时没有 8443 和 8081 监听,因此 www.hk.chermack.top 不可用。

临时恢复

docker exec trojan systemctl start trojan
docker exec trojan systemctl start trojan-web
ss -ltnp | grep -E ':(8443|8081)'

永久兜底

容器内 unit 虽为 enabled,但容器启动时没有拉起服务。因此在香港宿主机新增并启用:/etc/systemd/system/trojan-container-services.service。

[Unit]
Description=Start Trojan services inside the trojan container
Requires=docker.service
After=docker.service network-online.target
Wants=network-online.target

[Service]
Type=oneshot
ExecStart=/usr/bin/docker exec trojan /bin/systemctl start trojan.service
ExecStartPost=/usr/bin/docker exec trojan /bin/systemctl start trojan-web.service
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

启用并验证:

systemctl daemon-reload
systemctl enable trojan-container-services.service
systemctl start trojan-container-services.service
systemctl is-enabled trojan-container-services.service
systemctl is-active trojan-container-services.service
docker exec trojan systemctl is-active trojan trojan-web

本次已验证该兜底服务为 enabled、active;Trojan 和 trojan-web 均为 active,且外部 HTTPS 访问 https://www.hk.chermack.top/ 成功。

美国服务器也已部署同名的宿主机兜底 unit,并完成验证:trojan-container-services.service 为 enabled、active;Trojan 监听 0.0.0.0:8443,管理后台监听 127.0.0.1:8081;https://www.us.chermack.top/ 与 https://git.us.chermack.top/ 外部访问均成功。

10. 日常检查与故障排查

# 统一入口、监听与容器
nginx -t
ss -ltnp | grep -E ':(80|443|8080|8081|8443|9443|2222)'
docker ps

# Trojan 及后台
docker exec trojan systemctl is-active trojan
docker exec trojan systemctl is-active trojan-web

# Web 链路
curl -kI https://www.hk.chermack.top/
curl -kI https://git.hk.chermack.top/
curl -kI https://www.us.chermack.top/
curl -kI https://git.us.chermack.top/

www.* 不可访问时,先检查 trojan-web 和 8081;Trojan 客户端也异常时,再检查 trojan 和 8443:

docker exec trojan systemctl restart trojan
docker exec trojan systemctl restart trojan-web
docker exec trojan journalctl -u trojan -u trojan-web --no-pager -n 200
docker logs --tail 200 trojan

11. 美国服务器 Gitea 初始化记录

初始化页面曾提示数据库密码无效。服务器内核验结果如下:

  • gitea 容器的 GITEA__database__* 与 gitea-db 容器的 POSTGRES_* 用户、数据库和密码完全一致;
  • 使用 Gitea 容器实际注入的密码连接 PostgreSQL 成功;
  • /data/gitea/conf/app.ini 中落盘的密码也与 PostgreSQL 一致;
  • 初始化页面已预填密码,错误由浏览器密码管理器覆盖表单密码或提交了其他密码造成,不是数据库密码失效。

为避免表单再次覆盖,已通过 Gitea CLI 使用明确配置文件完成初始化:

gitea --work-path /data/gitea \
  --config /data/gitea/conf/app.ini migrate

随后创建临时管理员 admin,具备管理员权限并设置为首次登录必须修改密码;INSTALL_LOCK 已设为 true。随机初始密码只保存在美国服务器:

/root/gitea-initial-admin.txt

文件权限为 0600 root:root。登录并修改密码后应删除该凭据文件。

初始化前备份目录:

/root/gitea-us-pre-init-20260726-041434

最终验证结果:数据库中存在一个管理员且 must_change_password=true,Gitea 日志无初始化错误,https://git.us.chermack.top/user/login 从服务器内外访问均成功。

12. 美国管理后台周期性退出的根因(2026-07-26)

故障现象:https://www.us.chermack.top/ 失效,Nginx 80/443 和 Trojan 8443 正常,但 trojan-web 为 failed,127.0.0.1:8081 无监听。

现场排查排除了磁盘耗尽、内存 OOM、Docker 容器重启、Nginx/Caddy 和本次 ACME 定时任务。关键证据:

宿主机 cgroup:cgroup2fs
容器基础系统:CentOS 7 / systemd 219
容器 systemctl:systemctl.py 1.5.7113(Python 替代实现)
容器启动日志:Failed to allocate manager object, freezing
容器内状态:多个 trojan/web 僵尸进程,无 journal 日志

当前镜像的 PID 1 systemd 无法在宿主机 cgroup v2 环境中正常建立 manager;/usr/bin/systemctl 实际是一次性 Python 替代脚本,不是持续运行的服务管理器。因此 unit 中的 Restart=on-failure 不能可靠监督进程。宿主机现有 trojan-container-services.service 也是 Type=oneshot,只在开机时执行一次启动,运行中 Web 退出后不会再次拉起。

以前台方式直接运行以下命令持续 15 秒无异常,证明 Go Web 程序、数据库和 8081 端口本身健康:

docker exec trojan /usr/local/bin/trojan web \
  --host 127.0.0.1 --port 8081

探针启动的进程随后继续运行,8081、本地 /auth/check 和公网 HTTPS 均恢复 200;但替代 systemctl 仍错误显示 failed,再次证明问题位于服务管理层。

临时永久化建议:由宿主机真实 systemd 使用前台 docker exec 直接监督 trojan-web(以及 Trojan core),设置 Restart=always 并将 stdout/stderr 写入宿主机 journal。最终解决方案是使用已规划的新镜像,移除 CentOS 7、冻结的容器 systemd 和运行时下载的 systemctl.py。

13. 后续维护事项

  1. 两台服务器的 trojan-mariadb 仍将 3306 映射到公网;为避免额外中断,迁移中未改动。确认无外部依赖后,应限制为 127.0.0.1:3306 或移除映射。
  2. www.* 与 git.* 使用不同的证书管理者:前者为 Trojan 容器内 acme.sh,后者为 Caddy。
  3. 两台服务器均已部署 trojan-container-services.service。重启服务器后,优先检查该服务及容器内两个 Trojan 服务状态。

16. 香港证书过期恢复与两节点自动续期修复(2026-10-24)

本节时间除标注 UTC 外均为北京时间。操作范围为香港 43.154.35.111 和美国 43.159.139.193 的 Trojan 证书与调度;未调整用户、数据库、业务域名、端口或代理分流架构。

16.1 现场证据与原因

香港 www.hk.chermack.top 旧证书于 2026-10-23 23:56:30 到期。美国 www.us.chermack.top 旧证书原定 2026-10-24 04:45:53 到期,检查时尚有约三小时,因此同批提前恢复。两台的源证书和运行中证书均仍为 7 月签发;acme.sh 记录的续期时间分别为 9 月 22 日和 9 月 24 日,未成功执行。

两节点问题相同:

  1. trojan-manager-compat:2.0.3-hk/us 使用 systemctl.py,PID 1 实际为 tail,容器内没有真实 systemd 定时调度。trojan-acme-renew.timer 虽 enabled,但状态为 dead;旧 acme.sh crontab 存在,cron 守护进程未运行。
  2. 域名配置仍是 Le_Webroot='no' 的 standalone 验证。8082 已由 trojan acme-http 常驻服务监听,不能再启动 standalone 监听同一端口。
  3. 旧脚本用 openssl rsa -modulus 校验 ECC 私钥,并将证书复制到 /etc/trojan/certs/;实际 Trojan 配置直接读取 /root/.acme.sh/<域名>_ecc/fullchain.cer 和对应私钥。

Git 与 MinIO 的 Caddy 续期正常,检查时证书已更新至 12 月到期。本次不调整 Caddy。

16.2 备份与紧急恢复

操作前以 root 专用目录(0700)备份完整 ACME 状态、原 Trojan 配置及旧维护脚本:

香港:/opt/trojan/backups/certificate-renewal-20261023T175520Z
美国:/opt/trojan/backups/certificate-renewal-20261023T175606Z

acme-before.tar.gz       # 包含账户与私钥,不得上传到 Git 或公开分享
config-before.json
renew-before
compat-init-before
crontab-before.txt

确认 Nginx 的 /.well-known/acme-challenge/ 指向 127.0.0.1:8082,并在 /var/lib/trojan-acme-webroot/.well-known/acme-challenge/ 写入临时验证文件,经域名 HTTP 访问成功;测试文件已删除。

随后分别执行(美国替换域名):

docker exec trojan /root/.acme.sh/acme.sh --issue \
  --home /root/.acme.sh --server letsencrypt \
  -d www.hk.chermack.top \
  --webroot /var/lib/trojan-acme-webroot --keylength ec-256
docker exec trojan systemctl restart trojan

两次 HTTP-01 验证与签发均成功,配置已保存 Le_Webroot='/var/lib/trojan-acme-webroot'。仅重启 Trojan 核心加载证书,现有连接可能短暂重连;没有重启整个 Docker 容器、管理后台或数据库。

节点 新证书到期时间(北京时间) 新证书序列号
香港 2027-01-22 00:57:01 051911FACC1E378D646BE88B9CDD34A1F19E
美国 2027-01-22 00:57:47 06ECC2E3EBF581485D09EE5BEFB941C1FF72

16.3 自动续期的持久化部署

仓库新增文件及宿主机安装位置:

仓库文件(trojan-stack/scripts/ 下) 两台宿主机安装位置
renew-certificate-host.py /usr/local/sbin/renew-trojan-certificate-host.py
trojan-certificate-renew.service /etc/systemd/system/trojan-certificate-renew.service
trojan-certificate-renew.timer /etc/systemd/system/trojan-certificate-renew.timer

部署副本保留在 /opt/trojan/renewal-tools/。依赖宿主机已有的 Python 3、OpenSSL、Docker CLI 和真实 systemd,没有增加容器或替换镜像。

脚本从容器绑定目录映射和实际 config.json 读取域名、证书路径及 TLS 端口;文件锁防止并发,单次最长受 service 的 20 分钟超时约束。检查流程为:

  1. 读取正在运行的 TLS 证书指纹,启动/确认现有 ACME 文件服务。
  2. 执行 acme.sh --renew --ecc --webroot /var/lib/trojan-acme-webroot;未到续期时间的返回码 2 按正常跳过处理。
  3. 检查证书至少还有七天有效期、域名和证书/私钥公钥匹配,兼容 ECC 校验。
  4. 若需要部署,写入配置实际引用的持久化路径;私钥权限设为 0600。
  5. 运行中证书与源文件指纹不同时才重启核心,并验证实际 TLS 信任链、域名与指纹;失败返回非零,写入 journal。

定时器在宿主机时区每日 03:00、15:00 加 0–30 分钟随机延迟检查;开机五分钟后也检查,并通过 Persistent=true 补执行错过的日历任务。两台当前宿主机时区均为 CST(UTC+8)。启用命令:

systemd-analyze verify /etc/systemd/system/trojan-certificate-renew.service \
  /etc/systemd/system/trojan-certificate-renew.timer
systemctl daemon-reload
systemctl enable --now trojan-certificate-renew.timer
systemctl start trojan-certificate-renew.service

已禁用旧容器 timer,并备份后移除旧 acme.sh cron 行,保留其他 cron 内容。systemctl.py 不支持停止 timer,但它原本没有活动调度进程;已确认旧 timer 为 disabled。仓库和运行容器中的 compat-init 已去掉对旧 timer 的启用,旧 renew-trojan-certificate 维护脚本也已修正为 webroot、通用公钥匹配和实际配置路径。

宿主机单元不随容器重启消失;将来重建容器仍需保留现有 bind mount、8082 ACME 服务和 Nginx 验证路由,并使用包含修正脚本的新镜像或重新同步维护脚本。现有镜像标签未重新构建。

16.4 验证结果与运维

  • 两机真实宿主机 timer 均为 enabled、active (waiting);service 首次执行均为 Result=success、ExecMainStatus=0。
  • 实际签发完成后再次由 service 检查,均正常跳过未到期续签,TLS 指纹检查成功,没有重复重启核心。
  • 本机经公网访问两个 www.*:均 HTTP 200、TLS 校验为 0;服务器经 Nginx 443/SNI 路由回归检查也均通过。
  • 两个 Git 域名均为 HTTP 200;MinIO 匿名 S3 根路径为预期 403、TLS 校验为 0;相关容器仍健康。
  • 验证覆盖 HTTP-01 真正签发、实际证书加载、调度执行及 HTTPS 路由;未使用用户代理凭据进行完整 Trojan 隧道流量测试,未为验证而重启整台服务器。

日常检查:

systemctl list-timers --all trojan-certificate-renew.timer
systemctl show trojan-certificate-renew.service -p Result -p ExecMainStatus
journalctl -u trojan-certificate-renew.service --since '7 days ago' --no-pager
systemctl start trojan-certificate-renew.service

# 美国将域名替换为 www.us.chermack.top
openssl s_client -connect 127.0.0.1:443 -servername www.hk.chermack.top \
  </dev/null 2>/dev/null | openssl x509 -noout -dates -serial

当前已提供失败退出状态和持久日志,尚未配置邮件或聊天通知。acme.sh 当前下次续期计划为香港 2026-12-21T17:55:35Z、美国 2026-12-23T07:28:12Z,之后由各自 ACME 客户端按 CA 建议更新。

16.5 回滚与故障恢复

若新调度脚本出现问题,先暂停宿主机 timer,保留已经恢复的新证书:

systemctl disable --now trojan-certificate-renew.timer
journalctl -u trojan-certificate-renew.service -n 100 --no-pager

修正脚本后重新安装并执行 systemctl start trojan-certificate-renew.service,验证成功再 systemctl enable --now trojan-certificate-renew.timer。暂停期间没有自动续期,应及时恢复。

原脚本、cron、配置和 ACME 状态均可在上述备份目录取回;不要直接恢复旧 ACME 压缩包中的过期证书到生产路径。恢复旧配置前应先核对证书路径和有效期。本次业务配置与数据未改变,不需要回滚数据库、Nginx 或 Caddy。