直接用docker-compose部署gitlab ce最稳：避免系统污染、依赖隔离、升级省心；需确保内存≥8g、禁用localhost配置external_url、显式声明ssh端口、三路径独立挂载。
别装 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。
