链接功能

在仪表盘或通过 API 创建链接。链接必须有目标 URL，其他都是可选的。

短链码（Slug）与标签

不填短链码时，会生成随机小写码。区分大小写模式只影响自定义码：Docs 与 docs 可以不同。自动生成的码始终小写。

标签会转成小写。每个链接最多 10 个标签，每个 1–32 个字符。

过期时间与预览模式

如果设置过期时间，必须是未来时间。过期后链接失效。导入允许已过期记录（为了保留历史）。

预览模式

实例级演示开关。新建链接只活五分钟，且不能编辑或删除。只在可随时扔掉的公开演示里用。

密码与不安全警告

带密码的链接会在浏览器显示密码框。API 可在 x-link-password 请求头里传密码。

在仪表盘/API 设置的密码会受保护后存储。例外：从很旧的 KV 迁过来的链接，在你编辑密码前可能仍是旧格式。

unsafe 控制警告页：

• 自己设置可强制开/关警告
• 若配置了安全浏览且未设置 unsafe，Sink 会通过安全 DNS 检查域名
• 被判定拦截则标为不安全

安全浏览检查失败时放行

DNS 检查失败时，Sink 会放行链接，而不是拦截。

没有密码的不安全链接，访客必须用带 confirm=true 的 POST 确认。密码 + 不安全时，同时发送 x-link-password 和 x-link-confirm: true。

智能路由

• 查询参数： 可选把访客的 ?… 接到目标 URL
• 按国家/地区： 把国家代码（如 US、JP）映射到不同 URL
• 按设备： Apple / Android 目标优先于默认或国家目标

社交预览（OpenGraph）、机器人与隐匿

自定义标题、描述和图片，控制链接在社交应用里分享时的样子。配置 R2 后可上传图片（JPEG/PNG/WebP/GIF，最大 5 MB）。

社交机器人访问带有预览字段的链接时，Sink 返回预览页而不是直接跳转。

隐匿不是隐私功能

隐匿会在页面里打开目标站，地址栏仍显示短链接。浏览器和开发者工具仍能看到真实 URL。禁止被嵌入的网站（以及多数 OAuth/支付页）无法加载。

健康检查

Dashboard → Check（以及 /api/link/check）从服务端探测目标 URL（每次最多 10 条，超时 1–30 秒）。私有/本机地址会被拦截。

全站重定向选项

可改默认跳转状态码（默认 301）、要求浏览器不缓存跳转、重定向首页（NUXT_HOME_URL），以及未知短链码去向（NUXT_NOT_FOUND_REDIRECT，始终 302）。见配置参考。