Linux系统中安装GitLab

原创于 2025-05-03 14:00:00 发布 · 1.6k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#linux #gitlab #运维

运维专栏收录该内容

36 篇文章

订阅专栏

一、安装前准备：确认系统要求（新手必看！）

系统版本：推荐 Ubuntu 20.04 或更高（本文以 Ubuntu 22.04 为例）。
内存要求：
- 最低：2GB RAM（仅建议测试环境，需按后文优化内存）。
- 推荐：4GB+ RAM（生产环境更流畅）。
网络要求：确保服务器能联网，且防火墙允许 80（HTTP）、443（HTTPS）、22（SSH） 端口访问（后文会教你开端口）。

二、安装 GitLab（新手选方法 1 更简单！）

方法 1：官方包一键安装（推荐新手）

思路：用官方提供的安装包，全程自动配置，无需手动编译，适合新手。

第 1 步：更新系统（确保软件是最新的）

打开终端（快捷键 Ctrl+Alt+T），输入以下命令：

sudo apt update    # 检查软件更新
sudo apt upgrade -y  # 安装更新（-y 表示自动确认，不用手动输入 yes）

新手提示：sudo 是「以管理员权限执行」的意思，输入命令后可能需要输入你的系统密码（输入时看不到光标移动，输完按回车即可）。

第 2 步：安装必要工具（GitLab 需要这些「配件」）

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

解释：

curl：用于下载文件
openssh-server：允许远程连接服务器
其他：证书、时区等基础组件

第 3 步：添加 GitLab 官方安装源（告诉系统去哪下载 GitLab）

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

新手注意：这一步会自动添加 GitLab 的下载地址到你的系统，耐心等待几秒钟，看到 Successfully added repository 就表示成功。

第 4 步：安装 GitLab（关键！记得替换你的域名/IP）

sudo EXTERNAL_URL="http://你的域名或服务器IP" apt install gitlab-ce -y

举例：

如果你服务器的公网 IP 是 192.168.1.100，就写：

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

如果你有域名（比如 git.example.com），就写：

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

注意：这里的 URL 是未来访问 GitLab 的地址，安装后很难修改，新手建议先用 IP 测试，后续再绑定域名。

第 5 步：启动 GitLab（安装完成后激活服务）

sudo gitlab-ctl reconfigure  # 自动配置并启动服务

等待提示：命令会运行几分钟，最后看到 gitlab Reconfigured! 就成功了。

方法 2：用 Docker 安装（适合想「轻量化部署」的新手）

提示：如果看不懂 Docker 是什么，建议先跳过，用方法 1 更简单。
Docker 是一种「容器化工具」，能隔离环境，适合不想污染系统的场景。

第 1 步：安装 Docker（先装 Docker 引擎）

sudo apt update
sudo apt install -y docker.io  # 安装 Docker
sudo systemctl enable --now docker  # 让 Docker 开机自动启动

第 2 步：拉取 GitLab 镜像（从仓库下载 GitLab 安装包）

docker pull gitlab/gitlab-ce:latest  # 拉取最新社区版镜像

第 3 步：运行 GitLab 容器（启动一个隔离的 GitLab 环境）

docker run --detach \
  --hostname "你的域名或IP" \
  --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/logs:/var/log/gitlab \
  gitlab/gitlab-ce:latest

新手关键参数解释：

--publish 80:80：将容器内的 80 端口映射到服务器的 80 端口，这样浏览器才能访问。
--volume：将容器内的数据保存到服务器本地目录，避免容器删除后数据丢失。

三、首次访问 GitLab（新手必看！）

打开浏览器：在地址栏输入你安装时填写的 EXTERNAL_URL，例如：
- http://192.168.1.100（IP 访问）
- http://git.example.com（域名访问）
设置初始密码：
- 首次登录会看到「设置密码」页面，输入你想要的密码（建议复杂度高一些，如包含字母、数字、符号）。
- 默认用户名是 root（管理员账号）。

查看初始密码（如果忘记了）：
如果错过密码设置页面，可在终端输入：

cat /etc/gitlab/initial_root_password  # 查看临时密码（仅首次有效，登录后会提示修改）

四、常用管理命令（新手先记这几个）

操作场景	命令	说明
启动 GitLab	`sudo gitlab-ctl start`	启动所有服务
停止 GitLab	`sudo gitlab-ctl stop`	停止所有服务
重启 GitLab	`sudo gitlab-ctl restart`	重启服务（修改配置后常用）
查看运行状态	`sudo gitlab-ctl status`	检查各组件是否正常运行
查看日志	`sudo gitlab-ctl tail`	实时查看日志（用于排查问题）

五、新手常见问题解决

问题 1：浏览器无法访问 GitLab（页面打不开）

检查防火墙：

sudo ufw allow http  # 允许 80 端口
sudo ufw allow https # 允许 443 端口（如果用 HTTPS）
sudo ufw allow ssh   # 允许 22 端口（远程连接用）

检查服务器 IP/域名是否正确：确保 EXTERNAL_URL 填写的是服务器的公网 IP或已解析的域名，内网 IP 无法从外部访问。
检查 GitLab 服务是否启动：输入 sudo gitlab-ctl status，确保所有服务状态为 running。

问题 2：内存不足（系统卡顿）

新手测试环境临时方案：编辑配置文件优化内存（适合 2GB 内存）：

sudo nano /etc/gitlab/gitlab.rb  # 打开配置文件

添加以下内容（减少组件占用）：

puma['worker_processes'] = 2       # 减少网页服务进程数
sidekiq['concurrency'] = 5         # 减少后台任务并发数
redis['maxmemory'] = "512MB"       # 限制缓存内存

保存后运行：

sudo gitlab-ctl reconfigure  # 应用配置

提示：生产环境建议至少 4GB 内存，否则可能影响性能。

六、新手下一步建议

绑定域名（更专业）：
如果你有域名，可在 DNS 中添加一条 A 记录，指向服务器 IP，然后将 EXTERNAL_URL 修改为域名（需重新配置）。
开启 HTTPS（安全必备）：
使用 Let’s Encrypt 免费证书，参考 GitLab 官方文档：
HTTPS 配置指南
备份数据（重要！）：
定期执行备份命令：
```
sudo gitlab-rake gitlab:backup:create  # 生成备份文件
```
备份文件存放在 /var/opt/gitlab/backups/，建议拷贝到其他存储设备。