第一步:准备服务器环境
在开始之前,请确保你的服务器满足以下要求,特别是内存:
-
硬件最低要求:
-
内存:至少 4GB RAM(如果低于4GB,GitLab可能无法正常启动)。
-
CPU:至少 2 核心。
-
磁盘:至少 10GB(根据代码量建议给更大)。
-
-
操作系统:Ubuntu 22.04/20.04 或 CentOS 7/8/9。
-
网络:需要能访问互联网以下载安装包。
第二步:安装依赖和GitLab
这里以最常见的 Ubuntu 和 CentOS 系统为例。
1. Ubuntu/Debian 系统
-
安装必要依赖(包括用于发送邮件通知的 Postfix):
bash
sudo apt update sudo apt install -y curl openssh-server ca-certificates tzdata perl postfix在 Postfix 安装界面,选择 "Internet Site" 并按提示操作即可。
-
添加GitLab官方仓库并安装社区版(CE):
bash
# 添加仓库脚本 curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash # 安装GitLab(请将 YOUR_SERVER_IP 替换为你的服务器公网IP或域名) sudo EXTERNAL_URL="http://YOUR_SERVER_IP" apt install gitlab-ce
2. CentOS/RHEL 系统
-
安装依赖:
bash
sudo yum install -y curl policycoreutils-python openssh-server perl postfix sudo systemctl enable postfix sudo systemctl start postfix -
添加仓库并安装:
bash
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash sudo EXTERNAL_URL="http://YOUR_SERVER_IP" yum install -y gitlab-ce
第三步:配置和启动
安装完成后,需要运行核心配置命令,这可能会花费几分钟时间:
bash
sudo gitlab-ctl reconfigure
这条命令会自动完成数据库初始化、Nginx配置等一系列工作。
第四步:获取初始密码并登录
-
获取root用户的初始密码 :
首次安装会自动生成一个随机密码,你需要通过命令查看它:
bash
sudo cat /etc/gitlab/initial_root_password注意 :这个密码文件会在首次执行
reconfigure后的 24小时内自动删除,所以请务必在24小时内登录并修改密码,或者提前记下来。 -
访问GitLab :
打开浏览器,访问你在安装时设置的
EXTERNAL_URL(例如http://你的服务器IP)。 -
登录 :
用户名是
root,密码是上一步获取的那个字符串。
第五步:常用管理命令
安装完成后,你可以通过以下命令管理GitLab服务:
| 命令 | 说明 |
|---|---|
sudo gitlab-ctl start |
启动所有GitLab组件 |
sudo gitlab-ctl stop |
停止GitLab |
sudo gitlab-ctl restart |
重启GitLab |
sudo gitlab-ctl status |
查看各组件运行状态 |
sudo gitlab-ctl reconfigure |
修改 /etc/gitlab/gitlab.rb 配置后,需执行此命令使其生效 |
sudo gitlab-ctl tail |
实时查看日志,用于排查错误 |
其他安装方式:Docker 快速体验
如果你只是想快速测试,或者不想在物理机上安装依赖,Docker 是个不错的选择。
bash
docker run --detach \
--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
注意:如果使用 Docker,获取初始密码的命令需要改为 docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password。
几个后续优化建议
成功登录后,为了更好地使用,建议进行以下配置:
-
修改密码:登录后立即点击右上角头像 -> Preferences -> Password 修改 root 密码。
-
配置邮件服务(SMTP) :编辑
/etc/gitlab/gitlab.rb,配置gitlab_rails['smtp_enable'] = true等相关参数,这样系统才能正常发送注册、通知邮件。 -
配置HTTPS :为了安全,建议申请SSL证书,并在
/etc/gitlab/gitlab.rb中将external_url改为https://开头,并指定证书路径。
你是打算将GitLab安装在 Ubuntu 还是 CentOS 系统上?这两个系统的防火墙命令(ufw 或 firewalld)不同,如果你告诉我具体环境,我可以补充后续的端口开放步骤。