Skip to content

自定义域名

付费套餐可以为 HTTP / HTTPS 隧道绑定自己的域名。NiceFRP 通过 DNS TXT 所有权验证确认域名归你所有,验证通过后你的域名会和平台域名一起写入 frpc 配置,对外直接生效。

前置条件

  • 订阅包含自定义域名权限的付费套餐(试用套餐不包含)。
  • 隧道协议为 HTTP 或 HTTPS。
  • 你有该域名 DNS 的修改权限。

步骤

1. 申请域名

打开控制台Tunnels → 打开目标隧道 → Connect → 在 Custom domains 区域输入域名(例如 www.example.com) 并点击 Request

申请成功后控制台会显示两段信息:

  • 节点公网主机名:把域名的 A/AAAA/CNAME 记录指向它。
  • TXT 记录:NameValue 两行,用于证明域名所有权。

2. 配置 DNS

在域名服务商处添加两条记录:

类型名称
A / AAAA / CNAME你的域名(例如 www节点公网主机名
TXT_nicefrp-verify.<你的域名>nicefrp-verify=<控制台显示的 Token>

不要把 TXT 记录做成通配符;每条域名单独添加。DNS 生效通常需要几分钟。

3. 验证所有权

等 DNS 生效后,回到控制台点击该域名旁边的 Verify。验证通过后状态变为 verified;未通过会变为 failed,可以检查 TXT 记录后重新验证。

验证窗口为 72 小时。超时后状态变为 expired,需要先 Remove 再重新申请。

4. 重新下载配置并运行

验证通过后重新下载该隧道的 frpc 配置——新的配置会把你的域名和平台域名 一起写入 customDomains

bash
frpc -c nicefrp-<tunnel-id>.toml

现在可以直接用 https://www.example.com 访问你的服务。

HTTPS 证书

HTTPS 隧道的 TLS 由节点前置的 Caddy 自动处理:

  • 平台子域名使用通配证书;
  • 自定义域名通过 on-demand TLS 自动签发并续期。

你不需要上传或管理证书,只要域名 DNS 指向节点即可。

移除域名

在控制台点击 Remove 后,该域名会立即从节点授权中失效;旧的 frpc 配置 里如果仍包含该域名,会被拒绝。需要再次使用同一域名时,重新走一遍申请和 验证流程。

常见问题

  • Verification failed — TXT 记录尚未生效、名称或值复制不完整。检查后等 几分钟重试;已变成 failed 的记录可以直接再次点击 Verify。
  • 域名已被占用 — 同一域名在同一时间只能被一个隧道使用,换一个域名或 联系支持。
  • 与平台域名后缀重叠 — 不能申请平台管理域名后缀本身或其子域名。
  • 试用套餐提示无权限 — 自定义域名是付费套餐功能,升级后即可使用。
  • 验证超时(expired) — 72 小时窗口内未验证成功,移除后重新申请。

仍有问题?发邮件至 support@nicefrp.com