Gitlab安装不使用自带的Nginx

在Linux环境下安装Gitlab时遇到与已有Nginx服务端口冲突的问题,可以通过禁用Gitlab内置Nginx,修改监听端口并配置外部Nginx代理来解决。具体步骤包括编辑gitlab.rb配置文件,设置新端口,重新配置并重启Gitlab,以及调整Nginx服务器块以实现域名访问。

Gitlab安装教程参考:Linux下安装GitLab仓库,史上最详细的教程来啦~ – 源码巴士

安装完成后,发现和服务器中原有的Nginx冲突,80、443端口被占用。

解决办法:禁止启动Gitlab内嵌的nginx服务,设置配置文件按某端口进行启动

具体步骤:

1. 修改/etc/gitlab/gitlab.rb 配置文件:修改前先备份一份

external_url 'http://yourhostname'
gitlab_rails['trusted_proxies'] = ['127.0.0.1']
gitlab_workhorse['listen_network'] = "tcp"
#指定按某个端口进行启动,事先确保该端口未被占用
gitlab_workhorse['listen_addr'] = "127.0.0.1:8021" 
web_server['external_users'] = ['www'] #gitlab nginx所在的用户
nginx['enable'] = false

2. Gitlab重新加载配置文件:

sudo gitlab-ctl reconfigure

3. 重启Gitlab

sudo gitlab-ctl restart

4. 访问:如果在服务器外访问,请确保8021端口已加入防火墙开放端口列表中

curl http://127.0.0.1:8021
#如果出现以下提示,说明成功
<html><body>You are being <a href="http://127.0.0.1:8021/users/sign_in">redirected</a>.</body></html>

5. 配置Nginx,使用域名访问:

 server {
          listen       80;
          server_name  yourhostname;
          location / {
                return 301 https://yourhostname:443$request_uri;
          }
          proxy_set_header Host $http_host_with_default;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header Upgrade $http_upgrade;
          proxy_set_header X-Forwarded-Ssl on;
          proxy_set_header X-Forwarded-Proto https;

          error_page   500 502 503 504  /50x.html;
          location = /50x.html {
                  root   html;
          }
     }

server {
         listen 443 ssl;
         server_name yourhostname;
         root html;
         index index.html index.htm;
         ssl_certificate cert/yourhostname.pem;
         ssl_certificate_key cert/yourhostname.key;
         ssl_session_timeout 5m;
         ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
         ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
         ssl_prefer_server_ciphers off;

         add_header Strict-Transport-Security "max-age=63072000";
         proxy_hide_header Referrer-Policy;
         add_header Referrer-Policy strict-origin-when-cross-origin;


        if ($http_host = "") {
            set $http_host_with_default "yourhostname";
        }

        if ($http_host != "") {
            set $http_host_with_default $http_host;
        }
        proxy_read_timeout      3600;
        proxy_connect_timeout   300;
        proxy_redirect          off;
        proxy_http_version 1.1;

        proxy_set_header Host $http_host_with_default;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header X-Forwarded-Ssl on;
        proxy_set_header X-Forwarded-Proto https;

         location / {
              proxy_pass http://127.0.0.1:8021;
         }

      }

6. 预期结果:

访问http://yourhostname和https://yourhostname 都会自动跳转到https://yourhostname/users/sign_in 就代表成功

GitLab 中配置外部 Nginx 服务进行反向代理,需要禁用 GitLab 自带Nginx 并调整相关权限与路径设置,以确保外部 Nginx 能够通过 Unix 套接字(`gitlab.socket`)与 GitLab 后端通信。 ### 配置步骤 1. **禁用 GitLab 内置 Nginx** 在 `/etc/gitlab/gitlab.rb` 文件中将内置 Nginx 禁用: ```ruby nginx['enable'] = false ``` 2. **设置外部访问地址** 指定 GitLab 的外部访问 URL: ```ruby external_url 'http://git.example.com' ``` 3. **配置 Unicorn 监听地址和端口** 设置 GitLab 的 Unicorn 服务监听所有 IP 地址及指定端口(如 `8081`): ```ruby unicorn['listen'] = '0.0.0.0' unicorn['port'] = 8081 ``` 4. **配置外部 Nginx 用户权限** 若外部 Nginx 使用的是非默认用户(例如 `www`),需将其加入 GitLab 的外部用户列表,以便其可以访问 `gitlab.socket`: ```ruby web_server['external_users'] = ['www'] ``` 这一配置允许外部 Nginx 以指定用户身份访问 GitLab 的 Unix 套接字文件[^2]。 5. **重载 GitLab 配置** 修改完配置后执行以下命令使更改生效: ```bash sudo gitlab-ctl reconfigure sudo gitlab-ctl restart ``` 6. **配置外部 Nginx 反向代理** 将 GitLab 的内置 Nginx 配置文件 `gitlab-http.conf` 作为参考,创建或修改外部 Nginx 的站点配置文件。示例配置如下: ```nginx upstream gitlab { server unix:/var/opt/gitlab/gitlab-rails/sockets/gitlab.socket fail_timeout=0; } server { listen 80; server_name git.example.com; location / { proxy_pass http://gitlab; 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; } access_log /var/log/nginx/gitlab_access.log; error_log /var/log/nginx/gitlab_error.log; } ``` 7. **调整 socket 文件权限** 如果出现 502 错误,可能是外部 Nginx 用户无法访问 GitLab 的 socket 文件。可临时性地开放权限进行测试: ```bash sudo chmod -R o+x /var/opt/gitlab/gitlab-rails ``` 此操作为 socket 文件所在目录增加全局可执行权限,确保外部 Nginx 用户具备访问能力[^2]。 8. **日志监控** 查看外部 NginxGitLab 的日志文件有助于排查连接问题: - 外部 Nginx 访问日志:`/var/log/nginx/gitlab_access.log` - GitLab Unicorn 错误日志:`/var/log/gitlab/unicorn_stderr.log` ### 注意事项 - 确保外部 Nginx使用的用户具有对 GitLab socket 文件的访问权限。 - 如果使用 HTTPS,还需在外部 Nginx 上配置 SSL 证书并启用 HTTPS 监听。 - 当外部 Nginx 占用了 80 或 443 端口时,应避免 GitLab 自带Nginx 试图绑定相同端口导致冲突
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值