Linux系统中安装GitLab

一、安装前准备:确认系统要求(新手必看!)

  1. 系统版本:推荐 Ubuntu 20.04 或更高(本文以 Ubuntu 22.04 为例)。
  2. 内存要求
    • 最低:2GB RAM(仅建议测试环境,需按后文优化内存)。
    • 推荐:4GB+ RAM(生产环境更流畅)。
  3. 网络要求:确保服务器能联网,且防火墙允许 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(新手必看!)

  1. 打开浏览器:在地址栏输入你安装时填写的 EXTERNAL_URL,例如:

    • http://192.168.1.100(IP 访问)
    • http://git.example.com(域名访问)
  2. 设置初始密码

    • 首次登录会看到「设置密码」页面,输入你想要的密码(建议复杂度高一些,如包含字母、数字、符号)。
    • 默认用户名是 root(管理员账号)。
  3. 查看初始密码(如果忘记了)
    如果错过密码设置页面,可在终端输入:

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

四、常用管理命令(新手先记这几个)

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

五、新手常见问题解决

问题 1:浏览器无法访问 GitLab(页面打不开)
  1. 检查防火墙
    sudo ufw allow http  # 允许 80 端口
    sudo ufw allow https # 允许 443 端口(如果用 HTTPS)
    sudo ufw allow ssh   # 允许 22 端口(远程连接用)
    
  2. 检查服务器 IP/域名是否正确:确保 EXTERNAL_URL 填写的是服务器的公网 IP已解析的域名,内网 IP 无法从外部访问。
  3. 检查 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 内存,否则可能影响性能。

六、新手下一步建议

  1. 绑定域名(更专业)
    如果你有域名,可在 DNS 中添加一条 A 记录,指向服务器 IP,然后将 EXTERNAL_URL 修改为域名(需重新配置)。

  2. 开启 HTTPS(安全必备)
    使用 Let’s Encrypt 免费证书,参考 GitLab 官方文档:
    HTTPS 配置指南

  3. 备份数据(重要!)
    定期执行备份命令:

    sudo gitlab-rake gitlab:backup:create  # 生成备份文件
    

    备份文件存放在 /var/opt/gitlab/backups/,建议拷贝到其他存储设备。

总结:新手安装成功标志

  • 能通过浏览器访问 GitLab 登录页面。
  • root 账号和设置的密码成功登录。
  • 看到 GitLab 主页,能创建项目、仓库等基本操作。

如果遇到问题,别慌!对照以上步骤重新检查,或在终端查看日志(sudo gitlab-ctl tail),根据错误提示百度搜索解决方法。新手多练几次就熟练啦! 😊

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

awei0916

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值