Ubuntu 上 GitLab 使用教程精选与快速上手
一 安装与部署
- 使用 Omnibus 包安装（推荐）
- 更新系统并安装依赖：sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata perl
- 添加官方仓库并安装：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash，随后 sudo apt install -y gitlab-ce
- 首次配置：sudo gitlab-ctl reconfigure
- 访问地址：http://<服务器IP或域名>；管理员账号为 root，初始密码在 /etc/gitlab/initial_root_password，该文件会在 24 小时后自动删除，请尽快登录并修改密码
- 使用 Docker 部署（便于迁移与隔离）
- 运行示例：docker run --detach --hostname localhost --publish 443:443 --publish 80:80 --publish 22:22 --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-ce:latest
- 说明：将主机端口 80/443/22 映射到容器内，持久化目录分别为 config、logs、data
二 基础配置与运维
- 核心配置文件与生效方式
- 编辑：sudo vim /etc/gitlab/gitlab.rb，常见项为 external_url ‘http://your_domain_or_ip’
- 使配置生效：sudo gitlab-ctl reconfigure
- 服务管理常用命令
- 启动/停止/重启/状态：sudo gitlab-ctl start|stop|restart|status
- 邮件通知 SMTP 示例
- 在 /etc/gitlab/gitlab.rb 中启用并填写：gitlab_rails[‘smtp_enable’] = true；gitlab_rails[‘smtp_address’] = “smtp.example.com”；gitlab_rails[‘smtp_port’] = 465；gitlab_rails[‘smtp_user_name’] = “user@example.com”；gitlab_rails[‘smtp_password’] = “password”；gitlab_rails[‘smtp_authentication’] = “login”；gitlab_rails[‘smtp_enable_starttls_auto’] = true；gitlab_rails[‘smtp_tls’] = true
- 防火墙放行
- UFW 示例：sudo ufw allow 80/tcp；sudo ufw allow 443/tcp；sudo ufw allow 22/tcp；sudo ufw reload
三 日常使用流程
- 登录与初始设置
- 使用浏览器访问实例地址，使用 root 和初始密码登录，并立即修改密码
- 创建项目与代码托管
- 在 Web 界面点击 “New Project”，填写项目名称、描述与可见性后创建
- 本地初始化并推送示例：git init；git add .；git commit -m “init”；git remote add origin <项目URL>；git push -u origin main
- 克隆与分支管理
- 克隆方式：HTTPS：git clone https://<your_domain_or_ip>//.git；SSH：git clone git@<your_domain_or_ip>:/.git
- 分支操作：git branch new-branch；git checkout new-branch；开发完成后合并到 main 并推送
四 备份恢复与安全加固
- 备份与恢复
- 创建备份：sudo gitlab-backup create（Omnibus 新版本推荐）或 sudo gitlab-rake gitlab:backup:create（旧版本）；备份文件默认位于 /var/opt/gitlab/backups
- 恢复备份：先确保实例已安装同版本，将备份文件放入备份目录后执行 sudo gitlab-backup restore BACKUP= 或 sudo gitlab-rake gitlab:backup:restore BACKUP=
- 安全与可用性建议
- 修改默认管理员账户名与强密码策略，开启 2FA
- 配置 HTTPS/TLS（Let’s Encrypt 或自有证书），对外仅暴露 80/443，SSH 使用非默认端口时同步调整防火墙与 GitLab 配置
- 定期升级 GitLab 版本，保持安全补丁更新；限制管理接口与内网访问，审计关键操作日志
