GitLab

核心概念

Zleap 通过 GitLab 的 Application 机制获取代码信息。只需在 GitLab 中新建 Application，将生成的 Application ID、Secret 密钥和回调地址（Callback URL）填入 Zleap 即可完成对接，无需提供 GitLab 密码。

登录您的 GitLab 服务，点击右上角头像，在下拉菜单中选择【Preferences】，进入个人偏好设置页面。

在左侧导航栏中找到并点击【Applications】，进入 OAuth 应用管理页面。

点击【Add new application】，开始创建一个新的 OAuth 应用。

在应用创建表单中填写以下信息，完成后点击【Save application】保存。

Scopes（权限范围）：勾选 api、read_api、read_user、read_repository、write_repository
Redirect URI（回调地址）：请根据您的部署方式选择对应的填写格式：

网页版（公网）：https://您所需的zleap域名/oauth-callback
需使用公网 IP 或已备案域名，Zleap 云端服务可正常访问
一体机/局域网部署：http://您的GitLab服务器IP/oauth-callback
⚠️ 仅限在同一局域网内使用，Zleap 需与 GitLab 处于相同网络环境

📌 注意事项

公网 IP 场景：确保您的 GitLab 服务器可被公网访问，否则云端无法完成回调验证。
局域网 IP 场景（如 http://192.168.XXX）：仅适用于一体机本地部署或同网络环境下的测试，Zleap 网页版无法连接此类私有地址。
如不确定使用哪种方式，建议优先采用公网域名/公网 IP 方式进行配置。

💡 常见问题

Q：为什么填写局域网 IP（如 192.168.x.x）后连接失败？

A：Zleap 网页版运行在云端服务器，无法访问您本地的私有网络地址。如需使用局域网 IP，请在一体机（本地部署）环境中操作。

Q：我没有域名，只有 IP 地址怎么办？

A：如果您使用的是一体机且 Zleap 与 GitLab 在同一局域网内，可以直接填写 GitLab 的局域网 IP 地址。如果是网页版，则需要使用公网 IP 或申请域名。