Debian怎样安装gitlab

在 Debian 上安装 GitLab 主要有两种方式：官方 Omnibus 包（推荐） 和 Docker。下面我以 Debian 11/12 为例，给你一个最常用、最稳妥的安装方案（Omnibus）。

一、安装前准备

1. 系统要求

Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
最低配置
- CPU：2 核
- 内存：4GB 以上（强烈建议 8GB）
- 磁盘：20GB+

2. 更新系统

sudo apt update
sudo apt upgrade -y

3. 安装必要依赖

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

二、使用官方 Omnibus 安装 GitLab（推荐）

1. 下载并运行 GitLab 安装脚本

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

该脚本会自动配置 GitLab 的 APT 源

2. 安装 GitLab CE（社区版）

替换 gitlab.example.com 为你自己的域名或服务器 IP：

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

✅ 示例：

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

3. 初始化配置

sudo gitlab-ctl reconfigure

这一步会：

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

三、访问 GitLab

浏览器访问：

http://你的IP或域名

首次登录：

用户名：root
密码在：

sudo cat /etc/gitlab/initial_root_password

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

四、GitLab 常用命令

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

五、配置域名 + HTTPS（可选但推荐）

1. 修改配置

sudo nano /etc/gitlab/gitlab.rb

external_url 'https://gitlab.example.com'
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['your@email.com']

2. 重新配置

sudo gitlab-ctl reconfigure

六、Docker 方式（可选）

如果你更熟悉 Docker：

docker run -d \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

七、常见问题

1️⃣ 内存不足

GitLab 非常吃内存
建议 8GB RAM
或关闭部分服务（不推荐新手）

2️⃣ 访问慢

关闭或限制 CI Runner
使用 SSD

3️⃣ 端口冲突

GitLab 默认使用 80 / 443 / 22
可修改 /etc/gitlab/gitlab.rb

八、总结（最简流程）

apt update
apt install -y curl
curl -fsSL https://packages.gitlab.com/setup.sh | bash
EXTERNAL_URL="http://你的IP" apt install gitlab-ce -y
gitlab-ctl reconfigure

如果你愿意，我可以帮你：

✅ 对接 LDAP / AD
✅ 配置 SMTP 邮件
✅ 迁移 GitLab
✅ 从 GitHub / Gitea 迁移
✅ 内网离线安装

只要告诉我你的 Debian 版本 + 使用场景 即可。