反向代理
配置 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;
}串流位置块禁用了缓冲并增加了超时时间。如果不这样配置,大型视频文件可能无法正常串流。
使用 Certbot 获取 Let's Encrypt 证书
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d milmil.example.com故障排除
确保你的代理为 /ws 和 /api/ 路径传递了 Upgrade 和 Connection 头。检查 Nginx 中是否设置了 proxy_http_version 1.1。
为串流端点禁用代理缓冲。在 Nginx 中设置 proxy_buffering off 并增加 proxy_read_timeout。
检查 milmil-api(端口 8080)和 milmil-web(端口 3000)是否都在运行。使用 docker ps 验证。