# 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. 最终架构 ```mermaid 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. 迁移前备份与检查 在变更前检查原容器和配置: ```bash docker ps docker inspect trojan docker exec trojan cat /usr/local/etc/trojan/config.json docker exec trojan systemctl cat trojan-web.service ``` 已创建的备份目录: ```text /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 配置调整为: ```json { "local_port": 8443, "remote_port": 8081 } ``` 管理后台 systemd unit 调整为: ```ini ExecStart=/usr/local/bin/trojan web --host 127.0.0.1 --port 8081 ``` 重载和启动命令: ```bash 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 统一入口 安装并启用: ```bash 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`): ```nginx 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`。 每次配置改动后: ```bash 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。 ```bash cd /opt/gitea docker compose up -d docker compose ps ``` Caddy 管理 `git.*` 的 HTTPS 证书和自动续期;Nginx 对 Git 的 443 流量仅做 TLS 透传。Gitea 初始化时应填写: ```text 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。 变更前备份: ```text /etc/ssh/sshd_config.pre-gitea-20260726-014417 ``` 安全操作: ```bash 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 节。 ```bash 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 都自动启动,但: ```bash docker exec trojan systemctl is-active trojan # inactive docker exec trojan systemctl is-active trojan-web # inactive ``` 此时没有 `8443` 和 `8081` 监听,因此 `www.hk.chermack.top` 不可用。 ### 临时恢复 ```bash 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`。 ```ini [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 ``` 启用并验证: ```bash 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. 日常检查与故障排查 ```bash # 统一入口、监听与容器 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`: ```bash 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 使用明确配置文件完成初始化: ```bash gitea --work-path /data/gitea \ --config /data/gitea/conf/app.ini migrate ``` 随后创建临时管理员 `admin`,具备管理员权限并设置为首次登录必须修改密码;`INSTALL_LOCK` 已设为 `true`。随机初始密码只保存在美国服务器: ```text /root/gitea-initial-admin.txt ``` 文件权限为 `0600 root:root`。登录并修改密码后应删除该凭据文件。 初始化前备份目录: ```text /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 定时任务。关键证据: ```text 宿主机 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 端口本身健康: ```bash 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 配置及旧维护脚本: ```text 香港:/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 访问成功;测试文件已删除。 随后分别执行(美国替换域名): ```bash 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)。启用命令: ```bash 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 隧道流量测试,未为验证而重启整台服务器。 日常检查: ```bash 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 | openssl x509 -noout -dates -serial ``` 当前已提供失败退出状态和持久日志,尚未配置邮件或聊天通知。acme.sh 当前下次续期计划为香港 `2026-12-21T17:55:35Z`、美国 `2026-12-23T07:28:12Z`,之后由各自 ACME 客户端按 CA 建议更新。 ### 16.5 回滚与故障恢复 若新调度脚本出现问题,先暂停宿主机 timer,保留已经恢复的新证书: ```bash 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。