Ubuntu 上 GitLab 启动失败的原因很多,需要结合具体现象和日志来判断。下面我按「常见原因 → 排查方法 → 解决思路」给你一个系统性的排查清单,你可以对照看是哪一种。
sudo gitlab-ctl status
常见结果:
downnginx、postgresql、redis)失败reconfiguringsudo gitlab-ctl tail
或单独看某个服务:
sudo gitlab-ctl tail nginx
sudo gitlab-ctl tail postgresql
sudo gitlab-ctl tail redis
GitLab 官方建议 至少 4GB 内存。
检查:
free -h
现象:
postgresql 或 sidekiq 启动后立即退出oom-killer 日志解决:
常见冲突:
检查:
sudo netstat -tulnp | grep -E '80|443|8080'
解决:
编辑过:
/etc/gitlab/gitlab.rb
但没生效或写错:
解决:
sudo gitlab-ctl reconfigure
如果报错,按报错行修 gitlab.rb
常见于:
/var/opt/gitlab修复权限:
sudo gitlab-ctl reconfigure
sudo chown -R git:git /var/opt/gitlab
df -h
GitLab 对磁盘非常敏感,尤其:
/var/opt/gitlab/var/log/gitlabUbuntu 20.04+ 使用 systemd:
sudo systemctl status gitlab-runsvdir
启动:
sudo systemctl start gitlab-runsvdir
开机自启:
sudo systemctl enable gitlab-runsvdir
例如:
建议:
你可以依次执行:
free -h
df -h
sudo gitlab-ctl status
sudo gitlab-ctl reconfigure
sudo gitlab-ctl tail
请把以下信息贴出来(脱敏即可):
lsb_release -a)cat /opt/gitlab/version-manifest.txt | head)sudo gitlab-ctl status 输出sudo gitlab-ctl tail 的前 30 行)我可以直接告诉你是哪一步挂了、怎么修。