Docker 绑定域名、反代与 HTTPS

目标：把 Docker 版 danmu_api 从 服务器IP:9321 改成你自己的 域名 访问。

说明：这页前半段通用，后半段二选一：Caddy 或 Nginx。

权限：下面命令默认按 root 写；如果你不是 root，就在需要权限的命令前面加 sudo。

开始前先确认这 4 件事：

• Docker 部署 已经跑通
• 你已经有自己的域名；如果还没有，先去 先准备一个域名
• 你能登录这台 VPS
• 这台 VPS 的 80 和 443 端口没有被防火墙拦住

先回到主服务目录：

cd ~/danmu-api

再打开主服务的 Compose 文件：

nano docker-compose.yml

把原来的：

- "9321:9321"

改成：

- "127.0.0.1:9321:9321"

先回到主服务目录：

cd ~/danmu-api

再重建容器：

docker compose up -d

最后检查端口绑定：

docker compose ps

正常情况下，你应该能看到：

127.0.0.1:9321->9321/tcp

这条 Docker / VPS 路线通常只需要一条 A 记录：子域名指向 VPS 公网 IP。这里不是填云平台给的 CNAME，也不是先改 nameserver。

推荐直接用一个子域名，例如：

api.example.com

大多数 DNS 提供商里，这条记录都可以先按下面这个口径填：

如果你的 DNS 在 Cloudflare，第一次先用 DNS only 灰云。找不到添加记录的位置时，看 云平台绑定域名页里的 Cloudflare 填记录步骤；Docker 这条线的记录值仍然填 VPS 公网 IP。如果不托管 Cloudflare，再看 域名商直接解析。

下一步：查看 Cloudflare 填记录步骤

下面两条路线只走一条：

• 路线 A：Caddy
• 路线 B：Nginx + Certbot

apt update

apt install -y caddy

caddy version

systemctl status caddy --no-pager --lines=0

nano /etc/caddy/Caddyfile

改成下面这样：

api.example.com {
    encode gzip
    reverse_proxy 127.0.0.1:9321
}

这里只需要改 1 个地方：

• api.example.com 换成你自己的完整域名

caddy validate --config /etc/caddy/Caddyfile

systemctl reload caddy

先打开普通页面：

https://你的域名/87654321

再打开管理员页面：

https://你的域名/你的ADMIN_TOKEN

apt update

apt install -y nginx

nginx -v

systemctl status nginx --no-pager --lines=0

nano /etc/nginx/sites-available/danmu-api.conf

改成下面这样：

server {
    server_name 你的域名;

    location / {
        proxy_pass http://127.0.0.1:9321;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

这里只需要改 1 个地方：

• 你的域名 换成你自己的完整域名

ln -s /etc/nginx/sites-available/danmu-api.conf /etc/nginx/sites-enabled/danmu-api.conf

rm -f /etc/nginx/sites-enabled/default

nginx -t

systemctl reload nginx

apt install -y certbot python3-certbot-nginx

certbot --version

certbot --nginx -d 你的域名

如果它问你要不要把 HTTP 自动跳到 HTTPS，直接选“跳转”那一项。

先打开普通页面：

https://你的域名/87654321

再打开管理员页面：

https://你的域名/你的ADMIN_TOKEN

先检查两件事：

• DNS 记录是不是还没生效
• 服务器的 80 和 443 有没有放行

如果当前机器用的是 UFW，可以先执行：

ufw allow 80/tcp

ufw allow 443/tcp

最常见的原因：

• 域名还没真正指到这台 VPS
• 80 / 443 被拦住了
• Cloudflare 一上来就开了代理

第一次做这条线时，Cloudflare 建议先用 DNS only。

回去再看一次：

docker compose ps

确认端口是不是已经变成：

127.0.0.1:9321->9321/tcp

如果你走的是 Caddy：

journalctl -u caddy -n 50 --no-pager

如果你走的是 Nginx：

journalctl -u nginx -n 50 --no-pager

• 域名跑通后，继续看播放器接入
• 后面还想继续改变量，再看 UI 与环境变量
• 想继续调缓存，再看缓存配置

参考来源：Caddy 官方反向代理文档、Caddy Linux service 文档、huangxd-/danmu_api README、Ubuntu 软件源中的 nginx / certbot / python3-certbot-nginx 包信息，以及本次按正文真实命令整理的终端实操图。