如何让Caddy服务器在Web应用重定向到根路径时保留子路径

要让SPA始终在/subpath/spa和/subpath/page路径下正常运行，需要同时调整SPA应用的基础路径配置和Caddy的路由规则，具体步骤如下：

1. 配置SPA应用的基础路径 #

SPA内部导航路由默认基于根路径/生成，必须让它知晓自身运行在/subpath/spa子路径下，这样所有内部跳转链接才会自动带上/subpath前缀：

• 以X-UI为例，启动时可通过环境变量指定基础路径，比如设置BASE_URL=/subpath/spa（具体参数需参考对应SPA的官方文档）。
• 若是编译型SPA，需在编译阶段注入基础路径配置，确保打包后的资源和路由都基于指定子路径生成。

2. 调整Caddy路由配置 #

Caddy需要正确处理子路径的静态文件请求和前端路由的 fallback 逻辑，以下是基础Caddyfile配置示例：

your-domain.com {
    # 处理/subpath/spa下的静态文件与路由
    handle_path /subpath/spa/* {
        root * /实际的SPA静态文件目录路径
        file_server
        # 前端路由fallback：文件不存在时返回index.html，交由SPA处理路由
        try_files {path} /index.html
    }

    # 处理/subpath/page的导航请求
    handle_path /subpath/page/* {
        root * /实际的SPA静态文件目录路径
        try_files {path} /index.html
        file_server
    }
}

配置说明 #

• handle_path指令会自动剥离匹配的子路径前缀（比如/subpath/spa），让Caddy能正确定位静态文件，无需额外调整文件路径。
• try_files是核心配置：SPA路由由前端控制，当用户直接访问/subpath/page这类路径时，服务器没有对应物理文件，需返回index.html让前端路由处理跳转。
• 若SPA所有导航路径都以/subpath开头，可简化为统一匹配/subpath/*，避免逐个配置路径：

handle_path /subpath/* {
    root * /实际的SPA静态文件目录路径
    try_files {path} /index.html
    file_server
}

对应Caddy Docker Proxy的标签配置（参考） #

如果使用Caddy Docker Proxy，给SPA容器添加以下标签即可转换上述配置：

caddy.http.routers.spa-router.rule=Path(`/subpath/spa/*`, `/subpath/page/*`)
caddy.http.routers.spa-router.handle.0.root=/容器内的SPA静态文件路径
caddy.http.routers.spa-router.handle.0.file_server=
caddy.http.routers.spa-router.handle.0.try_files={path} /index.html

内容的提问来源于stack exchange，提问作者Kenya-West