milmilmilmil

反向代理

設定 Nginx、Caddy 或 Traefik 作為 milmil 的反向代理。

反向代理是 HTTPS 的必要條件，也是正式環境部署的推薦配置。milmil 使用 WebSocket 連線來實現即時功能（彈幕、通知），因此你的代理必須支援 WebSocket 升級。

Nginx

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

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

    # 前端
    location / {
        proxy_pass http://127.0.0.1:3000;
        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;
    }

    # API + WebSocket
    location /api/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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 端點
    location /ws {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 串流 — 增加逾時時間並停用緩衝
    location /api/v1/stream/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_buffering off;
        proxy_request_buffering off;
        client_max_body_size 0;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }
}

# HTTP 導向 HTTPS
server {
    listen 80;
    server_name milmil.example.com;
    return 301 https://$host$request_uri;
}

串流的 location 區塊會停用緩衝並增加逾時時間。如未設定，大型影片檔案可能無法正常串流。

使用 Certbot 取得 Let's Encrypt 憑證

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d milmil.example.com

疑難排解

本頁內容

Nginx使用 Certbot 取得 Let's Encrypt 憑證CaddyTraefik疑難排解