域名 (Domain)

域名代表一个短链接对外服务的品牌域。dwz-server 天然支持多域名——同一个后端实例可以同时承载若干个短链域名。

典型使用场景

• 一家公司有多个产品线，每个产品线用独立域名（s.product-a.com、s.product-b.com）
• 运营活动期间临时启用一个营销短域名
• 海外 / 国内分开域名，分别做 ICP 备案

字段

字段	说明
id	内部 ID
host	域名主机部分，如 s.example.com
protocol	http / https
icp_number	ICP 备案号（国内合规）
police_number	公安备案号
pass_query	跳转时是否透传原始查询参数
status	启用 / 禁用
created_at / updated_at	时间戳

源码中还包含可选的随机化 / 校验和 / XOR 混淆字段，用于短码生成时追加额外扰动，属高级特性。

配置步骤

1. 在 DNS 上将目标域名 CNAME / A 记录指向 dwz-server 所在主机
2. 在反向代理（Nginx / Caddy）上为该域名配置证书和转发
3. 登录后台 域名管理，点击「添加域名」，填写 host、协议、备案号等
4. 创建短链接时选择该域名，或通过 POST /api/v1/short_links 传入 domain 字段

启停切换

• 启用：PUT /api/v1/domains/{id}/status → active，立即对外生效
• 禁用：同接口切为 inactive，跳转路由会返回错误页
• 删除：会级联影响已存在的短链接，建议先将对应短链接迁移到其它域名