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

第17章 DNS 与网络配置

DNS 与网络配置

为 Pangolin 部署配置域名、DNS 记录和网络设置

Pangolin 需要正确的 DNS 配置和网络设置才能正常运行。本指南涵盖域名设置、DNS 记录、端口配置以及网络方面的注意事项。

DNS 配置

基础 DNS 记录

你需要创建指向 VPS IP 地址的 A 记录(IPv6 则用 AAAA 记录)。

创建泛域名记录

为你的域名创建一条泛域名子域名记录:

类型:A 名称:* 值:YOUR_VPS_IP_ADDRESS TTL:300(或使用默认值)

这样任何子域名(如 app.example.com、api.example.com)都能解析到你的 VPS。

创建根域名记录(可选)

如果打算将根域名作为资源使用:

类型:A 名称:@(或留空) 值:YOUR_VPS_IP_ADDRESS TTL:300(或使用默认值)

只有当你希望直接使用 example.com(而不仅是子域名)作为资源时才需要这条记录。

等待解析生效

DNS 变更在全球范围内生效可能需要 5 分钟到 48 小时。

可以借助 Google DNS(8.8.8.8)或服务商的 DNS 更快地验证变更是否生效。

端口配置

所需端口

Pangolin 要求 VPS 上开放以下端口:

TCP 端口 80:HTTP/SSL 验证,用于 Let's Encrypt 域名验证和非 SSL 资源,使用泛域名证书时可禁用。

TCP 端口 443:HTTPS 流量,包括 Pangolin Web 管理面板和 SSL 加密的资源,运行必需。

UDP 端口 51820:站点隧道,Pangolin Site 与代理建立隧道时的默认端口。

UDP 端口 21820:客户端隧道,客户端经由服务器中转连接到 Pangolin Site 的默认端口,仅客户端需要。

请务必核实你暴露的端口(例如用 nmap 或 RustScan),确保只开放绝对必要的端口。通过隧道连接到 VPS,实际上等于把 VPS 纳入了你的安全边界,因此必须将其作为整体网络策略的一部分加以防护。更多细节参见 Docker 的端口发布文档。

Docker 端口暴露

默认情况下,Pangolin 会在所有网络接口上暴露这些端口:

gerbil: ports: - "80:80" # HTTP/SSL 验证及非 SSL 资源 - "443:443" # Web 界面和 SSL 资源的 HTTPS - "51820:51820" # Newt 连接使用的 WireGuard - "21820:21820" # 客户端连接使用的 WireGuard

防火墙配置

确保 VPS 防火墙允许这些端口:

在云服务商控制台配置安全组/防火墙规则,放行:

TCP 端口 80 和 443 UDP 端口 51820 和 21820

内部网络配置

默认子网设置

Pangolin 使用以下默认网络配置:

gerbil: block_size: 24 site_block_size: 30 subnet_group: 100.89.137.0/20

含义如下:

Gerbil 网络:使用 100.89.137.0/20 范围内的第一个 /24 子网。 站点分配:每个站点分配一个 /30 子网(4 个 IP)。 CGNAT 范围:可避免与大多数私有网络冲突。

100.89.137.0/20 属于 CGNAT(运营商级 NAT)地址段,通常不会与常见的私有网段(192.168.x.x、10.x.x.x、172.16-31.x.x)冲突。

重要提示:如果该子网与你的网络冲突,请在注册第一个 Gerbil 之前在配置文件中修改。

自定义网络设置

如果需要更改默认网络:

gerbil: block_size: 24 # Gerbil 网络块大小 site_block_size: 30 # 每个站点的网络块大小 subnet_group: 10.0.0.0/8 # 自定义子网范围 start_port: 51820 # WireGuard 服务器端口

如果 WireGuard 使用量大,可考虑将 site_block_size 增大到 29(每站点 8 个 IP)或 28(16 个 IP)。

Docker 网络

本地服务

在 Pangolin 旁边用 Docker 部署服务时:

容器间通信:同一 Docker Compose 中的服务,可直接用服务名作为主机名,例如 http://pangolin:8080。Docker Compose 会自动创建内部网络。

访问宿主机:要访问宿主机上的服务,可使用 172.17.0.1(Docker 网桥网关),或 host.docker.internal(Docker Desktop),例如 http://172.17.0.1:3000。

外部服务:对于 Docker 之外的服务,使用宿主机的公网 IP,确保防火墙放行所需端口,并建议使用 VPN 或安全隧道。

本页内容对你有帮助吗?

评论 (0)