网络环境要求

边缘节点对网络环境有特定要求，请确保满足以下条件。

网络类型

支持的网络类型

✅ 企业专线

• 固定 IP 专线
• 最佳选择，稳定性高

✅ IDC 机房

• 数据中心托管服务器
• BGP 多线接入

✅ 云服务器

• 阿里云、腾讯云、AWS 等
• 按量付费或包年包月

不支持的网络类型

❌ 移动网络（4G/5G）

• IP 地址频繁变动
• 网络不稳定

❌ 内网 NAT

• 无公网 IP
• 无法被外部访问

带宽要求

上行带宽

节点的核心指标，直接影响收益：

带宽	适用场景	预期收益
10-50 Mbps	测试/小规模	低
50-100 Mbps	家庭宽带	中
100-500 Mbps	企业宽带	高
500+ Mbps	IDC/云服务器	很高

下行带宽

• 建议下行带宽 ≥ 上行带宽 × 2
• 用于从源站拉取内容

带宽测试

部署前建议测试实际带宽：

# 使用 speedtest-cli 测试
pip install speedtest-cli
speedtest-cli

# 或使用 iperf3 测试
iperf3 -c speedtest.tele2.net

端口要求

必需端口

节点需要开放以下端口：

端口	协议	用途	方向
80	TCP	HTTP 服务	入站
443	TCP	HTTPS 服务	入站
8080	TCP	管理接口	入站
9000	TCP	数据同步	双向

可选端口

端口	协议	用途
8443	TCP	HTTPS 管理
6379	TCP	Redis（如使用）

防火墙配置

Linux (iptables):

# 开放 HTTP/HTTPS
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
iptables -A INPUT -p tcp --dport 443 -j ACCEPT
iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
iptables -A INPUT -p tcp --dport 9000 -j ACCEPT

# 保存规则
iptables-save > /etc/iptables/rules.v4

Linux (firewalld):

firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --permanent --add-port=443/tcp
firewall-cmd --permanent --add-port=8080/tcp
firewall-cmd --permanent --add-port=9000/tcp
firewall-cmd --reload

Windows:

# 开放端口
New-NetFirewallRule -DisplayName "PCDN HTTP" -Direction Inbound -Protocol TCP -LocalPort 80 -Action Allow
New-NetFirewallRule -DisplayName "PCDN HTTPS" -Direction Inbound -Protocol TCP -LocalPort 443 -Action Allow
New-NetFirewallRule -DisplayName "PCDN Admin" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow
New-NetFirewallRule -DisplayName "PCDN Sync" -Direction Inbound -Protocol TCP -LocalPort 9000 -Action Allow

IP 地址要求

公网 IP

• 必须: 节点必须有公网 IP
• 类型: 静态 IP 或动态 IP 均可
• IPv4: 必须支持
• IPv6: 可选，支持更佳

检查公网 IP

# 查看公网 IP
curl ifconfig.me
curl ip.sb

# 检查是否为公网 IP
curl https://api.yunwawa.cloud/check-ip

NAT 穿透

如果在 NAT 网络环境下：

1. 配置端口转发（路由器）
2. 使用 UPnP 自动映射
3. 联系网络运营商申请公网 IP

网络质量

延迟要求

• 国内节点: < 50ms
• 跨省节点: < 100ms
• 国际节点: < 200ms

丢包率

• 正常: < 0.5%
• 可接受: < 1%
• 不可接受: > 2%

测试网络质量

# 测试延迟
ping -c 100 api.yunwawa.cloud

# 测试丢包
mtr -r -c 100 api.yunwawa.cloud

DNS 配置

推荐 DNS 服务器

• 国内: 114.114.114.114, 223.5.5.5
• 国际: 8.8.8.8, 1.1.1.1

配置 DNS

Linux:

# 编辑 /etc/resolv.conf
nameserver 223.5.5.5
nameserver 114.114.114.114

Windows:

# 设置 DNS
Set-DnsClientServerAddress -InterfaceAlias "以太网" -ServerAddresses ("223.5.5.5","114.114.114.114")

运营商选择

推荐运营商

1. 电信: 覆盖广，稳定性好
2. 联通: 北方地区优势明显
3. 移动: 价格实惠，部分地区质量好

BGP 多线

如果是 IDC 机房或云服务器，建议选择 BGP 多线接入，可以：

• 自动选择最优线路
• 提高访问速度
• 增加节点收益

网络监控

部署后建议持续监控网络状态：

# 安装监控工具
apt install nethogs iftop vnstat

# 实时监控带宽
iftop -i eth0

# 查看流量统计
vnstat -l

下一步

• 操作系统要求
• Linux 部署指南
• Docker 部署指南