温馨提示×

怎么在debian配置gitlab

小樊
42
2026-10-08 09:41:35
栏目: 智能运维

在 Debian 上配置 GitLab,通常推荐使用 GitLab 官方 Omnibus 包,部署简单、维护方便。下面按步骤说明。


一、准备工作

1. 系统要求

  • Debian 11(Bullseye)或 Debian 12(Bookworm)
  • 至少 4GB 内存(2GB 勉强可用,但不推荐)
  • 一个非 root 用户(用 sudo)

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装依赖

sudo apt install -y curl openssh-server ca-certificates postfix
  • postfix:用于邮件通知
  • 若不使用邮件,可选择 No configuration

三、添加 GitLab 仓库

使用官方脚本(推荐)

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

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


四、安装 GitLab

1. 设置访问地址

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

如果是本地服务器:

sudo EXTERNAL_URL="http://192.168.1.100" apt install gitlab-ee

五、初始化配置

sudo gitlab-ctl reconfigure

首次配置会花几分钟。


六、访问 GitLab

浏览器打开:

http://你的IP或域名

默认用户:

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

七、基础配置(可选)

1. 修改配置文件

sudo nano /etc/gitlab/gitlab.rb

常见配置:

external_url 'http://gitlab.example.com'
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'

修改后执行:

sudo gitlab-ctl reconfigure

2. 常用命令

sudo gitlab-ctl status
sudo gitlab-ctl restart
sudo gitlab-ctl stop

八、启用 HTTPS(推荐)

使用 Let’s Encrypt:

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

然后:

sudo gitlab-ctl reconfigure

九、常见问题

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

修改:

nginx['listen_port'] = 8080

并重写 external_url 带上端口。

2. 内存不足

可关闭部分服务(如 registry、pages):

registry['enable'] = false
gitlab_pages['enable'] = false

如果你愿意,我可以:

  • 帮你做 最小内存配置
  • 配置 Docker 版 GitLab
  • 配置 GitLab Runner(CI/CD)

你目前是本地测试还是生产环境?

0 踩