解决GitLab安装中的TCP连接问题：清华镜像源实战指南

1. 为什么GitLab安装会卡在TCP连接错误？

最近在帮团队搭建GitLab私有仓库时，遇到了经典的"TCP connection reset by peer"报错。这个错误在国内开发者群体中特别常见——当你用默认的yum源安装GitLab时，系统会尝试连接国外的软件仓库，而跨国网络连接就像早高峰挤地铁一样不稳定。

具体表现是执行yum install gitlab-ce时，控制台突然抛出红色错误：

Error: TCP connection reset by peer Trying other mirror...

这时候yum会不死心地尝试其他镜像站，但往往都是徒劳。我实测发现，在晚间网络高峰期，这个错误出现概率高达90%。根本原因是GitLab官方源服务器位于海外，国内访问时容易受到网络波动影响。

2. 清华镜像源为什么是终极解决方案？

2.1 镜像源的工作原理

镜像源就像是一个"本地缓存仓库"。清华TUNA镜像站会定时（通常每小时）从GitLab官方源同步所有软件包到国内服务器。当你使用清华源时：

1. 你的请求直接发往清华校内服务器
2. 服务器返回距离最近的CDN节点
3. 下载速度轻松跑满百兆带宽

我用curl测试过响应时间：

• 官方源：平均延迟380ms
• 清华源：平均延迟28ms

2.2 具体配置步骤

2.2.1 创建repo配置文件

先进入yum配置目录：

cd /etc/yum.repos.d

用vim新建配置文件（不会vim的同学可以用nano）：

vi gitlab-ce.repo

粘贴以下内容时要注意：

• el$releasever会自动匹配你的CentOS主版本
• gpgcheck=0跳过了签名验证（生产环境建议设为1并配置gpgkey）

[gitlab-ce] name=Gitlab CE Repository baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/ gpgcheck=0 enabled=1

2.2.2 更新yum缓存

执行以下命令让配置生效：

yum clean all yum makecache

看到Metadata Cache Created提示才算成功。这里有个坑：如果系统时间不同步会导致缓存失败，建议先执行ntpdate pool.ntp.org同步时间。

3. 安装过程中的避坑指南

3.1 版本兼容性问题

清华镜像源默认提供最新版GitLab，但有些老系统可能需要指定版本。比如我们需要安装12.3.5版本：

yum install gitlab-ce-12.3.5-ce.0.el7

查看可用版本列表：

yum list gitlab-ce --showduplicates

3.2 依赖冲突处理

有时会遇到如下错误：

Error: Package: gitlab-ce-15.0.0-ce.0.el7.x86_64 (gitlab-ce) Requires: /usr/bin/python

这是因为新版GitLab需要Python3但系统只有Python2。解决方法：

yum install python3 alternatives --set python /usr/bin/python3

4. 安装后的必要配置

4.1 修改访问地址

编辑配置文件：

vi /etc/gitlab/gitlab.rb

找到external_url改为你的实际域名或IP：

external_url 'http://gitlab.yourcompany.com'

4.2 邮件服务配置

很多同学会漏配邮件服务，导致用户注册收不到验证码。在配置文件中添加：

gitlab_rails['smtp_enable'] = true gitlab_rails['smtp_address'] = "smtp.exmail.qq.com" gitlab_rails['smtp_port'] = 465 gitlab_rails['smtp_user_name'] = "git@yourcompany.com" gitlab_rails['smtp_password'] = "yourpassword" gitlab_rails['smtp_authentication'] = "login" gitlab_rails['smtp_enable_starttls_auto'] = true gitlab_rails['smtp_tls'] = true

4.3 重置并启动服务

执行配置生效命令（这个过程比较耗时，可能要10-20分钟）：

gitlab-ctl reconfigure

启动所有服务：

gitlab-ctl start

检查服务状态：

gitlab-ctl status

5. 验证安装成功的三个关键点

1. 端口检测：

netstat -tunlp | grep 80

应该看到nginx进程监听80端口

2. 页面访问： 浏览器打开配置的external_url，应该看到GitLab的密码设置页面

3. 健康检查：

gitlab-rake gitlab:check

所有项目都应该显示"Checking... Finished"

6. 常见问题排查手册

6.1 502 Whoops页面

这个问题我遇到过三次，主要原因是：

• 服务器内存不足（GitLab至少需要4GB内存）
• Unicorn worker没有正常启动

解决方法：

# 查看日志定位问题 gitlab-ctl tail unicorn # 临时解决方案（重启服务） gitlab-ctl restart unicorn

6.2 忘记管理员密码

执行以下命令重置：

gitlab-rails console -e production user = User.where(id: 1).first user.password = 'newpassword' user.password_confirmation = 'newpassword' user.save!

6.3 备份与恢复

创建完整备份：

gitlab-rake gitlab:backup:create

恢复备份时要注意：

1. 先确保GitLab版本一致
2. 备份文件放到/var/opt/gitlab/backups
3. 执行：

gitlab-rake gitlab:backup:restore BACKUP=备份文件名

7. 性能优化建议

7.1 数据库调优

编辑/etc/gitlab/gitlab.rb：

postgresql['shared_buffers'] = "256MB" postgresql['max_worker_processes'] = 8

7.2 内存限制配置

对于小内存服务器（4-8GB），建议调整：

unicorn['worker_processes'] = 2 sidekiq['concurrency'] = 5

7.3 定期维护任务

创建cronjob执行垃圾回收：

gitlab-rake gitlab:cleanup:orphan_job_artifact_files gitlab-rake gitlab:cleanup:project_uploads

8. 进阶技巧：容器化部署方案

虽然yum安装简单，但实际生产环境我更推荐Docker部署：

docker run --detach \ --hostname gitlab.example.com \ --publish 443:443 --publish 80:80 \ --name gitlab \ --restart always \ --volume /srv/gitlab/config:/etc/gitlab \ --volume /srv/gitlab/logs:/var/log/gitlab \ --volume /srv/gitlab/data:/var/opt/gitlab \ gitlab/gitlab-ee:latest

这种方式的优势在于：

• 隔离性好，不影响主机其他服务
• 升级回滚方便
• 资源限制更精确

最后提醒下，GitLab非常吃资源，建议生产环境使用8核16G以上配置。如果团队规模小于20人，可以考虑轻量级的Gitea作为替代方案。