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 集成後，配置使用該集成的功能：
