温馨提示×

centos gitlab如何修改端口

小樊
49
2026-08-03 16:18:27
栏目: 智能运维

CentOS 上修改 GitLab 的端口,常见的是修改 Web 访问端口(HTTP/HTTPS),也可能涉及 SSH 端口。下面分情况说明。


一、修改 GitLab Web 端口(最常用)

1️⃣ 编辑 GitLab 配置文件

sudo vi /etc/gitlab/gitlab.rb

找到或添加以下配置(默认是 80 / 443):

# HTTP
external_url 'http://gitlab.example.com:8080'

# 或 HTTPS
external_url 'https://gitlab.example.com:8443'

注意:

  • external_url 必须写端口
  • GitLab 会自动把 Nginx 监听端口改成对应的

2️⃣ 如果你的 GitLab 使用内置 Nginx

直接执行:

sudo gitlab-ctl reconfigure

3️⃣ 重启 GitLab

sudo gitlab-ctl restart

4️⃣ 防火墙放行端口(CentOS 7/8)

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

5️⃣ 验证

浏览器访问:

http://服务器IP:8080

二、只修改 Nginx 端口(不推荐,但可用)

如果你不想改 external_url,可以手动指定 Nginx 端口:

nginx['enable'] = true
nginx['listen_port'] = 8080

然后:

sudo gitlab-ctl reconfigure

⚠️ 不推荐原因
external_url 会影响 Git clone 地址、邮件链接等。


三、修改 GitLab SSH 端口(可选)

1️⃣ 修改 SSH 端口

编辑:

sudo vi /etc/ssh/sshd_config

修改:

Port 2222

重启 SSH:

sudo systemctl restart sshd

2️⃣ 告诉 GitLab 新的 SSH 端口

gitlab_rails['gitlab_shell_ssh_port'] = 2222

执行:

sudo gitlab-ctl reconfigure

四、常见问题排查

✅ 端口被占用

ss -lntp | grep 8080

✅ 页面打不开

  • 检查防火墙
  • 检查 SELinux
getenforce

临时关闭:

sudo setenforce 0

✅ Git clone 地址不对

确认 external_url 已正确配置端口。


五、总结(最标准做法 ✅)

external_url 'http://IP:端口'
gitlab-ctl reconfigure
gitlab-ctl restart
firewall-cmd --add-port=端口/tcp

如果你愿意,可以告诉我:

  • ✅ GitLab 版本
  • ✅ CentOS 版本
  • ✅ 用 HTTP 还是 HTTPS
  • ✅ 是否使用 Docker

我可以给你 精确到命令级别 的配置方案。

0