返回

使用自定义域名访问 GitLab 私有仓库——一键修改 Clone 地址

原创
admin的头像admin·发布于 2025-07-23 12:42·阅读 61

内容

在日常开发中,我们常常需要通过 git clone 从 GitLab 私有仓库拉取代码。如果你为 GitLab 配置了自定义域名,却在项目页面看到的 Clone 地址依然是 IP + 端口,每次复制后还要手动替换,实在令人头疼。

下面分享一个简单、有效的方法,只需修改一处配置,重启服务,即可让项目页面自动显示你的域名地址,彻底告别“动手改链接”的烦恼。


一、问题描述

  • 已为 GitLab 配置了自定义域名(如 git.example.com),并在 DNS 解析和防火墙规则中完成相应设置。
  • 在浏览器打开私有仓库项目页面时,Clone 地址仍然显示为 http://192.168.1.100:8929/your-group/your-project.git,而非 https://git.example.com/your-group/your-project.git
  • 每次复制后都要手动替换,非常不方便,也容易出错。

二、解决方案

修改 GitLab Rails 组件的主配置文件 gitlab.yml,将默认的主机名和端口改为你的域名。操作步骤如下:

  1. 打开配置文件
    bash 复制代码
    sudo vim /opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml
复制代码
2. **定位 `external_url` 配置**
   在文件中找到类似如下的段落:

   ```yaml
   ## GitLab settings
   gitlab:
     # Web server settings  
     host: 192.168.1.100  
     port: 8929  
     https: false
   ```
3. **修改为自定义域名**
   将 `host` 和 `port` 字段替换成你的域名,并根据需要启用 HTTPS:

   ```yaml
   gitlab:
     host: git.example.com
     port: 443
     https: true
   ```
4. **保存并退出编辑器**
   在 Vim 中输入 `:wq` 保存并退出。
5. **重启 GitLab 服务**

   ```bash
   sudo gitlab-ctl restart
   ```
6. **验证效果**
   再次打开项目页面,Clone 地址将变为:

   ```
   https://git.example.com/your-group/your-project.git
   ```

   从此,无需再手动替换链接,直接复制即可使用。

---

## 三、小贴士

* 如果你使用的是 HTTP(非 HTTPS),将 `port` 设置为 `80`,并将 `https: false`。
* 修改配置后,若页面仍然显示旧地址,可清除浏览器缓存或尝试重启服务器后再访问。
* 若使用 Omnibus 安装包,也可通过修改 `/etc/gitlab/gitlab.rb` 中的 `external_url` 来统一设置域名,操作更简便。

---
作者的其他文章
IP地址配置HTTPS 内网IP配置HTTPS保姆教程
本文介绍了在Nginx中配置HTTPS的完整流程:1)使用OpenSSL生成自签名证书和私钥;2)解密私钥以避免重启时输入密码;3)配置Nginx支持HTTPS,包括指定证书路径、设置安全协议和加密套件等。适用于开发、测试和内网环境,但需注意自签名证书会触发浏览器警告,生产环境建议使用CA签发的正式证书。通过简单的命令和配置即可实现基本的HTTPS加密保护。
IP地址配置HTTPS 内网IP配置HTTPS保姆教程
Docker 数据目录迁移完整指南:从 /var/lib/docker 迁移到自定义路径
本文介绍了将 Docker 数据目录从 /var/lib/docker 迁移到自定义路径 /data2/docker/data 的完整过程,包括停止 Docker 服务、复制数据、修改配置文件及验证数据完整性。提供了常见问题的解决方案,帮助用户在空间不足时顺利迁移 Docker 数据。
Docker 数据目录迁移完整指南:从 /var/lib/docker 迁移到自定义路径
2025年必备:让Nginx配置清晰如诗的工具推荐
文章浏览阅读464次,点赞4次,收藏4次。本文介绍了格式化Nginx配置文件的重要性,指出良好格式能提升可读性、团队协作效率和降低错误风险。文章推荐了2025年优秀的在线格式化工具,这类工具应具备操作简单、专业格式化效果、安全保障等特性。建议将格式化工具集成到开发流程中,并制定团队规范,以优雅管理Nginx配置。文末推荐了一个专业在线格式化工具,帮助开发者高效处理配置文件。
2025年必备:让Nginx配置清晰如诗的工具推荐
Claude 命令大全:从入门到精通的终端操作指南(2025 最新)
本教程全面整理 *Claude 命令行(CLI)使用指南*,从基础启动命令、项目管理、权限控制、模型切换到高级思考模式,全方位提升开发者在终端中使用 Claude 的效率。适合新手与资深开发者收藏参考。
Claude 命令大全:从入门到精通的终端操作指南(2025 最新)
屏幕检测专家 — 专业的在线屏幕测试工具
屏幕检测专家 — 专业的在线屏幕测试工具
屏幕检测专家 — 专业的在线屏幕测试工具
Keye-VL-1.5-8B(快手 Keye-VL)— 腾讯云两卡 32GB GPU **保姆级** 部署指南(Ubuntu 22.04 / CUDA 12.2 / Driver 535.216.01 / Python 3.10)
保姆级教程:在腾讯云两卡 32GB GPU(Ubuntu 22.04 / CUDA 12.2)上完整部署快手 Keye-VL-1.5-8B。包含驱动安装、conda 环境、PyTorch、bitsandbytes、vLLM、ModelScope 模型下载与 Gradio demo 运行步骤及常见排错。适合工程复现与上线优化。
Keye-VL-1.5-8B(快手 Keye-VL)— 腾讯云两卡 32GB GPU **保姆级** 部署指南(Ubuntu 22.04 / CUDA 12.2 / Driver 535.216.01 / Python 3.10)
Ubuntu系统ECS重启后“/etc/resolv.conf”被还原怎么办?
处理方法 在处理前,建议先禁用systemd-resolved服务。 方法一:手动修改/etc/resolv.conf文件。 以root用户登录ECS。 关闭并禁用systemd-resolved服务
共享打印机报错连不上怎么办?修复错误代码(0x000006d9/0x0000011b 等)最新Win10/11 共享打印机常见问题 + 解决教程,附工具!
Win11 打印机共享报错全面修复指南:涵盖 0x000006d9、0x0000011b、0x0000007e 等常见码,并提供一键 PowerShell 工具,十分钟内搞定老款惠普共享打印机。
共享打印机报错连不上怎么办?修复错误代码(0x000006d9/0x0000011b 等)最新Win10/11 共享打印机常见问题 + 解决教程,附工具!
实战Spring Boot + Vue 集成 Activiti 工作流引擎 | 双模式简单 & 自定义审批平台
基于 Spring Boot 与 Vue 的高效工作流平台,支持简单模式与自定义模式双引擎,在线流程建模、版本管理、审批节点灵活配置,多渠道消息通知,Docker/K8s 部署,高可用与可扩展。
2025 年国内 Docker/DockerHub 镜像源加速列表(7 月 28 日更新 · 长期维护)
2025 年最新国内 Docker Hub 镜像源加速列表,包含轩辕镜像、腾讯云、阿里云、DaoCloud、AtomHub 等多家稳定 CDN 服务,附详细配置教程与常见问题说明,适用于 Linux、macOS、Windows 平台。
2025 年国内 Docker/DockerHub 镜像源加速列表(7 月 28 日更新 · 长期维护)