Debian如何部署GitLab

在 Debian 上部署 GitLab，官方最推荐、最稳定的方式是使用 Omnibus 包。下面我按 最新 Debian（11/12） 给你一个完整、可用的部署流程（含常见坑）。

一、准备环境

系统要求（最低）

1. Debian 11（Bullseye）或 Debian 12（Bookworm）
2. 至少 4GB 内存（2GB 会非常卡）
3. CPU：2 核以上
4. 磁盘：20GB+

更新系统

sudo apt update && sudo apt -y upgrade

二、安装依赖

sudo apt install -y 

curl

openssh-server

ca-certificates

tzdata

perl

三、添加 GitLab 官方仓库

下载并运行 GitLab 安装脚本

curl -fsSL https://packages.gitlab.com/setup.sh | sudo bash

该脚本会自动识别 Debian 版本

四、安装 GitLab（关键步骤）

设置访问地址（非常重要）

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

推荐做法（本地或内网）

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

例如：

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

如果你打算用域名，请提前解析好 DNS

五、初始化 GitLab

sudo gitlab-ctl reconfigure

第一次会耗时 2–5 分钟

六、访问 GitLab

浏览器访问：

http://服务器IP

默认账号

1. 用户名：root
2. 密码获取方式：

sudo cat /etc/gitlab/initial_root_password

密码只在 24 小时内可见

七、基础配置（非常重要）

修改配置文件

sudo nano /etc/gitlab/gitlab.rb

常见修改项：

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

gitlab_rails['gitlab_email_enabled'] = true

gitlab_rails['gitlab_default_from_email'] = '[email protected]'

修改后执行：

sudo gitlab-ctl reconfigure

八、常用管理命令

sudo gitlab-ctl status重启sudo gitlab-ctl restart停止sudo gitlab-ctl stop查看日志sudo gitlab-ctl tail

九、可选：开启 HTTPS（推荐）

方式一：Let’s Encrypt（自动）

letsencrypt['enable'] = true

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

然后：

sudo gitlab-ctl reconfigure

十、常见问题

内存不足

1. 建议 4GB+
2. 或关闭部分服务（不推荐新手）

访问 502

1. 等待 1–2 分钟
2. 或检查端口 80 / 8080 是否被占用

卡在 reconfigure

1. 检查 /etc/hosts
2. 确保 hostname -f 有返回值

十一、CE 还是 EE？

GitLab EE官方默认，免费功能够用GitLab CE已合并进 EE

直接装 EE 即可

十二、总结（最简流程）

apt update

apt install -y curl openssh-server

curl -fsSL https://packages.gitlab.com/setup.sh | bash

EXTERNAL_URL="http://服务器IP" apt install gitlab-ee

gitlab-ctl reconfigure

如果你愿意，可以告诉我：

1. Debian 版本
2. 是否内网 / 公网
3. 是否要 Docker 部署
4. 是否要 中文界面

我可以给你 定制版部署方案（比如 Docker + Nginx + HTTPS）。