温馨提示×

debian下gitlab怎么部署

小樊
36
2026-09-20 19:02:25
栏目: 智能运维

在 Debian 下部署 GitLab,通常推荐使用 官方 Omnibus 包(一键安装、好维护)。下面给你一份从零开始的可操作流程(以 Debian 11/12 为例)。


一、准备工作

1. 系统要求

  • Debian 11(Bullseye)或 Debian 12(Bookworm)
  • 至少 4GB 内存(推荐 4G+,2G 会非常卡)
  • 已配置好域名(可选但推荐)
  • root 或具有 sudo 权限的用户操作

二、安装依赖

sudo apt update
sudo apt install -y curl openssh-server ca-certificates postfix

postfix 用于邮件通知,选 Internet Site 即可(可后续改)


三、添加 GitLab 源并安装

方式一:官方脚本(最简单)

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

社区版用 gitlab-ce,企业版用 gitlab-ee

安装 GitLab(以 CE 为例):

sudo EXTERNAL_URL="http://gitlab.example.com" apt install gitlab-ce

如果是本机测试:

sudo EXTERNAL_URL="http://你的服务器IP" apt install gitlab-ce

四、初始化配置

sudo gitlab-ctl reconfigure

这一步会:

  • 自动配置 Nginx
  • 初始化数据库
  • 启动所有服务

五、访问 GitLab

浏览器访问:

http://服务器IP

首次登录:

  • 用户名:root
  • 密码在:
sudo cat /etc/gitlab/initial_root_password

⚠️ 该文件 24 小时后会自动删除


六、常用管理命令

sudo gitlab-ctl status        # 查看状态
sudo gitlab-ctl stop          # 停止
sudo gitlab-ctl start         # 启动
sudo gitlab-ctl restart       # 重启
sudo gitlab-ctl tail          # 查看日志

七、修改配置(如域名、端口)

编辑:

sudo nano /etc/gitlab/gitlab.rb

例如:

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

修改后执行:

sudo gitlab-ctl reconfigure

八、开启 HTTPS(推荐)

使用 Let’s Encrypt

external_url 'https://gitlab.example.com'
letsencrypt['enable'] = true
letsencrypt['auto_renew'] = true

然后:

sudo gitlab-ctl reconfigure

九、常见问题

1. 内存不足

  • 关闭一些服务(如 Mattermost)
  • 或增加 swap

2. 端口冲突(如 80 被占用)

修改:

nginx['listen_port'] = 8080

3. 想用 Docker 版?

也可以,但 Omnibus 更适合生产环境


十、总结

✅ Debian 下最推荐方式:

Omnibus 安装 + 官方源 + reconfigure

如果你需要:

  • Docker 部署
  • 离线安装
  • 高可用 / 备份迁移
  • 中文配置

可以继续问我。

0