gitlab在debian如何设置

下面给你一份**在 Debian 上安装并配置 GitLab（社区版 CE）**的常用做法，适合自建服务器使用。

一、系统准备

1. 系统要求

• Debian 11 / 12（推荐）
• 至少 4GB 内存（2GB 勉强可跑，但容易卡）
• 已配置好 hostname 和域名（可选但推荐）

sudo apt update
sudo apt upgrade -y

设置主机名（可选）：

sudo hostnamectl set-hostname gitlab.example.com

二、安装 GitLab CE

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

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

安装 GitLab（替换为你自己的域名）：

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

如果用 IP 访问：

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

三、基础配置

1. 编辑配置文件

sudo vim /etc/gitlab/gitlab.rb

常见配置项：

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

# 邮箱（可选）
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"

2. 重新加载配置

sudo gitlab-ctl reconfigure

四、防火墙与访问

开放端口

sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

访问 GitLab

• 浏览器打开：https://gitlab.example.com
• 初始管理员账号：root
• 查看初始密码：

sudo cat /etc/gitlab/initial_root_password

五、启用 HTTPS（推荐）

GitLab 自带 Let’s Encrypt：

letsencrypt['enable'] = true
letsencrypt['auto_renew'] = true

然后：

sudo gitlab-ctl reconfigure

六、常用管理命令

sudo gitlab-ctl status
sudo gitlab-ctl stop
sudo gitlab-ctl start
sudo gitlab-ctl restart
sudo gitlab-ctl tail

七、备份与恢复（重要）

备份

sudo gitlab-rake gitlab:backup:create

恢复

sudo gitlab-rake gitlab:backup:restore BACKUP=时间戳

八、常见问题

1. 内存不足

• 关闭一些服务（如 Mattermost）

mattermost['enable'] = false

2. 访问慢

• 使用 SSD
• 增加 swap

3. 修改端口

external_url 'http://gitlab.example.com:8080'
nginx['listen_port'] = 8080

如果你告诉我：

• Debian 版本
• 是否用 Docker
• 是否内网/公网
• 是否需要 CI/CD、LDAP、邮件

我可以给你更精确的配置方案。