Hiddify اشتراک را درون‌ریزی نمی‌کند: خطای Failed to Add Profile

دیدن Failed to Add Profile،‏ Unexpected Connection Error یا «نوع لینک اشتراک قابل تشخیص نیست» هنگام درون‌ریزی الزاماً به این معنا نیست که همهٔ گره‌ها از کار افتاده‌اند. خطا می‌تواند هنگام دریافت اشتراک، اعتبارسنجی HTTPS، شناسایی قالب محتوا یا ذخیرهٔ پیکربندی رخ دهد.

کاربران Windows همین خطاها را در مخزن رسمی گزارش کرده‌اند. Issue #1661 شامل Failed to Add Profile / Unexpected Connection Error است و Issue #2037 اشتراک Clash شناسایی‌نشده را ثبت کرده است. این‌ها نمونه‌های کاربران هستند و ثابت نمی‌کنند علت همهٔ دستگاه‌ها یکسان است.

نشانه‌ها

• بلافاصله پس از انتخاب افزودن از حافظهٔ موقت خطا دیده می‌شود.
• ورود دستی URL به خطای غیرمنتظرهٔ اتصال منتهی می‌شود.
• لینک در نسخهٔ قدیمی یا دستگاه دیگر درون‌ریزی می‌شود، اما روی دستگاه فعلی نه.
• برنامه نوع اشتراک را تشخیص نمی‌دهد یا پس از درون‌ریزی هیچ گره‌ای نمایش نمی‌دهد.
• بررسی به‌روزرسانی و افزودن نمایه هر دو خطای شبکه می‌دهند.

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

تشخیص دو دقیقه‌ای

1. نشانی اشتراک را دوباره از پنل ارائه‌دهنده کپی کنید. مطمئن شوید با https:// یا طرح تک‌گرهٔ پشتیبانی‌شده آغاز می‌شود و فاصله، خط جدید یا نویسهٔ افتاده ندارد.
2. لینک را منتشر نکنید. نشانی HTTPS را در مرورگری مطمئن باز کنید و ببینید محتوای پیکربندی برمی‌گرداند یا به صفحهٔ ورود، CAPTCHA، خطا یا هشدار گواهی می‌رود.
3. فقط یک بار بین Wi-Fi و نقطهٔ اتصال تلفن همراه جابه‌جا شوید. اگر فقط یک شبکه خراب است، ابتدا DNS،‏ TLS یا محدودیت دسترسی همان شبکه را بررسی کنید.
4. همان لینک را روی دستگاه دیگر درون‌ریزی کنید یا اشتراک سالم دیگری را روی دستگاه فعلی بیازمایید. با نتیجهٔ متقاطع، مشکل دستگاه را از مشکل اشتراک جدا کنید.
5. متن کامل خطا و زمان را ثبت کنید. برنامه را پی‌درپی نصب نکنید، هسته را تغییر ندهید و همهٔ تنظیمات پیشرفته را هم‌زمان دست‌کاری نکنید.

رفع اشکال لایه‌به‌لایه

کلاینت: روش ورود و نسخه را بررسی کنید

مستندات رسمی دو روش پایه را شرح می‌دهد: افزودن از حافظهٔ موقت یا ورود دستی نام و URL. مراحل در راهنمای رسمی HiddifyApp آمده است.

• لینک را در یک ویرایشگر متن سادهٔ محلی بچسبانید، ابتدا و انتها و خط‌های جدید ناخواسته را بررسی کنید و بلافاصله متن موقت را پاک کنید.
• اگر افزودن از حافظهٔ موقت خراب است، همان URL کامل را با گزینهٔ افزودن دستی وارد کنید. این آزمون فقط مشکل محتوای حافظهٔ موقت را کنار می‌گذارد.
• نسخهٔ پایدار فعلی و بستهٔ درست برای پلتفرم را در انتشارهای رسمی بررسی کنید.
• پیش از ارتقا، نمایه‌های سالم فعلی را نگه دارید. پاک‌کردن دادهٔ برنامه را نخستین مرحله قرار ندهید؛ ممکن است تنها پیکربندی محلی قابل استفاده را حذف کند.
• پیشنهاد «فعال‌کردن حالت اشکال‌زدایی» در برخی دیدگاه‌های Issues راه‌حل عمومی نیست. ارزش اصلی حالت اشکال‌زدایی، دریافت گزارش دقیق‌تر است.

اشتراک: مطمئن شوید پاسخ پیکربندی است، نه صفحهٔ وب

• انقضای حساب، ترافیک باقی‌مانده و محدودیت دستگاه‌های هم‌زمان را بررسی کنید.
• مطمئن شوید «لینک اشتراک» را کپی کرده‌اید، نه صفحهٔ اصلی پنل، پرداخت یا آموزش.
• اگر مرورگر صفحهٔ ورود HTML،‏ CAPTCHA، صفحهٔ مسدودسازی WAF، صفحهٔ خالی یا JSON خطا برمی‌گرداند، ارائه‌دهنده باید پاسخ را اصلاح کند.
• اگر لینک به‌عنوان Clash،‏ sing-box یا تک‌گره معرفی شده است، پاسخ باید با همان قالب سازگار باشد. راهنمای رسمی چند قالب اشتراک و پروتکل پشتیبانی‌شده را فهرست می‌کند، اما «پشتیبانی‌شده» به این معنا نیست که هر متن دلخواهی قابل تجزیه است.

DNS/TLS: مرز امنیتی HTTPS را حفظ کنید

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

هرگز https:// را در لینک اشتراک به http:// تغییر ندهید. حتی اگر دیدگاهی آن را راه‌حل موقت بداند، HTTP توکن اشتراک و اطلاعات گره را به‌صورت متن آشکار می‌فرستد. فایل رسمی HISTORY نیز تصمیم امنیتی غیرفعال‌کردن لینک‌های HTTP در Hiddify 4.x را ثبت کرده است: مشاهدهٔ تاریخچهٔ تغییرات.

سرور: از ارائه‌دهنده بخواهید پاسخ واقعی را بررسی کند

اگر همان لینک روی چند دستگاه و شبکه درون‌ریزی نمی‌شود، از ارائه‌دهنده بخواهید این موارد را بررسی کند:

• گواهی HTTPS معتبر است و زنجیرهٔ کاملی دارد؛
• درخواست به‌جای حلقهٔ 3xx یا وضعیت 401،‏ 403،‏ 404 یا 5xx، پاسخ 200 می‌دهد؛
• مقصد تغییرمسیر همچنان به‌صورت امن در دسترس است؛
• بدنهٔ پاسخ شامل پیکربندی معتبر Clash،‏ sing-box یا گره است؛
• توکن، حساب، ترافیک و محدودیت دستگاه معتبر هستند.

هنگام انتقال دامنهٔ اشتراک، ارائه‌دهنده می‌تواند از سازوکار moved-permanently-to در مستندات رسمی URL Scheme استفاده کند و از کاربر نخواهد به HTTP تنزل دهد.

اعتبارسنجی

پس از رفع مشکل باید همهٔ موارد زیر برقرار باشند:

1. نمایه‌های تکراری ساخته‌شده در آزمون را حذف کنید، اما نمایهٔ سالم تأییدشده را نگه دارید.
2. همان لینک HTTPS را سه بار پیاپی درون‌ریزی یا تازه کنید و خطای اصلی را نبینید.
3. نمایه گره‌ها را نشان دهد و دست‌کم یک گره هم آزمون تأخیر و هم بازکردن یک وب‌سایت واقعی را کامل کند.
4. پس از راه‌اندازی دوبارهٔ برنامه، نمایه باقی بماند.
5. همان خطای دریافت، گواهی یا تجزیه دیگر در گزارش دیده نشود.

اگر درون‌ریزی موفق است اما پس از اتصال شبکه ندارید، راهنمای Hiddify متصل است اما اینترنت ندارد را ادامه دهید.

چه زمانی با ارائه‌دهنده تماس بگیرید

اگر مرورگر هشدار گواهی می‌دهد، لینک صفحهٔ ورود یا خطا برمی‌گرداند، حساب منقضی شده، چند کلاینت لینک را نمی‌خوانند یا چند گرهٔ یک ارائه‌دهنده هم‌زمان از کار افتاده‌اند، مستقیماً با ارائه‌دهندهٔ اشتراک تماس بگیرید.

اگر لینک در کلاینت‌ها و دستگاه‌های دیگر کار می‌کند اما در نسخه‌ای مشخص از Hiddify پایداراً خراب است، نسخهٔ سیستم، نسخهٔ Hiddify، منبع نصب، متن دقیق خطا، مراحل بازتولید و گزارش پالایش‌شده را در Issues رسمی ثبت کنید. URL کامل اشتراک، توکن، UUID، کد QR یا اطلاعات ورود سرور را ارسال نکنید.