GitLab 集成可连接你的仓库，以便你使用 云端代理、Bugbot 等功能。
设置¶
GitLab.com¶
需要具备 Cursor 管理员权限和 GitLab 维护者权限。
GitLab 集成需要 付费 GitLab 方案 (Premium 或 Ultimate) 。此集成所需的项目访问 token 在 GitLab Free 中不可用。
- 前往仪表盘中的集成
- 点击 GitLab 旁的 连接 (如果已连接，则点击 管理连接)
- 按照 GitLab 安装流程操作
- 返回“集成”标签页，点击 GitLab 连接旁的 管理，然后选择 同步仓库
- 返回仪表盘，为仓库配置功能
如需断开 GitLab 账户连接，请返回集成仪表盘并点击 断开账户连接。
GitLab 自托管¶
GitLab 集成需要 付费 GitLab 方案 (Premium 或 Ultimate) 。此集成所需的项目访问 token 在 GitLab Free 中不可用。
网络¶
- GitLab 自托管需要允许 Cursor 安全地入站访问，并支持用于 webhook 通知的出站访问。
- 你需要拥有 GitLab 实例的管理员权限，才能创建应用。
IP 允许列表 (推荐)¶
将以下 IP 地址添加到允许列表：
184.73.225.134
3.209.66.12
52.44.113.131
如需了解 IP 允许列表以外的连接选项，请参阅高级网络。
创建 GitLab 应用¶
- 在 GitLab 实例中创建新应用 (建议创建实例级应用)
- 将重定向 URI 设置为
https://cursor.com/gitlab-connected - 配置应用：
- 可信：true
- 保密：true
- 作用域：api和write_repository - 创建后，你将获得 Application ID 和 Secret
在 Cursor 中注册¶
- 前往仪表盘中的集成 → 高级 → GitLab 自托管
- 输入 GitLab 实例的主机名
- 粘贴 Application ID 和 Secret
- 点击 注册
- 从下拉列表中选择 GitLab 实例
- 点击 连接完成安装
- 返回“集成”标签页，点击 GitLab 连接旁的 管理，然后选择 同步仓库
- 返回仪表盘，为仓库配置功能
高级网络¶
自托管实例除 IP 允许列表外，还支持多种连接方式。
AWS PrivateLink 或 Cloudflare Tunnel¶
企业版客户可用。允许 Cursor 通过私有网络连接访问您的实例。有关设置，请参阅私有网络连接，或联系您的 Cursor 客户代表。
最适合： 位于私有网络中、防火墙后的实例，包括托管在 AWS 上的实例以及可运行 cloudflared 的环境
安全性： HTTPS 加密、AWS PrivateLink、Cloudflare Tunnel、VPC 允许列表、服务账户访问 token
缺点： 需要与 Cursor 协调。目前不支持 Google Private Service Connect。
反向代理隧道¶
企业版客户可用。在本地部署反向代理隧道，与 Cursor 的服务器建立长期 WebSocket 连接。网络请求会通过该隧道转发到您的实例。无需入站网络访问。有关设置，请联系您的 Cursor 客户代表。
最适合： 无法进行入站网络访问的环境
安全性： HTTPS 加密、服务账户访问 token
缺点： 与更直接的连接方式相比，会增加复杂性、维护负担和潜在的安全考量
受保护的 Git 范围¶
将 GitLab 群组或命名空间锁定到 Cursor 组织，使只有你的团队能通过云端代理、自动化和 Bugbot 使用其中的仓库。保护范围需要具备 GitLab Owner 角色。请参阅 受保护的 Git 范围。
后续步骤¶
连接 GitLab 集成后，配置使用该集成的功能：
