快速开始 · servd

几秒内托管一个目录，加上 SPA 与 API 代理，并确认实际托管的内容。

托管当前目录

不带任何路由时，servd 会在 8080 端口托管当前工作目录：

servd

启动时你应当看到打印出的解析后配置：

servd 0.1.0 listening on 0.0.0.0:8080 (all IPv4 interfaces)
Hosts: unrestricted
  static / -> /current/working/dir

servd 始终监听所有 IPv4 接口（0.0.0.0）。打开 http://localhost:8080/。

servd --static=./dist --port=3000

使用 --spa，让客户端路由回退到 index.html：

servd --spa=./frontend --port=8080

回退仅在「无扩展名的导航请求且带 Accept: text/html」时触发，因此静态资源请求（.js、.css、.png 等）会被正常托管，缺失的资源仍然返回 404。

通过同一个源托管前端并代理后端：

servd \
  --spa=./frontend \
  --proxy=/api/=http://localhost:9000/api/ \
  --ws=/ws=ws://localhost:9000/ws \
  --port=8080

现在 GET /api/users 会被转发到 http://localhost:9000/api/users，/ws 会隧道转发到上游 WebSocket —— 开发时无需再折腾 CORS。

按 Ctrl+C。servd 会优雅关闭。若想让它在后台常驻并自动重启，参见守护进程模式。