短网址管理

用途与权限

创建、筛选、复制、编辑、启停和删除短网址，并可配置活动、标签、UTM、链接安全与高级路由。工作区成员可按角色授权操作；删除和批量变更需要写权限。

入口

左侧菜单“链接管理 → 短网址”，路由为 /links/short-links。

页面总览

列表支持关键词、域名、活动、标签、安全状态和路由状态筛选；每行提供复制、统计、编辑、路由、启停及删除操作。

主要操作

1. 先在“域名”页面添加并启用至少一个域名。
2. 点击“创建短网址”，填写原始 URL，选择域名；自定义短码留空时由系统生成。
3. 按需填写标题、描述、活动、标签、UTM、兜底地址、跳转状态码、备注和过期时间。
4. 如需保护访问，配置密码、最大访问次数、访问时段、IP 和 Bot 策略。
5. 保存后复制短网址；通过“统计”进入详情，通过“高级路由”增加按地域、设备、浏览器、系统、语言、来源或查询参数分流的规则。
6. 批量创建时每行输入一个 URL；勾选列表项后可批量启用、禁用或删除。

字段/限制

• original_url 必须是可解析的目标 URL；custom_code 在同一域名内唯一。
• 重复 URL 行为受域名策略控制：禁止重复、允许重复或由本次请求决定。
• 跳转码支持系统提供的 301、302、307、308 选项；不确定时保留默认值。
• 启用中的短网址不能直接删除，需先禁用；批量删除会跳过仍启用的项目。
• IP 规则每行一个 IP/CIDR；单 IP 会按 /32 或 /128 保存。
• 高级路由按优先级匹配，未命中时使用短链原始地址或兜底地址。

常见错误

• “没有可用的活跃域名”：先新增并启用域名。
• 自定义短码冲突：更换短码，或按域名重复策略复用已有链接。
• 删除失败：先关闭“启用”状态。
• 路由测试未命中：检查优先级、条件运算符和模拟请求字段。
• 安全配置保存失败：先保存短链基础信息，再重新编辑安全设置。

关联 API

• GET|POST /api/v1/short_links
• GET|PUT|DELETE /api/v1/short_links/{id}
• PUT /api/v1/short_links/{id}/status
• POST /api/v1/short_links/batch
• POST /api/v1/short_links/batch/status
• POST /api/v1/short_links/batch/delete
• GET|POST /api/v1/short_links/{id}/routes