2.8 KiB
无损替换运行手册
- 以镜像 digest 设置
TROJAN_IMAGE;禁止使用latest。 - 先备份 MariaDB,记录用户数,并保存
docker inspect trojan与 Nginx 配置。 - 在旧容器仍运行时执行
migrate-v1.sh,然后用 18443/18081/18082 完成预演。 - 使用
verify.sh验证管理端、证书、Trojan 监听与公开 443 分享链接。 - 正式切换时停止并重命名旧容器为
trojan-legacy,再以本 compose 启动新容器。 - 任一核心检查失败,立即运行
rollback.sh。保留旧容器至少一个证书续期周期。
Docker 证书自动续期(2026-10-24 修正)
兼容镜像使用 systemctl.py,容器中的 .timer 不会实际调度。必须在
宿主机安装仓库 trojan-stack/scripts/ 下的脚本和 systemd 单元:
install -m 0755 trojan-stack/scripts/renew-certificate-host.py /usr/local/sbin/renew-trojan-certificate-host.py
install -m 0644 trojan-stack/scripts/trojan-certificate-renew.service /etc/systemd/system/
install -m 0644 trojan-stack/scripts/trojan-certificate-renew.timer /etc/systemd/system/
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
systemctl list-timers --all trojan-certificate-renew.timer
journalctl -u trojan-certificate-renew.service -n 80 --no-pager
依赖宿主机 Python 3、OpenSSL、Docker CLI 和真实 systemd。默认操作 trojan
容器,配置与证书必须使用持久化 bind mount。域名与实际证书路径从现有
/usr/local/etc/trojan/config.json 读取,当前实现针对 ECC 证书。
HTTP-01 使用 /var/lib/trojan-acme-webroot,宿主机 Nginx 的
/.well-known/acme-challenge/ 必须转发到现有 127.0.0.1:8082 常驻文件服务。
初次从旧 standalone 配置迁移时先使用 acme.sh --issue --webroot /var/lib/trojan-acme-webroot -d <域名> --keylength ec-256 签发;之后脚本按
到期计划调用 --renew --ecc --webroot,不用 --force。
定时器每天 03:00、15:00(宿主机时区)加 0–30 分钟随机延迟检查,开机后 5 分钟也检查,并补执行关机期间错过的日历任务。脚本使用文件锁防并发; 校验至少 7 天有效期、域名、ECC/RSA 通用公钥匹配,然后部署到配置指定路径。 只有运行中证书指纹与文件不同才重启 Trojan,最后校验运行端口 TLS 信任链、 域名与证书指纹。失败会使 service 返回非零并写入 journal;尚未接入外部通知。
容器内旧 trojan-acme-renew.timer 与旧 acme.sh crontab 应停用,避免未来启动
cron 后出现两套调度。安装宿主机定时器不需要重建或重启整个容器。