Remote Gateway CORS 配置说明
概述
Remote Gateway 服务支持灵活的 CORS（跨域资源共享）配置，可以通过环境变量控制哪些域名可以访问远程桌面网关。
环境变量
1. CORS_ALLOWED_ORIGINS
类型: 字符串（逗号分隔） 默认值: 空 描述: 额外允许的 CORS 来源，支持多个域名（逗号分隔）
示例:
dotenv
CORS_ALLOWED_ORIGINS=https://yourdomain.com,https://www.yourdomain.com,https://admin.yourdomain.com2. CORS_ALLOW_ALL
类型: 布尔值（true 或 false） 默认值: false描述: 是否允许所有来源访问（仅用于开发环境，生产环境强烈不推荐）
示例:
dotenv
CORS_ALLOW_ALL=true # ⚠️ 仅用于开发/测试3. FRONTEND_URL 和 MAIN_BACKEND_URL
类型: 字符串（URL） 默认值:
FRONTEND_URL:http://localhost:5173MAIN_BACKEND_URL:http://localhost:3001
描述: 默认允许的前端和后端 URL，始终会被添加到 CORS 白名单
配置示例
Docker Compose 配置
编辑 docker-compose.yml 文件中的 remote-gateway 服务：
yaml
remote-gateway:
image: ghcr.io/silentely/nexus-terminal-remote-gateway:latest
environment:
GUACD_HOST: localhost
GUACD_PORT: 4822
FRONTEND_URL: http://frontend
MAIN_BACKEND_URL: http://backend:3001
# 添加额外的允许域名
CORS_ALLOWED_ORIGINS: https://yourdomain.com,https://www.yourdomain.com
# 开发模式（可选，不推荐生产使用）
# CORS_ALLOW_ALL: true本地开发配置
创建或编辑 .env 文件：
dotenv
FRONTEND_URL=http://localhost:5173
MAIN_BACKEND_URL=http://localhost:3001
CORS_ALLOWED_ORIGINS=http://localhost:8080
CORS_ALLOW_ALL=false常见问题
Q1: 浏览器控制台显示 CORS 错误怎么办？
情况 1: 错误域名不是你的应用
如果看到类似 keylol.cloudflareaccess.com 或 ssh.cosr.eu 的域名：
- ✅ 这些错误不是来自你的应用代码
- ✅ 通常是浏览器扩展、广告拦截器或代理软件尝试加载资源
- ✅ 这些错误不影响应用功能，可以安全忽略
排查方法:
- 在无痕窗口中测试（禁用所有扩展）
- 禁用广告拦截器（如 uBlock Origin、AdGuard）
- 检查 VPN 或代理软件
情况 2: 错误域名是你的应用
如果看到自己的域名被 CORS 拦截：
- 检查
docker-compose.yml中的FRONTEND_URL和MAIN_BACKEND_URL是否正确 - 如需支持额外域名，配置
CORS_ALLOWED_ORIGINS - 重启 remote-gateway 服务：
docker-compose restart remote-gateway
Q2: 为什么我的自定义域名访问不了？
确保在 CORS_ALLOWED_ORIGINS 中添加了你的域名：
yaml
environment:
CORS_ALLOWED_ORIGINS: https://terminal.example.com,https://www.example.com注意：
- ✅ 包含协议（
http://或https://） - ✅ 不要添加尾部斜杠
- ✅ 多个域名用逗号分隔，不要有空格
Q3: 开发时能临时允许所有来源吗？
可以，但仅限开发环境：
yaml
environment:
CORS_ALLOW_ALL: true # ⚠️ 生产环境禁用！生产环境必须明确配置允许的域名，不能使用 CORS_ALLOW_ALL=true。
安全建议
- 最小权限原则: 仅允许必要的域名访问
- 生产环境: 禁用
CORS_ALLOW_ALL - HTTPS: 生产环境使用 HTTPS 协议
- 定期审查: 定期检查允许的域名列表
日志示例
正常启动日志
[Remote Gateway] CORS 允许的来源: http://frontend, http://backend:3001, https://yourdomain.com开发模式日志
[Remote Gateway] ⚠️ CORS 允许所有来源（开发模式）