当前位置：首页 > news >正文

linux安装极狐gitlab

news 2025/7/4 20:07:31

1. 官网寻找安装方式

不管我们使用任何软件，最靠谱的方式就是查看官方文档。gitlab提供了相应的安装文档，并且有对应的中文文档。地址如下：

https://gitlab.cn/install/

我在这里以CentOS作为安装示例，大家可根据自己的需要选择对应的方式；另外官方也提供了在docker镜像或Kubernetes安装的两种方式，如果大家有需要自行参看文档即可，这里不再赘述。

2. 开始在CentOS中安装GitLab

2.1 安装和配置必须的依赖项

在系统防火墙中打开 HTTP、HTTPS 和 SSH 访问。这是一个可选步骤，如果您打算仅从本地网络访问极狐GitLab，则可以跳过它。

# 安装并且启动sshd
sudo yum install -y curl policycoreutils-python openssh-server perl
sudo systemctl enable sshd
sudo systemctl start sshd
# 系统防火墙中打开 HTTP、HTTPS 和 SSH 访问；由于是演示，我这里直接将防火墙彻底关闭
# sudo firewall-cmd --permanent --add-service=http
# sudo firewall-cmd --permanent --add-service=https
# sudo systemctl reload firewalld
sudo systemctl stop firewalld
# 如果大家后续想永远不开启防火墙，可以使用以下命令，但不推荐。
# sudo systemctl disable firewalld

在这里我先不开启邮件服务，大家如果需要配置邮件服务，参看文档进行配置即可（配置外部 SMTP 服务器）。

2.2 下载/安装GitLab

配置极狐GitLab 软件源镜像。

curl -fsSL https://packages.gitlab.cn/repository/raw/scripts/setup.sh | /bin/bash

脚本执行完毕后，接下来有两种选择，一种是指定域名进行访问，另一个则是指定ip进行访问。这里是演示，因此我们先使用ip。

2.2.1 安装gitlab，通过域名访问

接下来，安装极狐GitLab。确保您已正确设置您的 DNS，并更改 https://gitlab.example.com 为您要访问极狐GitLab 实例的 URL。安装包将在该 URL 上自动配置和启动极狐GitLab。

对于 https 站点，极狐GitLab 将使用 Let’s Encrypt 自动请求 SSL 证书，这需要有效的主机名和入站 HTTP 访问。您也可以使用自己的证书或仅使用 http://（不带s）。

如果您想为初始管理员用户(root)指定自定义密码，请查看文档。如果未指定密码，将自动生成随机密码。

sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-jh

2.2.2 安装gitlab，通过ip访问

sudo EXTERNAL_URL="http://192.168.220.105" yum install -y gitlab-jh

2.3 访问极狐GitLab 实例并登录

安装完成后，只要没有错误信息，等待一会gitlab服务就会完成启动，在启动完全之前，访问会出现502页面，这时候可以使用

gitlab-ctl tail

查看日志，日志只要滚动就代表程序还在启动中，只要没有报错信息，在全部执行完成后，就可以通过网页进行访问了。

只要在安装过程中没有指定自定义密码，就会将随机生成一个密码并存储在 /etc/gitlab/initial_root_password 文件中(出于安全原因，24 小时后，此文件会被第一次 gitlab-ctl reconfigure 自动删除，因此若使用随机密码登录，建议安装成功初始登录成功之后，立即修改初始密码）。使用此密码和用户名 root 登录。

3. 配置说明

3.1 个人常用设置

3.1.1 将界面语言设置为中文

登陆后选择右上角头像，选择Preferences

在弹出的页面中，向下滚动找到Localization，然后点击Language下方的下拉框，选择简体中文后，点击Save changes，保存成功后刷新页面即可。

3.1.2 修改密码

点击页面右上角头像，选择用户设置里的密码，进行密码配置即可

4. 常见问题及解决方法

4.1 克隆代码时提示fatal: unable to access ‘xxx’: Issuer certificate is invalid.

这种问题是由于ssl认证导致的，最简单的办法就是选择关闭ssl认证。直接使用以下命令就可以解决。

git config --global http.sslverify false # 变更系统当前用户
git config --system http.sslverify false # 变更全局所有用户