gitlab在debian怎么部署

下面给你一份**在 Debian 上部署 GitLab（社区版 CE）**的实用指南，适用于 Debian 11 / 12。

一、准备工作

1. 系统要求

• Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
• 至少 4GB 内存（2GB 也能跑，但不推荐）
• 干净系统（建议专用服务器）

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装依赖

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

三、添加 GitLab 源并安装

方式一：官方脚本（最简单）

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

安装 GitLab CE

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

⚠️ EXTERNAL_URL 改成你的域名或 IP
如果用 IP：http://192.168.1.100

四、配置 GitLab

重新加载配置

sudo gitlab-ctl reconfigure

启动服务

sudo gitlab-ctl start

查看状态

sudo gitlab-ctl status

五、首次访问

浏览器访问：

http://你的IP或域名

首次登录：

• 用户名：root
• 密码在：

sudo cat /etc/gitlab/initial_root_password

密码仅显示一次，请尽快修改

六、常用命令

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

七、可选配置（推荐）

1. 修改配置文件

sudo nano /etc/gitlab/gitlab.rb

常见修改：

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

修改后执行：

sudo gitlab-ctl reconfigure

2. 启用 HTTPS（Let’s Encrypt）

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

3. 邮件配置（SMTP）

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "gitlab@example.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true

八、卸载 GitLab

sudo gitlab-ctl uninstall
sudo apt remove gitlab-ce
sudo rm -rf /etc/gitlab /var/opt/gitlab /var/log/gitlab

九、常见问题

1. 访问很慢

• 内存不足
• 可关闭部分服务（如 Mattermost）

2. 端口冲突

GitLab 默认使用：

• 80（HTTP）
• 443（HTTPS）
• 22（SSH）

3. 防火墙

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

如果你需要：

• Docker 方式部署
• GitLab + Nginx 反向代理
• GitLab Runner（CI/CD）

告诉我，我可以一步一步帮你配。