站点路由
服务器对每个请求执行两级解析:
| 优先级 | 规则 | 说明 |
|---|---|---|
| 1 | Host 域名精确匹配 | 请求头的 Host 与注册表中某站点的 domain 一致 |
| 2 | 路径前缀 /:name/ |
URL 首段与站点名一致,剩余路径映射到站点产物内 |
| 均未命中 | 404 | 通用 404 页面(无站点上下文,无跳转按钮) |
404 页面
站点上下文内的未命中路径返回统一的 404 页面(HTML):地址对应有效站点(Host 域名或 /:name/ 前缀)但页面不存在时,页面附「返回首页」按钮指向站点根(域名站点为 /,前缀站点为 /:name/);服务器根的无效地址(主机与路径前缀均未命中)返回无跳转按钮的 404 页面。
保留名
站点名 api 为保留名:其路径前缀与管理 API 前缀冲突,注册时校验拒绝。
内容接口
命中站点后,/api/v1/tree 与 /api/v1/document(页面检索)请求由服务器读取该站点产物中的 tree.json 与 index.json 应答;其余路径按静态文件返回。接口契约见独立 API 参考文档站,站内搜索 ?sites、?api。
TLS 与路由
携带域名注册的站点在 TLS 启用时自动签发证书;仅路径前缀路由的站点始终走 HTTP。机制详见 TLS 与 ACME。
