温馨提示×

CentOS GitLab如何改端口

小樊
32
2026-08-29 20:10:44
栏目: 智能运维

CentOS 上修改 GitLab 的端口,通常是修改 GitLab 的对外访问端口(如从 80 / 443 改成其他端口)。下面按最常见场景一步一步说明。


一、修改 GitLab 端口(推荐方式)

1️⃣ 编辑 GitLab 配置文件

sudo vi /etc/gitlab/gitlab.rb

找到或添加以下内容(以改成 8080 / 8443 为例):

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

如果你只是改 HTTP 端口,也可以单独指定:

nginx['listen_port'] = 8080

HTTPS 端口:

nginx['listen_https'] = true
nginx['listen_port'] = 8443

2️⃣ 重新配置 GitLab(必须)

sudo gitlab-ctl reconfigure

3️⃣ 重启 GitLab

sudo gitlab-ctl restart

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

firewalld

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

iptables(老系统)

iptables -I INPUT -p tcp --dport 8080 -j ACCEPT
iptables -I INPUT -p tcp --dport 8443 -j ACCEPT
service iptables save

5️⃣ 验证

浏览器访问:

http://服务器IP:8080

二、如果你只是想改 SSH 端口

GitLab 的 SSH(22)端口 也可以改:

sudo vi /etc/gitlab/gitlab.rb
gitlab_rails['gitlab_shell_ssh_port'] = 2222

然后:

sudo gitlab-ctl reconfigure

并且确保 服务器 SSH 端口也是 2222(或做端口转发)。


三、常见问题排查

✅ 端口被占用

ss -lntp | grep 8080

✅ GitLab 启动失败

sudo gitlab-ctl status
sudo gitlab-ctl tail

✅ external_url 和 nginx 端口不一致

⚠️ external_url 里的端口优先级最高,不要两边写矛盾。


四、示例总结

需求 配置
改 HTTP 端口 external_url 'http://ip:8080'
改 HTTPS 端口 external_url 'https://ip:8443'
改 SSH 端口 gitlab_shell_ssh_port
生效 gitlab-ctl reconfigure

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

  • ✅ CentOS 版本(7 / 8 / Stream)
  • ✅ GitLab 安装方式(Omnibus / Docker)
  • ✅ 想改的是 HTTP / HTTPS / SSH

我可以给你完全贴合你环境的配置示例

0