反向代理（Nginx/Caddy）

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

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

另外，如果你遇到「打开页面被跳到 http://localhost/login?ReturnUrl=%2F」这种情况，说明反代没有把正确的 Host/Proto 透传给上游应用。

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_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
  }
}

Caddy 示例

example.com {
  reverse_proxy 127.0.0.1:5000
}

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

宝塔面板（BT）反向代理要点

• 反代目标：http://127.0.0.1:5000
• 需要透传：Host + X-Forwarded-Host + X-Forwarded-Proto（否则可能跳到 localhost）

如果你要启用 Bot Webhook，还需要确保 Webhook 路径可外网访问：见 Bot Webhook。