跳转至

Phoenix Edge 订阅者连接

连接到 DoubleZero 即表示我同意 DoubleZero 使用条款。请注意，数据仅供您内部使用，不得转发（参见第 2(e) 条）。

Phoenix 数据源通过 DoubleZero Edge 网络以 UDP 多播方式传输 Phoenix 永续合约市场数据。共有两个数据源：

  • 最优报价（TOB）：最优买价和卖价，以及成交记录
  • 按价格深度（MBP）：价格级别深度，以及成交记录

定价

数据源按月计费：

数据源 价格
phoenix-tob $50 / 月
phoenix-mbp $100 / 月

我应该选择哪种方式？

# 方式 最适合 工作量
1 Edge Connect 需要简单 CLI 和通过 WebSocket 获取已解码 JSON 的代理和应用 最低
2 原生多播 针对原始线路格式构建自己的解码器 最高

在选择任何方式之前：请在 doublezero.xyz/edge/subscribe 购买您需要的数据源。购买即表示您同意 DoubleZero 使用条款。

想让 AI 协助您完成安装？连接 DoubleZero MCP 并让它引导您完成 Phoenix / Edge Connect 的设置。

从这里开始。 doublezero-edge-connect 是对代理友好的方式：一条安装命令，主机加入 DoubleZero，您的应用通过 WebSocket 上的已解码 JSON（ws://<host>:8081）消费数据，而无需解码二进制多播。

Edge Connect 满足了不断增长的用户群的需求。这是最简单的连接方式，除非您有特定的技术需求，否则应使用此方式。

简短版本：

curl -fsSL https://get.doublezero.xyz/connect | \
  DZ_SECRET=/path/to/keypair.json DZ_FEEDS=PHOENIX DZ_ASSUME_YES=1 bash

变量放在管道符之后，以便安装程序（bash）接收它们。DZ_SECRET 是 DZ_… 访问令牌或拥有您的访问通行证/数据源购买的 Solana 密钥对 JSON 文件的路径。

如果主机上的 doublezerod 已在运行，它和容器自身的守护进程都会绑定 UDP 端口 44880，因此容器的守护进程会在启动后立即退出。安装程序会提示停止并禁用主机守护进程，当设置了 DZ_ASSUME_YES=1 时则会直接执行而不询问。如需手动操作：

sudo systemctl stop doublezerod
sudo systemctl disable doublezerod

然后在容器内验证状态（预期看到 BGP Session Up 和您的 Phoenix 组），并将 WebSocket 客户端连接到 :8081：

docker exec doublezero-edge-connect doublezero status

Edge Connect 会在 Phoenix 发布者之间进行仲裁，因此 WebSocket 客户端只会看到每个更新的一份副本。

完整步骤、验证和注意事项： 连接 DoubleZero MCP 并让它引导您完成 Phoenix 的 Edge Connect 设置。 WebSocket 协议： PROTOCOL.md。

2. 原生多播（高级）

需要更深入的技术知识

原生多播意味着您需要自行加入组播组，并在主机上解码原始 Edge 线路格式。只有技术能力最强的用户才应选择此方式。您需要阅读并理解规范，从 market-by-price/spec.md 和 edge-feed-spec 的其余部分开始。除非您有必须自行拥有解码器的硬性要求，否则请优先使用 Edge Connect。

DoubleZero 客户端设置

按照设置说明安装和配置 DoubleZero 客户端。保持客户端更新：

sudo apt update && sudo apt install doublezero

购买数据源

在 doublezerod 运行的情况下，购买前先确定延迟最低的设备：

doublezero latency

在 https://doublezero.xyz/edge/subscribe 购买。

配置防火墙

允许 GRE、BGP、PIM 和 Phoenix 数据源流量。Phoenix UDP 端口范围为 9201–9213：9201/9202 承载最优报价的市场数据和参考数据，9211/9212/9213 承载按价格深度的市场数据、参考数据和快照数据。参见数据源地址。

iptables：

sudo iptables -A OUTPUT -p gre -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -p pim -j ACCEPT
# Phoenix 市场 / 参考 / 快照（两个数据源）
sudo iptables -A INPUT -i doublezero1 -p udp --dport 9201:9213 -j ACCEPT

UFW：

sudo ufw allow proto gre from any to any
sudo ufw allow in on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
# Phoenix 市场 / 参考 / 快照（两个数据源）
sudo ufw allow in on doublezero1 to any port 9201:9213 proto udp

UFW 没有 pim 协议。UFW 的默认出站策略允许出站 PIM；如果您拒绝出站流量，请在 /etc/ufw/before.rules 中为 PIM 添加原始规则。

订阅

加入您购买的所有数据源（客户端 v0.35.0 或更高版本）：

doublezero connect multicast

或通过数据源代码指定数据源：

doublezero connect multicast --subscribe-feed phoenix-tob phoenix-mbp

使用数据源代码 phoenix-tob / phoenix-mbp，而不是按城市命名的数据源名称（如 phoenix-tob-cmh），也不是组代码（edge-phoenix-…）。使用 --subscribe 通过组代码订阅在已购买的通行证上会失败。

预期看到 ✅ User Provisioned。等待约 60 秒，然后：

doublezero status

预期在正确的 DoubleZero 网络上看到 BGP Session Up。

doublezero user list --client-ip <your ip>

您的数据源会出现在 groups 列中。使用以下命令检查组 IP：

doublezero multicast group list

自行解码线路数据

Schema 版本为 3 — 丢弃您的解码器未实现其版本的数据报。权威布局：edge-feed-spec，包括 top-of-book/spec.md、market-by-price/spec.md 和 GLOSSARY。

每个数据报以 24 字节的数据报头开始，后跟一个或多个应用消息，打包至 MTU 上限。数据报采用小端序和固定布局。

字段 说明
Magic 偏移量 0 处的 u16：TOB 为 0x445A，MBP 为 0x4442。请验证它。
Schema 版本 3
Channel ID 两个 Phoenix 数据源都使用通道 1
Sequence 按源 IP 地址、Channel ID 和目标端口单调递增 — 每个端口有自己的序列。用于丢包检测。
发送时间戳 自 Unix 纪元以来的纳秒数
消息计数 此数据报中打包的消息数
重置计数 任何变化（包括 255 → 0 的回绕）都是重置；丢弃该发布者的通道状态。MBP 也可能在会话中因全场重新播种而递增。
数据报长度 总字节数

每个 Phoenix 数据源有多个发布者发送，使用相同的组、通道和端口。所有通道和合约状态的键必须包含源 IP 地址和 Channel ID，否则两个发布者的序列号系列会交织在一起。原生订阅者每个发布者会收到每笔交易的一份副本。

应用消息（TOB）

类型 ID 大小 端口 内容
Heartbeat 0x01 16 B 市场数据 市场平静时的存活信号
InstrumentDefinition 0x02 130 B 参考数据 交易品种、指数、最小变动价位和手数、到期日
Quote 0x03 60 B 市场数据 最优买价和卖价、价格和数量、更新标志
Trade 0x04 52 B 市场数据 价格、数量、主动方向、交易 ID
EndOfSession 0x06 12 B 市场数据 正常关闭
ManifestSummary 0x07 24 B 参考数据 有效标志、Manifest Seq 变化计数器、合约数量、时间戳

Phoenix 不发送 0x08（清算）。Phoenix 在 edge-feed-spec 注册表中的 Source ID 为 2。从每个 InstrumentDefinition 中读取 price_exponent 和 qty_exponent — 不要硬编码。指数是价格精度，不是最小变动价位：Phoenix 上的 BTC 使用指数 -2，最小变动价位为 100，因此它以整美元为单位变动。

MBP 数据源使用按价格深度消息集。请参阅 edge-feed-spec 中的 market-by-price 和 reference-data 规范。两个数据源来自同一个发布者进程，因此它们共享合约 ID，MBP 市场数据端口承载与 TOB 相同的成交记录。Phoenix 交易 ID 是按市场的序列号，因此请使用（合约 ID, 交易 ID）去重交易，切勿仅使用交易 ID。

传输采用即发即弃的 UDP，无重传，参考数据端口不修复市场数据：它仅重复发送 InstrumentDefinition（至少每 30 秒一次）和 ManifestSummary（至少每 1 秒一次）。丢失的 TOB Quote 在该市场的最优买价或卖价发生变化之前一直处于丢失状态。只有 MBP 有修复路径 — 其快照周期 — MBP 冷启动必须绑定快照端口。

数据源地址

数据源代码 组代码 描述 多播组 市场数据 参考数据 快照
phoenix-tob edge-phoenix-tob 永续合约最优报价和成交 233.84.178.24 9201 9202 —
phoenix-mbp edge-phoenix-mbp 永续合约按价格深度 233.84.178.25 9211 9212 9213

使用数据源代码订阅；doublezero status 和 multicast group list 显示组代码。

组选择数据源；端口选择其中的市场数据、参考数据或快照。多播复制按源 IP 地址和组进行，网络层不检查 UDP 端口，因此加入一个组会通过您的 DoubleZero 隧道传输该组上的所有内容。端口是在字节到达后在您自己的主机上应用的套接字过滤器。

故障排除

如果您遇到此处未涵盖的问题，请在尝试变通方案之前通过您现有的渠道联系我们。如果您没有渠道，请参阅支持。

确保客户端是最新版本

运行：sudo apt update && sudo apt install doublezero

没有数据报到达

  1. 确认已在 https://doublezero.xyz/edge/subscribe 购买了数据源。未购买的数据源不会传输流量。
  2. 确认 BGP 已建立：doublezero status 应在正确的 DoubleZero 网络上显示 BGP Session Up。
  3. 确认订阅处于活动状态：doublezero user list --client-ip <your ip> 应在 groups 下列出该数据源。
  4. 确认在正确的接口上加入了组。多播到达 doublezero1，而不是 doublezero0。
  5. 确认防火墙允许数据源的 UDP 端口在 doublezero1 上入站。

序列号间隙

按源 IP 地址、Channel ID 和目标端口跟踪序列号；仅以 Channel ID 为键的解码器会看到虚假间隙。真正的间隙意味着数据报丢失。在 MBP 上，受影响的市场会从下一个快照周期恢复。在 TOB 上没有修复机制：市场的报价在其最优买价或卖价下次变化时才会恢复为最新状态。

重置计数变化

重置计数的任何变化意味着该发布者重启或重新播种了通道。丢弃该源 IP 地址和通道的状态，从参考数据端口重新收集定义，在 MBP 上从快照端口重建订单簿。

隧道未建立

  1. Edge Connect： 在容器内运行状态检查 — docker exec doublezero-edge-connect doublezero status。当数据源正常时（容器拥有守护进程），主机上的 doublezero status 通常会失败。确认主机上的 doublezerod 已停止。
  2. 原生方式： 验证主机守护进程正在运行：sudo systemctl status doublezerod
  3. 验证防火墙规则已就位（GRE、BGP、PIM 以及 doublezero1 上的数据源端口）
  4. 从您连接的同一位置（容器或主机）检查连接状态 — 预期在正确的 DoubleZero 网络上看到 BGP Session Up

客户端 IP 从您主机的公网 IP 自动发现。验证它是否与您购买数据源时使用的 IP 一致。

研究参考设计

可选。如果您已在主机上拥有 DoubleZero 隧道和订阅，并希望记录和绘制数据源数据，研究参考设计通过 Docker Compose 运行 multicast → parser → topofbook-bot → ClickHouse → Grafana：

github.com/malbeclabs/edge-multicast-ref/tree/main/demo

以下将演示指向 Phoenix TOB（参见数据源地址）：

cd demo
cp .env.example .env
sed -i -e 's/^DZ_MULTICAST_GROUP=.*/DZ_MULTICAST_GROUP=233.84.178.24/' \
       -e 's/^DZ_MARKETDATA_PORT=.*/DZ_MARKETDATA_PORT=9201/' \
       -e 's/^DZ_REFDATA_PORT=.*/DZ_REFDATA_PORT=9202/' \
       -e 's/^DZ_INTERFACE=.*/DZ_INTERFACE=doublezero1/' .env
docker compose up -d --build

Grafana 通常在主机的 http://localhost:3000 上访问。详细信息和仪表板：demo README。

这只是可视化您已在接收的数据。它不能替代数据源购买、订阅或上述任一连接方式。