Linux搭建GitLab私有仓库教程

本文详解如何通过 docker-compose 稳健部署 GitLab CE 私有仓库，强调容器化方案在避免系统污染、隔离依赖、简化升级与故障排查上的显著优势，并直击常见部署痛点：必须确保内存≥8G、禁用 localhost 类 external_url、显式配置 SSH 端口、严格分离 config/logs/data 三路径挂载；同时深入剖析 gitlab-ctl reconfigure 卡死的五大真实原因（内存不足、SELinux 干预、Postfix 未就绪、external_url 错误、磁盘空间不足），并给出启动后无法访问时的精准排查路径——从容器状态、日志错误、防火墙策略到协议端口一致性，帮你一次性绕过所有“看似玄学实则可解”的坑，真正实现开箱即用、稳定可靠的私有代码托管。

别装 Omnibus 包，直接用 docker-compose 部署 GitLab CE —— 这是目前最稳、升级最省心、排查最直观的方式。直接 apt/yum 安装会污染系统服务（比如接管 postfix、nginx、systemd），reconfigure 失败率高，且错误提示极不友好；而容器化部署把所有依赖锁死在镜像里，配置改错也不会影响宿主机。

gitlab-ctl reconfigure 卡住或失败的真正原因

这不是 GitLab 脚本坏了，而是底层资源或依赖没对齐。常见卡点有：

• 内存不足：低于 8G 时，PostgreSQL 和 Redis 同时启动会争资源，gitlab-ctl reconfigure 假死；用 free -h 看可用内存是否 ≥ 6GB
• SELinux 干预（CentOS/RHEL）：没装 policycoreutils-python-utils，/var/opt/gitlab 目录权限初始化失败
• Postfix 未就绪：GitLab 启动时检查 SMTP 状态，systemctl is-active postfix 必须返回 active，否则 hang 在 mailroom 阶段
• external_url 写成 http://localhost 或 http://127.0.0.1：导致 Nginx 构造的静态资源路径、SSH 克隆地址、Webhook 回调全错，浏览器跳 404 或克隆连自己本地
• 磁盘空间不足：/var/opt/gitlab 默认占大头，100G 硬盘装完只剩 20G，CI runner、LFS、备份全崩

docker-compose.yml 中必须改的三个关键字段

不改这三项，GitLab 启动后根本无法访问或推送代码：

• external_url 必须填实际可访问地址，例如 'http://192.168.1.100:8080' 或 'https://gitlab.example.com'；禁用 localhost 和 127.0.0.1
• gitlab_rails['gitlab_shell_ssh_port'] = 2222 必须显式声明：宿主机 OpenSSH 通常已占 22 端口，不改会导致 git clone git@xxx:/xx 超时
• volumes 三路径必须分开挂载：./gitlab/config:/etc/gitlab（配置）、./gitlab/logs:/var/log/gitlab（日志）、./gitlab/data:/var/opt/gitlab（仓库+数据库）；混挂或少挂一个，重启后项目全丢

启动后连不上？先查这三处

常见现象：浏览器打不开、git clone 报 Connection refused、SSH 推送超时。按顺序排查：

• 执行 docker ps -a | grep gitlab，确认状态是 Up；若为 Restarting 或 Exited，立刻跑 docker logs -f gitlab，重点搜 error 和 failed —— 90% 是 shm_size 不够或磁盘满
• 检查防火墙和云厂商安全组：若用了 8080:80 映射，必须同步放行宿主机 8080 端口，不能只开 80
• 确认 external_url 中的协议（http:// 还是 https://）与端口一致；若配了 https://，但没配 nginx['ssl_certificate']，Nginx 根本启不来

最容易被忽略的是：external_url 不只是“你从哪访问”，它还决定 SSH URL 生成格式、Webhook 回调地址、邮件里的链接、Avatar 图片路径——写错一个地方，整个协作链路就断。别图省事填 localhost，哪怕只在本机测试，也该用 http://$(hostname -I | awk '{print $1}'):8080 动态取主网卡 IP。

以上就是《Linux搭建GitLab私有仓库教程》的详细内容，更多关于的资料请关注golang学习网公众号！