您的服务订阅
导入、更新、名称、标志和套餐信息。可使用 Remnawave,或支持兼容订阅格式的自建面板。
导入、更新、名称、标志和套餐信息。可使用 Remnawave,或支持兼容订阅格式的自建面板。
通过 Google 注册服务、验证域名,并准备品牌资料和草稿。向用户分发内容需要另行批准并完成集成。
验证订阅归属、定向通知,以及通过您的面板 API 选择服务器。
01 / 订阅
导入订阅只需 HTTPS 链接。无需注册 DoDo 控制台。
服务器链接列表、Base64 和兼容的 Xray JSON。完整 JSON 配置会保留自己的 DNS、路由规则和负载均衡器。
格式与示例在响应头中提供名称、标志、支持链接、续费页面、有效期和流量。DoDo 会将它们显示在订阅卡片中。
HTTP 响应头请求订阅时,iOS 和 Android 会发送 HWID、型号、操作系统及其版本。您的面板可使用这些数据限制设备数量。限制本身由您的服务器检查。
设备信息与限制可以使用自建面板。DoDo 直接从您的服务器读取订阅。无需管理 API 令牌,也无需改用 Remnawave。支持的协议和配置限制列在文档中。
分发 DoDo crypt1 保护链接。iOS 2.2.0 和 Android APK 2.2.0 支持 dodoapp://crypt1/…:生成器加密现有的 HTTPS 订阅地址,应用在设备上解密,无需访问 DoDo API。普通列表、Base64 和完整 JSON 仍可使用,无需修改面板。机器人可使用适用于 Node.js 24+ 的 SDK 和 CLI。也可单独配置 AGE1,对服务器响应体本身进行加密。这些格式无需注册、高级权限或 providerid。保护链接仍是访问凭证,不得公开。Android 请使用剪贴板或手动输入:部分 HUAWEI 设备的 crypt1 二维码识别仍在改进中。已发布的 macOS 版暂不支持这些格式;Windows 正在准备中。
准备备用订阅地址。iOS 2.2.0 和 Android APK 2.2.0 支持 fallback-url:主要来源暂时不可用时,DoDo 会尝试同一用户预先保存的备用地址。此机制适用于普通列表、Base64 和 JSON,也适用于 crypt1。请提供含所需路径和令牌的完整备用 HTTPS 地址,应用不会自行构造镜像。必须在成功访问主要地址时获取备用地址:如果首次添加时主要地址已不可用,就无法从其响应中获取备用地址。无需注册或高级权限;已发布的 macOS 版暂不支持此机制。
02 / 订阅外观
向订阅服务器的响应添加所需响应头。所有字段均为可选;下方示例使用演示值。
profile-title 设置名称,x-dodo-provider-logo-url 设置标志地址。支持链接和续费页面链接会在应用中添加相应按钮。
profile-update-interval 设置更新间隔:1 至 168 的整数小时数。应用在能够执行网络请求时检查订阅是否需要更新;系统不保证后台严格按计划启动。
subscription-userinfo 中的流量以字节为单位,expire 为以秒为单位的 Unix timestamp。
响应头示例
profile-title: Example 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请勿将真实 UUID、密码、HWID、API 令牌或秘密链接放入公开示例或标志 URL。
| 您的设置 | HTTP 响应头 | 应用中的效果 |
|---|---|---|
| 服务名称 | profile-title | 订阅卡片名称。西里尔字母或其他非 ASCII 字符可使用 UTF-8 编码的 base64:…。 |
| 标志 | x-dodo-provider-logo-url | 顶部区域的标志。应为公开 HTTPS 图片,不是商店中的应用图标。 |
| 支持与控制台 | support-urlprofile-web-page-url | 支持按钮和跳转续费页面的按钮。 |
| 有效期与流量 | subscription-userinfo | 状态、到期日期和流量额度。数值由您的服务器设置。 |
| 何时更新订阅 | profile-update-interval | 以小时为单位的更新检查间隔,受操作系统后台执行限制影响。 |
| 备用地址 | fallback-urlproviderid — 可选 | 同一订阅的完整备用 HTTPS 地址。如果指定 providerid,备用响应必须返回相同的值。这不用于验证支付,也不授予 DoDo 控制台访问权限。 |
| 公告 | announce | 订阅卡片中的文本。不会创建故事或发送通知。 |
| 流量规则 | routing / autorouting | 此订阅的路由。规则也可放在完整 Xray JSON 中。 |
响应头须随 HTTPS 订阅链接的成功响应一并返回。值格式、响应体中支持的注释及限制详见响应头参考。
名称和支持联系方式有助于统计服务使用情况。iOS 2.2.0 中,DoDo 根据公开的 profile-title 和经过清理的 support-url 对报告分组。报告包含设备型号、iOS 和应用版本,以及已保存配置数量。不发送密钥地址、配置本身、HWID 或流量内容。统计对象是发送了数据的 DoDo 安装实例,而不是您全部用户或在线用户。
分析统计默认启用,但会遵循之前保存的拒绝选择。您可在应用的“设置 → 隐私政策”关闭发送并请求删除数据。每 24 小时最多尝试发送两次;统计服务器不可用不会阻止导入或 VPN 连接。报告目前仅供 DoDo 开发者访问,服务商独立查看自身报告的权限正在准备中。服务名称和支持联系方式不能证明服务所有权,也不会授予其控制台访问权限。
03 / 服务商控制台
通过 Google 自助创建控制台。注册免费;每个服务商仅能操作自己的服务和材料。
所有者管理服务并邀请编辑者。编辑者准备材料,所有者发布故事。其他服务商无法访问您的设置和材料。
填写名称、标志、支持链接和网站。预览会显示它们在浅色和深色模式下的效果。预览中选择的强调色暂时仅用于预览,iOS 使用系统颜色。
DoDo 本身在商店和设备上的名称及图标不会改变。
添加图片或短视频、标题和说明。可保存为草稿、发布前预览或移入归档。应用内展示目前仅对测试参与者开放。
功能可用性公开品牌和故事无需安装模块。通过 Google 创建控制台,使用 DNS TXT 验证精确的订阅域名,等待 DoDo 批准,并在订阅成功返回的 HTTPS 响应中添加控制台中的 x-dodo-provider-id。无需签名密钥或面板 API 令牌。设置准备完成,不代表服务器已部署、新版应用已发布,或已在 iPhone 上测试。
| 类型 | 格式 | 限制 |
|---|---|---|
| 图片 | JPEG, PNG, WebP | 最多 10 MiB。上传后图片保存为 JPEG。 |
| 视频 | MP4 | 最多 20 MiB,最长 30 秒。文件将在服务器上检查并处理。 |
| 发布 | 标题和简短说明 | 标题最多 80 个字符,说明最多 500 个字符;有效期为 12 或 24 小时。 |
04 / 公开内容
公开内容与服务的精确域名及其 ID 关联。这不用于验证订阅有效或已付费,也不是私密受众。
x-dodo-provider-id 是您控制台中的 UUID。应用仅从订阅同一精确主机名实际成功返回的 HTTPS 响应中接受它,不接受响应体注释、错误响应或重定向。
需要有效的 DNS TXT 验证和 DoDo 批准。公开品牌和故事不需要签名连接器。
外观和发布内容通过 /api/provider-content/v1 单独提供。发布故事需要有效的 DNS 验证及服务授权。展示需要兼容的应用版本。
公开 ID 不能证明用户已付款,不会创建经过验证的私密受众,也不允许定向群发。此处不得放置仅供付费用户查看的材料。
通过 DNS TXT 验证精确域名。控制台会生成唯一记录并进行检查。人工批准历史单独保存,不视为 DNS 验证。对一个主机名的验证不涵盖相邻子域名。公开内容不会改变订阅响应体、HWID 策略或 VPN 功能。
可选的签名协议仍与公开内容分开。DNS 不能替代用户验证。面板必须检查用户和设备,然后针对 x-dodo-subscriber-challenge 在 x-dodo-subscriber-token 中返回动态签名证明。禁止所有用户共用固定字符串;公开 ID 不会放宽这些验证。
定向群发需要独立验证的受众及用户权限;此处不承诺已提供推送交付。请将面板管理令牌、签名私钥和密码仅保存在服务器上,不得放入订阅、应用或公开页面。
高级协议与限制05 / 面板仍由您掌控
服务器和用户管理仍由您掌控。通过 DoDo 连接 VPN 无需面板管理权限。
按受支持的任一格式分发订阅。使用完整 Xray JSON 时,请提供整个配置:DNS、路由、负载均衡器和所有关联设置。
检查格式将 x-dodo-provider-id 添加到现有的成功 HTTPS 响应。公开品牌和故事无需新端点、signer 或完整面板管理 API。Remnawave 或可设置 HTTP 响应头的自建系统均可。
用户验证和设备策略仍由您的服务器负责。公开 ID 不能证明这些检查的结果。
地图按国家、粗略城市分组和运营商网络(ASN),展示过去 24 小时、7 天或 30 天的订阅请求分布。Remnawave 数据源需以只读权限手动接入;自建面板需要单独集成。
地图不显示精确位置或在线用户数。小规模分组会隐藏,原始 IP 和 HWID 不会传入控制台。
应用已内置路由所需的地理数据文件。geosite.dat 和 geoip.dat 可用于按域名和 IP 地址类别设置规则。它们不用于绘制用户分布地图。
06 / 自动选择服务器
请在完整 Xray JSON 配置中提供负载均衡器。iOS 中独立的 DoDo 自动选择按钮暂时隐藏;通过面板 API 进行负载均衡仍在开发中。
| 方式 | 工作方式 | 状态 |
|---|---|---|
| Xray 负载均衡器 | 您在完整 JSON 配置中设置选择规则:标签、observatory 和 balancers。DoDo 使用完整的兼容配置。 | 可用 |
| DoDo 自动选择 | 基于测量结果选择服务器的独立按钮在 iOS 中暂时隐藏。这不会停用完整 JSON 配置内的负载均衡器。 | iOS 暂时隐藏 |
| 通过服务商 API 自动选择 | 面板将可根据服务器负载、优先级及用户可用路由推荐服务器。 | 开发中 |
延迟与速度是不同指标。iOS 2.2.0 和 Android APK 2.2.0 的普通 TCP 显示实测连接时间,不做除法。Android 中仅含一个 TCP 服务器的普通 JSON 同样使用直连检测;Hysteria、负载均衡器和复杂配置则使用 HTTP。HTTP GET 和 HEAD 通过服务器配置检测请求。只有估算模式 DoDo Ping 会将 HTTP GET 结果除以 3.3。即使 VPN 无法工作,服务器仍可能响应 TCP 或 ICMP;HTTP 测量成功也不保证下载速度或所有路由均可用。
07 / 如何开始
先从测试订阅开始。控制台和故事可稍后接入,不影响 VPN 功能。
准备包含服务器列表、Base64 或 Xray JSON 的 HTTPS 链接。测试导入、更新和连接。请勿在公开示例中使用有效密钥。
快速开始在响应头中添加名称、标志、有效期、流量和支持链接。确认订阅卡片显示符合预期。
使用 Google 登录,填写服务名称和支持联系方式。使用控制台提供的 TXT 记录验证精确域名。之后即可准备品牌资料和故事。
打开服务商控制台将控制台中的 x-dodo-provider-id 添加到成功的 HTTPS 订阅响应。通过 DoDo 批准和 DNS 验证后,即可准备公开品牌和故事。无需模块或密钥对;展示需要兼容的应用版本。
接入流程DODO PROVIDER CONSOLE
通过 Docker Compose 安装面板,并使用您自己的 HTTPS 域名访问。在 DoDo 网站使用 Google 登录,确认安装,然后管理服务外观、DNS 和故事。中央 API 会检查每个请求的权限,不会提供其他服务的数据。无需 Remnawave 模块或 VPN 节点访问权限。
0.1.1 的统计按 provider ID 和已验证域名分隔:包含型号、系统和应用版本,以及 1/7/30 天报告。需要兼容的新版 iOS 客户端;旧版及 Android 暂不发送此 scope。统计的是上报设备,不是在线人数或已付费用户数。数据和已发布文件仍保存在 DoDo。VPN 功能不依赖控制台。
08 / 可用性
密钥核心功能无需注册即可使用。免费控制台已开放抢先体验;完整正式上线和定向群发正在分别准备中。
可用 — 可直接使用。测试中 — 受邀访问。开发中 — 暂不可用。不支持 — 不属于 DoDo 当前功能。
| 功能 | 状态 | 重要说明 |
|---|---|---|
| 导入和更新订阅 | 可用 | 无需控制台即可使用。格式和协议详见文档。 |
| DoDo crypt1 保护链接与 AGE1 | iOS 与 Android APK | 已在 App Store 的 iOS 2.2.0 和 Android APK 2.2.0 中提供。crypt1 搭配普通响应时无需修改面板;服务器端 AGE 加密需单独设置。部分 HUAWEI 设备添加保护链接时,需用剪贴板或手动输入代替二维码。如何接入。 |
| 名称、标志、有效期、流量、链接 | 可用 | 通过订阅服务器响应头设置。 |
| 团队、角色、品牌与预览 | 抢先体验 | 注册控制台后可用。预览的强调色暂不应用于 iOS。公开品牌需要 DNS、DoDo 批准和 x-dodo-provider-id,但不需要签名连接器。 |
备用订阅:fallback-url | iOS 与 Android APK | iOS 2.2.0 和 Android APK 2.2.0 支持普通列表、Base64 和 JSON。providerid 可选,且不用于验证支付。已发布的 macOS 版暂不支持此机制。如何准备服务器。 |
| 按名称和支持联系方式进行服务统计 | iOS 与 Android APK | iOS 2.2.0 和 Android APK 2.2.0 根据 profile-title 和 support-url 发送有限统计,并保留用户选择。可在隐私政策中关闭发送。Android 尚未接入用于服务商控制台的 provider ID 统计。统计如何运行。 |
| 故事编辑器与媒体上传 | 测试中 | 草稿、预览、12 或 24 小时发布及归档。 |
| 应用内展示品牌和故事 | 测试中 | 仅在单独接入的 iOS 设备上可用。简单公开方式需要 DNS、批准和 ID 响应头,无需模块。本说明不代表新的正式版本已发布或已完成真实运行测试。 |
| 自动验证用户 | 开发中 | 将需要订阅验证及服务商服务器的签名响应。 |
| 向自己的用户发送通知 | 开发中 | 在验证订阅并获得用户同意后定向发送。 |
| 仅供已验证用户查看的私密故事 | 开发中 | 这是需要订阅验证的独立任务。不属于公开故事,不能仅凭 provider ID 启用。 |
| 国家、城市分组与 ASN 地图 | 测试中 | 数据源需单独接入。地图仅显示汇总统计。 |
| 通过面板 API 自动选择 | 开发中 | 根据服务商提供的负载和可用路由数据选择服务器。 |
| 服务商自助注册 | 抢先体验 | Google 登录、创建自己的控制台,以及 DNS TXT 域名验证。免费,无需套餐或付款。完整正式上线即将到来。 |
| 其他客户端的 Lite Mode 与 Premium API | 不支持 | 不会执行其他客户端用于更改主题、强制设置、管理 HWID 和 premium-url 按钮的命令。 |
| Happ 加密链接与命令 | 不支持 | 可读取兼容的 JSON 订阅;不处理 Happ crypto 和 Happ 深层链接。 |
| 平台 / 版本 | 功能 | 说明 |
|---|---|---|
| iOS · App Store 2.2.0 | 导入和更新、完整 JSON 配置和负载均衡器、crypt1 和 AGE1、备用地址、HWID、延迟检测模式、路由、地理数据文件、日志,以及经用户同意发送的错误报告。 | 适用于 iOS 15 及以上版本。分析统计在隐私政策中管理。控制台和故事正在测试;暂不支持向所有用户定向发送。 |
| Android · APK 2.2.0 (2107) | 完整 JSON 和负载均衡器、crypt1 和 AGE1、备用地址、密钥信息和更新间隔、路由、地理数据文件、TCP 不做除法的延迟检测、MTU 和 IPv4 / IPv6、实时日志及自愿错误报告。 | 11 月 10 日的 APK。Google Play 更新上线后将另行通知。部分 HUAWEI 设备添加 crypt1 时,请使用剪贴板或手动输入代替二维码。Android 暂未启用故事和服务商通知。 |
| macOS · Mac App Store 2.0.8 | 应用位于与 iOS 共用的 App Store 页面。 | Mac 目前仍提供之前的 2.0.8 版本。 |
| Windows · 即将推出 | Windows 版本正在准备中。 | 安装程序链接将在发布后提供。 |
下一次 iOS 更新将提供本地 SOCKS 保护。更改尚未在 App Store 发布。内部连接的服务凭据会为每个会话单独生成,不会沿用到其他服务商。完整配置中可用的本地凭据会保留。远程 SOCKS 服务器授权不变,无需重新配置节点。兼容性取决于配置参数,不会为了连接而关闭安全要求。
保护机制与新诊断详情错误报告经用户同意后发送。报告发送给 DoDo 开发者,而不是服务商控制台。服务商无法访问全局诊断或其他服务的信息。报告有助于排查应用故障,但并非所有系统崩溃或卡死都会自动记录。订阅请求中的 HWID 请求头会另行发送到您的服务器。
报告包含哪些数据立即开始
文档介绍受支持的格式、响应头示例、导入链接和路由规则。