本地Arch Linux部署GitLab遇无样式及密码设置异常问题

• 资源加载异常：样式/脚本返回text/html，说明Nginx或GitLab配置错误，导致静态资源请求被重定向到GitLab的HTML页面（比如404页面），而非实际的静态文件。同时CSP的default-src 'self'限制了字体等资源的加载，若静态资源路径配置错误，就会触发这个限制。
• 核心配置缺失：你怀疑的两个操作——Nginx端口设置、GitLab配置文件软链接（步骤2.9.1）确实是关键：
  • 未配置Nginx的GitLab端口转发，导致请求没有正确路由到GitLab服务，静态资源无法被正确解析。
  • 未创建GitLab配置文件软链接，可能导致GitLab使用默认配置，和Nginx的路由规则不匹配，引发资源路径错误。
• 密码设置报错：8项字段为空（含重复Username错误），是因为静态资源加载失败后，GitLab的前端表单脚本无法正常初始化，导致表单验证逻辑混乱，误判所有字段为空。
• favicon.ico缺失：属于次要问题，是GitLab或Nginx配置中未正确映射该图标文件路径，不影响核心功能。

1. 补全GitLab配置文件软链接 #

执行以下命令创建软链接：

ln -s /usr/share/webapps/gitlab/config/gitlab.yml /etc/webapps/gitlab/gitlab.yml

之后重启GitLab服务：

systemctl restart gitlab.target

2. 修正Nginx的GitLab端口配置 #

编辑Nginx的GitLab配置文件（通常在/etc/nginx/sites-available/gitlab或/etc/nginx/conf.d/gitlab.conf），确保配置正确：

server {
    listen 8080; # 对应你访问的端口
    server_name localhost;

    location / {
        proxy_pass http://127.0.0.1:8080; # 和GitLab的internal_port保持一致
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 直接读取静态资源，避免代理出错
    location ~ ^/(assets|uploads)/ {
        root /usr/share/webapps/gitlab/public;
        expires max;
        add_header Cache-Control public;
    }
}

配置完成后，测试并重启Nginx：

nginx -t
systemctl restart nginx

3. 调整GitLab的CSP配置 #

编辑GitLab的gitlab.yml配置文件，找到content_security_policy部分，修改为：

content_security_policy:
  enabled: true
  directives:
    default_src: "'self'"
    font_src: "'self' data:"
    style_src: "'self' 'unsafe-inline'"
    script_src: "'self' 'unsafe-inline' 'unsafe-eval'"

修改后重启GitLab服务：

systemctl restart gitlab.target

4. 修复favicon.ico缺失问题 #

在Nginx的GitLab配置中添加图标路径映射：

location /favicon.ico {
    root /usr/share/webapps/gitlab/public;
}

之后重启Nginx生效。

5. 验证修复效果 #

• 重启所有相关服务：systemctl restart nginx gitlab.target redis
• 清除浏览器缓存后重新访问localhost:8080，检查样式是否加载正常
• 尝试设置密码，确认表单验证错误消失

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