DODO APP / مستندات فنی

سرویس خود را به DoDo متصل کنید.

ارائه اشتراک را تنظیم کنید، نام سرویس و پیوندهای مفید برای کاربران را اضافه کنید. یک پاسخ HTTPS سازگار کافی است — نیازی به دادن دسترسی به API پنل خود ندارید.

اشتراک‌های HTTPS Remnawave یا پنل اختصاصی وضعیت به تفکیک پلتفرم

Android 2.2.0 به‌صورت APK، ساخت 2107 مورخ 10 نوامبر در دسترس است. دانلود APK. این نسخه خارج از Google Play توزیع می‌شود؛ انتشار به‌روزرسانی در فروشگاه جداگانه اعلام خواهد شد. اگر DoDo را از Google Play نصب کرده‌اید، آن را از طریق فروشگاه به‌روزرسانی کنید: امضاها ممکن است متفاوت باشند. برای نصب APK، برنامه یا داده‌ها را حذف نکنید.

iOS 2.2.0 در 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 انتخاب می‌کند، ارائه Xray JSON کامل را برای DoDoApp در iOS و پیشوند DoDoApp/ در Android تنظیم کنید.
  3. نام سرویس، فاصله به‌روزرسانی و دیگر داده‌های اشتراک را به سرآیندهای HTTP پاسخ اضافه کنید.
  4. کاربر پیوند را از طریق «+» اضافه می‌کند: از کلیپ‌بورد، به‌صورت دستی یا با کد QR. برای ربات یا وب‌سایت از 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 را مشخص کنید و به‌جای فهرست URI، JSON ارسال کنید.

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. دامنه را تأیید کنید

در بخش «دامنه‌ها و دسترسی»، host دقیق مانند 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 با سرویس همچنان شرط جداگانه و الزامی است. پس از این مراحل، شناسه ارائه‌دهنده را از پنل خود بردارید و به پاسخ موفق واقعی HTTPS ارائه اشتراک روی همان host دقیق اضافه کنید:

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

این یک سرآیند واقعی HTTP پاسخ است، نه توضیح در بدنه و نه فیلد JSON. خطا، صفحه جایگزین HTML، تغییرمسیر یا پاسخ host دیگر مناسب نیست. این UUID را با providerid کوتاه برای نشانی پشتیبان اشتباه نگیرید.

4. برند عمومی و استوری‌ها را تنظیم کنید

ظاهر سرویس و مطالب را در پنل خود تنظیم کنید. برای برند عمومی و استوری‌ها نیازی به نصب ماژول، ساخت signer یا جفت کلید، ارائه توکن API پنل یا تغییر Xray، نودهای VPN و بدنه اشتراک نیست. انتشار استوری همچنان به تأیید معتبر DNS و اجازه DoDo نیاز دارد.

محتوای عمومی در /api/provider-content/v1 جدا شده است. این محتوا اشتراک معتبر یا پرداخت‌شده را تأیید نمی‌کند، گروه مخاطبان خصوصی ایجاد نمی‌کند و اعلان push هدفمند را فعال نمی‌کند. مطالب مختص مشترکان پولی را اینجا منتشر نکنید. خطای محتوا نباید وارد کردن، به‌روزرسانی اشتراک یا VPN را مسدود کند.

پیشرفته: تأیید امضاشده یک مشترک مشخص

این پروتکلی جداگانه و اختیاری است، نه شرطی برای برند عمومی و استوری‌ها. بررسی‌های سخت‌گیرانه آن حفظ می‌شوند؛ شناسه عمومی جای امضای سرور را نمی‌گیرد.

Google حساب مالک، DNS کنترل دامنه و پاسخ امضاشده سرور شما حق دریافت محتوای سرویس توسط یک مشترک مشخص را تأیید می‌کنند. این‌ها بررسی‌های متفاوتی هستند. صرف تطابق profile-title، support-url یا شناسه عمومی دسترسی به مطالب یا گزارش‌های دیگران نمی‌دهد.

  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سرور ارائه‌دهنده → DoDoUUID ثابت پنل. فقط برای شناسایی سرویس، نه مجوزدهی.
x-dodo-subscriber-challengeبرنامه → سرور ارائه‌دهندهدرخواست تأیید یک‌بارمصرف مرتبط با یک نصب مشخص.
x-dodo-subscriber-tokenسرور ارائه‌دهنده → برنامهپاسخ پویای امضاشده به این درخواست. نمی‌توان آن را با رشته‌ای مشترک برای همه جایگزین کرد.

endpoint جداگانه و API مدیریتی کامل Remnawave الزامی نیست: می‌توانید بررسی را به پردازشگر موجود ارائه کلید اضافه کنید. همین اصل برای پنل اختصاصی نیز صدق می‌کند. نیازی به تغییر Xray و نودهای VPN نیست. پاسخ‌های دارای توکن باید کش عمومی CDN را دور بزنند و از Cache-Control: private, no-store استفاده کنند؛ کلیدها، HWID، challenge یا توکن‌ها را در گزارش‌های باز ثبت نکنید.

خطای بررسی محتوا نباید ارائه عادی کلید، وارد کردن یا VPN را مختل کند. چند سرویس روی یک دستگاه مستقل به هم متصل می‌شوند؛ حذف کلید یا لغو مجوز، نمایش محتوای مرتبط را متوقف می‌کند. این پروتکل جدا از محتوای عمومی در فضای /api/provider-binding/v1 باقی می‌ماند.

این راهنما به معنای راه‌اندازی آماده عملیاتی نیست. آماده‌سازی پنل و DNS، استقرار سرور، انتشار ساخت جدید در App Store یا آزمایش روی iPhone را تأیید نمی‌کند. نمایش به نسخه سازگار برنامه نیاز دارد. ارسال انبوه push هدفمند جزو روش ساده اتصال نیست.

DODO PROVIDER CONSOLE

پنل روی سرور خودتان

دسترسی زودهنگام · 0.1.1

پنل جداگانه را روی سرور Linux نصب کنید و آن را در دامنه HTTPS خود باز کنید. ظاهر، دامنه‌ها و استوری‌ها از طریق API DoDo مدیریت می‌شوند. پنل مدیریت اصلی، سرویس‌های دیگران، عیب‌یابی عمومی و کلیدهای ارسال push در بسته نیستند. داده‌ها و فایل‌های منتشرشده در سمت DoDo ذخیره می‌شوند.

  1. بایگانی را استخراج کنید، SHA256SUMS را بررسی و در .env نشانی دقیق پنل را تنظیم کنید.
  2. Docker Compose را اجرا و پراکسی HTTPS به 127.0.0.1:8795 را تنظیم کنید. کانتینر بدون 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 لازم است؛ تا پیش از انتشار آن، برنامه‌های قدیمی این داده‌ها را ارسال نمی‌کنند. گزارش‌های قدیمی براساس تطابق نام یا پشتیبانی در اختیار ارائه‌دهندگان قرار نمی‌گیرند. این شمارنده آنلاین یا پایگاه مشترکان پولی نیست. push هدفمند و پرداخت‌ها هنوز متصل نشده‌اند.

اگر 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 است و به‌خودی‌خود محافظت اضافه محسوب نمی‌شود.
WireGuard معمولیwg://, wireguard://با محدودیت URI دارای پارامتر یا پروفایل Base64 از نوع wg-quick درون URI. فایل‌های دارای مجموعه دلخواه peers و پارامترهای AmneziaWG پشتیبانی نمی‌شوند.
AmneziaWG, TUIC, SSR, Hysteria v1طرح‌ها و افزونه‌های اختصاصی آن‌هادر iOS پشتیبانی نمی‌شوند پروفایل AmneziaWG به WireGuard معمولی تبدیل نمی‌شود.

در Xray JSON کامل، خروجی‌های کمکی HTTP، SOCKS و WireGuard مجازند. برای وارد کردن جداگانه، فقط از URIهای جدول استفاده کنید.

ویژگی‌های Android APK 2.2.0. AmneziaWG در Android حفظ شده و در 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 / verifyPeerCertByNamepin نامعتبر، الزام ECH پشتیبانی‌نشده یا دور زدن بررسی گواهی باعث رد وارد کردن آن URI می‌شود، نه تضعیف بررسی TLS.

Hysteria2 از QUIC بدون type=quic استفاده می‌کند. آن را از طریق hy2:// یا hysteria2:// ارسال کنید. مقادیر ترنسپورت URI شامل quic، h2 و http در iOS پشتیبانی نمی‌شوند.

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

پروفایل خراب یا پشتیبانی‌نشده به‌طور کامل رد می‌شود. در صورت شکست به‌روزرسانی، سرورهای قبلی باقی می‌مانند. برای سرورهای مطابق، شناسه، ترتیب، سنجاق‌شدن، سرور انتخاب‌شده و آخرین مقادیر پینگ حفظ می‌شوند.

سازگاری موقت با ارائه JSON در Happ

سازگاری موقت ابتدا DoDo درخواست معمولی می‌فرستد. اگر سرور JSON کامل و قابل‌استفاده برگرداند، درخواست اضافه‌ای انجام نمی‌شود. در غیر این صورت، برنامه ممکن است درخواست همان URL را با User-Agent: Happ/DoDoApp-compat و X-DoDo-Client که کلاینت واقعی DoDo را مشخص می‌کند تکرار کند. پاسخ‌ها در یک فهرست ادغام نمی‌شوند.

برای ارائه JSON کامل، قاعده DoDo را براساس User-Agent تنظیم کنید یا پیوند صریح دارای /json بدهید. برنامه این مسیر را به پیوندهای دلخواه اضافه نمی‌کند. اگر درخواست سازگاری ناموفق باشد، پاسخ اصلی قابل‌استفاده حفظ می‌شود؛ پروفایل کامل ذخیره‌شده با فهرست ناقص URI جایگزین نمی‌شود.

پشتیبانی نمی‌شود happ://crypto…، happ://crypt…، قالب‌های رمزنگاری‌شده بسته Happ و باز کردن deeplinkهای Happ. قالب اختصاصی DoDo crypt1 و AGE1 با گیرنده DoDo در iOS 2.2.0 و Android APK 2.2.0 موجود است. DoDo فایل‌های AGE رمزنگاری‌شده فقط برای Happ یا گیرنده دیگر را رمزگشایی نمی‌کند.

محدودیت دریافت در iOS 2.2.0: حداکثر 8 000 000 بایت برای هر پاسخ، 12 000 000 بایت مجموع هر عملیات و 2 000 000 بایت برای هر پروفایل JSON. برای AGE1 حد جداگانه بدنه رمزنگاری‌شده 2 MiB است. در Android 2.2.0 محدودیت پاسخ و عملیات به‌ترتیب 2 / 4 MiB است. مهلت کلی 25 ثانیه و تعداد تلاش‌ها محدود است. بررسی TLS هنگام خطا غیرفعال نمی‌شود. پاسخ نیمه‌دریافت‌شده همراه با خطای شبکه وارد نمی‌شود.

04.1 / پیوندهای محافظت‌شده

DoDo crypt1: اشتراک را بدون URL آشکار ارائه کنید

پیاده‌سازی شده

در iOS 2.2.0 از App Store و Android APK 2.2.0 (2107) در دسترس است. در Android پیوند محافظت‌شده را از کلیپ‌بورد یا دستی اضافه کنید. در برخی دستگاه‌های HUAWEI ممکن است کدهای QR دارای crypt1 فعلاً شناسایی نشوند؛ اصلاح اسکن در دست آماده‌سازی است. پشتیبانی Windows برنامه‌ریزی شده است. انتقال به نسخه جدید Mac هنوز در Mac App Store منتشر نشده است.

crypt1 پیوند HTTPS موجود کاربر را رمزنگاری کرده و پیوندی به‌شکل dodoapp://crypt1/<JWE> می‌سازد. پس از باز کردن، DoDo تأیید افزودن را می‌خواهد و فقط پس از آن به سرور اشتراک درخواست می‌دهد. منبع معمول شما می‌تواند در داخل باقی بماند: فهرست URI، Base64، یک Xray JSON کامل یا آرایه پروفایل‌ها. DNS، مسیریابی و توزیع‌کننده‌های بار با همان تجزیه‌کننده خوانده می‌شوند.

برای crypt1 معمولی با response: "auto" نیازی به تغییر پنل یا محتوای اشتراک نیست. پیوند به‌صورت محلی رمزنگاری می‌شود — بدون API رمزنگاری، ثبت‌نام در DoDo، دسترسی ویژه یا providerid اجباری. Remnawave و پنل‌های اختصاصی به یک اندازه مناسب‌اند. این قالب اختصاصی DoDo است، نه روشی برای باز کردن پیوندهای رمزنگاری‌شده بسته Happ یا INCY.

مولد در مرورگر با WebCrypto کار می‌کند. URL واردشده به سرور ارسال نمی‌شود؛ برای پیوندها از کوکی یا فضای ذخیره‌سازی مرورگر استفاده نمی‌شود. برای ارائه خودکار، از Node.js 24+ و همان SDK موجود در بایگانی استفاده کنید. فهرست عمومی کلیدها فقط شامل کلیدهای عمومی RSA و گیرندگان AGE است.

شروع سریع بدون تغییر پنل

  1. نشانی HTTPS موجود اشتراک یک کاربر مشخص را بردارید.
  2. مولد را باز کنید، نشانی را جای‌گذاری کنید و گزینه «خودکار» را نگه دارید. نام اختیاری است.
  3. پیوند crypt1 ساخته‌شده را در پیام خصوصی یا دکمه ربات به همان کاربر بدهید. یک اشتراک شخصی را به همه مشترکان ارائه نکنید.
  4. در iOS 2.2.0 پیوند را باز کنید یا از طریق «+» از کلیپ‌بورد، دستی یا با کد QR اضافه کنید. در Android APK 2.2.0 از کلیپ‌بورد یا ورود دستی استفاده کنید؛ محدودیت شناخته‌شده QR در HUAWEI در بالا توضیح داده شده است. افزودن را تأیید و به‌روزرسانی و VPN را بررسی کنید.

در «اشتراک‌گذاری کد QR» و کپی، DoDo از پیوند اصلی crypt1 استفاده می‌کند، نه URL آشکارشده. پیوند بسیار طولانی ممکن است در کد QR جا نشود — در این صورت آن را به‌صورت متن بفرستید. رمزنگاری دوباره همان 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 می‌خواند و فقط پیوند محافظت‌شده را خروجی می‌دهد. توکن واقعی را در آرگومان فرمان، تاریخچه ترمینال یا گزارش ربات قرار ندهید. خروجی 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 به‌روز کنید، نه در هر درخواست کاربر.

فیلدهای payload برای createCrypt1Link
فیلدالزامیچه چیزی ارسال شود
vبلهعدد 1.
typeبلهرشته subscription-url.
urlبلهنشانی کامل HTTPS کاربر، حداکثر 4096 بایت UTF-8. بدون نام کاربری/گذرواژه، fragment، فاصله، IP صریح و نشانی محلی.
responseبلهauto برای پاسخ معمولی یا AGE1؛ age1-required فقط برای منبع AGE1 ازپیش‌تنظیم‌شده.
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 خالی.
AES-GCMCEK تصادفی جدید 32 بایتی، IV با 12 بایت و tag با 16 بایت. AAD برابر ASCII اولین بخش کدگذاری‌شده JWE است.
سرآیندفقط موارد الزامی 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 را جداگانه برای گیرنده X25519 منتشرشده DoDo رمزنگاری کند.

age1-required رمزنگاری سرور را فعال نمی‌کند. این پارامتر از برنامه می‌خواهد پاسخ رمزنگاری‌نشده، از جمله پاسخ نشانی پشتیبان، را رد کند. ابتدا AGE1 را روی سرور تنظیم و بررسی کنید، سپس پیوند را با این سیاست ارائه دهید. با auto پاسخ معمولی پشتیبانی‌شده یا AGE1 پذیرفته می‌شود؛ AGE خراب شناسایی‌شده دوباره به‌عنوان متن آشکار تجزیه نمی‌شود.

برنامه سرآیندی برای فعال کردن AGE روی سرور شما نمی‌فرستد: درخواست همچنان دارای Accept: */* معمولی، User-Agent و داده‌های دستگاه است. مقدار response در crypt1 نیز فرمانی برای سرور نیست. روش مطمئن، نشانی HTTPS جداگانه‌ای است که همیشه AGE1 می‌دهد؛ برای دیگر کلاینت‌ها پیوند قبلی را نگه دارید. اگر از قواعد User-Agent استفاده می‌کنید، توجه کنید که خود مقدار DoDoApp شماره ساخت کاربر را مشخص نمی‌کند.

برای نمونه زیر CLI رسمی age با X25519 و 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 اختیاری است؛ اگر همراه پشتیبان ذخیره شده باشد، پشتیبان باید همان شناسه را برگرداند. پشتیبان مستقل از رمزنگاری پیوند، طبق قواعد عمومی fallback کار می‌کند. با age1-required، هر دو نشانی اصلی و پشتیبان باید AGE1 ارائه کنند.

پیش از ارائه به کاربران

  1. مطمئن شوید iOS 2.2.0 یا جدیدتر نصب است. یک اشتراک آزمایشی اضافه کنید و بررسی کنید درخواست فقط پس از تأیید آغاز شود.
  2. تعداد پروفایل‌ها را با JSON اصلی مقایسه کنید؛ پروفایل کامل دارای توزیع‌کننده بار، به‌روزرسانی، انتخاب سرور و اتصال را بررسی کنید.
  3. برای AGE نشانی‌های اصلی و پشتیبان را بررسی کنید. گیرنده اشتباه، بدنه خراب و پاسخ آشکار با age1-required باید به خطا منجر شوند، نه وارد کردن بخشی از سرورها.
  4. کپی/QR، افزودن دوباره و به‌روزرسانی را بررسی کنید: پیوند اصلی crypt1، ترتیب اشتراک‌ها و تنظیمات باید حفظ شوند. توکن‌های واقعی را در تصاویر صفحه منتشر نکنید.
اگر پیوند یا پاسخ پذیرفته نمی‌شود
علتچه چیزی بررسی شود
کلید یا قالب ناشناختهنسخه و شماره ساخت برنامه، فهرست عمومی به‌روز و طرح اختصاصی dodoapp://crypt1/. کلیدهای Happ و پیوندهای رمزنگاری آن مناسب نیستند.
باز کردن اشتراک محافظت‌شده ممکن نشدکامل بودن پیوند، پنج بخش JWE، فیلدهای پشتیبانی‌شده و نبود کدگذاری مجدد URL/Base64 را بررسی کنید. سرورهای قبلی حذف نمی‌شوند.
پاسخ AGE لازم استسرور با age1-required داده آشکار برگردانده است. ارائه پاسخ در سرور را تغییر دهید، نه اینکه بررسی‌های برنامه را غیرفعال کنید.
رمزگشایی AGE ممکن نشدگیرنده DoDo، قالب باینری یا ASCII armor، نبود پوشش و انتقال کامل فایل را بررسی کنید. برای استخراج URIهای جداگانه از بدنه خراب تلاش نکنید.
HTTP، TLS، HWID یا مدت اشتراکمحدودیت‌های معمول سرور حفظ می‌شوند. crypt1/AGE رد دسترسی، محدودیت دستگاه یا خطای گواهی را دور نمی‌زنند.

پیوند محافظت‌شده همچنان دسترسی به اشتراک می‌دهد. این DRM یا تأیید هویت ارائه‌دهنده نیست. کلید رمزگشایی در برنامه تعبیه شده و با بررسی برنامه قابل استخراج است. پیوندهای اصلی و crypt1 را امن نگه دارید، به گزارش عمومی نفرستید و از HTTPS، احراز هویت و محدودیت‌های پنل خود استفاده کنید. توکن API مدیریتی یا گذرواژه سرور را در payload قرار ندهید.

05 / فراداده

سرآیندهای HTTP پاسخ

پیاده‌سازی شده

این فیلدها را در سرآیندهای پاسخ HTTP 200 نشانی اشتراک ارسال کنید. بزرگی و کوچکی حروف نام‌ها مهم نیست. برای فراداده معمولی، DoDo ابتدا سرآیندهای HTTP و سپس فیلدهای پشتیبانی‌شده در توضیحات بدنه، Base64 رمزگشایی‌شده و فراداده JSON را می‌خواند. اولین مقدار معتبر استفاده می‌شود. x-dodo-provider-id استثناست: فقط پاسخ موفق واقعی HTTPS از همان host دقیق.

سرآیندهای اشتراک؛ دسترسی به قابلیت‌ها به نسخه برنامه وابسته است
سرآیندچه چیزی ارسال شودکاربر چه می‌بیندویژگی‌ها
profile-titleنام به‌صورت متن یا base64:… UTF-8.نام کارت اشتراک / سرویس.اگر فیلد وجود نداشته باشد، ابتدا subscription-name و سپس filename / filename* در Content-Disposition استفاده می‌شوند.
x-dodo-provider-idUUID ارائه‌دهنده از پنل خود.ارتباط با برند عمومی و استوری‌ها در نسخه سازگار برنامه؛ وجود این قابلیت در نسخه‌های منتشرشده در اینجا ادعا نمی‌شود.host دقیق تأییدشده با DNS و موافقت DoDo لازم است. پرداخت را تأیید نمی‌کند، دسترسی به گروه مخاطبان خصوصی نمی‌دهد و push را فعال نمی‌کند. ماژول امضا لازم نیست.
x-dodo-provider-logo-urlURL عمومی HTTPS تصویر.نشان سرویس در بخش بالایی.گذرواژه یا پیوند محرمانه اشتراک را در نشانی تصویر قرار ندهید. آیکون برنامه روی دستگاه تغییر نمی‌کند.
support-urlنشانی پشتیبانی، مثلاً پیوند HTTPS به Telegram.دکمه «پشتیبانی» در کارت.بدون مقدار، دکمه خودکار ساخته نمی‌شود.
profile-web-page-urlپیوند عمومی پنل، ربات یا صفحه اشتراک.دکمه رفتن به سایت / «خرید / تمدید».نام جایگزین: homepage. پرداخت در صفحه شما انجام می‌شود، نه در DoDo.
subscription-userinfoupload=…; download=…; total=…; expire=….مدت اعتبار، وضعیت و ترافیک مصرف‌شده / موجود.حجم‌ها را برحسب بایت و expire را به‌صورت Unix timestamp برحسب ثانیه ارسال کنید. HTTP 403 به‌تنهایی تاریخ پایان را تعیین نمی‌کند.
profile-update-intervalتعداد صحیح ساعت از 1 تا 168. نه دقیقه و نه ثانیه.به‌روزرسانی خودکار وقتی زمان آن برسد و برنامه فرصت اجرا دریافت کند.پیش‌فرض — 1 ساعت. در پس‌زمینه، زمان اجرا را سیستم‌عامل تعیین می‌کند.
routingJSON ثابت / Base64 / پیوند مسیریابی DoDo.قواعد Direct / Proxy / Block برای این اشتراک.برای به‌روزرسانی قواعد از شبکه از autorouting استفاده کنید. قواعد جدید در اتصال بعدی اعمال می‌شوند.
autoroutingURL از نوع HTTPS برای منبع جداگانه قواعد.قواعد به‌روز اشتراک خود.قالب، محدودیت‌ها و فاصله بررسی در بخش «مسیریابی» توضیح داده شده‌اند.
announceمتن یا base64:… پشتیبانی‌شده.بخش اطلاعیه درون کارت.اطلاعیه به‌صورت اعلان push ارسال و به‌شکل استوری منتشر نمی‌شود.

اگر اشتراک یک فایل متنی ثابت است

برای فیلدهای پشتیبانی‌شده، خطوط توضیح در ابتدای بدنه مجازند. برای مثال:

#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 روی همان host دقیق پذیرفته می‌شوند، نه از توضیحات بدنه. خود شناسه دسترسی به محتوای بسته را تأیید نمی‌کند؛ برند عمومی و استوری‌ها بررسی پرداخت نیستند.

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 شما، مثلاً demo-vpn.ارائه‌دهنده شناسه را خودش انتخاب می‌کند. این مجوز Happ، شناسه پنل DoDo، HWID یا بررسی پرداخت نیست. اگر پاسخ اصلی آن را همراه پشتیبان ارسال کرده باشد، پشتیبان باید دقیقاً همان مقدار را برگرداند.

نام سرآیند به بزرگی و کوچکی حروف حساس نیست. مقدار providerid حساس است: Demo-VPN و demo-vpn متفاوت‌اند. 1 تا 128 نویسه ASCII مجاز است: ابتدا حرف یا رقم و سپس حرف، رقم، نقطه، خط تیره، زیرخط و دونقطه. از توکن محرمانه API استفاده نکنید. اگر سرویس شما از قبل شناسه خود را ارسال می‌کند، نیازی به تغییر آن برای DoDo نیست.

اگر از قبل fallback-url و providerid را برای کاربران Happ یا INCY ارائه می‌کنید، DoDo آن‌ها را در قالب توضیح‌داده‌شده اینجا می‌خواند. پیوند عادی HTTPS اشتراک برای کاربر کافی است؛ شناسه جداگانه DoDo لازم نیست. این کار پشتیبانی از 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 دریافت‌شده از منبع اصلی. اگر شناسه ذخیره شده باشد و پشتیبان شناسه دیگری برگرداند یا اصلاً برنگرداند، به‌روزرسانی رد می‌شود و سرورهای قبلی می‌مانند. تطابق شناسه به‌تنهایی مالکیت سرویس یا تعلق مشترک را تأیید نمی‌کند.

نحوه تنظیم در 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 با پشتیبان دور زده نمی‌شوند. از یک نشانی پشتیبان استفاده می‌شود، بدون زنجیره آینه‌ها یا حدس مسیرها.

دریافت موفق همان کارت را به‌روز می‌کند: پیوند اصلی، شناسه و ترتیب اشتراک‌ها حفظ می‌شوند. اگر هر دو نشانی پاسخ ندهند یا پشتیبان پروفایل غیرقابل‌استفاده برگرداند، برنامه سرورها و تنظیمات قبلی اشتراک را حذف نمی‌کند.

ابتدا باید نشانی پشتیبان دریافت شود. 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": []
}

پیوند مسیریابی محلی

JSON را با UTF-8 ذخیره کنید، به Base64 یا Base64URL کدگذاری کنید و نتیجه را پس از /add/ یا /onadd/ قرار دهید. برای پیوند، Base64URL بدون = پایانی مناسب‌تر است. Base64 معمولی را می‌توان یک‌بار با percent-encoding کدگذاری کرد.

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

هر دو فرمان پروفایل را ذخیره و فعال می‌کنند. off قواعد را بدون حذف غیرفعال می‌کند. نام کاربری، گذرواژه، پورت، query یا fragment به پیوند اضافه نکنید. قواعد در اتصال بعدی اعمال می‌شوند؛ VPN فعلی خودکار دوباره متصل نمی‌شود.

autorouting: JSON جداگانه از HTTPS

در autorouting پیوند عمومی HTTPS فایل قواعد را ارسال کنید، مثلاً https://example.invalid/routing.json. نشانی را با دامنه خود جایگزین کنید: .invalid و نشانی‌های محلی پذیرفته نمی‌شوند.

  • پاسخ — HTTP 200 با شیء JSON در UTF-8. Base64، پیوند مسیریابی و Xray JSON کامل اینجا پذیرفته نمی‌شوند.
  • فقط فیلدهای نمونه بالا و LastUpdated رشته‌ای مجازند؛ نام‌های مستعار camelCase آن‌ها پشتیبانی می‌شوند. فیلدهای ناشناخته و نام‌های مستعار متعارض رد می‌شوند.
  • فهرست‌ها آرایه رشته‌ها هستند: دامنه‌ها، domain:، full:، regexp: قابل‌بررسی، geosite:؛ برای IP — IP/CIDR و geoip:. وجود دسته براساس فایل‌های جغرافیایی موجود بررسی می‌شود.
  • برای قالب راه‌دور، DomainStrategy: AsIs، IPIfNonMatch یا IPOnDemand. GlobalProxy — مقدار boolean در JSON یا رشته "true" / "false".
  • محدودیت‌ها: 256 KiB برای هر فایل، مجموعاً تا 2048 ورودی و تا 512 بایت برای هر ورودی. در iOS هر درخواست تا 12 ثانیه زمان دارد.
  • از HTTPS روی پورت استاندارد، بدون نام کاربری، گذرواژه و fragment استفاده کنید. تغییرمسیر فقط در همان origin و به تعداد محدود مجاز است. HWID، کوکی‌ها و توکن‌های API اشتراک در این درخواست ارسال نمی‌شوند.
  • قواعد هر اشتراک جداگانه ذخیره می‌شوند. در صورت خطای شبکه یا JSON نامعتبر، آخرین نسخه سالم باقی می‌ماند.
  • در iOS منبع موفق حداکثر یک‌بار در ساعت بررسی می‌شود؛ پس از خطا، بررسی با وقفه تکرار می‌شود. کار در پس‌زمینه به سیستم وابسته است. قواعد جدید در اتصال بعدی استفاده می‌شوند.

درون بدنه اشتراک، dodo://autorouting/add/… و dodo://autorouting/onadd/… با منبع HTTPS نیز شناسایی می‌شوند. آن‌ها را به‌عنوان پیوند باز کردن برنامه از ربات یا مرورگر استفاده نکنید.

تنظیمات اضافی. DNS / FakeDNS، Geoipurl / Geositeurl خارجی و routeOrder در این قالب پشتیبانی نمی‌شوند. برای مسیریابی پیچیده و توزیع‌کننده‌های بار از Xray JSON کامل سازگار استفاده کنید.

در Android 2.2.0 فاصله بررسی autorouting برابر 24 ساعت و مهلت درخواست 8 ثانیه است. قواعد برای هر اشتراک جداگانه ذخیره می‌شوند؛ درخواست شامل HWID، کوکی و توکن 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 نسخه فایل‌ها و بررسی دستی در «تنظیمات → کاربران پیشرفته → داده‌های جغرافیایی» موجود است. برنامه هنگام دریافت فرصت اجرا و دسترس‌پذیری منبع، به‌روزرسانی‌ها را خودکار نیز بررسی می‌کند.

از دسته‌های geosite: / geoip: موجود در مجموعه Loyalsoldier استفاده کنید. دسته‌های مجموعه‌های دیگر ممکن است موجود نباشند. دریافت فایل‌های جغرافیایی دلخواه از پیوندهای ارائه‌دهنده پشتیبانی نمی‌شود.

در Android، VPN فعال تا زمان قطع، از نسخه انتخاب‌شده فایل‌ها استفاده می‌کند. فایل‌های به‌روز در اتصال بعدی اعمال می‌شوند؛ بازگشت به نسخه سالم در نظر گرفته شده است.

10 / بررسی سرور

سنجش تأخیر

در iOS روش در «تنظیمات → کاربران پیشرفته → پینگ» انتخاب می‌شود. پیش‌فرض TCP است. URL آزمون HTTPS اختصاصی و مهلت 1 تا 10 ثانیه قابل تنظیم‌اند.

روشچه چیزی بررسی می‌شودمعنای عدد
TCPبرقراری اتصال با سرور. برای Hysteria از بررسی HTTP جداگانه از طریق پروفایل استفاده می‌شود، چون پروتکل بر بستر UDP کار می‌کند.زمان اندازه‌گیری‌شده اصلی، بدون تقسیم بر 3.3. باز بودن پورت TCP به‌تنهایی احراز هویت و دسترسی اینترنت را تأیید نمی‌کند.
DoDo PingHTTP GET از طریق پروفایل Xray پشتیبانی‌شده سرور؛ برای برخی پروتکل‌ها بررسی اختصاصی استفاده می‌شود.مقدار تخمینی: نتیجه اندازه‌گیری بر 3.3 تقسیم می‌شود.
HTTP GET / HTTP HEADدرخواست روش مربوطه از طریق پروفایل به URL آزمایشی HTTPS.زمان اندازه‌گیری درخواست بدون تقسیم بر 3.3. سرعت انتقال داده اندازه‌گیری نمی‌شود.
ICMPدرخواست ICMP به سرور.زمان پاسخ. سرور ممکن است ICMP را مسدود کند و در عین حال اتصال‌های VPN را درست ارائه دهد.

اندازه‌گیری‌های اصلی بدون تبدیل ذخیره می‌شوند. هنگام تغییر روش بررسی، iOS سنجش مناسب را اجرا می‌کند و نتیجه روش دیگر را به‌جای نتیجه جدید نشان نمی‌دهد. هنگام به‌روزرسانی کلید، آخرین مقادیر برای سرورهای مطابق حفظ می‌شوند. N/A یعنی بررسی ناموفق بوده یا برای این پروفایل موجود نیست؛ سه‌نقطه یعنی هنوز برای روش انتخاب‌شده نتیجه‌ای وجود ندارد.

تعداد بررسی‌های هم‌زمان محدود است. سنجش VPN فعلی را دوباره متصل نمی‌کند. اگر JSON توزیع‌کننده بار داشته باشد، بررسی از طریق کل پروفایل و با قواعد انتخاب سرور آن انجام می‌شود.

در Android APK 2.2.0 (2107) همان پنج روش موجود است. TCP معمولی زمان اتصال اندازه‌گیری‌شده را بدون تقسیم نشان می‌دهد: این موضوع برای پروفایل JSON بدون ابهام با یک سرور TCP نیز صدق می‌کند. برای 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 از پروفایلهماهنگ‌سازی تونل سیستم با DNS در Xray، زمانی که تطبیق امن پیکربندی ممکن باشد.برای حفظ قواعد DNS ارائه‌دهنده. ساختارهای مبهم، FakeDNS و وابستگی‌های DNS سیستم به‌اجبار بازنویسی نمی‌شوند؛ تبدیل عمومی هر پروفایل DNS ادعا نمی‌شود.
منابع VPNصفحه جداگانه حافظه افزونه، Go heap، اتصال‌ها و توصیفگرهای فایل.برای عیب‌یابی. گزارش‌های عیب‌یابی فعال و نشست تازه VPN لازم است؛ اگر داده‌ای نباشد، برنامه به‌جای شاخص‌های صفر این موضوع را اعلام می‌کند.

پروفایل‌های کامل سازگار، DNS، مسیرها، توزیع‌کننده‌های بار و پارامترهای ترنسپورت خود را حفظ می‌کنند. انتخاب IP و MTU کلید ذخیره‌شده را تغییر نمی‌دهد. محدودیت دستی حافظه، No Limit Mode و ویرایشگر جداگانه همه پارامترهای Xray به برنامه اضافه نشده‌اند.

در Android APK 2.2.0 نیز MTU از 1280 تا 1500 بایت و ترجیح IPv4 / IPv6 موجود است. تنظیمات برای اتصال جدید اعمال می‌شوند؛ پروفایل کامل ذخیره‌شده و DNS ارائه‌دهنده بازنویسی نمی‌شوند. صفحه منابع VPN و ویژگی‌های DNS ممکن است با iOS متفاوت باشند.

IOS / نسخه 2.2.2

سازگاری پیکربندی‌ها و بررسی سرورها

در App Store Connect بارگذاری شد

نسخه iOS 2.2.2 (113) در ۱۲ نوامبر ۲۰۲۶ به App Store Connect بارگذاری شد. انتشار هنوز در حال آماده‌سازی است؛ زمان دسترسی در App Store جداگانه اعلام می‌شود. تغییرات زیر فقط مربوط به همین بیلد iOS است، نه نسخه‌های منتشرشده Android و macOS.

پروفایل‌های کامل JSON

هنگام ورود، پروفایل کامل حفظ می‌شود، حتی اگر env و version تنها فیلدهای اضافی آن باشند. بزرگی و کوچکی حروف نام متغیرهای محیطی حفظ می‌شود و محدودیت نسخه هسته همچنان اعمال می‌شود. آرایه‌ای از پروفایل‌های مستقل به‌صورت فهرست گزینه‌ها باقی می‌ماند؛ بالانسر به چند سرور مستقل تقسیم نمی‌شود.

بررسی‌های HTTP و Hysteria2

اتصال و HTTP GET / HEAD از آماده‌سازی مشترک پروفایل استفاده می‌کنند: قواعد مسیریابی، DNS، تنظیمات ترنسپورت و محدوده داده‌های جغرافیایی ارائه‌دهنده. بررسی، درخواست را از پروکسی یا بالانسر انتخاب‌شده عبور می‌دهد، بدون آنکه VPN فعلی دوباره متصل شود. هسته آزمایشی متغیرهای env را به‌شکل ایزوله اعمال می‌کند و پس از پایان، محیط را به وضعیت قبلی برمی‌گرداند. متغیرهای داخلی خود برنامه در برابر جایگزینی محافظت می‌شوند.

آماده‌سازی داده‌های جغرافیایی برای سنجش HTTP در Hysteria2 اصلاح شد. در حالت TCP، این سرورهای UDP همچنان از طریق HTTP بررسی می‌شوند؛ TCP معمولی زمان اندازه‌گیری‌شده اتصال را بدون تقسیم نشان می‌دهد. فقط DoDo Ping تخمینی نتیجه HTTP GET را بر 3.3 تقسیم می‌کند. این بررسی، تست سرعت یا آزمایش کامل TUN و همه مقصدها نیست.

DNS و پشتیبانی محدود از FakeDNS

هماهنگی DNS هسته Xray با تونل سیستم، DoH تفکیک‌شده و نام‌های مستعار محلی DNS با محافظت در برابر چرخه بهبود یافت. پروفایل‌های سازگار FakeDNS با پیکربندی صریح و محدوده‌های استاندارد پشتیبانی می‌شوند؛ طرح‌های دلخواه و ترکیبی DNS به‌طور خودکار تطبیق داده نمی‌شوند. سنجش HTTP جداگانه برای پروفایل FakeDNS در دسترس نیست؛ این موضوع به‌تنهایی به معنای کار نکردن اتصال 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 کامل بی‌اطلاع شما اصلاح نمی‌شود. الزام فعال ناسازگار رد می‌شود، نه اینکه با روش دیگری جایگزین شود. قطعه‌قطعه‌سازی خودکار TCP روی UDP-only / Hysteria اعمال نمی‌شود. بررسی TLS تضعیف نمی‌شود.

رابط کاربری و محافظت محلی

فهرست اعلان‌ها و کارت VPN در صفحه قفل و Dynamic Island بهبود یافت. برنامه اصلی از 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 می‌تواند نشانه دریافت گزارش کرش یا هنگ برنامه اصلی را ارسال کند. این فایل کامل کرش، پشته فراخوانی یا ثبت تضمینی همه اختلال‌های افزونه VPN نیست. تحویل Apple ممکن است بعداً، پس از اجرای بعدی انجام شود.

عیب‌یابی در iOS و Android
پلتفرمقابلیت‌هامحدودیت‌ها
iOS 2.2.0رضایت ارسال، صف گزارش‌ها، تحویل، پس‌گرفتن رضایت و حذف داده‌ها. نشانه‌های محدود crash / hang از MetricKit.بدون پشته‌های کامل؛ همه کرش‌های سیستم، پایان اجرا به‌دلیل حافظه و هنگ‌ها را پوشش نمی‌دهد. مجوز اعلان جای رضایت عیب‌یابی را نمی‌گیرد.
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 روز نگهداری می‌شوند؛ سپس برچسب‌ها و کلید جداگانه ماه حذف می‌شوند.

از 9 نوامبر 2026 سرور سابقه ماهانه نگه می‌دارد: هر نصب در هر ماه یک‌بار شمرده می‌شود و یک نصب با کلیدهای چند سرویس می‌تواند در چند گروه ارائه‌دهنده باشد. گزارش‌های تجمیعی بسته‌شده بدون حذف خودکار نگهداری می‌شوند. آن‌ها شامل شناسه نصب، نشانی IP، کلید یا پیکربندی کامل نیستند؛ گروه‌های کوچک پنهان می‌شوند. سابقه پیش از شروع این شمارش بازسازی نمی‌شود. پس‌گرفتن رضایت، اطلاعات فردی را حذف و ماه باز را دوباره محاسبه می‌کند؛ نمی‌توان نصب مشخصی را از خلاصه بی‌نام بسته‌شده جدا کرد.

دسترسی به گزارش‌ها در حال حاضر گزارش‌ها در پنل مدیریت بسته در اختیار مالک DoDo هستند. پنل‌هایی با گزارش فقط ارائه‌دهنده خود به‌صورت جداگانه آماده می‌شوند. نام، نشانی پشتیبانی و شناسه عمومی، حق دسترسی به داده‌ها، استوری‌ها یا پیام‌رسانی دیگران را نمی‌دهند.

12 / دسترسی

قابلیت‌ها به تفکیک پلتفرم

در دسترس — قابل استفاده در نسخه مشخص‌شده. با محدودیت — ویژگی‌های بخش مربوطه را بخوانید. در دست توسعه — قابلیت هنوز برای اتصال عمومی در دسترس نیست.

دسترسی به تفکیک پلتفرم

جدول قابلیت‌های iOS 2.2.0 و Android APK 2.2.0 (2107) را نشان می‌دهد. انتشار به‌روزرسانی Android در Google Play جداگانه اعلام خواهد شد. برای macOS، نسخه 2.0.8 در صفحه مشترک با iOS در App Store باقی مانده است. نسخه بومی جدید Mac با Xray 26.10.31 جداگانه در حال آماده‌سازی است و هنوز منتشر نشده؛ قابلیت‌های آن را نباید در 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 و AGE1در iOS 2.2.0 در دسترس تنظیم و محدودیت‌ها.با محدودیت QR در دسترس از کلیپ‌بورد یا ورود دستی استفاده کنید؛ اسکن crypt1 در برخی HUAWEIها نیاز به بهبود دارد.
نشانی پشتیبان fallback-urlدر دسترس از پاسخ موفق از پیش ذخیره می‌شود.در دسترس پشتیبان باید از پیش دریافت شود.
داده‌های اشتراک و فاصله به‌روزرسانیدر دسترسدر دسترس
Routing / autorouting / داده‌های جغرافیاییبا محدودیت قالب قواعد را ببینید.با محدودیت در دسترس فاصله‌های بررسی با iOS متفاوت‌اند.
پنج روش پینگ، گزارش‌ها، QR و بازنشانیدر دسترسبا محدودیت QR در دسترس TCP بدون تقسیم؛ روش‌های پینگ و QR crypt1 را ببینید.
MTU، ترجیح IPv4 / IPv6، منابع VPNدر دسترس در بخش کاربران پیشرفته.MTU و IPv4 / IPv6 در دسترس‌اند ترکیب عیب‌یابی منابع با iOS متفاوت است.
شمارش استفاده به تفکیک ارائه‌دهندهدر دسترس مدیریت در سیاست حریم خصوصی؛ گزارش‌ها برای مالک DoDo.در دسترس براساس نام و پشتیبانی، با تنظیمات رضایت و حذف. Provider ID برای پنل هنوز ارسال نمی‌شود.
گزارش‌های خطا با رضایت کاربردر دسترس می‌توان ارسال را غیرفعال و داده‌ها را حذف کرد.در دسترس همان تنظیمات رضایت و حذف.
استوری‌های ارائه‌دهندهآزمایش بسته فقط روی دستگاه‌های متصل‌شده برای آزمایش.هنوز در دسترس نیست
اتصال مشترک، push هدفمند و Auto سروردر دست توسعهدر دست توسعه

نسخه‌ها متفاوت‌اند. قابلیت‌های جدید iOS 2.2.0 خودکار در Android یا macOS ظاهر نمی‌شوند. پیش از ارائه قالب‌های جدید، مطمئن شوید کلاینت کاربر آن‌ها را پشتیبانی می‌کند؛ پیوند فروشگاه‌ها در صفحه اصلی است.

قابلیت‌های اضافی

قابلیتوضعیتمعنای آن چیست
وارد کردن، به‌روزرسانی، داده‌های اشتراک، QRدر دسترسبرای قالب‌های توضیح‌داده‌شده در راهنما. اسکنر QR به مجوز دوربین نیاز دارد.
Xray JSON کامل و توزیع‌کننده‌های باربا محدودیتپروفایل همراه خروجی‌های مرتبط به‌طور کامل حفظ می‌شود. قالب‌های مجاز و محدودیت‌ها در بخش «قالب‌های اشتراک» توضیح داده شده‌اند.
پیوندهای محافظت‌شده DoDo crypt1با محدودیت در دسترسiOS 2.2.0 از App Store و Android APK 2.2.0. مولد محلی و SDK بدون ثبت‌نام یا API رمزنگاری. در برخی HUAWEIها برای crypt1 به‌جای QR از کلیپ‌بورد یا ورود دستی استفاده کنید. مستندات.
اشتراک پشتیبان: fallback-urlدر دسترسiOS 2.2.0 و Android APK 2.2.0. برای پیوندهای عادی HTTPS، JSON و crypt1؛ پشتیبان باید از پیش دریافت شود. در نسخه منتشرشده Mac فعلاً در دسترس نیست. سرآیندها و تنظیم پشتیبان.
دکمه «انتخاب خودکار» DoDoموقتاً در iOS پنهان استکاربر پروفایل را دستی انتخاب می‌کند. توزیع‌کننده بار درون JSON کامل به کار ادامه می‌دهد؛ به این دکمه وابسته نیست.
Live Activity / Dynamic Islandدر دستگاه‌های سازگارنمایش وضعیت VPN برای iPhone با iOS 16.1+. مدل پشتیبانی‌شده، مجوز Live Activities و تنظیم فعال در DoDo لازم است.
ظاهر و بازنشانی تنظیماتپیاده‌سازی شدهپوسته روشن/تیره و تنظیمات برنامه. بازنشانی کامل تأیید می‌خواهد و اشتراک‌ها و تنظیمات کاربر را حذف می‌کند؛ پیش از بازنشانی کلیدهای خود را ذخیره کنید.
قواعد و داده‌های جغرافیایی به‌روزشوندهبا محدودیتداده‌های دریافتی بررسی می‌شوند. در صورت خطا نسخه سالم باقی می‌ماند؛ زمان اجرای پس‌زمینه را سیستم تعیین می‌کند.
استوری‌های ارائه‌دهندهآزمایش بستهمشاهده فقط روی دستگاه‌های متصل به آزمایش در دسترس است. اتصال عمومی ارائه‌دهندگان بعداً باز خواهد شد.
ثبت‌نام پنل و DNS TXTدسترسی زودهنگامورود با Google، ایجاد رایگان سرویس و تأیید دامنه دقیق. راه‌اندازی کامل عملیاتی به‌زودی. شروع اتصال.
برند عمومی و استوری‌هاآماده‌سازی یکپارچه‌سازیپنل، host دقیق با DNS TXT، موافقت DoDo و x-dodo-provider-id در پاسخ HTTPS اشتراک. بدون ماژول و کلید امضا. این به معنای ایجاد گروه مخاطبان خصوصی نیست؛ کلاینت سازگار لازم است و انتشار نسخه جدید در اینجا تأیید نمی‌شود.
تأیید امضاشده مشترکپایلوت اختیاریپروتکل پیشرفته جداگانه با امضای سرور. برای محتوای عمومی لازم نیست؛ شناسه عمومی جای بررسی‌های آن را نمی‌گیرد.
Push به مشترکان خودهنوز در دسترس نیستپیام‌رسانی هدفمند برای ارائه‌دهندگان مشخص هنوز متصل نشده است.
Auto سرور از طریق API پنلدر دست توسعهبا انتخاب خودکار محلی و توزیع‌کننده بار Xray متفاوت خواهد بود. توکن‌های محرمانه API را نباید در اشتراک یا برنامه کاربر قرار داد.
Happ crypto / Happ deeplinkپشتیبانی نمی‌شوندفقط سازگاری پاسخ‌های JSON که در بالا توضیح داده شد در دسترس است.
Lite Mode، Premium API و ظاهر اجباریپشتیبانی نمی‌شوندارائه‌دهنده نمی‌تواند از طریق این فیلدها Lite Mode را فعال یا پوسته و سبک دکمه‌های برنامه را تغییر دهد.

از اشتراک شروع کنید. پاسخ HTTPS را طبق نمونه‌های بالا تنظیم کنید، در DoDo اضافه کنید و اتصال را بررسی کنید. برای این کار پنل DoDo و دادن توکن خصوصی API به ما لازم نیست.