DODO APP / 技术文档

将您的服务接入 DoDo。

配置订阅分发,添加服务名称和对用户有用的链接。只需提供兼容的 HTTPS 响应,无需共享您面板的 API 访问权限。

HTTPS 订阅 Remnawave 或自建面板 各平台状态

Android 2.2.0 已提供 APK,构建版本为 2107,发布于 11 月 10 日。 下载 APK。此版本在 Google Play 之外发布;商店更新上线后将另行通知。如果 DoDo 来自 Google Play,请通过商店更新:签名可能不同。不要为了安装 APK 而删除应用或数据。

iOS 2.2.0 已于 11 月 6 日在 App Store 发布,支持 iOS 15 及以上版本,并使用 Xray 26.10.31。下方 Android 功能说明适用于 APK 2.2.0(2107)。macOS 和 Windows 的信息单独列出。

各平台功能

01 / 入门

快速开始

已实现
  1. 向用户提供 HTTPS 订阅链接:URI 列表、Base64 或受支持的 Xray JSON。
  2. 如果面板按 User-Agent 选择格式,请配置为向 iOS 的 DoDoApp 和 Android 的 DoDoApp/ 前缀返回完整 Xray JSON。
  3. 在 HTTP 响应头中添加服务名称、更新间隔及其他订阅信息。
  4. 用户可通过“+”从剪贴板、手动输入或二维码添加链接。机器人或网站请使用下方介绍的 dodoapp://import。
  5. 测试添加订阅、更新订阅以及连接服务器。
GET /sub/demo-token HTTP/1.1
Host: example.invalid
User-Agent: DoDoApp
Accept: */*

您的服务器所需的最简响应

HTTPS 订阅链接应返回 HTTP 200,在响应头中包含订阅信息,并在响应体中提供配置。使用 Xray JSON 时,请设置 Content-Type: application/json,并以 JSON 替代 URI 列表。

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
profile-title: Demo Provider
profile-update-interval: 1
support-url: https://example.invalid/support

vless://00000000-0000-4000-8000-000000000001@example.invalid:443?security=tls&type=ws&path=%2Fdemo#Demo

添加链接后,用户将看到订阅卡片和服务器列表。名称和支持按钮来自您的响应。请将示例中的 example.invalid 地址和密钥替换为您自己的值;请妥善保密有效的订阅链接。

DoDo 是连接客户端。服务器和访问权限由您的服务提供。您可以使用 Remnawave,或能输出下列任一订阅格式的自建面板。

DODO PARTNERS / 抢先体验

服务商免费注册

完整正式上线即将到来

服务商注册现已开放抢先体验。使用 Google 登录,为您的服务创建控制台,并验证实际分发密钥的精确域名。无需套餐或付款,免费访问没有期限;会实施防垃圾信息和过载的技术限制。

1. 创建您的服务

使用 Google 登录后,填写名称,也可选填公开的 HTTPS 支持链接。控制台归当前登录账号所有,无需输入 Firebase UID、面板密码或用户密钥。重复点击不会创建第二个控制台。您可以准备品牌资料和草稿;公开展示需要通过 DNS 验证并获得 DoDo 批准。

2. 验证域名

在“域名与访问”中填写精确主机名,例如 sub.example.com,不要包含协议、路径或端口。点击“获取 TXT 记录”,将记录名称和唯一值复制到 DNS 面板,然后点击“检查 DNS”。记录结构示例:

Тип: TXT
Имя: _dodo-verify.sub.example.com
Значение: dodo-verification=v1:КОД_ИЗ_ВАШЕГО_КАБИНЕТА

请勿用此示例替代实际验证码。DNS 面板可能会自动附加域名,请检查记录最终的完整名称。如果验证码已过期,请获取新码。控制台会分别显示验证有效期和最近一次 DNS 检查结果。

验证有效期为 30 天。控制台会在到期前七天显示提醒。点击“续期 DNS”,添加新的 TXT 记录,并在到期前完成检查。不支持后台自动续期。如果验证已过期或域名已被撤销,则需要重新验证。公开品牌和故事内容无需签名密钥;在可选的高级协议中,失去信任后,旧密钥不会自动重新启用。

验证仅适用于指定的域名,不涵盖所有子域名,也不涵盖共享 CDN 上的其他服务。如果不同秘密路径共用同一域名,请使用您自己的域名或专用子域名。DoDo 的人工决定记录会单独保存:人工批准不等于 DNS 验证。

3. 等待 DoDo 批准并添加一个响应头

Google 用于验证所有者账号,DNS 用于验证对精确域名的控制权。DoDo 团队对服务的批准仍是另一项必需条件。完成这些步骤后,从控制台获取服务商 ID,并将其添加到同一精确主机名实际成功返回的 HTTPS 订阅响应中:

x-dodo-provider-id: UUID_ПРОВАЙДЕРА_ИЗ_КАБИНЕТА_DODO

这是实际的 HTTP 响应头,不是响应体中的注释或 JSON 字段。错误响应、HTML 占位页、重定向或来自其他主机名的响应均不适用。请勿将此 UUID 与providerid这一用于备用地址的短 ID 混淆。

4. 设置公开品牌和故事内容

在控制台设置服务外观和发布内容。公开品牌和故事内容无需安装模块、创建 signer 或密钥对,也无需提供面板 API 令牌,或修改 Xray、VPN 节点及订阅响应体。发布故事仍需有效的 DNS 验证和 DoDo 授权。

公开内容独立放在 /api/provider-content/v1 中。它不能证明订阅有效或已付费,不会建立私密受众,也不会启用定向推送。请勿在此发布仅供付费用户查看的材料。内容错误不应阻止导入、更新订阅或 VPN 连接。

高级:对特定用户进行签名验证

这是可选的独立协议,不是公开品牌和故事内容的要求。其严格验证仍然保留;公开 ID 不能替代服务器签名。

Google 验证所有者账号,DNS 验证域名控制权,而您服务器的签名响应则验证特定用户是否有权获取服务内容。这些是不同的验证。仅 profile-title、support-url 或公开 ID 相匹配,并不能授予其他服务的材料或报告访问权限。

  1. 在您自己的基础设施中创建 Ed25519 签名密钥。完成 DNS 验证后,仅在控制台登记公开 JWK。私钥始终保留在您的服务器上。
  2. 将控制台中的 x-dodo-provider-id 添加到成功分发密钥的 HTTPS 响应中。普通场景不需要可选的 x-dodo-connector-id。
  3. 当应用携带 x-dodo-subscriber-challenge 发起请求时,请检查密钥、用户权限及您的设备策略,然后生成已签名的 x-dodo-subscriber-token。
  4. 集成通过验证并获 DoDo 批准后,内容会话仅允许访问该服务。用户无需在应用中使用 Google 账号。
集成试点响应头
请求头或响应头方向用途
x-dodo-provider-id服务商服务器 → DoDo控制台的固定 UUID。仅用于发现服务,不用于授权。
x-dodo-subscriber-challenge应用 → 服务商服务器与特定安装实例绑定的一次性验证请求。
x-dodo-subscriber-token服务商服务器 → 应用针对该请求动态生成的签名响应。不能替换为所有人共用的固定字符串。

无需独立端点或完整的 Remnawave 管理 API:可将验证加入现有的密钥分发处理程序。自建面板同样适用此原则。无需修改 Xray 或 VPN 节点。包含令牌的响应应绕过共享 CDN 缓存,并使用 Cache-Control: private, no-store;请勿将密钥、HWID、challenge 或令牌写入公开日志。

内容验证失败不应影响正常的密钥分发、导入或 VPN 连接。同一设备上的多个服务独立关联;删除密钥或撤销权限后,应停止显示关联内容。该协议仍位于 /api/provider-binding/v1 命名空间,与公开内容分开。

本指南不代表已经正式上线。控制台和 DNS 准备完成,不代表服务器已部署、新构建已在 App Store 发布,或已在 iPhone 上测试。内容展示需要兼容的应用版本。简单接入方式不包含大规模定向推送。

DODO PROVIDER CONSOLE

自托管面板

抢先体验 · 0.1.1

在 Linux 服务器上安装独立控制台,并通过您自己的 HTTPS 域名访问。外观、域名和故事内容通过 DoDo API 管理。安装包不包含主管理后台、其他服务、全局诊断或推送发送密钥。数据和已发布文件保存在 DoDo 侧。

  1. 解压归档,检查 SHA256SUMS,并在 .env 中设置控制台的精确地址。
  2. 启动 Docker Compose,并配置指向 127.0.0.1:8795 的 HTTPS 代理。容器不以 root 运行,也无法访问 VPN 节点。
  3. 使用指南中的命令获取私密设置码。在您的面板中点击“连接到 DoDo”,然后在 DoDo 网站使用 Google 登录,选择服务并确认一次性代码。
  4. 要操作数据,请以所有者或编辑者身份单独登录。每个安装实例都会获得可独立撤销的访问权限;安装本身不能替代用户权限。
  5. 通过 DNS TXT 验证密钥分发域名,并在成功响应中添加 x-dodo-provider-id。控制台域名与密钥分发域名可以不同。

无需 Remnawave 模块、VPN 面板密码或其管理 API 令牌。您可在 DoDo 主控制台的服务商分区中管理安装实例并撤销其访问权限。请勿向支持人员发送私密设置码,也不要在截图中泄露。

仅统计您的服务。面板 0.1.1 显示上报设备、型号、操作系统和 DoDo 版本、最近发送日期,以及 1/7/30 天历史记录。使用成功分发密钥的响应中的 provider ID 和精确域名;服务器会检查 DNS 验证是否仍有效。需要兼容的新版 iOS 客户端;在其发布前,旧版应用不会发送这些数据。不会根据名称或支持链接匹配而向服务商提供旧报告。这不是在线人数计数器,也不是付费用户数据库。定向推送和支付尚未接入。

如果 API 不可用,控制台会提示重试,不会创建无限重试队列。写入操作超时后,请先刷新页面并检查结果。密钥和 VPN 功能不依赖此控制台是否可用。

02 / 兼容性

协议

下表列出 iOS 2.2.0 的格式。配置服务时,请使用您面板实际提供的传输方式和参数测试导入与连接。Android 的特殊说明位于表格之后。

协议输入格式支持情况与说明
VLESSvless://, Xray JSON已实现包括兼容的 TLS / Reality 配置。
VMessvmess:// 搭配 Base64 JSON、Xray JSON已实现会验证传输和安全参数。
Trojantrojan://, Xray JSON已实现URI 默认使用 TLS。
Shadowsocksss://, Xray JSON已实现常见的 SIP002 / Base64 变体。加密算法支持取决于内核;不支持 URI 中的外部插件。
Hysteria2hy2://、hysteria2://、兼容的 Xray JSON已实现版本 2;支持格式中可使用 Salamander 和 hopping 参数。
SOCKS5socks://, socks5://, Xray JSON已实现可使用或不使用用户名/密码。这是一种 SOCKS 连接,本身并不提供额外保护。
标准 WireGuardwg://, wireguard://有限支持支持带参数的 URI,或 URI 中以 Base64 编码的 wg-quick 配置。不支持包含任意 peers 集合的文件或 AmneziaWG 参数。
AmneziaWG, TUIC, SSR, Hysteria v1其专有协议方案与扩展iOS 不支持AmneziaWG 配置不会转换为标准 WireGuard。

完整 Xray JSON 中可使用 HTTP、SOCKS 和 WireGuard 辅助出站。单独导入时,请仅使用表中列出的 URI。

Android APK 2.2.0 特别说明。Android 保留了 AmneziaWG 支持,iOS 则不可用。Hysteria2 提供导入和启动功能;请使用您服务器的参数测试连接。只有在应用能识别主要代理协议及其所有关联出站时,才会接受完整 JSON。

03 / 传输

传输与 TLS

取决于配置
URI 参数支持的值说明
type / networktcp, raw, ws, websocket, grpc, xhttp, splithttp, httpupgrade, kcp, mkcpwebsocket 按 WS 解析,splithttp 按 XHTTP 解析。复杂传输设置请通过完整 JSON 提供。
securitynone, tls, reality组合必须得到协议本身和内核的支持。
TLS / Realitysni / peer、fp / fingerprint、alpn;Reality 使用 pbk、sid、spx请使用与服务器设置一致的值。应用会将其传递给 Xray。
WS / gRPC / XHTTPhost、path;gRPC serviceName、authority;XHTTP mode、JSON 对象 extra复杂的嵌套参数建议使用完整 JSON。
证书验证pcs / pinnedPeerCertSha256, vcn / verifyPeerCertByName无效的 pin、不受支持的 ECH 要求或绕过证书验证的设置,会导致该 URI 导入失败,而不是降低 TLS 验证强度。

Hysteria2 使用 QUIC,不使用 type=quic。请通过 hy2:// 或 hysteria2:// 提供。iOS 不支持 URI 传输值 quic、h2 和 http。

04 / 订阅响应

格式与配置完整性

已实现
  • URI 文本列表:独立服务器,通常每行一个。
  • Base64:编码后的列表或受支持的 JSON 容器。Base64 不是加密。
  • 完整 Xray JSON:一个逻辑配置,包含 DNS、规则、负载均衡器及出站依赖关系。
  • JSON 配置数组:各个独立配置显示为不同的可选项。
  • 独立 outbounds 集合:显示为多个独立服务器,不会添加负载均衡器。

完整配置会保存为一个配置文件,而不是替换为指向第一个 outbound 的链接。DoDo 会保留兼容的规则、标签、DNS、observatory / burstObservatory、policy / stats,以及出站之间的关联。配置功能取决于所用 Xray 版本。

通过 JSON 配置可在兼容的完整配置中提供 TLS 分片设置,包括 freedom.settings.fragment。应用内没有独立的分片编辑器。服务用 inbound、本地端口和启动参数会针对 iOS 进行调整。

vless://00000000-0000-4000-8000-000000000001@example.invalid:443?type=ws&security=tls&path=%2Fdemo#Demo
trojan://demo-not-a-real-password@example.invalid:443?security=tls#Demo
hy2://demo-not-a-real-password@example.invalid:443?sni=example.invalid#Demo

损坏或不受支持的配置会被整体拒绝。更新失败时,原有服务器会保留。匹配的服务器会保留 ID、顺序、置顶状态、所选服务器及最近的延迟值。

Happ JSON 输出的临时兼容机制

临时兼容DoDo 首先发送正常请求。如果服务器返回完整可用的 JSON,则不会再发起额外请求。否则,应用可能重新请求同一 URL,使用 User-Agent: Happ/DoDoApp-compat 和标识真实 DoDo 客户端的 X-DoDo-Client。响应不会合并成一个列表。

要提供完整 JSON,请按 User-Agent 为 DoDo 设置规则,或提供明确包含 /json 的链接。应用不会给任意链接追加该路径。如果兼容请求失败,仍会保留可用的主要响应;已保存的完整配置不会被不完整的 URI 列表替换。

不支持happ://crypto…、happ://crypt…、Happ 专有加密格式,以及打开 Happ 深层链接。DoDo 自有的DoDo crypt1 和以 DoDo 为接收方的 AGE1已在 iOS 2.2.0 和 Android APK 2.2.0 中提供。仅为 Happ 或其他接收方加密的 AGE 文件,DoDo 无法解密。

iOS 2.2.0 的下载限制:每个响应最多 8 000 000 字节,每次操作累计最多 12 000 000 字节,每个 JSON 配置最多 2 000 000 字节。AGE1 加密响应体单独限制为 2 MiB。Android 2.2.0 的响应和操作限制分别为 2 / 4 MiB。总超时为 25 秒,重试次数有限。发生错误时不会关闭 TLS 验证。出现网络错误的未完整下载响应不会被导入。

04.1 / 保护链接

DoDo crypt1:分发订阅,无需暴露原始 URL

已实现

已在 App Store 的 iOS 2.2.0 和 Android APK 2.2.0(2107)中提供。Android 请通过剪贴板或手动输入添加保护链接。部分 HUAWEI 设备暂时可能无法识别 crypt1 二维码,扫描修复正在准备中。Windows 支持已列入计划。新的 Mac 版本移植尚未在 Mac App Store 发布。

crypt1 加密用户已有的 HTTPS 链接,生成 dodoapp://crypt1/<JWE> 形式的链接。打开后,DoDo 会要求确认添加,然后才访问订阅服务器。内部仍可使用常规来源:URI 列表、Base64、一个完整 Xray JSON 或配置数组。DNS、路由和负载均衡器由同一解析器读取。

使用 response: "auto" 的普通 crypt1 无需修改面板或订阅内容。链接在本地加密,无需加密 API、注册 DoDo、付费高级权限,也不强制要求 providerid。Remnawave 和自建面板均适用。这是 DoDo 自有格式,不是打开 Happ 或 INCY 专有加密链接的方式。

生成器通过浏览器中的 WebCrypto 运行。输入的 URL 不会发送到服务器;链接不会使用 Cookie 或浏览器存储。自动分发请使用 Node.js 24+ 以及归档中的同一 SDK。公开密钥清单仅包含公开 RSA 密钥和 AGE 接收方。

无需修改面板,快速开始

  1. 获取某一特定用户已有的 HTTPS 订阅地址。
  2. 打开生成器,粘贴地址并保留“自动”选项。名称可不填。
  3. 通过私信或机器人按钮将生成的 crypt1 链接发送给该用户。请勿将同一个个人订阅分发给所有用户。
  4. 在 iOS 2.2.0 中打开链接,或通过“+”从剪贴板、手动输入或二维码添加。Android APK 2.2.0 请使用剪贴板或手动输入;HUAWEI 的已知二维码限制见上文。确认添加后,测试更新和 VPN 连接。

在“分享二维码”和复制时,DoDo 使用原始 crypt1 链接,而不是解密后的 URL。过长的链接可能无法放入二维码,此时请以文本发送。对同一 URL 重复加密会产生不同字符串,但应用会更新原有的订阅卡片。

在 Telegram 机器人或您的服务器上生成

解压工具归档。其中包含 cli/、generator/、keys/、指南和规范。SDK 无需 npm 包,也不会从网络下载密钥。请将用户 URL 保存在您服务的安全存储中。

# Запускайте из папки распакованного архива; требуется Node.js 24+.
# subscription-url.txt содержит HTTPS-ссылку одного пользователя.
node cli/dodo-crypt1.mjs --name "Demo Provider" < subscription-url.txt

# Для полного payload из JSON-файла:
node cli/dodo-crypt1.mjs --input-json < payload.json

CLI 从 stdin 读取原始 URL,仅输出保护链接。请勿将真实令牌放入命令参数、终端历史或机器人日志。CLI 输出同样是秘密链接,只能交给订阅所有者。

import { readFile } from 'node:fs/promises';
import { createCrypt1Link } from './generator/crypt1.mjs';

const publicManifest = JSON.parse(
  await readFile(new URL('./keys/public-keys.json', import.meta.url), 'utf8')
);

const protectedLink = await createCrypt1Link({
  v: 1,
  type: 'subscription-url',
  url: 'https://primary.example/sub/demo-token?format=json',
  response: 'auto',
  name: 'Demo Provider',
}, publicManifest);

// Передайте protectedLink пользователю; не записывайте её в общий лог.

createCrypt1Link(payload, publicManifest) 返回 Promise<string>。第一个参数描述订阅,第二个参数是已发布清单的内容。SDK 使用其中的 activeKid;服务商不需要私钥。请在 DoDo 更换密钥时更新公开清单的本地副本,而不是在每次用户请求时更新。

createCrypt1Link 的 payload 字段
字段必填传入内容
v是数字 1。
type是字符串 subscription-url。
url是用户的完整 HTTPS 地址,最多 4096 个 UTF-8 字节。不得包含用户名/密码、片段、空格、IP 字面量或本地地址。
response是普通响应或 AGE1 响应使用 auto;仅已配置好的 AGE1 来源使用 age1-required。
name否去除首尾空格后非空的名称,最多 120 个 UTF-8 字节。禁止使用控制字符。这是供确认时显示的名称,不是服务商身份凭证。

不要向 payload 添加自定义字段。URL 按原样保存,不会再次解码:%2F、%252F、+ 符号、路径和 query 均须保持与面板输出完全一致。primary.example、backup.example 和 demo-token 仅为示例,不是有效地址或密钥。

自行实现时使用的 crypt1 格式

使用现成 SDK 时,它会自动创建头部和随机值。其他实现需要使用 JWE Compact Serialization:五个 protected.encrypted_key.iv.ciphertext.tag 段,采用不带 =、空格或额外编码层的规范 base64url。

{"alg":"RSA-OAEP-256","enc":"A256GCM","typ":"dodo-subscription+jwe","kid":"dodo-crypt1-20261102"}

此处的 kid 仅作为当前密钥的示例。自行实现时,请从公开清单的 activeKid 中选择,不要永久硬编码。

{"v":1,"type":"subscription-url","url":"https://primary.example/sub/demo-token","response":"auto","name":"Demo Provider"}
crypt1 v1 的精确参数
参数值
RSA3072 位,exponent 65537;RSA-OAEP-256,使用 SHA-256 和 MGF1 SHA-256,OAEP label 为空。
AES-GCM每次使用新的随机 CEK 32 字节、IV 12 字节、tag 16 字节。AAD 为 JWE 第一个编码段的 ASCII 字节。
请求头或响应头仅包含必需的 alg、enc、typ、kid。kid 必须是应用已知的值。
限制完整 crypt1 链接为 16 384 个 UTF-8 字节;JSON payload 为 8192 字节;原始 URL 为 4096 字节;名称为 120 字节。
禁止使用重复的 JSON 字段名、未知字段/算法、zip、crit、jku、内嵌密钥,以及从头部 URL 下载密钥。

AGE1:服务器响应加密需单独配置

crypt1 保护链接;AGE1 保护该链接返回的 HTTP 响应体。AGE1 也可搭配普通 HTTPS 地址使用。服务器必须另行将有效的 JSON、URI 列表或 Base64 加密给已公开的 DoDo X25519 接收方。

age1-required 不会启用服务器端加密。此参数要求应用拒绝未加密的响应,包括备用地址的响应。请先在服务器上配置并验证 AGE1,再分发使用此策略的链接。使用 auto 时,可接受普通受支持响应或 AGE1;已识别但损坏的 AGE 不会再次按明文解析。

应用不会发送用于在您的服务器上启用 AGE 的请求头:请求仍包含常规的 Accept: */*、User-Agent 和设备信息。crypt1 中的 response 也不是发给服务器的命令。可靠的方式是使用一个始终返回 AGE1 的独立 HTTPS 地址,为其他客户端保留原有链接。如果使用 User-Agent 规则,请注意:DoDoApp 这一值本身并不包含用户的构建版本号。

以下示例需要支持 X25519 的官方 CLI age 和 jq。将公开清单保存到 keys/public-keys.json;不会向服务商提供任何 DoDo 私钥。subscription.json 必须包含该用户当前有效的配置。

# В примере используется первый опубликованный AGE-получатель.
jq -er '.ageRecipients[0].recipient' keys/public-keys.json > age-recipients.txt

# Бинарное тело HTTP-ответа:
age --encrypt --recipients-file age-recipients.txt \
  --output subscription.json.age subscription.json

# Или ASCII armor вместо бинарного тела:
age --encrypt --armor --recipients-file age-recipients.txt \
  --output subscription.json.age.armor subscription.json

将生成文件的内容直接作为响应体返回:二进制 age v1 通常使用 Content-Type: application/octet-stream,ASCII armor 使用 text/plain。DoDo 根据响应体开头识别格式,而不只依赖 Content-Type。不要添加 JSON 包装、额外一层 Base64、BOM 或 HTML。不支持密码式 scrypt、SSH 密钥、插件,以及为其他接收方加密的 AGE 文件。

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Cache-Control: private, no-store
profile-title: Demo Provider
profile-update-interval: 2
subscription-userinfo: upload=0; download=0; total=107374182400; expire=1893456000
fallback-url: https://backup.example/sub/demo-token
providerid: demo-vpn

名称、有效期、流量、更新间隔、支持链接和 fallback-url 仍须放在真正的 HTTP 响应头中,位于 AGE 响应体之外,并遵循原有的优先级和验证规则。示例中的 providerid 对 crypt1/AGE 是可选的;如果它与备用地址一起被保存,备用地址必须返回相同的 ID。备用机制遵循通用 fallback 规则,不受链接加密影响。使用 age1-required 时,主要地址和备用地址都必须返回 AGE1。

向用户分发前

  1. 确认已安装 iOS 2.2.0 或更新版本。添加一个测试订阅,确认请求仅在用户确认后开始。
  2. 将配置数量与原始 JSON 对比;测试包含负载均衡器的完整配置、更新、服务器选择和连接。
  3. 使用 AGE 时,请测试主要地址和备用地址。接收方错误、响应体损坏,以及 age1-required 策略下返回明文时,都应报错,而不是导入部分服务器。
  4. 测试复制/二维码、重复添加和更新:原始 crypt1 链接、订阅顺序和设置都应保留。请勿在截图中公开有效令牌。
链接或响应无法被接受时
原因检查内容
未知密钥或格式检查应用版本和构建版本号、最新公开清单,以及 DoDo 自有的 dodoapp://crypt1/ 方案。Happ 密钥及其加密链接不适用。
无法打开保护订阅检查完整链接是否未受损、五个 JWE 段、受支持字段,以及是否存在重复的 URL/Base64 编码。原有服务器不会被删除。
需要 AGE 响应服务器在 age1-required 策略下返回了明文数据。请修改服务器输出,而不是关闭应用验证。
无法解密 AGE检查 DoDo 接收方、二进制格式或 ASCII armor、是否没有额外包装,以及文件是否完整传输。不要尝试从损坏的响应体中提取单独 URI。
HTTP、TLS、HWID 或订阅有效期服务器原有的限制仍然有效。crypt1/AGE 无法绕过访问拒绝、设备数量限制或证书错误。

保护链接仍然能访问订阅。它不是 DRM,也不能证明服务商身份。解密密钥内置于应用中,研究应用时可能被提取。请安全存储原始链接和 crypt1 链接,不要发送到共享日志,并使用您面板的 HTTPS、身份验证及限制机制。不要在 payload 中放入管理 API 令牌或服务器密码。

05 / 元数据

HTTP 响应头

已实现

请将这些字段放在订阅链接返回的 HTTP 200 响应头中。字段名不区分大小写。对于普通元数据,DoDo 先读取 HTTP 响应头,再读取响应体注释、解码后的 Base64 和 JSON 元数据中受支持的字段,使用第一个有效值。x-dodo-provider-id 是例外:只接受来自同一精确主机名、实际成功返回的 HTTPS 响应头。

订阅响应头;功能可用性取决于应用版本
请求头或响应头发送内容用户看到的内容说明
profile-title纯文本名称,或 base64:… UTF-8。订阅 / 服务卡片名称。缺少此字段时,先使用 subscription-name,再使用 Content-Disposition 中的 filename / filename*。
x-dodo-provider-id您控制台中的服务商 UUID。在兼容的应用版本中关联公开品牌和故事;此处并不声称已发布版本具备此功能。需要通过 DNS 验证的精确主机名及 DoDo 批准。不能验证支付,不会开放私密受众,也不会启用推送。无需签名模块。
x-dodo-provider-logo-url图片的公开 HTTPS URL。顶部区域的服务标志。不要在图片地址中包含密码或秘密订阅链接。设备上的应用图标不会改变。
support-url支持地址,例如指向 Telegram 的 HTTPS 链接。卡片中的“支持”按钮。没有值时,不会自动创建该按钮。
profile-web-page-url控制台、机器人或订阅页面的公开链接。跳转网站 / “购买 / 续费”按钮。别名:homepage。支付在您的页面完成,不在 DoDo 内进行。
subscription-userinfoupload=…; download=…; total=…; expire=….有效期、状态和已用 / 可用流量。流量大小请以字节发送,expire 以秒为单位的 Unix timestamp 发送。单独的 HTTP 403 不会设置到期日期。
profile-update-interval1 至 168 的整数小时数。不是分钟,也不是秒。到达更新时点且应用获得执行时间后,自动更新。默认 1 小时。后台启动时间由操作系统决定。
routing静态 JSON / Base64 / DoDo routing 链接。该订阅的 Direct / Proxy / Block 规则。通过网络更新规则请使用 autorouting。新规则会在下次连接时生效。
autorouting独立规则资源的 HTTPS URL。该订阅的最新规则。格式、限制和检查间隔请参阅“路由”章节。
announce文本或受支持的 base64:…。卡片中的公告区域。公告不会作为推送通知发送,也不会发布为故事。

如果订阅是静态文本文件

受支持的字段可以放在响应体开头的注释行中。例如:

#profile-title: Demo Provider
#profile-update-interval: 2
#support-url: https://example.invalid/support
#announce: Demo announcement
vless://00000000-0000-4000-8000-000000000001@example.invalid:443?security=tls#Demo

HTTP 响应头优先于注释。服务商识别字段,包括 x-dodo-provider-id,仅接受来自同一精确主机名的成功 HTTPS 响应,不接受响应体注释中的值。ID 本身不能证明对私密内容的访问权;公开品牌和故事不用于验证支付。

profile-title: Demo Provider
profile-update-interval: 2
x-dodo-provider-logo-url: https://example.invalid/logo.png
support-url: https://example.invalid/support
profile-web-page-url: https://example.invalid/account
subscription-userinfo: upload=0; download=0; total=107374182400; expire=1893456000
autorouting: https://example.invalid/routing.json

自动更新如何运行。DoDo 在使用期间以及用户返回应用时检查更新时点。后台执行时间由 iOS 安排,因此更新可能晚于设定间隔。发生网络错误时,已保存的订阅仍保留在设备上。

不支持 update-always、profile-description、premium-url、fragmentation-*、noises-*、server-address-resolve-* 响应头,也不支持服务商控制 Lite Mode、主题或按钮样式。DNS 和复杂传输参数请通过兼容的完整 Xray JSON 提供。不会根据响应头下载任意外部地理数据文件。

fallback-url 及其关联的 providerid 详见“备用订阅”章节。它们仅接受真正的 HTTP 响应头,不接受响应体注释或 JSON 字段。

05.1 / 备用地址

备用订阅:fallback-url

iOS 和 Android 2.2.0

当主要订阅地址暂时不可用时,DoDo 可从预先保存的备用地址下载更新。此功能适用于服务器 URI 列表、Base64 和受支持的 JSON,包括完整 Xray 配置。无需加密链接。

可用性。已发布的 iOS 2.2.0 和 Android APK 2.2.0(2107)支持备用地址。响应头可用于普通 HTTPS 链接和 JSON,不依赖 crypt1。已发布的 Mac 版本暂不支持此机制。

备用下载无需注册 DoDo 或获得高级权限。可使用 Remnawave 或自建面板:关键是服务器返回正确的 HTTP 响应头及对应用户的订阅。

备用订阅响应头
请求头或响应头值要求
fallback-url特定用户备用订阅的完整 HTTPS 链接。不能仅有域名。路径、令牌和 query 由服务商指定,应用不会自行复制它们。仅从主要 HTTPS 来源在同一 origin 上返回的有效成功响应中接受。
providerid您的 VPN 服务的可选固定 ID,例如 demo-vpn。ID 由服务商自行选择。它不是 Happ 许可证、DoDo 控制台 ID、HWID,也不用于验证支付。如果主要响应与备用地址一同提供了该 ID,备用地址必须返回完全相同的值。

响应头名称不区分大小写。providerid 的值区分大小写:Demo-VPN 和 demo-vpn 不同。允许 1–128 个 ASCII 字符:首字符为字母或数字,后续可为字母、数字、点、连字符、下划线及冒号。请勿使用秘密 API 令牌。如果您的服务已提供自己的 ID,无需为了 DoDo 而修改。

如果您已为 Happ 或 INCY 用户返回 fallback-url 和 providerid,DoDo 可以按此处描述的格式读取。用户只需普通 HTTPS 订阅链接,无需单独的 DoDo ID。这不会增加对 happ://crypto… 或其他应用命令的支持。

不要将 providerid 与服务商关联章节中的 x-dodo-provider-id 混淆。备用下载不会授予故事、通知或私密数据访问权限;这些功能需要单独配置。

主要与备用响应示例

主要订阅 https://primary.example/sub/demo-token 在响应体中返回用户配置,并返回以下响应头:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
providerid: demo-vpn
fallback-url: https://backup.example/sub/demo-token

备用地址必须返回同一用户的订阅。如果主要响应包含 providerid,备用响应也应添加该字段:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
providerid: demo-vpn

没有 providerid 时,备用机制也可按主要来源提供的精确 HTTPS 地址运行。如果 ID 已保存,而备用响应返回其他 ID 或完全未返回 ID,则会拒绝更新并保留原有服务器。ID 匹配本身不能证明服务所有权或用户归属。

如何在 Remnawave 中配置

  1. 打开订阅响应头设置:Response Headers 或 Additional Response Headers。具体名称取决于面板版本。
  2. 添加 fallback-url,填写用户专属的备用 URL,并在需要时添加固定的 providerid。
  3. 在支持响应头模板的版本中,使用 {{SHORT_UUID}} 让面板填入当前订阅标识。请设置备用服务确实能提供该订阅的域名和路径。
  4. 为所有需要的格式(包括 JSON)和适用的 User-Agent 配置响应头输出。可对特定客户端使用 Response Rules,但不要替换其他格式规则。
providerid: demo-vpn
fallback-url: https://backup.example/sub/{{SHORT_UUID}}

primary.example、backup.example 和 demo-token 域名仅为示例,不是有效地址或密钥。请替换为您自己的值。不要为所有用户写入同一个个人链接。服务器响应中必须已包含该用户的完整链接,不能残留未展开的 {{SHORT_UUID}}。

准备备用服务

  • 为备用地址配置 DNS、有效的 HTTPS 证书和配置分发服务。仅添加一条 DNS 记录不会创建备用服务。
  • 返回配置,而不是网站首页。保留订阅有效期、流量、规则和设备限制;DoDo 使用相同的 HWID。
  • 同一服务器上的备用域名可能有助于应对域名封锁,但无法应对服务器本身或其 IP 不可达。后一种情况需要为备用服务准备独立且可访问的基础设施。

应用何时使用备用地址

主要来源发生网络故障、超时、HTTP 408 或 5xx 错误后,应用可能在总时限和重试次数内访问已保存的备用地址。TLS 错误、授权拒绝、HWID 限制、明确停用或到期的订阅、HTTP 404/410 及 429,不会通过备用地址绕过。仅使用一个备用地址,不会串联镜像或猜测路径。

下载成功后更新同一张卡片:原始链接、ID 和订阅顺序均保留。如果两个地址都没有响应,或备用地址返回不可用配置,应用不会删除原有服务器和订阅设置。

必须先获取备用地址。DoDo 在成功添加或更新主要订阅后保存 fallback-url。如果首次添加时主要地址就已不可用,应用无法从不可访问的响应中获知备用地址。providerid 本身不会查找地址。

测试时,先在支持此功能的 DoDo 构建版本中成功更新订阅。然后检查同一用户的备用地址是否可用,并可控地让主要地址单独发生故障。完全断网无法测试 fallback:备用地址也需要网络。请勿在截图或日志中公开包含令牌的真实链接。

06 / 设备

HWID 与设备数量限制

已实现

下载订阅时,DoDo 会向您的服务器发送已保存的安装标识符、设备型号和系统版本。HWID 由应用生成,不是手机序列号,也不是 IDFA。请结合服务器上的访问验证,用它管理设备数量。

User-Agent: DoDoApp
Accept: */*
x-hwid: 00000000-0000-4000-8000-000000000001
x-device-os: iOS
x-ver-os: 18.5.0
x-device-model: iPhone 14 Pro

这是 iOS 请求示例。Android 使用相同的技术请求头名称,并发送 x-device-os: Android、自身的操作系统版本和型号。其 User-Agent 格式为 DoDoApp/2.2.0+2107 (Android 15; Demo Model);服务器规则不要限制为与 DoDoApp 完全相等。

  • 标识符保存在设备上,iOS 还会将其保存在 Keychain 中。拒绝后重新下载不会生成新的 HWID。
  • 重置应用设置不会改变 HWID,也不会重置服务商的设备数量限制。
  • HWID 通过请求头发送,不会添加到订阅地址中。
  • 重定向到其他 origin 时,iOS 会移除敏感请求头,Android 则拒绝整个跳转。禁止从 HTTPS 降级到 HTTP。
  • 允许的设备数量和订阅访问权限由服务商服务器决定。
服务商响应处理方式
x-hwid-max-devices-reached: true已达到设备数量限制的错误。
x-hwid-limit: true表示同一限制的兼容旧版标志。
x-hwid-not-supported: true / 明确的 HWID_REQUIRED明确提示下载被拒绝;不会更换为新标识符。

x-hwid 和 x-dodo-provider-id 不能替代用户授权。要访问私密发布内容,服务器还需单独确认该订阅属于此用户。

08 / 规则

静态与可更新路由

下方列出支持的字段

指定哪些域名和 IP 直连(Direct)、通过代理(Proxy)或阻止(Block)。DoDo 规则配置使用自有格式;不可在这些字段中传入完整 Xray JSON。

{
  "Name": "Demo rules",
  "GlobalProxy": true,
  "DomainStrategy": "IPIfNonMatch",
  "DirectSites": ["domain:example.invalid"],
  "DirectIp": [],
  "ProxySites": ["full:proxy.example.invalid"],
  "ProxyIp": [],
  "BlockSites": ["geosite:category-ads-all"],
  "BlockIp": []
}

本地 routing 链接

将 JSON 保存为 UTF-8,编码为 Base64 或 Base64URL,并将结果放在 /add/ 或 /onadd/ 后。链接中建议使用不带结尾 = 的 Base64URL。普通 Base64 可进行一次百分号编码。

dodo://routing/add/{BASE64_UTF8_JSON}
dodo://routing/onadd/{BASE64_UTF8_JSON}
dodo://routing/off

两个命令都会保存并启用配置。off 会停用规则,但不会删除。不要在链接中添加用户名、密码、端口、query 或 fragment。规则将在下次连接时应用;当前 VPN 不会自动重连。

autorouting:独立 HTTPS JSON

在 autorouting 中提供规则文件的公开 HTTPS 链接,例如 https://example.invalid/routing.json。请将地址替换为您自己的域名:不接受 .invalid 或本地地址。

  • 响应应为 HTTP 200,包含 UTF-8 编码的 JSON 对象。此处不接受 Base64、routing 链接或完整 Xray JSON。
  • 仅允许上述示例字段及字符串类型的 LastUpdated;也支持其 camelCase 别名。未知字段和冲突别名会被拒绝。
  • 列表必须是字符串数组:域名、domain:、full:、经过检查的 regexp:、geosite:;IP 列表可使用 IP/CIDR 和 geoip:。类别是否存在会根据可用地理数据文件检查。
  • 远程格式的 DomainStrategy:AsIs、IPIfNonMatch 或 IPOnDemand。GlobalProxy 为 JSON 布尔值或字符串 "true" / "false"。
  • 限制:每个文件 256 KiB,总计最多 2048 条,每条最多 512 字节。iOS 请求超时最长为 12 秒。
  • 使用标准端口的 HTTPS,不得包含用户名、密码或 fragment。重定向仅允许在同一 origin 内进行,且次数有限。该请求不会发送 HWID、Cookie 或订阅 API 令牌。
  • 规则按订阅独立保存。网络错误或 JSON 无效时,保留最后可用的版本。
  • iOS 对成功来源的检查频率不超过每小时一次;错误后会等待一段时间再重试。后台执行取决于系统。新规则在下次连接时使用。

订阅响应体中也可识别带 HTTPS 来源的 dodo://autorouting/add/… 和 dodo://autorouting/onadd/…。请勿将它们当作从机器人或浏览器打开应用的链接。

高级设置。此格式不支持 DNS / FakeDNS、外部 Geoipurl / Geositeurl 或 routeOrder。复杂路由和负载均衡器请使用兼容的完整 Xray JSON。

Android 2.2.0 中,autorouting 检查间隔为 24 小时,请求超时为 8 秒。规则同样按订阅独立保存;请求不包含 HWID、Cookie 或 API 令牌。autorouting 间隔与用于控制订阅本身更新的 profile-update-interval 无关。

09 / GEOIP 与 GEOSITE

应用内置地理数据

已实现

iOS 2.2.0 和 Android 2.2.0 内置 geoip.dat 和 geosite.dat。首次连接前无需随订阅下载这些文件。

更新来源为 Loyalsoldier/v2ray-rules-dat。安装前会验证 SHA-256、文件格式及所需类别是否存在。验证失败时,保留最后可用的文件对。

iOS 中可在“设置 → 高级用户 → 地理数据”查看文件版本并手动检查更新。当应用获得执行时间且来源可访问时,也会自动检查更新。

请使用 Loyalsoldier 数据集中存在的 geosite: / geoip: 类别。其他数据集的类别可能不存在。不支持从服务商链接下载任意地理数据文件。

Android 上正在运行的 VPN 会继续使用已选择的文件版本,直到断开连接。更新文件在下次连接时应用;支持回退到可用版本。

10 / 服务器检测

延迟检测

iOS 中可在“设置 → 高级用户 → 延迟检测”选择模式。默认为 TCP。可设置自定义 HTTPS 测试 URL,超时可设为 1 至 10 秒。

模式检测内容如何理解数值
TCP建立与服务器的连接。由于 Hysteria 使用 UDP,会通过配置执行单独的 HTTP 检测。原始实测时间,不除以 3.3。TCP 端口开放本身不能证明已通过授权或可访问互联网。
DoDo Ping通过受支持的服务器 Xray 配置执行 HTTP GET;部分协议使用其专用检测。估算值:实测结果除以 3.3。
HTTP GET / HTTP HEAD通过配置,使用相应方法请求测试 HTTPS URL。实测请求时间,不除以 3.3。不测量数据传输速度。
ICMP向服务器发送 ICMP 请求。响应时间。服务器可能阻止 ICMP,但仍可正常提供 VPN 连接。

原始测量结果会按原值保存,不做换算。切换检测方式时,iOS 会执行相应测量,不会把其他方法的结果当作新结果显示。更新密钥后,匹配服务器的最近数值会保留。N/A 表示检测失败或该配置不支持;省略号表示所选方法尚无结果。

并发检测数量有限。测量不会重连当前 VPN。如果 JSON 包含负载均衡器,会通过整个配置及其服务器选择规则进行检测。

Android APK 2.2.0(2107)提供相同的五种模式。普通 TCP 显示实测连接时间,不做除法:仅含一个 TCP 服务器且无歧义的 JSON 配置也适用。Hysteria、负载均衡器以及复杂或含糊的配置,在 TCP 模式下会通过完整配置执行 HTTP GET。辅助内核启动和本地授权不计入显示的 HTTP 时间,但会占用总超时。只有 DoDo Ping 会将 HTTP GET 结果除以 3.3。

10.1 / 网络设置

DNS、MTU 与首选 IP

iOS 2.2.0

打开“设置 → 高级用户 → 网络”。普通连接建议保留默认值。更改在下次连接时应用,不会自行重连正在运行的 VPN。

iOS 高级设置
参数可用选项适用场景
隧道 MTU默认、1420、1380、1280,或 1280 至 1500 字节之间的整数。用于排查特定网络的加载问题。这是数据包大小,而非速度限制;不会自动寻找最佳 MTU。
首选 IP“遵循配置”、“优先 IPv4”或“优先 IPv6”。为以域名指定的 VPN 服务器选择地址族。这不会关闭手机的 IPv6。复杂配置可能不会应用此设置,以保留服务商规则。
配置中的 DNS在可安全调整配置时,使系统隧道与 Xray DNS 协调。用于保留服务商的 DNS 规则。不会强制改写含糊的方案、FakeDNS 或对系统 DNS 的依赖;不保证能通用转换任意 DNS 配置。
VPN 资源独立页面展示扩展内存、Go heap、连接和文件描述符。用于诊断。需要启用诊断日志并有近期 VPN 会话;没有数据时应用会明确提示,而不是显示零值。

兼容的完整配置会保留自己的 DNS、路由、负载均衡器和传输参数。选择 IP 和 MTU 不会更改已保存的密钥。应用尚未加入手动内存限制、No Limit Mode 或可编辑所有 Xray 参数的独立编辑器。

Android APK 2.2.0 同样提供 1280 至 1500 字节的 MTU,以及 IPv4 / IPv6 偏好。设置对新连接生效;不会改写已保存的完整配置和服务商 DNS。VPN 资源页面和 DNS 行为可能与 iOS 不同。

IOS / 版本 2.2.2

配置兼容性与服务器检测

已上传至 App Store Connect

iOS 2.2.2 (113) 已于 2026 年 11 月 12 日上传至 App Store Connect。目前仍在准备发布;App Store 上线时间将另行公布。以下变更仅适用于此 iOS 构建版本,不代表已发布的 Android 或 macOS 版本也已更新。

完整 JSON 配置

即使 env 和 version 是唯一的附加字段,导入时仍会保留为一个完整配置。环境变量名称保留大小写,核心版本限制仍然有效。独立配置数组仍显示为多个可选配置;负载均衡器不会拆分为多个独立服务器。

HTTP 检测与 Hysteria2

连接与 HTTP GET / HEAD 采用相同的配置准备流程,包括路由规则、DNS、传输设置和提供商的地理数据作用域。检测会通过选定的代理或负载均衡器发送请求,不会重新连接当前 VPN。测试核心隔离应用 env 变量,并在结束后恢复环境。应用自身的内部变量受到保护,无法被替换。

修复了 Hysteria2 HTTP 检测时的地理数据准备问题。在 TCP 模式下,这类 UDP 服务器仍通过 HTTP 检测;普通 TCP 则直接显示测得的连接时间,不作除法。只有估算模式 DoDo Ping 会将 HTTP GET 结果除以 3.3。这不是测速,也不是对 TUN 或所有目标的完整检测。

DNS 与有限的 FakeDNS 支持

改进了 Xray DNS 与系统隧道的协调、分流 DoH,以及具有循环保护的本地 DNS 别名处理。支持显式配置、使用标准地址池的兼容 FakeDNS 配置;不会自动适配任意混合 DNS 方案。FakeDNS 配置无法进行独立 HTTP 检测,但这本身不表示其 VPN 连接无法工作。不支持 Lua 脚本。

FinalMask 与分片

支持兼容的 URI 参数 fm、fragment 和 fragmentPackets / fragmentLength / fragmentInterval,以及 HTTP 响应头 fragmentation-enable、fragmentation-type、fragmentation-packets、fragmentation-length、fragmentation-delay 和 fragmentation-maxsplit。只有 fragmentation-enable: true 且类型为 xray 时,才会启用响应头中的掩码;fragmentation-interval 可作为延迟响应头的别名。

优先顺序为:完整 JSON 配置、URI 中显式指定的掩码、成功 HTTP 响应中的设置。不会自动叠加两种掩码,也不会静默修正完整 JSON。不兼容的有效要求会被拒绝,而不是替换为其他方法。不会向 UDP-only / Hysteria 自动添加 TCP 分片。不会降低 TLS 验证要求。

界面与本地保护

改进了通知列表,以及锁定屏幕和灵动岛中的 VPN 卡片。主应用支持 iOS 15 及以上版本;Live Activity 需要 iOS 16.1 和兼容设备。

  • 本地 SOCKS 保护。设备上 VPN 隧道与 Xray 之间的内部连接,每次连接使用独立的服务用户名和密码。切换服务商后,这些凭据不会沿用到下一次会话。
  • 保留服务商密码。如果完整配置已要求本地 SOCKS 入站授权,并包含可用账号,则会使用该账号,不会替换为服务密码,也不会关闭安全要求。
  • 不会重新配置远程服务器。此保护针对应用的本地入站,而不是服务商的 SOCKS 服务器。其地址、用户名和密码不会改变,无需重新配置节点。
  • 更清楚地说明失败原因。自愿发送的技术报告将补充有限的导入错误摘要:阶段、原因、最近最多四次下载尝试、HTTP 状态码、允许的系统网络代码和耗时。摘要不超过 1024 字节;不发送 URL、密钥、HTTP 响应头或响应体。发送仍需用户同意。

仍会严格拒绝不完整导入:不受支持的配置不会仅导入可用部分并显示添加成功;更新失败时会保留原有服务器。兼容性仍取决于配置、传输方式和内核版本;不会放宽 TLS 验证或下载限制。

此更新尚未发布。 请在用户更新客户端后再下发新参数。兼容性取决于配置和核心版本;请使用您服务的密钥和用户网络进行测试。我们会在更新页面和 Telegram 频道公布发布消息。

11 / 支持

日志与自愿报告

已实现

iOS 中打开“设置 → 高级用户 → 日志”:可启用记录、实时查看事件、暂停查看,以及复制或清除日志。发送前请检查内容,其中可能仍包含服务器的技术地址。

发生错误后,DoDo 可能会询问是否自动向开发者发送技术报告。只有用户同意后才会开始发送。您可在设置中关闭、撤回同意并删除已发送的数据。

  • 报告包含错误代码及阶段、设备型号、系统和应用版本。
  • 技术报告不包含订阅链接、HWID、完整 VPN 配置或流量内容。
  • 无网络时,报告会在设备上容量有限的队列中等待发送。
  • 报告由 DoDo 开发者接收。服务商无法通过订阅响应头获得访问权限。

自动报告涵盖应用已处理的密钥添加及 VPN 运行错误。iOS 2.2.0 还集成了 Apple MetricKit:用户同意诊断后,DoDo 可发送已收到主应用崩溃或卡死报告的标志。这不是完整 crash 文件或调用栈,也不保证记录 VPN 扩展的所有故障。Apple 的报告可能延后至下次启动后才送达。

iOS 与 Android 诊断
平台功能限制
iOS 2.2.0发送同意、报告队列、交付、撤回同意和删除数据。来自 MetricKit 的有限 crash / hang 标志。不含完整调用栈;不涵盖所有系统崩溃、内存不足终止或卡死。通知权限不能替代诊断同意。
Android APK 2.2.0用户同意、安全报告队列、应用运行时发送、撤回同意和删除数据。下载报告有助于区分网络、响应和导入错误。并非所有系统崩溃和卡死都会被记录。应用关闭后不会持续发送;不会发送密钥和配置响应体。
服务商可接收用户主动决定分享给它的日志。无法访问 DoDo 全局诊断、其他服务或流量内容。

请勿将订阅请求中的设备信息与诊断混淆:您的服务器接收 HWID 和技术请求头,自愿报告则由 DoDo 开发者接收。本地日志由用户另行分享。

11.1 / 统计

按服务商统计使用情况

iOS 2.2.0

DoDo 根据 profile-title 中的公开服务名称和经过清理的 support-url 联系方式分组,以统计应用使用不同服务商密钥的情况。此统计不强制要求额外的 providerid,也无需带令牌的链接、VPN 密钥或完整配置。

统计包含什么,以及如何理解
数据用途与限制
服务名称和支持联系方式用于分组。名称相同不能证明属于同一所有者;个人信息或疑似秘密的值可能被跳过。
型号、操作系统、应用版本用于按 iPhone 和 Android 设备型号、操作系统版本及 DoDo 构建版本生成报告。Android APK 2.2.0 也已接入此统计。macOS 和 Windows 尚未接入。
安装实例与配置数量1 / 7 / 30 天报告。这不是精确人数、活跃 VPN 会话数或在线计数;同一安装实例可使用多个服务商。
不会发送的内容秘密密钥 URL、VPN 密码、订阅 HWID、手机名称和浏览历史。此统计不会按来源 IP 绘制地理地图。

iOS 2.2.0 默认对符合条件的公开服务分组启用统计。先前保存的拒绝选择不会被覆盖。您可在“设置 → 隐私政策”关闭发送并请求删除数据。这是独立设置,不等同于同意发送技术错误报告。

Android APK 2.2.0 也支持按公开名称和支持联系方式统计。先前的同意或拒绝选择会保留;可在隐私政策中管理。供服务商控制台使用的、基于已验证 provider ID 的独立统计尚未接入 Android。

应用每 24 小时最多尝试发送两次,间隔不少于 12 小时。统计服务器不可用不会阻止 DoDo 启动、导入密钥或运行 VPN。详细统计最多保存 30 天。用于识别日历月内重复报告的临时标记会保存到该月结算,最长 31 天;随后删除标记和独立月度密钥。

自 2026 年 11 月 9 日起,服务器记录月度历史:同一安装实例每月计数一次;使用多个服务密钥的安装实例可同时计入多个服务商分组。已结算的汇总报告不会自动删除,不包含安装标识符、IP 地址、密钥或完整配置;小规模分组会隐藏。统计开始前的历史不会补建。撤回同意后会删除个人数据并重新计算未结算月份;无法从已结算的匿名汇总中识别某一具体安装实例。

报告访问权限目前报告仅供 DoDo 所有者在私密管理后台查看。仅显示各服务商自身报告的控制台正在单独准备。名称、支持联系方式和公开 ID 不会授予其他服务的数据、故事或群发权限。

12 / 可用性

各平台功能

可用 — 可在所列版本中使用。有限支持 — 请阅读相应章节的说明。开发中 — 暂未开放普遍接入。

各平台可用性

表中列出 iOS 2.2.0 和 Android APK 2.2.0(2107)的功能。Android 在 Google Play 的更新上线后将另行通知。macOS 商店中仍为 2.0.8 版,与 iOS 共用 App Store 页面。采用 Xray 26.10.31 的原生 Mac 新版本正在单独准备,尚未发布;不可视其功能为已在 Mac App Store 提供。Windows 版本正在准备中。

iOS 2.2.0 和 Android APK 2.2.0(2107)的功能
功能iOS 2.2.0Android APK 2.2.0
URI / Base64 / 完整 Xray JSON可用可用完整保留配置。
DoDo crypt1 与 AGE1iOS 2.2.0 可用配置与限制。可用,但二维码有限制请使用剪贴板或手动输入;部分 HUAWEI 设备上的 crypt1 扫描仍需改进。
fallback-url 备用地址可用须预先从成功响应中保存。可用须提前获取备用地址。
订阅信息与更新间隔可用可用
Routing / autorouting / 地理数据有限支持参阅规则格式。可用,但有限制检查间隔与 iOS 不同。
五种延迟检测模式、日志、二维码与重置可用可用,但二维码有限制TCP 不做除法;参阅延迟检测方法及 crypt1 二维码。
MTU、IPv4 / IPv6 偏好、VPN 资源可用位于高级用户分区。MTU 和 IPv4 / IPv6 可用资源诊断内容与 iOS 不同。
按服务商统计使用情况可用在隐私政策中管理;报告供 DoDo 所有者查看。可用按名称和支持联系方式统计,可设置同意和删除。尚不向控制台发送 Provider ID。
经用户同意发送错误报告可用可关闭发送并删除数据。可用提供相同的同意和删除设置。
服务商故事封闭测试仅限已接入测试的设备。暂不可用
用户关联、定向推送与服务器端 Auto开发中开发中

版本存在差异。iOS 2.2.0 的新功能不会自动出现在 Android 或 macOS 中。分发新格式前,请确认用户的客户端支持;商店链接位于首页。

更多功能

功能状态含义
导入、更新、订阅信息、二维码可用适用于本指南所述格式。二维码扫描需要相机权限。
完整 Xray JSON 与负载均衡器有限支持完整保存配置及关联出站。允许格式和限制详见“订阅格式”章节。
DoDo crypt1 保护链接可用,但有限制App Store 的 iOS 2.2.0 和 Android APK 2.2.0。提供无需注册或加密 API 的本地生成器和 SDK。部分 HUAWEI 设备添加 crypt1 时请使用剪贴板或手动输入,不要使用二维码。文档。
备用订阅:fallback-url可用iOS 2.2.0 和 Android APK 2.2.0。适用于普通 HTTPS 链接、JSON 和 crypt1;须提前获取备用地址。已发布的 Mac 版本暂不可用。备用响应头与配置。
DoDo“自动选择”按钮iOS 暂时隐藏用户手动选择配置。完整 JSON 内的负载均衡器仍正常运行,不依赖此按钮。
Live Activity / Dynamic Island兼容设备可用适用于 iOS 16.1+ iPhone 的 VPN 状态显示。需要支持的型号、实时活动权限,并在 DoDo 中启用相应设置。
外观与设置重置已实现浅色/深色模式及应用设置。完全重置需要确认,会删除订阅和用户设置;重置前请保存您的密钥。
可更新的规则和地理数据有限支持下载的数据会经过验证。发生错误时保留可用版本;后台执行时间由系统决定。
服务商故事封闭测试仅接入测试的设备可以查看。服务商的普遍接入将于之后开放。
控制台注册与 DNS TXT抢先体验使用 Google 登录,免费创建服务,并验证精确域名。完整正式上线即将到来。开始接入。
公开品牌与故事集成准备中需要控制台、通过 DNS TXT 验证的精确主机名、DoDo 批准,以及 HTTPS 订阅响应中的 x-dodo-provider-id。无需模块或签名密钥。这不是私密受众功能;需要兼容客户端,此处不确认新版本已发布。
用户签名验证可选试点使用服务器签名的独立高级协议。公开内容不需要此协议;公开 ID 不能替代其验证。
向自己的用户推送暂不可用面向各服务商的定向群发尚未接入。
通过面板 API 的服务器端 Auto开发中将与本地自动选择和 Xray 负载均衡器不同。不得将秘密 API 令牌放入订阅或用户应用。
Happ crypto / Happ deeplink不支持仅提供上文所述的 JSON 响应兼容机制。
Lite Mode、Premium API 与强制外观不支持服务商无法通过这些字段启用 Lite Mode,或改变应用主题和按钮样式。

从订阅开始。按上述示例配置 HTTPS 响应,将其添加到 DoDo 并测试连接。无需 DoDo 控制台,也无需向我们提供私密 API 令牌。