前后端分离

    CBCTF 默认将前端静态资源嵌入 Go 二进制，通过同一个服务地址提供 /platform。如果需要把前端单独托管到 CDN、静态站点或其他域名，可以采用前后端分离方式。

    适用场景

    • 需要 CDN 加速前端资源
    • 前端需部署到独立域名
    • 希望前后端分别发布

    前端构建

    git clone https://github.com/0RAYS/CBCTF.git
cd CBCTF/frontend
pnpm install

    修改 frontend/src/api/config.js：

    export const API_CONFIG = {
    BASE_URL: 'https://api.ctf.example.com',
};

    然后构建：

    pnpm build

    构建完成后，将 frontend/dist/ 部署到任意静态托管环境。

    后端配置

    config.yaml 示例：

    host: https://api.ctf.example.com

gin:
  cors:
    - https://ctf.example.com
    • host 必须填写后端真实对外地址，OAuth 回调与邮件链接都会使用它
    • gin.cors 需要包含前端独立域名

    OAuth 注意事项

    前后端分离时，OAuth 回调链路为：

    1. 第三方回调到后端 https://api.ctf.example.com/oauth/{uri}/callback
    2. 后端完成登录后重定向到 https://api.ctf.example.com/platform/#/oauth/callback?...
    Warning

    当前代码默认仍依赖后端提供 /platform 下的前端回调页。若完全拆离前端托管位置，需要同步调整 OAuth 回调后的前端跳转逻辑。

    Helm 场景

    若后端仍通过 Helm 部署，只需在 values.yaml 中设置：

    cbctf:
  host: "https://api.ctf.example.com"
  gin:
    cors:
      - "https://ctf.example.com"