温馨提示×

怎样用debian搭gitlab

小樊
41
2026-10-14 07:09:10
栏目: 智能运维

下面给你一个**在 Debian 上自建 GitLab(CE 社区版)**的实用步骤,适用于 Debian 11 / 12,以 官方 Omnibus 包 方式安装(最省心、最常用)。


一、准备环境

1. 系统要求

  • Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
  • 至少 4GB 内存(2GB 能跑但容易 OOM)
  • 建议 CPU ≥ 2 核
  • 一个域名(可选但推荐)
  • 干净系统(不要和 Nginx/PostgreSQL 冲突)

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装依赖

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

(可选,发送邮件用)

sudo apt install -y postfix

选 Internet Site,填域名即可


三、添加 GitLab 官方仓库

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

四、安装 GitLab CE

方式 1:使用域名(推荐)

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

方式 2:先用 IP(后续再改)

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

安装完成后会自动:

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

五、初始化与访问

1. 查看 root 密码

sudo cat /etc/gitlab/initial_root_password

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

2. 浏览器访问

https://gitlab.example.com

或

http://服务器IP

用 root 登录,立即修改密码。


六、常用配置(可选但重要)

1. 修改配置

sudo nano /etc/gitlab/gitlab.rb

示例:

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

2. 重新加载配置

sudo gitlab-ctl reconfigure

3. 常用命令

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

七、开启 HTTPS(推荐)

使用 Let’s Encrypt(最简单)

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']

然后:

sudo gitlab-ctl reconfigure

八、防火墙(如有)

sudo ufw allow 80
sudo ufw allow 443
sudo ufw allow 22

九、常见问题

1. 内存不足

  • 关闭一些组件(如 Mattermost、Prometheus)
mattermost['enable'] = false
prometheus['enable'] = false

2. 访问慢

  • 使用 SSD
  • 增加 swap

3. 想用 Docker 版?

可以,但 Omnibus 更适合新手和生产


十、后续建议

  • 定期备份:
sudo gitlab-rake gitlab:backup:create
  • 升级:
sudo apt update
sudo apt install gitlab-ce

如果你愿意,我可以:

  • 给你 Debian + Docker 版 GitLab
  • 或 内网 GitLab + 反代
  • 或 最小化配置(低内存)

你打算 公网还是内网?有没有域名?

0 踩