自建 GitLab 没公网？用内网穿透技术，远程开发协作超丝滑

前言

作为常年折腾私有部署的开发者，我深知自建代码仓库的痛点 ------ 明明把 GitLab 搭在了本地服务器，结果只能内网访问，跨地域协作时要么折腾复杂的路由器端口映射，要么被迫把代码放到公有平台，总少了点安全感。

最近试了用 cpolar 搭配 CentOS 7 上的 GitLab，没想到几步就搞定了公网访问，不用改复杂的网络配置，也不用依赖云服务商，今天就把这套低成本、高可控的方案分享给同样有私有部署需求的朋友。

通过本教程，您将获得：

✅ 完全自主的代码仓库：在自有服务器搭建 GitLab CE，掌握代码数据主权
🌐 无缝的公网访问能力：利用 cpolar 穿透内网限制，无需复杂路由器配置
🔒 安全的远程访问方案：避免代码暴露在公有云平台，降低泄露风险
🛠️ 企业级开发体验：享受 GitLab 强大的项目管理功能

让我们开始构建您专属的、可全球访问的私有代码托管平台！

文章目录

- 前言
- [1 为什么选择自建 GitLab？](#1 为什么选择自建 GitLab？)
- - [1.1 GitLab](#1.1 GitLab)
  - [1.2 Gitee](#1.2 Gitee)
  - [1.3 GitHub](#1.3 GitHub)
- [2 GitLab安装（CE 13.9.6）](#2 GitLab安装（CE 13.9.6）)
- - [2.1 添加GitLab软件仓库](#2.1 添加GitLab软件仓库)
  - [2.2 安装GitLab](#2.2 安装GitLab)
  - [2.3 配置GitLab](#2.3 配置GitLab)
  - [2.4 启动及访问GitLab](#2.4 启动及访问GitLab)
- [3 GitLab创建项目](#3 GitLab创建项目)
- - [3.1 项目创建](#3.1 项目创建)
  - [3.2 下拉代码](#3.2 下拉代码)
  - [3.3 上传代码](#3.3 上传代码)
- [4 使用 cpolar 实现公网访问](#4 使用 cpolar 实现公网访问)
- - [4.1 安装 cpolar](#4.1 安装 cpolar)
  - - [4.1.1 什么是cpolar？](#4.1.1 什么是cpolar？)
    - [4.1.2 安装cpolar](#4.1.2 安装cpolar)
  - [4.2 配置cpolar系统服务](#4.2 配置cpolar系统服务)
  - [4.3 注册及登录cpolar web ui管理界面](#4.3 注册及登录cpolar web ui管理界面)
  - - [4.3.1 注册cpolar](#4.3.1 注册cpolar)
    - [4.3.2 放行9200端口（web ui端口）](#4.3.2 放行9200端口（web ui端口）)
    - [4.3.3 访问cpolar web ui管理界面](#4.3.3 访问cpolar web ui管理界面)
  - [4.4 配置gitlab隧道及访问测试](#4.4 配置gitlab隧道及访问测试)
  - - [4.4.1 配置 HTTP 隧道绑定到 8888 端口](#4.4.1 配置 HTTP 隧道绑定到 8888 端口)
    - [4.4.2 访问公网地址验证 GitLab 是否可访问](#4.4.2 访问公网地址验证 GitLab 是否可访问)
  - [4.5 设置固定二级子域名（Pro用户）](#4.5 设置固定二级子域名（Pro用户）)
  - - [4.5.1 保留二级子域名](#4.5.1 保留二级子域名)
    - [4.5.2 修改gitlab隧道为子域名方式](#4.5.2 修改gitlab隧道为子域名方式)
    - [4.5.3 访问子域名测试](#4.5.3 访问子域名测试)
- [5 修改 clone 地址为公网地址](#5 修改 clone 地址为公网地址)
- - [5.1 修改GitLab 配置文件](#5.1 修改GitLab 配置文件)
  - [5.2 访问测试](#5.2 访问测试)
  - [5.3 下拉代码测试](#5.3 下拉代码测试)
  - [5.4 上传代码测试](#5.4 上传代码测试)
- [6 常见问题排查](#6 常见问题排查)
- - [6.1 修改 GitLab 的外部访问地址为公网域名](#6.1 修改 GitLab 的外部访问地址为公网域名)
- [7 总结](#7 总结)

1 为什么选择自建 GitLab？

1.1 GitLab

GitLab是一个基于Web的开源代码托管平台，它提供了代码托管、项目管理、持续集成和持续部署等功能。GitLab采用了Git作为版本控制系统，并提供了易于使用的界面和丰富的功能。

GitLab 与市场上的Gitee 和GitHub相比具有以下优点：

开源自托管：GitLab是开源软件，你可以选择将其部署在自己的服务器上，完全掌握代码托管的控制权，不受第三方平台的限制。而Gitee和GitHub则是商业化的托管服务。
完整的CI/CD支持：GitLab内置了持续集成和持续部署功能，使团队能够自动构建、测试和交付软件。这有助于提高团队的开发效率和软件质量。
全面的项目管理功能：除了代码仓库管理外，GitLab还提供了项目计划、问题跟踪、文档管理和协作功能，帮助团队更好地组织和管理项目。
丰富的社区支持：GitLab拥有庞大的全球开发者社区，你可以从社区中获取开源项目、解决问题以及分享经验。同时，GitLab社区版也有许多活跃的贡献者为其不断增加新功能和修复bug。

1.2 Gitee

Gitee是中国的一家Git代码托管平台，与GitHub类似。它提供了类似于GitHub的代码托管和项目管理功能，但更关注中国开发者的需求。Gitee在国内有较好的网络连接速度，支持中文界面和中文文档，因此在中国用户中比较流行。

1.3 GitHub

GitHub 是全球最大的代码托管平台，也是一个开发者社交网络。它具有极高的知名度和广泛的开发者社区，涵盖了各种技术领域。GitHub提供了卓越的协作和分享功能，使得开发者能够轻松地与全球的开发者共同合作。它也提供了很多与第三方服务集成的功能，例如代码审查工具、持续集成服务等。

总之，GitLab、Gitee和GitHub都是优秀的代码托管平台，适用于不同的需求和场景。选择哪个平台取决于你的团队规模、项目需求和个人偏好。

2 GitLab安装（CE 13.9.6）

2.1 添加GitLab软件仓库

shell 复制代码

#从GitLab官方网站获取与添加仓库脚本的URL
#sudo bash 以管理员权限运行脚本，将GitLab软件仓库添加到系统中。
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

curl命令执行完成后，会在/etc/yum.repos.d目录下生成 gitlab_gitlab-ce.repo文件。

2.2 安装GitLab

虚拟机IP查看可以使用ifconfig命令

shell 复制代码

# 使用管理员权限执行以下命令
# 设置 GitLab 的外部访问地址为 http://<您的虚拟机IP>:8888
# 并通过 yum 安装 GitLab 社区版 13.9.6，自动确认所有提示

#如：sudo EXTERNAL_URL="http://192.168.184.133:8888" yum install -y gitlab-ce-13.9.6
sudo EXTERNAL_URL="http://<您的虚拟机IP>:8888" yum install -y gitlab-ce-13.9.6

安装成功提示如下图：

2.3 配置GitLab

打开 GitLab 的主配置文件 gitlab.rb，准备修改默认的访问端口。

为什么要改 ：GitLab 默认使用 HTTP 80 和 unicorn 8080，如果端口冲突或你想用其他端口（比如要做端口映射或配合内网穿透工具如 cpolar），就要改成自定义的端口，比如 8888、8887。

shell 复制代码

sudo vim /etc/gitlab/gitlab.rb

打开后，在external_url 'http://<您设置的IP地址>:8888'下面添加：

shell 复制代码

nginx['listen_port'] = 8888
unicorn['port'] = 8887

nginx['listen_port'] = 8888：指定 GitLab 使用内置 nginx 服务监听 8888 端口（即网页访问用这个端口）
unicorn['port'] = 8887：指定 GitLab 的应用服务器（unicorn）使用 8887 端口

接下来需要给防火墙开放端口，刷新配置：

shell 复制代码

#防火墙开放端口
firewall-cmd --zone=public --add-port=8888/tcp --permanent
firewall-cmd --zone=public --add-port=8887/tcp --permanent

#刷新配置
firewall-cmd --reload

刷新GitLab以应用新的配置：

shell 复制代码

sudo gitlab-ctl reconfigure

2.4 启动及访问GitLab

shell 复制代码

sudo gitlab-ctl start	#启动
sudo gitlab-ctl restart	#重启
sudo gitlab-ctl stop	#停止
sudo gitlab-ctl status	#状态

启动图示如下：

访问前面设置的 http://192.168.184.133:8888 ,出现如下图即成功：

如上为设置密码页面，设置好密码后会跳转如下登录界面：

管理员登录使用：

shell 复制代码

#用户名
root

#密码
您设置的密码

登录成功即可进入主页面：

3 GitLab创建项目

前后端皆可此方法，这里以前端举例

3.1 项目创建

选择新项目（new project），然后选择创建空项目（create blank project）

点击进入项目信息页面，填写项目信息：

点击创建项目后，项目即可创建成功！随即会跳转到创建好的项目页面：

3.2 下拉代码

使用前需有git环境，可去git官网下载：

复制项目的地址：

shell 复制代码

http://192.168.184.133:8888/root/myvue3demo.git

安装好git后，在任意文件夹位置鼠标右键可以看到open Git Bash here选择，点击进入：

进入git bash终端后，输入如下命令下拉代码：

shell 复制代码

git clone http://192.168.184.133:8888/root/myvue3demo.git

可能会出现需要输入密码的情况,输入gitlab的用户名root和您设置的gitlab密码即可

3.3 上传代码

为了方便快捷，我这边使用cursorAI编辑器，生成了一个简单的Vue3项目演示站：

项目会放在结尾开源，供大家免费下载代码，进行测试~

生成的页面展示如下：

现在，目录列表里面就有项目文件啦：

接下来，继续在当前位置鼠标右键打开git bash，执行如下命令：

shell 复制代码

#添加暂存区
git add .

#提交本地git仓库 加内容
git commit -m "内容"

#推送到远程
git push

这样，代码就成功推送成功了，服务器刷新也可以看到，代码已经成功上传到gitlab仓库啦！

4 使用 cpolar 实现公网访问

4.1 安装 cpolar

4.1.1 什么是cpolar？

cpolar 是一款内网穿透工具，可以将你在局域网内运行的服务（如本地 Web 服务器、SSH、远程桌面等）通过一条安全加密的中间隧道映射至公网，让外部设备无需配置路由器即可访问。
广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台，并提供一键安装脚本方便部署。

4.1.2 安装cpolar

首先，我们需要先安装curl：

shell 复制代码

sudo yum install curl

接下来下载cpolar,一条命令完成安装

shell 复制代码

curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash

测试 cpolar版本以确保安装

shell 复制代码

cploar version

4.2 配置cpolar系统服务

向系统添加及启动cpolar服务

shell 复制代码

#添加cpolar服务
sudo systemctl enable cpolar

#启动cpolar服务
sudo systemctl start cpolar

查看服务状态

shell 复制代码

sudo systemctl status cpolar

4.3 注册及登录cpolar web ui管理界面

4.3.1 注册cpolar

访问cpolar官网，点击免费注册按钮，进行账号注册

注册页面：

4.3.2 放行9200端口（web ui端口）

在访问web页面前，需要先检查系统防火墙是否放行9200端口，避免访问不了

shell 复制代码

systemctl status firewalld

有两种方式可以实现访问，一种是放行该端口，另一种是直接关闭防火墙（不建议）

shell 复制代码

#放行 9200 端口  
#--zone=public：使用默认区域（通常是 public）
#--add-port=9200/tcp：添加 TCP 协议的 9200 端口
#--permanent：永久生效（不加此参数则是临时规则，重启失效）
firewall-cmd --zone=public --add-port=9200/tcp --permanent

#重载防火墙配置(及刷新配置使其生效)
firewall-cmd --reload

验证端口是否已放行

shell 复制代码

firewall-cmd --zone=public --query-port=9200/tcp

输出内容为yes则成功放行

4.3.3 访问cpolar web ui管理界面

在访问之前，不确定ip地址可以通过ifconfig命令查看服务器ip

shell 复制代码

ifconfig

确定好ip地址后，在浏览器中访问：

shell 复制代码

http：//<此处应为您的IP>:9200  #如：http://192.168.184.133:9200

将前面步骤注册好的cpolar账号登录即可进入后台页面

登录成功同时，服务器也会后台无感自动配置token,无需手动配置token

配置文件位置：/usr/local/etc/cpolar/cpolar.yml

shell 复制代码

cat /usr/local/etc/cpolar/cpolar.yml

4.4 配置gitlab隧道及访问测试

4.4.1 配置 HTTP 隧道绑定到 8888 端口

点击左侧菜单栏的隧道管理，展开进入隧道列表页面，页面下默认会有 2 个隧道：

ssh隧道，指向22端口，tcp协议
website隧道，指向8080端口，http协议（http协议默认会生成2个公网地址，一个是http，另一个https，免去配置ssl证书的繁琐步骤）

接着点击创建隧道菜单，进入到创建页面，如下图配置：

创建完成后，点击左侧菜单的状态菜单，接着点击在线隧道列表菜单按钮，可以看到有2个gitlab的隧道，一个为http协议,另一个为https协议

注意：每个用户创建的隧道显示的公网地址都不一样！

4.4.2 访问公网地址验证 GitLab 是否可访问

在浏览器中访问创建gitlab隧道生成的公网地址（http和https皆可）

这里以https为例：

登录gitlab账号，成功进入gitlab首页！

4.5 设置固定二级子域名（Pro用户）

4.5.1 保留二级子域名

使用cpolar为其配置二级子域名，该域名为固定格式域名，不会随机变化,方便后续远程访问gitlab仓库。

进入官网的预留页面：https://dashboard.cpolar.com/reserved

列表中显示了一条已保留的二级子域名记录：

地区：显示为China Top。
二级域名：显示为gitlab01。

注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主

4.5.2 修改gitlab隧道为子域名方式

进入侧边菜单栏的隧道管理下的隧道列表，可以看到前面配置名为gitlab-8888的隧道

点击编辑按钮进入编辑页面，修改域名类型为二级子域名，然后填写前面配置好的子域名，点击更新按钮：

4.5.3 访问子域名测试

来到状态菜单下的在线隧道列表可以看到隧道名称为gitlab-8888的公网地址已经变更为二级子域名+固定域名主体及后缀的形式了：

这里以https协议做访问测试:

访问成功！

5 修改 clone 地址为公网地址

部署完成后，即使你已经使用 cpolar 成功穿透并访问 GitLab 页面，GitLab 显示的项目克隆地址仍可能是内网地址（如 192.168.x.x），如下图所示：

这会导致使用 git clone 时默认用的是内网地址，外网机器无法访问。为了解决这个问题，我们需要修改 GitLab 的配置，使其显示为公网地址。

5.1 修改GitLab 配置文件

编辑gitlab的配置文件：

shell 复制代码

sudo vim /etc/gitlab/gitlab.rb

找到如图这行：

shell 复制代码

external_url 'http://192.168.184.133:8888'

将其修改为你的 Cpolar 分配的公网地址（注意不要加端口号）：

shell 复制代码

#注意，请使用http的域名
external_url 'http://gitlab01.cpolar.top'

保存退出后，然后重新加载gitlab配置：

shell 复制代码

sudo gitlab-ctl reconfigure

5.2 访问测试

访问gitlab穿透的项目地址:

shell 复制代码

https://gitlab01.cpolar.top/root/myvue3demo

可以看到，clone的地址已经正确的从内网地址变更为cpolar穿透的二级域名地址了！

5.3 下拉代码测试

复制clone地址：

shell 复制代码

http://gitlab01.cpolar.top/root/myvue3demo.git

在本地资源管理器中任意文件夹位置，单机鼠标右键,选择Open Git Bash here，点击进入打开shell窗口，输入如下命令:

shell 复制代码

#项目地址替换为您项目的地址链接
git clone http://gitlab01.cpolar.top/root/myvue3demo.git

输入用户信息确认后，可以发现成功下拉代码

5.4 上传代码测试

这边使用AI软件cursor进行了简单的开源文件修改，进行上传代码测试，如图：

控制台已经提示上传成功，可以看到如下提示：
To http://gitlab01.cpolar.top/root/myvue3demo.git

打开gitlab仓库查看，是否有最新提交：

可以发现，修改的开源文件提交上传上来了！

6 常见问题排查

6.1 修改 GitLab 的外部访问地址为公网域名

在大纲为5小节的修改 clone 地址为公网地址时，如果设置外部地址使用的https协议地址，会出现如下问题：

less 复制代码

letsencrypt_certificate[...] had an error: RuntimeError: [...] Validation failed, unable to request certificate

这是因为 GitLab 在执行 reconfigure 时尝试向 Let's Encrypt 自动申请 HTTPS 证书失败 ，由于你的公网地址是 cpolar 动态分配的临时域名（或没有正确配置 DNS），导致验证失败。

而 Cpolar 的地址（如 *.cpolar.top）：

本质上是 临时公网穿透地址
没有公网 DNS 可验证所有权
也无法配合 Let's Encrypt 做 HTTP-01 验证

所以只适合用作 HTTP 明文访问，而不是自动走 HTTPS。

不要用 https:// 开头的 external_url,改为http协议的链接填入即可，然后再执行sudo gitlab-ctl reconfigure进行配置更新！

7 总结

其实内网穿透的玩法远不止 GitLab，不管是本地的测试服务、NAS 里的文件，还是开发中的小程序后台，只要有公网访问需求，cpolar 都能以极简的方式解决。

相比于传统的端口映射，它不用暴露内网 IP，还能按需配置加密隧道，对注重数据安全的个人和中小团队来说，算是兼顾了便捷性和安全性的最优解之一。如果你也在为私有服务的公网访问发愁，不妨试试这套组合，把代码和服务的控制权牢牢握在自己手里。