Ubuntu环境下GitLab使用常见问题及解决方案
E: Unable to locate package gitlab-ee，多为Ubuntu版本与GitLab包不兼容或包源未正确配置所致。需前往GitLab官方包页面下载对应Ubuntu版本的安装脚本，严格按脚本指示操作；也可通过curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash添加官方APT仓库，再执行sudo apt update && sudo apt install gitlab-ce安装。curl、openssh-server、ca-certificates、postfix等必要依赖，否则会因依赖问题导致安装失败。可通过sudo apt install -y curl openssh-server ca-certificates postfix补充安装。.deb包后手动安装（sudo dpkg -i gitlab-ce.deb）。root，若忘记密码，可通过服务器命令行查看初始密码（cat /etc/gitlab/initial_root_password），或进入容器重置密码（Docker环境下执行docker-compose exec web gitlab-rake "gitlab:password:reset"）。/etc/gitlab/gitlab.rb中的external_url（如从http://IP改为http://domain.com），需执行sudo gitlab-ctl reconfigure重新配置GitLab并重启服务（sudo gitlab-ctl restart），否则无法通过新URL访问。/etc/gitlab/gitlab.rb中的端口设置（如nginx['listen_port'] = 8080）解决，修改后需重新配置并重启。runsv not running错误，需手动启动gitlab-runsvdir服务（sudo systemctl start gitlab-runsvdir）；若出现500/502错误，多为服务器资源不足（如内存小于2GB）或配置文件错误所致。可通过sudo gitlab-ctl tail查看日志定位具体原因，内存不足时可添加Swap分区（sudo fallocate -l 2G /swapfile）。sudo gitlab-ctl status），确保unicorn、sidekiq等服务均处于run状态；若状态异常，可尝试重启服务（sudo gitlab-ctl restart）。Permission denied (publickey)，需确认本地SSH密钥已添加至GitLab账户（ssh-copy-id git@your_server_ip），并检查~/.ssh/config文件是否正确配置（如Host your_server_ip段包含IdentityFile ~/.ssh/id_rsa）。sudo gitlab-rake gitlab:check检查账户状态，或重置密码（方法同上）；若使用LDAP认证，需确认LDAP配置正确（/etc/gitlab/gitlab.rb中的gitlab_rails['ldap_servers']设置）。sudo swapon /swapfile）或升级服务器配置解决。sudo du -sh /var/opt/gitlab/查看磁盘使用情况，清理过期流水线（sudo gitlab-rake gitlab:pipeline:cleanup）或备份文件（sudo gitlab-backup delete）。docker-compose.yml中配置数据卷（如volumes: - '/srv/gitlab/config:/etc/gitlab' - '/srv/gitlab/logs:/var/log/gitlab' - '/srv/gitlab/data:/var/opt/gitlab'），确保数据持久化。
