Apache2反向代理Docker版Mattermost未保留/mattermost前缀致资源404

可以直接定位到两个核心问题，没有复杂的隐藏逻辑：

1. Apache 反向代理配置存在多处逻辑错误 #

• <Location> 指令的匹配规则是 用户访问的URL路径，而非服务器本地文件系统路径。你配置中写的<Location /home/www/www-soft/mattermost> 完全无法匹配任何正常的URL请求，属于完全无效的配置块，无法起到你预期的代理作用。
• 现有ProxyPass 配置缺少路径边界处理：原配置写为ProxyPass /mattermost http://localhost:8083，没有添加尾部斜杠，会导致请求路径没有被正确剥离前缀，后端服务收到带/mattermost前缀的路径后无法匹配自身路由，返回404。
• WebSocket 重写规则未做路径适配：原规则直接将所有带Upgrade头的请求透传原始URI给后端，没有剥离/mattermost前缀，同时缺少对目标路径的判断，容易把非Mattermost的请求错误代理到后端。

2. Mattermost 服务本身未配置子路径访问 #

Docker部署的Mattermost默认以根路径（/）对外提供服务，生成的HTML页面中静态资源链接、接口地址均为根路径形式（如/static/main.xxx.css），不会自动添加/mattermost前缀。这就是为什么浏览器会直接请求不带前缀的资源地址，最终触发404的核心源头——你手动验证的带前缀路径可访问，恰恰说明后端服务本身是正常的，问题出在前端生成的链接上。

第一步：开启Apache必要模块 #

先确认所有反向代理依赖的模块已启用，执行以下命令：
a2enmod proxy proxy_http proxy_wstunnel rewrite ssl headers
模块开启完成后再进行后续配置。

第二步：修正虚拟主机的代理配置 #

删除原配置中无效的<Location /home/www/www-soft/mattermost> 块，替换为符合规则的代理配置：

<IfModule mod_ssl.c>
<VirtualHost *:443>
        ServerAdmin webmaster@localhost
        ServerName www.my.website.fr
        ServerAlias website.fr
        DocumentRoot /home/www/www-website

        ProxyRequests Off
        ProxyPreserveHost On
        RewriteEngine On

        # 带尾部斜杠的配置可自动剥离/mattermost前缀后转发给后端
        ProxyPass /mattermost http://127.0.0.1:8083/
        ProxyPassReverse /mattermost http://127.0.0.1:8083/

        # 修正WebSocket匹配规则，仅代理/mattermost路径下的WebSocket请求，同时剥离前缀
        RewriteCond %{REQUEST_URI} ^/mattermost/api/v[0-9]+/(users/)?websocket [NC,OR]
        RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC,OR]
        RewriteCond %{HTTP:CONNECTION} ^Upgrade$ [NC]
        RewriteRule ^/mattermost/(.*) ws://127.0.0.1:8083/$1 [P,QSA,L]
</VirtualHost>
</IfModule>

第三步：修改Mattermost自身的站点配置 #

找到Docker部署的Mattermost挂载目录下的config.json 文件，修改SiteURL 字段为实际的访问地址：

"SiteURL": "https://www.my.website.fr/mattermost"

保存配置后重启Mattermost容器，服务会自动在生成的静态资源、接口链接前添加/mattermost前缀，从根源上解决浏览器请求路径不带前缀的问题。

• 不要把本地文件系统路径写到<Location> 指令中，URL路径和磁盘文件路径是完全独立的两个配置体系
• 配置子路径反向代理时，ProxyPass 的前后路径必须严格匹配尾部斜杠规则，否则会出现路径拼接错误
• 子路径部署Mattermost时，仅配置反向代理是不够的，必须同步修改Mattermost的SiteURL 配置，否则静态资源链接无法正确生成

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