GitLab self-managed修改默认端口为8080后静态文件无法加载求助

该问题本质是GitLab生成静态资源路径时会直接读取external_url配置的地址前缀，仅修改服务监听端口不会同步更新资源引用路径，因此会出现页面框架可加载但CSS、JS等静态资源加载失败的情况。

1. 修改核心配置文件 #

编辑GitLab主配置文件/etc/gitlab/gitlab.rb：

sudo vim /etc/gitlab/gitlab.rb

• 找到external_url配置项，修改为带8080端口的访问地址，示例：

  external_url 'http://你的服务器IP或域名:8080'
  

注意：如果此前仅修改了Nginx监听端口未调整该配置，就是故障的直接诱因

2. 核对Nginx监听配置（可选） #

在同一配置文件中找到Nginx端口配置项，确认与external_url端口一致：

nginx['listen_port'] = 8080

若该配置被注释可取消注释，端口值设为8080即可。

3. 生效配置 #

执行命令重新编译GitLab配置：

sudo gitlab-ctl reconfigure

4. 重启服务（可选） #

若配置生效后仍有异常，可执行完整重启：

sudo gitlab-ctl restart

5. 放行防火墙端口 #

确认Ubuntu系统防火墙放行8080端口：

sudo ufw allow 8080/tcp
sudo ufw reload

操作完成后重新访问对应地址即可正常加载所有静态资源。

内容的提问来源于stack exchange，提问作者hweiu321