رفع خطای invalid UUID در v2rayNG؛ اصلاح کانفیگ ناقص
خطای invalid UUID هنگام خواندن تنظیمات v2rayNG معمولاً یعنی مقدار شناسه با قالبی که آن مسیرِ پردازش انتظار دارد سازگار نیست؛ اول کانفیگ اصلی و روش ورود آن را بررسی کنید. این خطا بهتنهایی نشانهٔ تمام‌شدن حجم، خرابی DNS یا مسدودبودن سرور نیست. ساخت یک شناسهٔ تصادفی هم حساب فعال روی سرور ایجاد نمیکند.
متن کامل خطا اهمیت دارد. اگر عبارت را همراه failed to load config یا هنگام شروع هسته میبینید، بررسی را از دادهٔ محلی آغاز کنید. اگر برنامه شروع میشود و بعد Timeout یا خطای دیگری می‌دهد، مرحلهٔ شکست متفاوت است. نام یک خطا را از روی شباهت ظاهری جای خطای واقعی خودتان نگذارید.
شناسهٔ کاربر با نشانی سرور فرق دارد
در مستندات VLESS در Xray، فیلد id برای شناسهٔ کاربر است؛ آدرس و پورت، فیلدهای جداگانه‌اند. اگر به‌جای شناسه، آدرس اشتراک، نام دلخواه سرور یا تمام لینک را در این فیلد بگذارید، نباید انتظار داشته باشید برنامه خودش معنای موردنظر شما را حدس بزند.
UUID متعارف به شکل گروه‌های حروف و ارقام هگزادسیمال دیده میشود. بااین‌حال، در بعضی مسیرهای Xray شناسهٔ متنی نیز به UUID نگاشت میشود. بنابراین قاعدهٔ «هر شناسه‌ای که ظاهر متفاوت دارد حتماً خراب است» دقیق نیست؛ پروتکل، نسخهٔ هسته و قالب ورودی اهمیت دارند. بهترین مبنا، خروجی سازگار و اصلی ارائهدهنده است.
| داده | نقش | اشتباه رایج |
|---|---|---|
| آدرس سرور | مقصد ارتباط | قراردادن آن در فیلد شناسه |
| پورت | شمارهٔ سرویس مقصد | عوض‌کردن آن برای خطای قالب UUID |
| شناسهٔ کاربر | اطلاعات شناسایی در تنظیمات پروتکل | تولید مقدار تصادفی به‌جای حساب واقعی |
| لینک اشتراک | دریافت مجموعهٔ تنظیمات | واردکردن کل URL در فیلد id |
| نام نمایشی | تشخیص کانفیگ در فهرست | تصور اینکه تغییر نام، حساب را عوض می‌کند |
۱. نسخهٔ اصلی داده را دوباره دریافت کنید
به پیام یا صفحهٔ اصلی تحویل اشتراک برگردید و از قابلیت کپی همان منبع استفاده کنید. متن طولانی را از روی اسکرین‌شات تایپ نکنید. فاصله، شکست خط و تبدیل ناخواستهٔ بعضی نویسه‌ها هنگام انتقال می‌تواند داده‌ای بسازد که شبیه اصل است اما عین آن نیست.
اگر چند نسخه از لینک در پیام‌ها دارید، مشخص کنید کدام آخرین خروجی معتبر است. قبل از حذف پروفایل قبلی، آن را با نام قابل‌شناسایی نگه دارید یا روش دریافت دوبارهٔ اطلاعات را بررسی کنید. بازنویسی همهٔ تنظیمات هم‌زمان، امکان مقایسه با نسخهٔ قبلی را از بین می‌برد.
برای مثال، اگر پس از ویرایش دستی یک فیلد خطا شروع شده، همان تغییر سرنخ است. ابتدا تنظیمات اصلی را در یک پروفایل جدا وارد کنید؛ لازم نیست بقیهٔ کانفیگ‌های سالم را پاک کنید. اگر خروجی تازه هم همان خطا را می‌دهد، نسخهٔ برنامه و قالبی را که ارائهدهنده تحویل داده ثبت کنید.
۲. روش ورود را با نوع اطلاعات هماهنگ کنید
لینک تک‌سرور، لینک اشتراک و فایل تنظیمات یک نوع ورودی نیستند. روش افزودن باید با داده‌ای که دریافت کرده‌اید سازگار باشد. از روی داشتن پیشوند اینترنتی یا طول زیاد متن، نتیجه نگیرید همهٔ آن‌ها باید در یک کادر قرار بگیرند.
برای نصب اولیه و شناخت مسیرهای ورود، راهنمای v2rayNG اندروید را ببینید. اگر مشکل هنگام به‌روزرسانی گروه اشتراک است، راهنمای خطای دریافت اشتراک مسئلهٔ متفاوتی را پوشش می‌دهد. این مقاله بر شناسهٔ نامعتبر هنگام تفسیر تنظیمات تمرکز دارد.
اسکن موفق QR نیز فقط نشان می‌دهد یک داده از تصویر خوانده شده است. باید مشخص شود آن داده چه قالبی دارد و مقصد ورود آن چیست. اگر QR از منبع اشتباه یا نسخهٔ قدیمی گرفته شده، وضوح بهتر تصویر الزاماً خطای شناسه را رفع نمیکند.
۳. قالب معتبر را با حساب معتبر اشتباه نگیرید
کد رسمی پردازش UUID در Xray نشان می‌دهد بررسی قالب و تبدیل شناسه مرحله‌ای مشخص است. عبور از این مرحله بهتنهایی تأیید نمیکند کاربر روی سرور وجود دارد، اشتراک فعال است یا تنظیمات انتقال درست‌اند.
ساختن UUID تصادفی ممکن است ظاهر داده را قابل‌پذیرش کند، اما شناسهٔ تازه باید با چیزی که سرور انتظار دارد هماهنگ باشد. اگر فقط در گوشی مقدار را عوض کنید، حساب سمت سرویس خودبه‌خود تغییر نمیکند. کاربر سرویس باید مقدار صحیح را از ارائهدهنده بگیرد؛ تولید و ثبت شناسهٔ جدید کار مدیریت همان سرور است.
حتی اگر بعد از یک ویرایش، invalid UUID ناپدید شد و خطای دیگری ظاهر شد، رفع کامل اتصال ثابت نشده است. ممکن است صرفاً از مرحلهٔ پردازش محلی عبور کرده باشید. متن خطای جدید و زمان رخداد را جدا ثبت کنید تا بررسی به عقب برنگردد و تنظیمات درست بی‌دلیل عوض نشوند.
۴. نسخهٔ کلاینت و هسته را بررسی کنید
v2rayNG رسمی کلاینت اندروید است و هسته‌های اتصال را به کار می‌گیرد. رفتار یک ورودی می‌تواند به نسخه و مسیر پردازش وابسته باشد. وقتی یک فایل در برنامه‌ای دیگر باز میشود، این نتیجه بهتنهایی ثابت نمیکند همان قالب در نسخهٔ نصب‌شدهٔ شما پشتیبانی میشود.
نام دقیق برنامه و نسخه را از خود آن بردارید. برنامه‌های همنام یا بسته‌های دست‌کاری‌شده ممکن است رفتار متفاوتی داشته باشند. پیش از به‌روزرسانی، راه دسترسی دوباره به لینک اشتراک را نگه دارید؛ برای آزمودن یک نسخهٔ رسمی لازم نیست حساب یا همهٔ پروفایل‌ها را از دست بدهید.
از تغییر گزینه‌های نامرتبط TLS، مسیر WebSocket یا DNS صرفاً برای حذف پیام UUID پرهیز کنید. این فیلدها نقش دیگری دارند و تغییرشان می‌تواند حتی پس از اصلاح شناسه، خطای اتصال تازه‌ای ایجاد کند. هدف، بازگشت به مجموعهٔ تنظیمات سازگار است، نه خاموش‌کردن هر گزینه‌ای که نام فنی دارد.
اگر همچنان خطا دارید
| نتیجهٔ بررسی | قدم بعدی |
|---|---|
| فقط نسخهٔ دستی خطا دارد | با خروجی اصلی و روش ورود درست مقایسه کنید |
| همهٔ خروجی‌های یک اشتراک خطا دارند | قالب تحویلی و نسخهٔ کلاینت را با پشتیبانی تطبیق دهید |
| تنظیمات بارگذاری میشود ولی اتصال شکست می‌خورد | خطای مرحلهٔ اتصال را جدا بررسی کنید |
| خطا بعد از تبدیل آنلاین ایجاد شده | نسخهٔ اصلی و تبدیل سازگار نزد ارائهدهنده را مبنا بگذارید |
| پیام خطا شناسه را هم نشان می‌دهد | قبل از ارسال تصویر، مقدار خصوصی را بپوشانید |
در گزارش به پشتیبانی بنویسید داده از لینک، فایل یا QR وارد شده، نسخهٔ برنامه چیست و خطا پیش از شروع اتصال رخ می‌دهد یا بعد از آن. لازم نیست لینک کامل اشتراک را در گروه عمومی قرار دهید. UUID، توکن و QR می‌توانند اطلاعات دسترسی داشته باشند و نمایش عمومی آن‌ها برای توضیح خطا ضروری نیست.
اگر بررسی قالب تمام شد و حالا اتصال وارد مرحلهٔ شبکه میشود، نتیجه را با همان نسخهٔ اصلاحشده آزمایش کنید. چند تغییر تازه را یک‌باره روی آن اعمال نکنید. شرایط فعلی سرویس در صفحهٔ اصلی v2route است؛ پیش از خرید دوباره، از پشتیبانی اشتراک موجود بخواهید صحت خروجی را بررسی کند.
سؤالات متداول
آیا invalid UUID یعنی حجم اشتراک تمام شده است؟
این پیام هنگام پردازش تنظیمات به قالب یا تفسیر شناسه مربوط است و بهتنهایی پایان حجم را ثابت نمیکند. وضعیت حساب باید جداگانه از مسیر ارائهدهنده بررسی شود.
با UUID Generator میتوانم اتصال را درست کنم؟
تولید یک شناسهٔ تازه حساب معتبر روی سرور ایجاد نمیکند. مقدار باید با تنظیمات سمت ارائهدهنده هماهنگ باشد؛ شناسهٔ اصلی یا خروجی اصلاحشده را از همان سرویس بگیرید.
چرا QR خوانده میشود ولی کانفیگ خطا دارد؟
خواندهشدن تصویر، معتبر و سازگار بودن دادهٔ داخل آن را تضمین نمیکند. نوع داده، روش ورود و نسخهٔ اصلی اشتراک را بررسی کنید.
برای بررسی خطا، UUID را در گروه پشتیبانی بفرستم؟
در محیط عمومی مقدار کامل، لینک اشتراک و QR را منتشر نکنید. ابتدا نسخهٔ برنامه و متن خطا با اطلاعات خصوصی پوشانده‌شده را ارسال کنید و ادامه را از مسیر رسمی پیگیری کنید.
راه‌حل‌های بالا را انجام دادید و هنوز مشکل باقی است؟
اول با یک کانفیگ سالم رایگان مقایسه کنید؛ اگر مشکل حل شد، بعد پلن مناسب را بخرید