使用方法示例：
https://your-domain/api/v1?url=https://xaoxuu.com |
如果需要配置到 Stellar 主题中，写法就是：
api: https://your-domain/api/v1?url=${href} |
支持 Vercel 部署
- fork 本仓库
- 打开 vercel.com，部署该项目
- 进入 Environment Variables 页面，设置 HOSTS 如下：
| Key | Value |
|---|---|
| HOSTS | localhost, xaoxuu.com |
把示例中的最后一个修改为自己网站的 host 部分。
逗号分隔，多个 host 之间用英文逗号隔开。
Node.js 版本由 package.json 的
engines控制（当前为 24.x），部署时 Vercel 会自动使用。
可选环境变量
| Key | 默认值 | 说明 |
|---|---|---|
| ALLOW_EMPTY_REFERER | 关闭 | 设为 1 允许不带 Referrer 的请求 |
| ALLOW_PRIVATE_HOSTS | 关闭 | 设为 1 允许抓取本机/内网地址，仅建议在可信的自部署环境开启 |
| ALLOWED_PORTS | 80, 443 |
允许的端口，逗号分隔；* 表示任意端口 |
| REQUEST_TIMEOUT_MS | 5000 |
单次请求整体超时（毫秒） |
| MAX_REDIRECTS | 5 |
最大重定向次数 |
| MAX_RESPONSE_BYTES | 1048576 |
响应体大小上限（字节） |
| CACHE_TTL_MS | 3600000 |
内存缓存有效期（毫秒），0 表示不缓存 |
| MAX_CACHE_ENTRIES | 200 |
内存缓存条目上限 |
行为与安全说明
- 仅允许
http://和https://，默认端口限定 80/443（可用ALLOWED_PORTS调整），URL 中不允许携带账号密码。 - 默认阻止
localhost、.local、.internal以及内网/回环/链路本地地址，DNS 解析结果也会逐地址校验；每个重定向跳转都会重新校验。 - 最多跟随 5 次重定向，存在跳转死循环时直接返回错误。
- 请求 5 秒超时，响应体超过 1 MiB 会中断。
- 成功响应通过
Vercel-CDN-Cache-Control缓存 7 天；错误响应返回对应的 4xx/5xx 状态码且不缓存。 - Referrer 校验失败返回 403；默认拒绝空 Referrer，如需放行设置
ALLOW_EMPTY_REFERER=1。