Telegram-Panel/docs/reverse-proxy.md

反向代理（Nginx/Caddy）

Telegram Panel 是 Blazor Server，需要 WebSocket（/_blazor）。

如果你反代后出现页面卡住/断开/一直重连，九成是 WebSocket 没配对。

Nginx（HTTP）示例

注意：请确保你的上游是 http://127.0.0.1:5000（对应 docker-compose.yml 暴露端口）。

server {
  listen 80;
  server_name example.com;

  location / {
    proxy_pass http://127.0.0.1:5000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header Host $host;

    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
  }
}

Caddy 示例

example.com {
  reverse_proxy 127.0.0.1:5000
}

如果你使用了 CDN/面板（例如 Cloudflare），也要确认它对 WebSocket 的支持与超时设置。