如何为GitLab配置支持WebSocket的Apache反向代理？

我太懂你这个痛点了！GitLab的实时更新（比如CI状态刷新、评论实时同步）全靠WebSocket连接，而你当前的Apache配置只是简单转发HTTP请求，完全没处理WebSocket的协议升级逻辑，这才导致/-/cable路径报404，实时功能直接罢工。

别担心，只需要调整下Apache的配置，专门为WebSocket做适配就行，步骤如下：

第一步：启用必要的Apache模块 #

首先得确保你的Apache装了处理反向代理和WebSocket的核心模块，在Debian/Ubuntu系统上可以用下面的命令启用：

a2enmod proxy proxy_http proxy_wstunnel rewrite

如果是RHEL/CentOS系，你需要通过httpd.conf或者模块配置文件手动开启这些模块，然后重启Apache。

第二步：修改反向代理配置 #

把你现有的Apache虚拟主机配置里的代理部分替换成下面的内容，重点是新增WebSocket的规则：

ProxyRequests     off
ProxyPreserveHost on

# 专门处理WebSocket握手与连接
RewriteEngine On
# 检测请求是否要升级为WebSocket协议
RewriteCond %{HTTP:Upgrade} =websocket [NC]
# 将WebSocket请求转发到GitLab后端的ws/wss端口
RewriteRule /(.*) wss://0.0.0.0:4000/$1 [P,L]

# 处理常规的HTTP/HTTPS请求
ProxyPass        / https://0.0.0.0:4000/
ProxyPassReverse / https://0.0.0.0:4000/

这里要注意：如果你的GitLab后端用的是纯HTTP（没有SSL），那RewriteRule里的wss://要改成ws://，和后端协议保持一致。

第三步：验证配置并重启Apache #

修改完配置后，先检查下配置有没有语法错误：

apache2ctl configtest
# 或者RHEL/CentOS用 httpd -t

如果显示Syntax OK，就重启Apache让配置生效：

systemctl restart apache2
# RHEL/CentOS用 systemctl restart httpd

最后验证效果 #

打开GitLab，按下F12打开开发者工具，切换到“网络”标签页，过滤WebSocket类型的请求，你会看到/-/cable的请求状态变成101 Switching Protocols，而不是之前的404，这就说明WebSocket连接成功了，实时更新功能也会恢复正常。

备注：内容来源于stack exchange，提问作者quazgar