在Debian上部署GitLab需要哪些步骤

在Debian上部署GitLab的详细步骤

1. 准备工作：更新系统并安装依赖

首先，确保Debian系统软件包为最新状态，避免兼容性问题：

sudo apt update && sudo apt upgrade -y

安装GitLab运行必需的依赖包（包括SSH服务、证书、时区数据等）：

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

2. 添加GitLab官方软件仓库

GitLab需通过官方仓库安装以获取最新版本。执行以下命令添加仓库：

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

该命令会自动导入GitLab的GPG密钥并配置APT仓库源。

3. 安装GitLab社区版（CE）

通过APT安装GitLab CE（免费社区版）：

sudo apt install gitlab-ce

安装过程中，系统会提示设置external_url（GitLab访问地址，如http://your_server_ip或域名），需根据实际情况填写。

4. 配置GitLab

安装完成后，需修改配置文件调整GitLab行为：

• 编辑主配置文件：

  sudo nano /etc/gitlab/gitlab.rb
  

• 找到external_url参数，修改为你的服务器公网IP或域名（如external_url 'http://192.168.1.100'），保存并退出。
• 应用配置变更：

  sudo gitlab-ctl reconfigure
  

  此命令会自动调整GitLab服务设置、初始化数据库及生成配置文件。

5. 启动GitLab服务

启动GitLab并设置开机自启：

sudo systemctl start gitlab
sudo systemctl enable gitlab

验证服务状态（确保无报错）：

sudo gitlab-ctl status

6. 配置防火墙（可选但推荐）

若服务器启用了UFW防火墙，需开放HTTP（80）和SSH（22）端口，允许外部访问GitLab：

sudo ufw allow http
sudo ufw allow ssh
sudo ufw reload

7. 访问GitLab

通过浏览器访问http://your_server_ip（或配置的域名），首次登录需设置root管理员密码（密码会保存在/etc/gitlab/initial_root_password文件中，首次登录后建议立即修改）。

8. 可选：配置HTTPS（增强安全性）

为避免数据传输泄露，建议使用Let’s Encrypt免费获取SSL证书，配置HTTPS：

sudo apt install certbot python3-certbot-nginx  # 若使用Nginx
sudo certbot --nginx -d your-gitlab-domain.com

按提示完成证书申请，GitLab会自动适配HTTPS访问。

注意事项

• 资源要求：GitLab至少需要2GB内存和20GB磁盘空间，建议使用更高配置以保证性能。
• 默认管理员：首次登录的管理员账号为root，密码可通过/etc/gitlab/initial_root_password查看。
• 版本选择：若需特定版本，可在添加仓库时指定分支（如bullseye对应Debian 11），参考GitLab官方文档。

完成以上步骤后，GitLab即可在Debian系统上正常运行，支持代码托管、CI/CD等功能。