GitLab在Linux环境下如何部署

Linux环境下部署GitLab的完整指南

一环境准备与规划

二安装方式一 Omnibus包安装 Ubuntu或CentOS

Ubuntu/Debian
1. 安装依赖
  sudo apt-get update && sudo apt-get install -y curl openssh-server ca-certificates tzdata perl
2. 添加官方仓库并安装
  curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
  sudo apt-get install -y gitlab-ce
3. 配置外部访问地址（将域名或IP替换为你的实际地址）
  echo “external_url ‘http://your_domain_or_ip’” | sudo tee -a /etc/gitlab/gitlab.rb
4. 应用配置并启动
  sudo gitlab-ctl reconfigure
  sudo gitlab-ctl start
CentOS/RHEL
1. 安装依赖
  sudo yum install -y curl policycoreutils-python openssh-server postfix
  sudo systemctl enable --now postfix
2. 添加官方仓库并安装
  curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
  sudo yum install -y gitlab-ce
3. 配置外部访问地址
  echo “external_url ‘http://your_domain_or_ip’” | sudo tee -a /etc/gitlab/gitlab.rb
4. 应用配置并启动
  sudo gitlab-ctl reconfigure
  sudo gitlab-ctl start
防火墙放行示例
Ubuntu：sudo ufw allow 80,443,22/tcp && sudo ufw enable
CentOS：sudo firewall-cmd --permanent --add-service=http --add-service=https && sudo firewall-cmd --reload

三安装方式二 Docker与Docker Compose

Docker单容器运行（示例将宿主机5480→80、5443→443、5022→22）
sudo docker run --detach
–hostname gitlab.example.com
–publish 5480:80 --publish 5443:443 --publish 5022: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
Docker Compose（推荐，便于编排与持久化）
version: “3.6” services: gitlab: image: gitlab/gitlab-ce:latest container_name: gitlab restart: always hostname: gitlab.example.com ports: - “5480:80” - “5443:443” - “5022:22” volumes: - ./config:/etc/gitlab - ./logs:/var/log/gitlab - ./data:/var/opt/gitlab shm_size: “256m” 启动：docker-compose up -d
获取初始root密码（容器首次启动后24小时内有效）
docker exec -it gitlab cat /etc/gitlab/initial_root_password
说明：如需EE版本，可将镜像更换为gitlab/gitlab-ee:latest；端口映射请与现有服务避免冲突。

四首次访问与安全加固

首次访问与初始化
浏览器访问配置的external_url（如：http://your_domain_or_ip），按向导设置管理员密码；默认管理员为root。
启用HTTPS与证书
方案A（推荐）：使用Let’s Encrypt自动签发
Ubuntu/Debian：sudo apt-get install -y certbot python3-certbot-nginx
CentOS/RHEL：sudo yum install -y certbot
获取证书后，在**/etc/gitlab/gitlab.rb**中配置：
nginx[‘redirect_http_to_https’] = true
nginx[‘ssl_certificate’] = “/etc/letsencrypt/live/your_domain/fullchain.pem”
nginx[‘ssl_certificate_key’] = “/etc/letsencrypt/live/your_domain/privkey.pem”
然后执行：sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart
方案B：使用已有证书，将证书路径写入gitlab.rb并reconfigure。
邮件通知SMTP（示例为端口587 STARTTLS）
在**/etc/gitlab/gitlab.rb**中配置：
gitlab_rails[‘smtp_enable’] = true
gitlab_rails[‘smtp_address’] = “smtp.example.com”
gitlab_rails[‘smtp_port’] = 587
gitlab_rails[‘smtp_user_name’] = “your_email@example.com”
gitlab_rails[‘smtp_password’] = “your_password”
gitlab_rails[‘smtp_domain’] = “example.com”
gitlab_rails[‘smtp_authentication’] = “login”
gitlab_rails[‘smtp_enable_starttls_auto’] = true
gitlab_rails[‘smtp_tls’] = false
执行：sudo gitlab-ctl reconfigure（必要时重启）。

五运维常用命令与备份恢复

常用运维
查看状态：sudo gitlab-ctl status
重启/停止：sudo gitlab-ctl restart / sudo gitlab-ctl stop
重新配置（修改gitlab.rb后必执行）：sudo gitlab-ctl reconfigure
查看日志：sudo gitlab-ctl tail（可加服务名，如：sudo gitlab-ctl tail nginx）
版本信息：gitlab-ctl version
备份与恢复（Omnibus）
备份：sudo /opt/gitlab/bin/gitlab-backup create（或旧版本：sudo gitlab-rake gitlab:backup:create）
恢复：将备份文件放到**/var/opt/gitlab/backups/**，执行
sudo /opt/gitlab/bin/gitlab-backup restore BACKUP=timestamp_of_backup
注意：恢复前确保版本一致，恢复后按需重启服务。
离线安装提示（无外网环境）
在有网环境下载gitlab-ce/gitlab-ee的RPM/DEB包及依赖，拷贝至离线主机后本地安装；安装完成后同样通过gitlab-ctl reconfigure初始化。

最新问答