vite-plugin-caddy-localhost

用 Caddy 把 Vite dev 映射到 https://xxx.localhost，host 须为 xxx.localhost 形式（如 frontend.localhost）。

前置条件

macOS 下三步（必做）：

1. 安装 Caddy：brew install caddy
2. 启动 Caddy：caddy run（监听 443 需权限时可 sudo caddy run 或 sudo setcap 'cap_net_bind_service=+ep' $(which caddy)）
3. 浏览器显示「安全」：执行一次 caddy trust

安装

npm i -D vite-plugin-caddy-localhost

使用

// vite.config.ts
import caddyLocalhost from 'vite-plugin-caddy-localhost'

export default defineConfig({
  plugins: [
    caddyLocalhost({ host: 'frontend.localhost' }),
  ],
})

• host（必填）：须为 xxx.localhost。
• caddyAdmin（可选）：Admin API 地址，默认 http://127.0.0.1:2019。
• autoStartCaddy（可选）：API 不可达时是否自动执行 caddy run，默认 true。若 443 已被占用会提示可能已有 Caddy 在跑，请只保留一个实例。

Caddy 被关掉后插件会提示；用户再次 caddy run 后会自动重新注册，无需重启 Vite。