StudyDiary-20261009/60-Imports/64-AI/Nginx 反向代理配置.md

Nginx 反向代理配置

Nginx 反向代理配置

前提说明

1. 假设域名：

• abs.example.com → 代理 Audiobookshelf (ABS)，容器内部端口 80，宿主机端口 13378

• ting.example.com → 代理 Ting‑Reader，容器内部端口 3000，宿主机端口 3000

2. 使用 certbot 获取 SSL 证书；证书路径 /etc/letsencrypt/live/你的域名/

3. Nginx 与 docker 服务在同一台机器，后端地址写 127.0.0.1:端口；不在同一台则替换为对应内网 IP。

4. 两个服务都需要websocket 支持，否则网页端实时状态、播放进度同步会异常。

1）Audiobookshelf (abs.example.com) nginx 配置

server {
    listen 80;
    server_name abs.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name abs.example.com;

    ssl_certificate     /etc/letsencrypt/live/abs.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/abs.example.com/privkey.pem;

    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;

    # WebSocket 关键配置，ABS必须
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    location / {
        proxy_pass http://127.0.0.1:13378;
        proxy_buffering off;
        client_max_body_size 100M;
    }
}

2）Ting‑Reader (ting.example.com) nginx 配置

server {
    listen 80;
    server_name ting.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name ting.example.com;

    ssl_certificate     /etc/letsencrypt/live/ting.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/ting.example.com/privkey.pem;

    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;

    # Ting‑Reader 同样需要WebSocket
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_buffering off;
        client_max_body_size 100M;
    }
}

单域名子路径模式（不推荐，简单给示例）

不建议子路径部署（如 https://xxx.com/abs、https://xxx.com/ting），两个程序对子路径兼容都一般，容易出现静态资源、websocket 异常。优先用子域名。

使用步骤

1. 将配置写入 nginx sites‑available 下，软链接到 sites‑enabled

2. 检查配置语法：

nginx -t

3. 重载 nginx

systemctl reload nginx

重要踩坑提示

1. 容器绑定地址：docker 端口映射必须是 0.0.0.0:xxxx:xxxx，不要只绑定 [127.0.0.1](127.0.0.1)（如果你 nginx 不在本机）。

2. 不要直接把容器端口暴露公网，全部走 nginx 443 HTTPS。

3. ABS 第三方客户端（希声 Still、AudioBooth 等）填写地址时直接填完整 https://abs.example.com，不要带端口。

4. Ting‑Reader 网页 / PWA 访问也直接用 https://ting.example.com。

5. 如果你使用 Nginx Proxy Manager (NPM)，不需要手写上面配置，网页界面填后端地址，开启 Websocket 开关即可。

NPM（Nginx Proxy Manager）界面填写要点

• ABS：Forward Hostname/IP 127.0.0.1，Port 13378，勾选 WebSockets Support

• Ting‑Reader：Forward Hostname/IP 127.0.0.1，Port 3000，勾选 WebSockets Support

• 申请 SSL 证书，强制 HTTPS。

如果你需要，我可以顺带给一份两者的 Caddy v2 配置（更简单，自动 https）。

（注：部分内容可能由 AI 生成）