Skip to Content
OpenFlare
使用指南安装部署技术参考架构设计更新日志

Pingora 边缘节点设计

OpenFlare Edge 使用 Pingora 提供 HTTP、HTTPS、WAF、PoW、站点身份验证、限流与缓存。控制端在保存配置后自动编译站点快照,节点从同一同步协议获取站点、WAF IP 组和性能策略。

配置同步

节点通过 POST /api/v1/agent/nodes/heartbeat 上报运行状态并获取配置清单。控制端提交配置变更后,使用 WebSocket 的 config_changed 事件唤醒节点。启用 Redis 时,该事件也会在控制端进程之间转发。断线、重连和丢失通知由周期心跳收敛。

资源键数据同步方式
performance.v1当前节点的性能参数或默认状态内联 JSON
sites.v1站点、证书、WAF 绑定和响应资源修订编号及 SHA-256,按需拉取
waf.ip-group.v1/<id>生效快照引用的 IP 组小对象内联,大对象按需拉取

资源提供者在 internal/apps/openflare/agent/config_sync.go 注册。每种资源使用稳定的版本化名称,描述符包含精确 JSON 字节的 SHA-256、可选内联内容以及提供者自己的元数据。内联限制为单项 8 KiB,单份清单 32 KiB。节点忽略未知资源键。

拉取统一使用 GET /api/v1/agent/config/pull?key=<资源键>&sha256=<摘要>。控制端按节点身份解析资源,在资源已更新时返回 HTTP 409。节点校验内容摘要后应用。新增资源时在控制端注册提供者,并在节点接入对应的校验和应用逻辑。注册、应用结果上报和 Pages 部署包下载各自保持业务入口。

自动同步与本地回退

站点、证书、WAF 规则和全局响应配置保存后,控制端自动编译最新已提交的数据。快照内容变化时,控制端分配递增的内部修订序号,并通知在线节点立即同步;后台变更也会由控制端定期检查。关闭或删除最后一条站点规则时,节点应用空站点快照并停止服务原有站点。

节点在心跳中同时上报 latest_config_version 和 current_version,分别表示最新观测到的修订和正在服务的健康快照。控制端根据最新修订编号省略节点已知的元数据,继续返回站点摘要。候选快照通过摘要、配置、证书和 Pages 资源校验并持久化后,节点才原子切换流量。校验或应用失败时,节点记录失败并继续服务最后一份健康快照。

同一失败修订后续会跳过拉取和应用。新的修订会自动尝试,节点重启或收到「强制同步」时也会清除失败标记并重试。传输失败会在后续心跳继续重试。控制端断开时,节点可使用持久化的健康快照启动。

性能策略

每个 Pingora 节点可显式关联一条性能策略,其余节点继承内置默认策略。自动配置在节点启动时根据可用 CPU 核心数和内存上限设置工作线程和空闲回源连接池容量。保存和批量分配的数据库事务完成后发布变更通知。节点持久化已接收的配置,回源连接和部分缓存参数通过内存替换应用。回源参数更新会隔离旧连接池中的连接。影响监听器、工作线程和运行时初始化的更改由节点自动重载。

HTTP 响应缓存

边缘代理通过 pingap-cache 接入 TinyUFO 内存存储和可选的磁盘存储。磁盘模式复用 TinyUFO 热层,并按访问时间淘汰及清理文件。缓存键由站点快照摘要、单对象有效缓存上限、协议、主机与完整请求 URI 生成,存储日志只使用散列值。请求是否查缓存、响应能否共享以及回源合并仍由 OpenFlare 的现有站点规则和 Pingora 缓存链路判定。

磁盘容量和读写限制属于节点启动配置,控制端通过现有性能策略同步下发。参见 性能策略。

节点公网 IP 上报

边缘节点在启动时优先扫描本地网卡地址,并排除全部内网及保留 CIDR 网段(包括 0.0.0.0/8、10.0.0.0/8、100.64.0.0/10、127.0.0.0/8、169.254.0.0/16、172.16.0.0/12、192.0.0.0/24、192.0.2.0/24、192.88.99.0/24、192.168.0.0/16、198.18.0.0/15、198.51.100.0/24、203.0.113.0/24、224.0.0.0/4、240.0.0.0/4 与对应 IPv6 保留网段)。若网卡未获取到可用公网地址,则在启动时及每分钟按顺序请求 https://api.ip.sb/ip、https://ip.me、https://api.ip2location.io/ 与控制端 GET /api/geoip。所有探测结果均校验公网可达性;若全部失效或仅返回内网/保留地址,则回退报告 0.0.0.0,控制端同样拒绝将未锁定的节点 IP 落库为内网或保留地址。

本页目录