GitLab在Ubuntu上的安装步骤

Ubuntu 上安装 GitLab 的标准流程

一 环境准备

• 建议使用 Ubuntu 20.04/22.04/24.04 LTS，并准备至少 4GB 内存（推荐 8GB+）、2 核 CPU（推荐 4 核+）、10GB 磁盘空间（推荐 20GB+）。确保以 root 或 sudo 权限执行安装命令。

二 安装步骤 Omnibus 方式（推荐）

• 1）安装依赖
  • 执行：sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata perl
  • 如需邮件通知，建议安装并配置 Postfix（安装过程中选择 Internet Site 并设置系统主机名）。
• 2）添加 GitLab 仓库
  • 执行：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
• 3）安装 GitLab 社区版
  • 执行：sudo apt install -y gitlab-ce
• 4）配置并启动
  • 编辑配置文件：sudo nano /etc/gitlab/gitlab.rb，设置外部访问地址，例如：external_url 'http://<服务器IP或域名>'
  • 应用配置并启动：sudo gitlab-ctl reconfigure
• 5）访问与初始登录
  • 浏览器访问：http://<服务器IP或域名>
  • 默认管理员账号为 root，初始密码保存在 /etc/gitlab/initial_root_password，该文件会在 24 小时后自动删除，请尽快登录并修改密码。

三 防火墙与端口开放

• 如使用 UFW：开放 HTTP（80）/HTTPS（443）端口
  • 执行：sudo ufw allow http 与 sudo ufw allow https
• 如使用云服务器，请在安全组放行 80/443（以及你自定义的端口）。

四 常用运维命令

• 启动/停止/重启/状态：sudo gitlab-ctl start|stop|restart|status
• 重新加载配置（修改 /etc/gitlab/gitlab.rb 后执行）：sudo gitlab-ctl reconfigure
• 设置开机自启动（确保 runsvdir 随系统启动）：sudo systemctl enable gitlab-runsvdir.service
• 查看日志：sudo gitlab-ctl tail（或进入 /var/log/gitlab 目录查看各组件日志）。

五 可选方案与后续配置

• Docker 部署（适合快速试用与隔离环境）
  • 执行示例：

    docker run --detach \
      --hostname yourdomain.com \
      --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
    

  • 持久化目录：配置 /etc/gitlab、日志 /var/log/gitlab、数据 /var/opt/gitlab。
• 后续建议
  • 配置 HTTPS/SSL（可使用 Let’s Encrypt 或自有证书）。
  • 配置 邮件（SMTP） 用于通知与找回密码。
  • 定期 备份与恢复：创建备份 sudo gitlab-rake gitlab:backup:create；恢复参考官方文档执行恢复流程。