一、安装前准备:确认系统要求(新手必看!)
- 系统版本:推荐 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/
,建议拷贝到其他存储设备。
总结:新手安装成功标志
- 能通过浏览器访问 GitLab 登录页面。
- 用
root
账号和设置的密码成功登录。 - 看到 GitLab 主页,能创建项目、仓库等基本操作。
如果遇到问题,别慌!对照以上步骤重新检查,或在终端查看日志(sudo gitlab-ctl tail
),根据错误提示百度搜索解决方法。新手多练几次就熟练啦! 😊