如何安装debian gitlab

在 Debian 上安装 GitLab（通常指 GitLab CE 社区版），官方推荐方式是使用 Omnibus 包，最简单稳定。下面按步骤说明。

一、准备工作

1. 系统要求

• Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
• 至少 4GB RAM（推荐 4G+，2G 容易卡）
• 干净的服务器（不要和 Nginx/Apache 冲突）

2. 更新系统

sudo apt update
sudo apt upgrade -y

3. 安装依赖

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

（可选）安装 Postfix 用于邮件：

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

方式一：使用域名（推荐）

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

方式二：本地/IP 访问

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

⚠️ EXTERNAL_URL 一旦设置，后期修改需改 /etc/gitlab/gitlab.rb

四、初始化配置

sudo gitlab-ctl reconfigure

首次会花费几分钟。

五、访问 GitLab

• 浏览器打开：

  https://gitlab.example.com
  

• 默认用户名：root
• 初始密码：

  sudo cat /etc/gitlab/initial_root_password
  

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

六、常用命令

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

七、常见问题

1. 端口冲突（如 80/443 被占用）

修改：

sudo nano /etc/gitlab/gitlab.rb

external_url 'http://your-ip:8080'
nginx['listen_port'] = 8080

然后：

sudo gitlab-ctl reconfigure

2. 修改域名

external_url 'https://new.domain.com'

再 reconfigure

八、可选：启用 HTTPS（Let’s Encrypt）

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

sudo gitlab-ctl reconfigure

如果你需要：

• Docker 安装 GitLab
• GitLab Runner 配置
• 离线/内网安装
• Debian + Nginx 反向代理

可以继续告诉我你的使用场景。