Caddy配置：无扩展名访问HTML文件及URL重写需求咨询

现有目录结构 #

Caddyfile
html/
├── 404.html
├── 500.html
├── about.html
├── blog
│   ├── one.html
│   ├── two.html
│   └── three.html
├── blog.html
├── home.html
├── projects.html
└── static
    ├── css
    │   └── site.css
    ├── images
    │   ├── favicon.ico
    └── js
        └── highlight.pack.js

期望的请求解析规则 #

• localhost:8080/ 或 localhost:8080 -> 返回html/home.html
• localhost:8080/about -> 返回html/about.html
• localhost:8080/about/ -> 返回html/about.html并将URI重写为/about
• localhost:8080/about.html -> 返回html/about.html并将URI重写为/about
• localhost:8080/blog/one -> 返回html/blog/one.html
• 404和500错误分别返回html/404.html和html/500.html

当前配置及问题 #

当前使用uri和try_files组合未达到预期效果，配置如下：

http://localhost:8080

uri strip_suffix .html
try_files {path}.html

handle_errors {
    rewrite * html/{err.status_code}.html
    file_server
}

file_server {
    index home.html
    root html
}

解决方案 #

是的，你需要对带有.html扩展名的请求做永久重定向，同时处理尾部斜杠的情况，才能完全满足需求。以下是调整后的完整Caddyfile配置：

http://localhost:8080 {
    root * html
    file_server {
        index home.html
    }

    # 匹配所有带.html后缀的请求，重定向到无后缀路径
    @htmlFiles {
        path *.html
    }
    redir @htmlFiles {path.*}/ 308

    # 匹配所有以/结尾的请求，重定向到去掉尾部斜杠的路径
    @trailingSlash {
        path */
    }
    redir @trailingSlash {path}/ 308

    # 优先尝试无后缀路径对应的.html文件，再尝试原路径（适配静态资源）
    try_files {path}.html {path}

    handle_errors {
        rewrite * {err.status_code}.html
        file_server
    }
}

配置说明 #

1. root * html：统一设置站点根目录为html，避免多指令重复配置。
2. .html后缀重定向：用@htmlFiles匹配规则锁定所有.html结尾的请求，通过308永久重定向去除后缀，保证URL规范。
3. 尾部斜杠处理：用@trailingSlash匹配规则捕获带尾部斜杠的请求，重定向到无斜杠路径，避免重复内容索引。
4. try_files逻辑：先尝试将无后缀路径映射为对应.html文件（比如/about对应about.html），如果匹配失败则保留原路径，确保静态资源（如CSS、JS）正常访问。
5. 错误处理简化：根目录已设置为html，直接用{err.status_code}.html匹配错误页面，无需额外前缀。

此配置可完全满足你提出的所有请求解析规则，同时保证URL格式统一规范。

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