启用NGINX转发后code-server登录后显示空白问题求助

1. 协议不匹配导致资源加载失败 #

code-server容器的8443端口默认运行HTTPS服务，但你在NGINX Proxy Manager中配置的转发协议是HTTP，这种协议不匹配会导致登录后静态资源、WebSocket连接无法正常建立，最终显示空白页。

修复步骤：

• 打开NGINX Proxy Manager的主机转发配置页面
• 将协议从HTTP修改为HTTPS
• 在SSL选项卡选择None（本地域名无需公网SSL证书，若需要可生成自签名证书）

2. 确保code-server的代理域名配置正确 #

你的code-server环境变量中PROXY_DOMAIN=${DOMAIN}需要指向你的本地域名code-server.gabriel，否则code-server会生成错误的资源路径。

检查与修复：

• 查看你的.env文件，确认DOMAIN=code-server.gabriel
• 重启code-server容器生效：

  docker-compose restart code-server
  

3. 添加自定义NGINX头以支持WebSocket和代理请求 #

code-server依赖WebSocket实现实时交互，需要在NGINX代理中添加必要的请求头，确保请求能正确传递到后端。

操作步骤：

• 在NGINX Proxy Manager的主机转发配置中切换到「Custom Nginx Configuration」选项卡
• 粘贴以下配置：

  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;
  

• 保存配置并重启NGINX Proxy Manager容器

4. 验证容器间网络连通性 #

确认NGINX容器能正常访问code-server的8443端口：

docker exec -it nginx-proxy curl -k https://10.120.4.3:8443

如果返回code-server的登录页面HTML，说明网络正常；若不通，检查nginx-local网络配置，确保两个容器都加入了该网络。

5. 清除浏览器缓存 #

空白页可能是浏览器缓存了旧的资源路径，按Ctrl+Shift+R强制刷新页面，或清空浏览器缓存后重新访问。

内容的提问来源于stack exchange，提问作者gabriel brandão