Vercel در ایران باز نمیشود؟ رفع خطای Deploy و Dashboard
اگر Vercel در ایران باز نمیشود، اول مشخص کنید کدام بخش خراب است: Dashboard، اتصال Git، Build، URL پیش‌نمایش یا Domain اختصاصی. این بخش‌ها زنجیرهٔ واحدی نیستند. بازشدن Dashboard ثابت نمیکند Build سالم است و خطای Deploy هم لزوماً از شبکهٔ شما نیست.
تست پنج‌مرحله‌ای برای پیدا کردن مشکل
- Dashboard را در پنجرهٔ Private باز کنید.
- صفحهٔ همان پروژه و آخرین deployment را ببینید.
- Build Log را از اولین خطای واقعی بخوانید.
- URL پیش‌نمایش Vercel را باز کنید.
- Domain اختصاصی را جدا آزمایش کنید.
| نتیجه | محل محتمل مشکل |
|---|---|
| Dashboard و همهٔ URLهای Vercel باز نمی‌شوند | مرورگر، DNS، شبکه یا اختلال سرویس |
| Dashboard باز است و Build قرمز میشود | کد، dependency، command یا متغیر محیطی |
| Preview سالم و Domain خراب است | DNS یا تنظیم Domain |
| Git push انجام شده ولی Deploy ساخته نمیشود | اتصال repository یا تنظیم branch |
| Build موفق و صفحه 500 می‌دهد | Runtime Log و کد سمت سرور |
این تفکیک جلوی تغییر بی‌دلیل DNS، framework و سرور VPN به‌صورت همزمان را می‌گیرد.
وقتی Dashboard یا Log باز نمیشود
ابتدا Vercel را در پنجرهٔ خصوصی و بدون افزونه‌های مسدودکنندهٔ script امتحان کنید. اگر فقط روی یک اینترنت شکست میخورد، اتصال سراسری یا TUN بگیرید تا مرورگر، Git و CLI از یک مسیر خارج شوند. حالت proxy مرورگر برای git push یا فرمان‌های ترمینال کافی نیست.
پس از تغییر مسیر:
- IP و DNS را با ابزارهای تست VPN بررسی کنید.
- tabهای قدیمی Dashboard را ببندید و دوباره وارد شوید.
- تا پایان بررسی، سرور یا کشور را تغییر ندهید.
- وضعیت عمومی سرویس را نیز ببینید؛ اختلال سراسری با تغییر مسیر محلی حل نمیشود.
اگر Dashboard سالم است، دیگر مشکل Build را به اتصال نسبت ندهید.
خطای Build را از اولین خط قرمز بخوانید
راهنمای رسمی Vercel برای عیب‌یابی Build توصیه میکند فرمان build را محلی بازتولید و تفاوت محیط محلی و cloud را بررسی کنید. از اولین error شروع کنید؛ آخرین خط معمولاً فقط نتیجهٔ متوقف‌شدن process است.
موارد رایج:
- dependency در
package.jsonیا lockfile نیست؛ - نسخهٔ Node با پروژه سازگار نیست؛
- نام فایل روی سیستم محلی با حروف بزرگ/کوچک متفاوت است؛
- build command یا output directory اشتباه است؛
- Environment Variable فقط محلی تعریف شده است؛
- import به فایل یا پکیجی اشاره میکند که commit نشده است.
همان commit را محلی با فرمان production build اجرا کنید. اگر آنجا هم شکست خورد، VPN موضوع اصلی نیست.
Environment Variable و Secret گم‌شده
مقدارهای محیط Preview و Production می‌توانند متفاوت باشند. نام متغیر، environment هدف و deploy جدید پس از تغییر را کنترل کنید. مقدار secret را داخل repository، screenshot یا log عمومی نگذارید.
اگر برنامه در زمان Build به API بیرونی وصل میشود، پاسخ را دسته‌بندی کنید: 401/403 بیشتر به credential یا permission مربوط است؛ timeout می‌تواند از endpoint، شبکه یا سقف زمان اجرا باشد. تغییر IP مجوز API ایجاد نمیکند.
Build موفق است ولی سایت 500 می‌دهد
در این حالت به Runtime Logs رسمی Vercel بروید. زمان request خراب را پیدا کنید و stack trace را با همان deployment تطبیق دهید. این موارد را بررسی کنید:
- متغیر محیطی Production وجود دارد؛
- اتصال دیتابیس از محیط Vercel مجاز است؛
- تابع به filesystem موقت به‌عنوان storage دائمی تکیه ندارد؛
- route و method درخواست درست است؛
- response سرویس بیرونی timeout یا rate-limit نشده است.
هر بار فقط یک عامل را تغییر دهید و deployment تازه را با قبلی مقایسه کنید.
Preview سالم است ولی Domain اختصاصی باز نمیشود
اگر URL پیش‌نمایش سالم است، برنامه و Deploy کار می‌کنند. DNS record، تأیید مالکیت، redirect و certificate Domain را در Dashboard بررسی کنید. زمان انتشار DNS ممکن است بین resolverها متفاوت باشد؛ چند record متناقض A و CNAME نسازید.
Domain را هم با و هم بدون www آزمایش و مقصد canonical را مشخص کنید. VPN راه‌حل record اشتباه نیست.
Vercel CLI و Git روی ترمینال وصل نمی‌شوند
اگر مرورگر سالم است ولی CLI timeout میشود، احتمالاً فقط مرورگر از proxy عبور میکند. حالت TUN یا تنظیم proxy خود ترمینال را به‌کار بگیرید. سپس یک فرمان خواندنی کوچک را اجرا کنید؛ deploy بزرگ را اولین تست اتصال قرار ندهید.
برای زنجیرهٔ Git نیز راهنمای VPN توسعه‌دهنده‌ها تفاوت مسیر مرورگر، Git و Docker را توضیح می‌دهد. مقالهٔ Replit در ایران نیز تفکیک Preview و محیط انتشار را پوشش می‌دهد.
چه زمانی اتصال پایدار کمک میکند؟
وقتی Dashboard، CLI و دریافت log فقط روی یک شبکه قطع میشوند و با مسیر دیگر همگی سالماند، مشکل شبکه محتمل است. یک اتصال پایدار برای ابزارهای توسعه را با پروژهٔ آزمایشی بسنجید و تا پایان session سرور را ثابت نگه دارید. اگر Build Log خطای مشخص کد دارد، به همان خطا برگردید.
سؤالات متداول
چرا Vercel باز میشود ولی Deploy شکست میخورد؟
Dashboard و Build دو لایهٔ جدا هستند. اولین error در Build Log، lockfile، نسخهٔ runtime و Environment Variableها را بررسی کنید.
چرا Preview سالم است ولی Domain کار نمیکند؟
احتمالاً مشکل DNS، تأیید Domain یا redirect است. سالم‌بودن Preview نشان می‌دهد deployment بالا آمده است.
آیا برای Vercel IP اختصاصی لازم است؟
برای استفادهٔ عادی الزام عمومی نیست. ثبات مسیر هنگام ورود و کار با Dashboard مهم‌تر از تعویض مداوم IP است.
VPN خطای 500 را حل میکند؟
معمولاً نه. خطای 500 را در Runtime Log، stack trace، secretها و اتصال سرویس‌های سمت سرور دنبال کنید.
راه‌حل‌های بالا را انجام دادید و هنوز مشکل باقی است؟
اول با یک کانفیگ سالم رایگان مقایسه کنید؛ اگر مشکل حل شد، بعد پلن مناسب را بخرید