在 Debian 12 上安装 GitLab CE(Community Edition)完整指南

发表于 2025-09-09 13:24:43 分类于 Linux运维 阅读量 95

在 Debian 12 上安装 GitLab CE(Community Edition)完整指南

GitLab 是一个开源的 DevOps 平台,提供 Git 仓库管理、CI/CD、问题追踪等功能。在 Debian 12 上安装 GitLab CE(Community Edition),推荐使用官方 Omnibus 安装包,这样依赖、服务管理都已经集成好,非常方便。


🔧 安装步骤

1. 更新系统

先更新系统软件包:

sudo apt update && sudo apt upgrade -y

2. 安装必要依赖

GitLab 需要一些基础依赖:

sudo apt install -y curl openssh-server ca-certificates tzdata perl

如果你需要邮件通知功能,可以安装 Postfix(可选):

sudo apt install -y postfix

安装过程中会提示选择配置类型,选 Internet Site,域名可以随便填(例如你的服务器域名)。


3. 添加 GitLab 官方仓库

执行官方安装脚本添加仓库:

curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

4. 安装 GitLab CE

sudo apt install -y gitlab-ce

5. 配置 GitLab

安装完成后,GitLab 配置文件位于:

/etc/gitlab/gitlab.rb

主要修改访问地址:

sudo nano /etc/gitlab/gitlab.rb

找到:

external_url 'http://gitlab.example.com'

改成你服务器的实际域名或 IP,例如:

external_url 'http://192.168.1.100'

6. 启动并应用配置

sudo gitlab-ctl reconfigure

GitLab 会自动初始化并配置 Nginx、PostgreSQL、Redis 等服务。


7. 访问 GitLab

在浏览器中访问你设置的地址,例如:

http://192.168.1.100

第一次访问会要求设置 root 用户密码。设置完成后即可使用 root 用户登录。


8. 管理常用命令

  • 启动 GitLab:
sudo gitlab-ctl start
  • 停止 GitLab:
sudo gitlab-ctl stop
  • 重启 GitLab:
sudo gitlab-ctl restart
  • 查看服务状态:
sudo gitlab-ctl status

⚠️ 注意事项

  1. GitLab 资源占用较高,建议 4GB RAM 以上 的服务器,否则容易卡顿。
  2. 如果需要域名 + HTTPS,可以直接在 /etc/gitlab/gitlab.rb 中配置 Let’s Encrypt 自动证书。
正物博客
一路向前,山海自平