CentOS 7 搭建 GitLab CE并通过 cpolar 实现公网远程访问完整教程前言团队代码只保存在个人电脑中时不仅难以统一管理成员之间的版本同步、提交记录和权限控制也比较混乱。使用公共代码托管平台虽然方便但部分项目可能更希望把代码和仓库数据保存在自己的服务器中。GitLab CE可以在本地服务器中搭建代码托管平台提供项目仓库、成员管理、提交记录和代码协作等功能。对于内部项目、个人开发环境或者测试团队来说可以自行决定仓库数据保存位置和访问范围。但GitLab部署在家庭、公司或实验室内网后通常只能通过局域网地址访问。外地成员即使能够打开项目说明也无法直接使用内网地址完成git clone、git pull和git push。本文将以CentOS 7和GitLab CE 13.9.6为例完成软件安装、端口配置、项目创建和代码推拉测试。随后通过cpolar配置公网访问并修改GitLab的external_url让项目页面和仓库克隆地址都能够在外部网络中使用。1 为什么选择自建 GitLab1.1 GitLabGitLab是一个基于Web的开源代码托管平台它提供了代码托管、项目管理、持续集成和持续部署等功能。GitLab采用了Git作为版本控制系统并提供了易于使用的界面和丰富的功能。GitLab与市场上的Gitee和GitHub相比具有以下优点开源自托管GitLab是开源软件你可以选择将其部署在自己的服务器上完全掌握代码托管的控制权不受第三方平台的限制。而Gitee和GitHub则是商业化的托管服务。完整的CI/CD支持GitLab内置了持续集成和持续部署功能使团队能够自动构建、测试和交付软件。这有助于提高团队的开发效率和软件质量。全面的项目管理功能除了代码仓库管理外GitLab还提供了项目计划、问题跟踪、文档管理和协作功能帮助团队更好地组织和管理项目。丰富的社区支持GitLab拥有庞大的全球开发者社区你可以从社区中获取开源项目、解决问题以及分享经验。同时GitLab社区版也有许多活跃的贡献者为其不断增加新功能和修复bug。1.2 GiteeGitee是中国的一家Git代码托管平台与GitHub类似。它提供了类似于GitHub的代码托管和项目管理功能但更关注中国开发者的需求。Gitee在国内有较好的网络连接速度支持中文界面和中文文档因此在中国用户中比较流行。1.3 GitHubGitHub是全球最大的代码托管平台也是一个开发者社交网络。它具有极高的知名度和广泛的开发者社区涵盖了各种技术领域。GitHub提供了卓越的协作和分享功能使得开发者能够轻松地与全球的开发者共同合作。它也提供了很多与第三方服务集成的功能例如代码审查工具、持续集成服务等。总之GitLab、Gitee和GitHub都是优秀的代码托管平台适用于不同的需求和场景。选择哪个平台取决于你的团队规模、项目需求和个人偏好。2 GitLab安装CE 13.9.62.1 添加GitLab软件仓库#从GitLab官方网站获取与添加仓库脚本的URL#sudo bash 以管理员权限运行脚本将GitLab软件仓库添加到系统中。curlhttps://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh|sudobashcurl命令执行完成后会在/etc/yum.repos.d目录下生成gitlab_gitlab-ce.repo文件。2.2 安装GitLab虚拟机IP查看可以使用ifconfig命令# 使用管理员权限执行以下命令# 设置 GitLab 的外部访问地址为 http://您的虚拟机IP:8888# 并通过 yum 安装 GitLab 社区版 13.9.6自动确认所有提示#如sudo EXTERNAL_URLhttp://192.168.184.133:8888 yum install -y gitlab-ce-13.9.6sudoEXTERNAL_URLhttp://您的虚拟机IP:8888yuminstall-ygitlab-ce-13.9.6安装成功提示如下图2.3 配置GitLab打开 GitLab 的主配置文件gitlab.rb准备修改默认的访问端口。为什么要改GitLab 默认使用HTTP 80和unicorn 8080如果端口冲突或你想用其他端口比如要做端口映射或配合内网穿透工具如 cpolar就要改成自定义的端口比如 8888、8887。sudovim/etc/gitlab/gitlab.rb打开后在external_url http://您设置的IP地址:8888下面添加nginx[listen_port]8888unicorn[port]8887nginx[listen_port] 8888指定 GitLab 使用内置 nginx 服务监听8888 端口即网页访问用这个端口unicorn[port] 8887指定 GitLab 的应用服务器unicorn使用8887 端口接下来需要给防火墙开放端口刷新配置#防火墙开放端口firewall-cmd--zonepublic --add-port8888/tcp--permanentfirewall-cmd--zonepublic --add-port8887/tcp--permanent#刷新配置firewall-cmd--reload刷新GitLab以应用新的配置sudogitlab-ctl reconfigure2.4 启动及访问GitLabsudogitlab-ctl start#启动sudogitlab-ctl restart#重启sudogitlab-ctl stop#停止sudogitlab-ctl status#状态启动图示如下访问前面设置的http://192.168.184.133:8888,出现如下图即成功如上为设置密码页面设置好密码后会跳转如下登录界面管理员登录使用#用户名root#密码您设置的密码登录成功即可进入主页面3 GitLab创建项目前后端皆可此方法这里以前端举例3.1 项目创建选择新项目new project然后选择创建空项目create blank project点击进入项目信息页面填写项目信息点击创建项目后项目即可创建成功随即会跳转到创建好的项目页面3.2 下拉代码使用前需有git环境可去git官网下载复制项目的地址http://192.168.184.133:8888/root/myvue3demo.git安装好git后在任意文件夹位置鼠标右键可以看到open Git Bash here选择点击进入进入git bash终端后输入如下命令下拉代码gitclone http://192.168.184.133:8888/root/myvue3demo.git可能会出现需要输入密码的情况,输入gitlab的用户名root和您设置的gitlab密码即可3.3 上传代码为了方便快捷我这边使用cursorAI编辑器生成了一个简单的Vue3项目演示站项目会放在结尾开源供大家免费下载代码进行测试~生成的页面展示如下现在目录列表里面就有项目文件啦接下来继续在当前位置鼠标右键打开git bash执行如下命令#添加暂存区gitadd.#提交本地git仓库 加内容gitcommit-m内容#推送到远程gitpush这样代码就成功推送成功了服务器刷新也可以看到代码已经成功上传到gitlab仓库啦4 使用 cpolar 实现公网访问4.1 安装 cpolar4.1.1 什么是cpolarcpolar 是一款内网穿透工具可以将你在局域网内运行的服务如本地 Web 服务器、SSH、远程桌面等通过一条安全加密的中间隧道映射至公网让外部设备无需配置路由器即可访问。广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台并提供一键安装脚本方便部署。4.1.2 安装cpolar首先我们需要先安装curlsudoyuminstallcurl接下来下载cpolar,一条命令完成安装curl-Lhttps://www.cpolar.com/static/downloads/install-release-cpolar.sh|sudobash测试cpolar版本以确保安装cploar version4.2 配置cpolar系统服务向系统添加及启动cpolar服务#添加cpolar服务sudosystemctlenablecpolar#启动cpolar服务sudosystemctl start cpolar查看服务状态sudosystemctl status cpolar4.3 注册及登录cpolar web ui管理界面4.3.1 注册cpolar访问cpolar官网点击免费注册按钮进行账号注册注册页面4.3.2 放行9200端口web ui端口在访问web页面前需要先检查系统防火墙是否放行9200端口避免访问不了systemctl status firewalld有两种方式可以实现访问一种是放行该端口另一种是直接关闭防火墙不建议#放行 9200 端口#--zonepublic使用默认区域通常是 public#--add-port9200/tcp添加 TCP 协议的 9200 端口#--permanent永久生效不加此参数则是临时规则重启失效firewall-cmd--zonepublic --add-port9200/tcp--permanent#重载防火墙配置(及刷新配置使其生效)firewall-cmd--reload验证端口是否已放行firewall-cmd--zonepublic --query-port9200/tcp输出内容为yes则成功放行4.3.3 访问cpolar web ui管理界面在访问之前不确定ip地址可以通过ifconfig命令查看服务器ipifconfig确定好ip地址后在浏览器中访问http//此处应为您的IP:9200#如http://192.168.184.133:9200将前面步骤注册好的cpolar账号登录即可进入后台页面登录成功同时服务器也会后台无感自动配置token,无需手动配置token配置文件位置/usr/local/etc/cpolar/cpolar.ymlcat/usr/local/etc/cpolar/cpolar.yml4.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的配置文件sudovim/etc/gitlab/gitlab.rb找到如图这行external_urlhttp://192.168.184.133:8888将其修改为你的 Cpolar 分配的公网地址注意不要加端口号#注意请使用http的域名external_urlhttp://gitlab01.cpolar.top保存退出后然后重新加载gitlab配置sudogitlab-ctl reconfigure5.2 访问测试访问gitlab穿透的项目地址:https://gitlab01.cpolar.top/root/myvue3demo可以看到clone的地址已经正确的从内网地址变更为cpolar穿透的二级域名地址了5.3 下拉代码测试复制clone地址http://gitlab01.cpolar.top/root/myvue3demo.git在本地资源管理器中任意文件夹位置单机鼠标右键,选择Open Git Bash here点击进入打开shell窗口输入如下命令:#项目地址替换为您项目的地址链接gitclone 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协议地址会出现如下问题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 CE已经可以在CentOS 7服务器中运行并能够完成项目创建、代码克隆、提交和推送等基础操作。代码仓库和项目数据保存在自有服务器中团队也可以根据项目需要继续设置成员和访问权限。通过cpolar为GitLab的8888端口建立公网隧道后原本只能通过局域网IP打开的管理页面可以从其他网络环境访问。继续配置固定二级子域名后公网入口能够保持不变更适合长期保存和团队使用。只让GitLab页面能够在公网打开还不够。如果项目中显示的克隆地址仍然是192.168.x.x等内网地址外部成员依然无法正常拉取代码。将external_url修改为公网域名并重新执行gitlab-ctl reconfigure后仓库页面中的克隆地址才能同步更新。需要注意的是GitLab中保存的是完整代码资产公网开放后应使用普通成员账号和最小权限管理项目避免长期使用root账号直接协作。同时还应设置复杂密码或访问令牌定期备份仓库、配置文件和密钥并根据实际环境规划HTTPS、系统更新、防火墙和登录审计。本文基于CentOS 7与GitLab CE 13.9.6应用到其他系统或版本时需要重新核对安装源、服务组件和配置项。