在 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
⚠️ 注意事项
- GitLab 资源占用较高,建议 4GB RAM 以上 的服务器,否则容易卡顿。
- 如果需要域名 + HTTPS,可以直接在
/etc/gitlab/gitlab.rb
中配置 Let’s Encrypt 自动证书。