进阶 docs.pangolin.net 2026-11-21 15:06:37 · 2 阅读

第9章 域名配置

Domains 学习如何为 Pangolin 资源配置域名,并了解可用的不同域名类型

域名允许你通过自定义 URL 访问 Pangolin 资源。根据部署模式和需求,Pangolin 支持不同的域名类型。你还可以在域名主机名上设置重定向,将匹配的请求转发至另一个 URL。

在 Pangolin Cloud 中,域名并非必需。在任何付费计划下,你都可以使用我们提供的域名后缀,如 .hostlocal.app 或 .tunneled.to 来访问资源。

域名类型

类型 | DNS 记录 | 覆盖范围 | 可用情况 A / AAAA | 基础域名及所有子域名(例如 example.com、app.example.com) | 自托管 域名委托 | NS | 基础域名及所有子域名,完全由 Pangolin 管理 | Cloud 或 带 DNS 的 Enterprise 单域名 | CNAME | 仅限提供的确切主机名(不含子域名) | Cloud 或 带 DNS 的 Enterprise

通配符(A 记录)域名是自托管环境中最常见的配置,因为你已经控制了服务器的 DNS,只需将其指向你的 VPS IP 即可。

将域名委托给 Pangolin Cloud

域名委托和单域名(CNAME)设置的存在,是因为 Pangolin Cloud 和 Enterprise 集群模式并不运行在由你控制单一 IP 的服务器上——你的流量会在多个节点上路由和终止。为了让 Pangolin 为你的域名颁发证书并路由流量,它必须能够代表你创建和更新 DNS 记录。

自托管:你将 A/AAAA 记录指向自己 VPS 的 IP 地址。DNS 仍由现有提供商管理;Pangolin 无需访问。 Cloud:不存在一个属于你的静态 IP 供你直接指向,而 Pangolin 需要创建记录(用于证书验证、路由和新资源),无需你每次手动更新 DNS。委托和 CNAME 设置通过授予 Pangolin 对整个区域(NS 委托)或单个可管理记录(CNAME)的控制权来解决这一问题。

域名委托是更强大的选项,因为新子域名可以自动生效。它还允许你通过 Pangolin 管理整个 DNS 区域,包括根据需要创建和更新记录。

设置方法

自托管(通配符 / A 记录) 请参阅“DNS 与网络”部分。

Cloud & Enterprise(NS 委托或 CNAME)

更改名称服务器将整个区域移交给 Pangolin,而不仅仅是单个记录。如果你将根域名(例如 example.com)的名称服务器指向 Pangolin,Pangolin 将成为该域名上所有记录的权威来源——包括 MX/邮件、TXT/SPF 以及其他你未打算迁移的子域名。一旦完成委托,你就必须通过 Pangolin 而非旧提供商管理该区域的 DNS。在切换之前,请按需重建你需要的记录作为自定义 DNS 记录。

像 Cloudflare 这样的部分注册商仅允许你在子域名上委托 NS 记录,不允许在根区域添加 NS 记录,或仍在根区域保留其名称服务器。在这种情况下,如果需要使用 NS 委托,请委托该域名的一个子域名,或使用 CNAME 记录。

在 Pangolin 仪表板中添加域名 从组织的域名设置中添加域名,并选择域名委托或单域名(CNAME)。Pangolin 将显示你需要配置的确切记录。 在注册商/提供商处配置 DNS 将域名(或子域名)的名称服务器更改为 Pangolin 的名称服务器,如仪表板所示: 类型: NS 名称: test.example.com 值: ns1.pangolin-ns.net ns2.pangolin-ns.net ns3.pangolin-ns.net 此操作在你的注册商或当前 DNS 提供商的名称服务器设置中进行,而不是作为普通的 DNS 记录。 等待验证 Pangolin 会自动检查记录。由于 NS 委托改变了整个区域(或子区域)的解析方式,其传播时间通常比 CNAME 更长。

自定义 DNS 记录

自定义 DNS 记录在 Pangolin Cloud 以及配置了 Pangolin DNS 服务器的集群模式自托管 Enterprise Edition 中可用。

当你使用 NS 记录将域名委托给 Pangolin 时,Pangolin 的名称服务器会响应该域名的所有查询。自定义 DNS 记录允许你从 Pangolin 提供其他记录,例如邮件(MX)、SPF 和 DMARC(TXT)、验证记录以及指向 Pangolin 外部服务器的主机名。这意味着你可以委托整个域名,而不会丢失旧 DNS 提供商正在提供的记录。

自定义 DNS 记录仅可添加到使用域名委托(NS)的域名。通配符、单域名(CNAME)域名或 Pangolin 提供的共享域名不支持。

委托之前

更改名称服务器会一次性移动整个区域。任何未在 Pangolin 中重新创建的记录,一旦更改传播即停止解析。为了实现无停机切换:

添加域名 在 Pangolin 中将域名添加为域名委托(NS)。暂时不要在注册商处更改名称服务器。 复制现有记录 在当前的 DNS 提供商处,列出该域名的记录。将仍需要使用的记录在 Pangolin 中“记录 > 自定义 DNS 记录”下重新创建。特别注意 MX、SPF、DKIM 和 DMARC 记录,以确保邮件功能正常。 你可以在域名验证前添加记录。Pangolin 会存储这些记录,并显示通知说明它们尚未提供服务。 更改名称服务器 按照“设置方法”中的说明,将域名的名称服务器指向 Pangolin。一旦域名验证通过,Pangolin 开始提供你的自定义记录。

添加记录

在组织的域名设置中打开该域名,进入“记录”,选择“添加记录”。

Pangolin 仪表板中的自定义 DNS 记录

字段 | 描述 名称 | 相对于域名的名称,如 mail 或 _dmarc。使用 @ 表示域名根,或在通配符的第一级标签中使用 *(例如 *.dev)。你也可以输入完整的主机名。 类型 | A、AAAA、CNAME、MX、NS、SRV 或 TXT 值 | 每行一个值。一个记录最多可包含 10 个值,例如 NS 记录的多个名称服务器或多个 TXT 值。 TTL | 解析器可以缓存答案的时间,范围为 60 到 86,400 秒。默认为 300。 优先级 | MX 和 SRV 记录必填 权重和端口 | SRV 记录必填 启用 | 关闭记录以停止提供服务而不删除它

更改可能需要几分钟才能传播,且解析器可能会在 TTL 过期前继续提供缓存的答案。

记录类型

类型 | 值 | 备注 A | IPv4 地址 | AAAA | IPv6 地址 | CNAME | 主机名 | 不允许在根(@)使用。仅限一个值,且没有其他记录可以共享该名称。 MX | 邮件服务器主机名 | 需要优先级。为每个优先级添加单独的记录。 TXT | 文本,最多 1,024 个可打印 ASCII 字符 | 引号会被移除,因此你可以从区域文件粘贴值。 SRV | 目标主机名 | 需要优先级、权重和端口。使用类似 _sip._tcp 的名称。 NS | 名称服务器主机名 | 将子域名委托给其他名称服务器。参见“委托子域名”。

主机名的值必须完全限定,如 mail.example.net。

委托子域名

添加 NS 记录可将子域名移交给另一个 DNS 提供商,例如让另一个团队管理 lab.example.com。Pangolin 随后会将该名称下(含子级)的所有查询指向你设置的名称服务器。

NS 记录不能添加在根或通配符名称上。 在已委托的子域名下(除该子域名内的名称服务器对应的 A 和 AAAA 胶水记录外),不能存在其他记录(例如 ns1.lab.example.com)。 如果 Pangolin 资源、登录页面或重定向使用该子域名下(含子级)的名称,则不能委托该子域名。

限制和保留名称

每个域名最多可有 100 个自定义记录。 每个名称每种类型仅限一条记录。若要添加更多值,请编辑现有记录。MX 和 SRV 记录可按优先级拆分,总共有最多 10 个值。 _acme-challenge 名称由 Pangolin 管理用于证书颁发,无法使用。 A、AAAA 和 CNAME 记录不能添加到被 Pangolin 资源、登录页面或重定向使用的名称上。Pangolin 会自行响应这些名称。 属于在 Pangolin 中单独添加的其他域名(例如,当 sub.example.com 本身就是一个独立域名时)内的名称属于该域名,无法在此使用。 此页面有帮助吗?

评论 (0)