域名管理

上线前必须确认：域名记录不只是生成短网址时的展示配置。公开跳转会使用应用实际收到的 HTTP Host + 短码 精确查找记录。后台填写的域名、浏览器访问地址和反向代理传给应用的 Host 必须一致；非标准端口也属于 Host 的一部分。

用途与权限

配置短网址使用的域名、协议、查询参数透传、重复 URL 策略、短码生成参数、防红和备案信息。工作区写权限成员可维护；品牌覆盖项可能受版本能力限制。

入口

左侧菜单“链接管理 → 域名”，路由为 /links/domains。

页面总览

列表概览总域名、启用数量、HTTPS 数量和防红策略数量；编辑抽屉包含基础、品牌覆盖、短码生成和安全相关字段。

首次上线检查

创建第一条正式短链前按顺序检查：

1. DNS 已指向公开入口，证书覆盖短域名。
2. HTTPS 由宝塔/Nginx/CDN 等入口终止，反向代理目标指向应用监听地址。
3. 标准 80/443 入口使用 proxy_set_header Host $host;；公开 URL 确实带非标准端口时使用 $http_host 保留端口。
4. 后台域名只填写公开 Host，例如 s.example.com 或 s.example.com:8443，不要填写协议、路径、末尾斜杠或内部地址 127.0.0.1:8080。
5. 协议选择公开访问实际使用的 http 或 https，保存并启用域名后再创建正式短链。

域名和协议会复制到新建短链。后续修改域名记录不会自动迁移已有短链，因此应先完成入口配置并验证，再投入正式使用。完整验收命令见创建首个域名与短链接。

主要操作

1. 点击“添加域名”，输入不带路径的主机名并选择 http 或 https。
2. 按需填写网站名称、ICP备案号、公安备案号和用途说明。
3. 选择是否透传访客查询参数，并设置重复 URL 策略。
4. 调整随机后缀长度、校验位、异或混淆、轮转值及起始编号时，先在测试域名验证兼容性。
5. 按需启用防红；保存并启用后，域名才会出现在创建短网址的候选列表。
6. 删除域名前先禁用，并确认没有仍需使用该域名的短链。

字段/限制

• 域名字段只填主机名，如 s.example.com，协议单独选择。
• 标准端口不写入域名；只有公开 URL 本身带非标准端口时才填写 域名:端口。内部应用端口不能写入公开域名。
• 当前版本使用 HTTP Host 精确匹配，不读取 X-Forwarded-Host 作为替代值。
• pass_query_params 开启后，访问短链携带的查询参数会传递到目标地址。
• 重复策略：deny 返回既有链接，allow 始终新建，by_request 由创建请求决定。
• 随机后缀长度允许 0–10；起始编号 0 表示从 1 开始。
• 品牌覆盖和品牌 Logo 上传属于企业版能力时，社区版页面不会执行对应写操作。
• 启用中的域名不能删除。

常见错误

• 创建后短链页面仍没有域名：确认域名状态已启用，并刷新候选列表。
• HTTPS 访问失败：域名解析、证书和反向代理必须在应用外正确配置。
• 后台正常但短链 404：检查代理最终传给应用的 Host，不要把 Host 设为上游 IP、容器服务名或内部端口。
• 生成的短网址协议或域名错误：修正域名配置后重新创建测试短链；修改域名记录不会批量改写已有短链。
• 删除失败：先禁用域名。
• 修改编码参数后旧链接异常：不要随意更改已投入使用域名的生成/解码参数。

关联 API

• GET|POST /api/v1/domains
• GET /api/v1/domains/active
• PUT|DELETE /api/v1/domains/{id}
• PUT /api/v1/domains/{id}/status
• GET|PUT /api/v1/ee/domains/{id}/branding（企业版）