راهنمای جامع و گام‌به‌گام انتقال سایت و وب‌اپلیکیشن‌های ساخته‌شده با Lovable.ai به هاست شخصی در ایران

ظهور پلتفرم‌های توسعه نرم‌افزار مبتنی بر هوش مصنوعی، پارادایم تولید برنامه‌های تحت وب را دستخوش تغییرات بنیادینی کرده است. پلتفرم Lovable.ai به عنوان یکی از پیشرفته‌ترین دستیاران برنامه‌نویسی، این امکان را فراهم آورده تا ایده‌های متنی در کوتاه‌ترین زمان به برنامه‌های کاربردی تمام‌عیار (Full-Stack) تبدیل شوند1. این پلتفرم در لایه فرانت‌اند (Frontend) از فناوری‌های مدرنی نظیر React و Vite بهره می‌برد و در لایه بک‌اند (Backend) و مدیریت داده‌ها، یکپارچگی عمیقی با زیست‌بوم Supabase دارد2. با وجود اینکه Lovable زیرساخت ابری مدیریت‌شده‌ای (Lovable Cloud) را برای میزبانی سریع نسخه‌های اولیه ارائه می‌دهد و برنامه‌ها را روی زیردامنه‌هایی نظیر lovable.app مستقر می‌سازد4، نیاز به استقلال داده‌ها، بهینه‌سازی حرفه‌ای برای موتورهای جستجو (SEO)، اعمال برندینگ از طریق دامنه‌های اختصاصی، و مهم‌تر از همه، مدیریت بهینه هزینه‌ها در مقیاس تولید (Production)، مهاجرت به زیرساخت‌های شخصی را به یک ضرورت گریزناپذیر تبدیل می‌کند2.

انتقال یک پروژه از زیرساخت بسته به سرورهای محلی یا ابری شخصی، به ویژه برای تیم‌های توسعه در ایران، با مجموعه‌ای از چالش‌های فنی و زیرساختی همراه است. این چالش‌ها از استخراج صحیح کدهای منبع آغاز شده و تا دور زدن تحریم‌های اینترنتی برای نصب وابستگی‌ها، پیکربندی پایگاه‌های داده، تنظیمات وب‌سرورها در هاست‌های اشتراکی نظیر سی‌پنل (cPanel) و اتصال به شبکه‌های توزیع محتوا (CDN) امتداد می‌یابد. در این گزارش تخصصی که با زبانی ساده، کاربردی و مرحله‌به‌مرحله تدوین شده است، تمامی سناریوهای ممکن برای استقرار (Deployment) برنامه‌های Lovable در محیط ایران به صورت موشکافانه بررسی می‌گردد. همچنین به منظور تسریع روند توسعه، رفع خطاهای پیچیده سرور و ارتقای کیفیت کدها، نقش کلیدی ابزارهای هوش مصنوعی و نحوه تهیه قانونی آن‌ها از مراجع معتبری نظیر «فروشگاه هوش مصنوعی ای آی کارت» تشریح خواهد شد.

فاز اول: استخراج کدهای منبع (Source Code) از زیست‌بوم Lovable.ai

یکی از اصول کلیدی در معماری Lovable، جلوگیری از قفل شدن توسعه‌دهنده در پلتفرم ارائه‌دهنده (Vendor Lock-in) است2. توسعه‌دهندگان مالکیت صددرصدی کدهای تولید شده را در اختیار دارند و می‌توانند پایگاه کد (Codebase) را در هر زمانی به طور کامل استخراج نمایند2. برای خروج کدها از محیط ابری Lovable، سه رویکرد اصلی وجود دارد که انتخاب هر یک به سطح تخصص تیم، نیاز به تاریخچه تغییرات و نوع معماری پروژه بستگی دارد.

همگام‌سازی دوطرفه با GitHub (رویکرد سازمانی و استاندارد)

این روش برای پروژه‌هایی که نیازمند کنترل نسخه (Version Control)، همکاری تیمی، و پیاده‌سازی چرخه‌های یکپارچه‌سازی و استقرار مداوم (CI/CD) هستند، استانداردترین گزینه محسوب می‌شود7. با اتصال پروژه به گیت‌هاب، کدهای Lovable از حالت یک پروژه ایزوله خارج شده و قابلیت ادغام با ابزارهای توسعه خارجی را پیدا می‌کنند.

فرآیند اتصال شامل مراجعه به تنظیمات پروژه در محیط ویرایشگر Lovable و انتخاب آیکون GitHub در گوشه سمت راست بالای فضای کاری است8. پس از انتخاب گزینه اتصال، سیستم یک پنجره تاییدیه باز کرده و نیازمند دریافت مجوز برای نصب برنامه Lovable GitHub App روی حساب کاربری یا سازمان توسعه‌دهنده است7. پس از اعطای این مجوز، Lovable یک مخزن (Repository) جدید ایجاد کرده و کدهای پروژه را به آن منتقل می‌کند7. این مخزن به صورت پیش‌فرض در حالت خصوصی (Private) قرار دارد تا امنیت دارایی‌های فکری حفظ گردد7. پس از اتمام این فرآیند، می‌توان مخزن ایجاد شده را با استفاده از دستورات گیت، نظیر git clone، از طریق پروتکل‌های HTTPS یا SSH و یا با استفاده از GitHub CLI در محیط محلی سیستم توسعه‌دهنده دریافت نمود7. شایان ذکر است که این همگام‌سازی دوطرفه است؛ یعنی تغییرات انجام شده در محیط Lovable به صورت خودکار به گیت‌هاب ارسال شده و تغییرات اعمال شده روی شاخه فعال (Active Branch) در گیت‌هاب نیز به درون Lovable بازمی‌گردد7.

دانلود مستقیم کدها به صورت فایل فشرده (رویکرد سریع)

برای تیم‌هایی که آشنایی کمتری با گیت‌هاب دارند یا صرفاً به دنبال تهیه یک نسخه پشتیبان سریع جهت استقرار دستی در هاست هستند، دانلود مستقیم کدها کارآمدتر است8. در نسخه‌های تجاری (Business Plan) پلتفرم Lovable، گزینه‌ای تحت عنوان “Download codebase” در پایین بخش کاوشگر فایل (File Explorer) در نوار کناری محیط ویرایشگر تعبیه شده است1. با کلیک بر روی این گزینه که با آیکون پیکان دانلود مشخص شده است، کل پایگاه کد در قالب یک فایل ZIP دانلود می‌گردد1.

مزیت بنیادین این روش سادگی بی‌نظیر آن است؛ فایل خروجی نیازی به راه‌اندازی گیت‌هاب ندارد و برای بررسی‌های سریع آفلاین بسیار مناسب است8. با این حال، نقطه‌ضعف این روش از دست رفتن تاریخچه تغییرات و عدم امکان همگام‌سازی خودکار با به‌روزرسانی‌های بعدی است8. توسعه‌دهندگانی که این روش را برمی‌گزینند، باید پس از استخراج فایل‌ها، در محیط خط فرمان سیستم خود با اجرای دستورات git init، git add . و git commit یک مخزن محلی برای کنترل نسخه‌های آتی ایجاد کنند تا از بروز تداخلات کدی جلوگیری شود8.

استخراج از طریق API غیررسمی (رویکرد برنامه‌نویسان حرفه‌ای)

در سناریوهایی که کاربران به پلن‌های تجاری دسترسی ندارند و هم‌زمان تمایلی به استفاده از گیت‌هاب نیز ندارند، راه‌حل‌های خلاقانه‌ای توسط جامعه کاربری توسعه یافته است. بر اساس مستندات و تجربیات به اشتراک گذاشته شده، Lovable از یک API داخلی برای ارائه فایل‌ها به رابط کاربری خود استفاده می‌کند9. توسعه‌دهندگان مجرب با استفاده از محیط DevTools مرورگر (تب Network)، قادرند توکن احراز هویت (Bearer Token) و شناسه پروژه (Project ID) را استخراج کنند9. با قرار دادن این اطلاعات در یک اسکریپت سفارشی مبتنی بر Node.js که از کتابخانه axios برای ارسال درخواست‌های HTTP به آدرس https://api.lovable.dev/projects/<ID_PROJECT>/source-code استفاده می‌کند، می‌توان تمامی فایل‌ها را با حفظ ساختار درختی و محتوای اصلی به صورت مستقیم در یک پوشه محلی ذخیره نمود9. این روش اگرچه رسمی نیست، اما برای مهاجرت‌های اضطراری، تهیه بک‌آپ‌های آفلاین و مهندسی معکوس کدهای تولید شده بسیار کارگشا ارزیابی می‌شود9.

 

روش استخراج کد	مزایای کلیدی	معایب و محدودیت‌ها	پیش‌نیازها
ادغام با GitHub	تاریخچه کامل، سنکرون دوطرفه، اتصال به ابزارهای CI/CD7	وابستگی مداوم پروژه به گیت‌هاب	حساب کاربری GitHub
دانلود مستقیم (ZIP)	سریع، بدون نیاز به دانش کنترل نسخه، دریافت ساختار کامل1	فقدان تاریخچه، عدم همگام‌سازی خودکار در آینده8	اشتراک Business در Lovable1
اسکریپت API کاستوم	دور زدن محدودیت‌های کاربری، کنترل کامل روی ساختار دانلود9	غیررسمی بودن، ریسک تغییر ساختار API توسط پلتفرم	محیط Node.js و استخراج Token9

فاز دوم: آماده‌سازی محیط توسعه و غلبه بر چالش‌های شبکه در ایران

پروژه‌های استخراج شده از Lovable بر پایه زبان‌های مدرن توسعه وب نظیر JavaScript و TypeScript و با بهره‌گیری از محیط زمان‌اجرای Node.js بنا شده‌اند2. در نتیجه، پس از انتقال کدها به محیط سیستم محلی، اولین گام فنی نصب وابستگی‌های پروژه (Dependencies) است که عموماً از طریق اجرای دستور npm install صورت می‌پذیرد10.

با این وجود، تیم‌های توسعه در ایران در این مرحله با یک مانع جدی روبرو می‌شوند: تحریم‌های نرم‌افزاری و محدودیت‌های دسترسی. بسیاری از مخازن اصلی اینترنت از جمله رجیستری npm، سرویس‌های ابری Google و Firebase، مخازن Docker و حتی برخی زیرساخت‌های GitHub، ترافیک ورودی با آدرس IP ایران را مسدود کرده و توسعه‌دهندگان را با خطای معروف ۴۰۳ (Forbidden) مواجه می‌سازند12. در این شرایط، اجرای دستورات نصب بسته‌ها در یک اتصال عادی اینترنتی با شکست روبرو خواهد شد.

استفاده از نرم‌افزارهای تغییر آی‌پی (VPN) سنتی، اگرچه این مشکل را دور می‌زند، اما به دلیل افزایش شدید تاخیر شبکه (Ping)، افت سرعت دانلود و اختلال در دسترسی به منابع داخلی شبکه، رویکرد بهینه‌ای برای فرآیند مداوم برنامه‌نویسی به شمار نمی‌رود. راهکار مهندسی‌شده و استاندارد در این زمینه، استفاده از سرویس‌های پروکسی DNS یا اصطلاحاً «تحریم‌شکن‌های ایرانی» است13. این سرویس‌ها در سطح سیستم‌عامل (یا مودم) تنظیم شده و صرفاً ترافیک مربوط به دامنه‌های تحریمی را از طریق سرورهای واسط خارج از کشور مسیریابی می‌کنند، در حالی که سایر ترافیک داخلی وب و درخواست‌های محلی دست‌نخورده باقی می‌مانند13.

معرفی و تنظیم سرویس‌های DNS تحریم‌شکن

چندین سرویس معتبر داخلی برای رفع این محدودیت‌ها در دسترس توسعه‌دهندگان قرار دارند:

1. سرویس 403.online: این سرویس با تمرکز ویژه بر برطرف کردن نیازهای توسعه‌دهندگان و برنامه‌نویسان توسعه یافته است و دسترسی پایدار به مخازنی نظیر npm، اندروید استودیو، و داکر را بدون افت سرعت فراهم می‌کند12. توسعه‌دهندگان باید آدرس‌های 10.202.10.202 و 10.202.10.102 را در تنظیمات شبکه (IPv4) سیستم خود وارد کنند13.
2. سرویس شکن (Shecan): به عنوان یکی از باسابقه ترین ابزارها در این حوزه، شکن قابلیت دسترسی قانونی و سریع به منابع جهانی را با ظرفیت اتصال تا ۲۰۰ مگابیت بر ثانیه تضمین می‌کند14. آی‌پی‌های تنظیم این سرویس 178.22.122.101 و 185.51.200.1 می‌باشند14.
3. سرویس آنتی‌تحریم هاست‌ایران و سرور.آی‌آر: شرکت‌های ارائه‌دهنده زیرساخت نیز به منظور راحتی کاربران خود، دی‌ان‌اس‌های اختصاصی با آدرس‌هایی نظیر 172.29.0.100 و 172.29.2.100 را ارائه کرده‌اند که برای استفاده روی سیستم‌های محلی و سرورهای اختصاصی بسیار کارآمد هستند15.

پس از اعمال این تنظیمات در کارت شبکه سیستم‌عامل، توسعه‌دهندگان می‌توانند محیط خط فرمان را باز کرده و با اطمینان دستور npm install (یا npm ci برای نصب دقیق و یکپارچه بسته‌ها) را اجرا نمایند10. با اتمام نصب، نوبت به پیکربندی متغیرهای محیطی می‌رسد. پروژه دارای یک فایل الگو به نام .env.example است که باید کپی شده و با نام .env.local در همان دایرکتوری ذخیره گردد8. این فایل دربردارنده مسیرهای اتصال به پایگاه داده، کلیدهای API، و رمزهای عبور است که از افشای آن‌ها در مخازن عمومی جلوگیری می‌کند8. در نهایت، با اجرای دستور npm run dev، سرور توسعه محلی Vite راه‌اندازی شده و اپلیکیشن استخراج‌شده بر روی پورت محلی نظیر http://localhost:3000 بارگذاری می‌شود تا بستر برای توسعه بیشتر یا تست‌های نهایی فراهم گردد10.

فاز سوم: مدیریت معماری بک‌اند و پایگاه داده (Supabase)

همان‌طور که پیش‌تر اشاره شد، پروژه‌های Lovable برای تامین امکانات سمت سرور خود اتکای عمیقی به Supabase دارند. این پلتفرم جایگزین متن‌باز Firebase است که با ارائه دیتابیس رابطه‌ای PostgreSQL، مدیریت کاربران و احراز هویت (GoTrue)، فضای ذخیره‌سازی ابری، رویدادهای بلادرنگ (Realtime) و توابع بدون سرور (Edge Functions)، تمامی نیازمندی‌های بک‌اند را پوشش می‌دهد3. در زمان مهاجرت از محیط Lovable Cloud، تعیین استراتژی برای میزبانی این لایه از معماری از اهمیت بالایی برخوردار است.

در این مرحله دو رویکرد اصلی پیش روی تیم‌های فنی قرار دارد: استفاده از سرویس مدیریت‌شده ابری، و یا استقرار شخصی (Self-Hosting).

رویکرد اول: اتصال به پلتفرم ابری Supabase (Supabase Cloud)

این رویکرد برای نمونه‌های اولیه (MVP)، استارتاپ‌های نوپا، و تیم‌هایی که تمایلی به درگیری با پیچیدگی‌های تیم‌های عملیات توسعه (DevOps) ندارند، ایده‌آل است. در این مدل، سرورهای بک‌اند در بستر بین‌المللی Supabase میزبانی می‌شوند و اپلیکیشن فرانت‌اند به عنوان یک کلاینت به آن‌ها متصل می‌گردد20.

مراحل پیکربندی در این رویکرد به شرح زیر است:

1. ابتدا باید در وب‌سایت اصلی Supabase یک سازمان و یک پروژه جدید ایجاد گردد20.
2. در صورتی که اپلیکیشن قبلاً روی بستر Lovable Cloud دارای داده بوده است، توسعه‌دهندگان باید به داشبورد Lovable مراجعه کرده و از بخش تنظیمات پیشرفته (Advanced settings)، یک خروجی (Export) کامل از پایگاه داده و فایل‌های ذخیره‌سازی (Storage Buckets) تهیه نمایند17. سپس این داده‌ها در پروژه جدید در پلتفرم Supabase بارگذاری (Import) می‌شوند17.
3. برای برقراری ارتباط اپلیکیشن با پایگاه داده جدید، باید آدرس URL پروژه (Project URL) و کلید ناشناس (anon key) از داشبورد Supabase کپی شده و در فایل متغیرهای محیطی .env.local پروژه جایگذاری شود4.
   Code snippet
   VITE_SUPABASE_URL=https://[PROJECT-ID].supabase.co
   VITE_SUPABASE_ANON_KEY=[YOUR_ANON_KEY] 
4. یکی از حیاتی‌ترین تنظیمات امنیتی در این مرحله، فعال‌سازی سیاست‌های امنیت سطح ردیف (Row Level Security یا RLS) در جداول PostgreSQL است4. این سیاست‌ها تعیین می‌کنند که کدام کاربران مجاز به خواندن یا نوشتن در کدام ردیف‌های پایگاه داده هستند4. علاوه بر این، در تنظیمات احراز هویت (Authentication Settings) پلتفرم Supabase، آدرس URL نهایی وب‌سایت (پس از استقرار) باید در بخش مجاز به تغییر مسیر (Allowed Redirect URLs) ثبت گردد تا فرآیند ورود کاربران با خطا مواجه نشود17.

رویکرد دوم: میزبانی شخصی بک‌اند (Self-Hosted Supabase با Docker)

برای سازمان‌های دولتی یا خصوصی بزرگی در ایران که به دلایل امنیتی، الزامات قانونی، و یا کنترل دقیق هزینه‌ها در مصرف بالای پهنای باند تمایلی به استفاده از زیرساخت‌های خارجی ندارند، استقرار Supabase به صورت محلی بر روی سرورهای لینوکس (VPS) داخلی بهترین راه‌حل است19. این پلتفرم ساختار معماری خود را بر پایه مجموعه‌ای از کانتینرهای داکر بنا کرده است که امکان استقرار هماهنگ و ایزوله آن‌ها با استفاده از Docker Compose فراهم است19.

فرآیند استقرار در این سناریو نیازمند تسلط بر مفاهیم مدیریت سرور است:

1. آماده‌سازی سرور: تهیه یک سرور مجازی (لینوکس مبتنی بر توزیع‌هایی نظیر Ubuntu)، اعمال به‌روزرسانی‌های امنیتی سیستم‌عامل، و نصب کامل موتور Docker و ابزار Docker Compose19.
2. دریافت فایل‌های پیکربندی: با استفاده از گیت، مخزن رسمی سوپابیس با دستور git clone –depth 1 https://github.com/supabase/supabase کلون می‌شود22. سپس فایل‌های پیکربندی اصلی واقع در دایرکتوری docker، به ویژه فایل‌های docker-compose.yml و فایل نمونه متغیرهای محیطی .env.example، به یک پوشه امن در سرور منتقل می‌شوند22.
3. تولید کلیدهای رمزنگاری و تنظیم متغیرها: فایل الگو به .env تغییر نام یافته و باز می‌شود. برخلاف رویکرد ابری که کلیدها به صورت خودکار تخصیص می‌یابند، در این روش ادمین سرور موظف است پارامترهای حساس را به صورت دستی تولید و مقداردهی کند22. مهم‌ترین پارامترها شامل رمز عبور اصلی دیتابیس (POSTGRES_PASSWORD)، و تولید کلیدهای ۶۴ یا ۳۲ کاراکتری با استفاده از دستوراتی نظیر openssl rand -base64 48 برای مقادیری مانند SECRET_KEY_BASE (جهت امنیت ارتباطات Realtime)، VAULT_ENC_KEY (برای رمزنگاری تنظیمات) و تولید JWT_SECRET است22. علاوه بر این، متغیرهای مسیردهی مانند SITE_URL، API_EXTERNAL_URL و PUBLIC_REST_URL باید به جای localhost با آدرس IP عمومی سرور یا دامنه‌ای که برای بک‌اند در نظر گرفته شده است جایگزین شوند24.
4. راه‌اندازی کانتینرها: با اجرای فرمان sudo docker compose up -d، داکر شروع به دانلود ایمیج‌های مربوط به سرویس‌های Kong (رابط API)، GoTrue، PostgREST و Studio کرده و شبکه آن‌ها را راه‌اندازی می‌کند19. پس از موفقیت در اجرا، داشبورد مدیریت (Supabase Studio) بر روی پورت 3000 و سرویس دسترسی به API روی پورت 8000 سرور قابل فراخوانی خواهند بود24.
5. نگهداری و پایش: مدیریت یک زیرساخت Self-Hosted نیازمند تدوین روندهای منظم برای پشتیبان‌گیری از داده‌های PostgreSQL، مدیریت فضای ذخیره‌سازی، پایش مصرف دیسک و بررسی دوره‌ای لاگ‌های امنیتی است تا از پایداری سرویس اطمینان حاصل گردد19.

 

متغیر محیطی حیاتی در داکر	عملکرد و نقش در معماری بک‌اند	نحوه تولید استاندارد کلید
POSTGRES_PASSWORD	رمز عبور قدرتمند ادمین پایگاه داده PostgreSQL	رشته متنی پیچیده و طولانی دستی25
JWT_SECRET	امضا و اعتبارسنجی توکن‌های احراز هویت کاربران	اجرای کدهای نودجی‌اس یا OpenSSL25
SECRET_KEY_BASE	رمزنگاری ارتباطات ایمن بین ماژول‌های داخلی و Realtime22	openssl rand -base64 48 [cite: 22]
VAULT_ENC_KEY	کلید مخفی جهت ذخیره رمزنگاری‌شده تنظیمات در Supavisor22	openssl rand -hex 16 (دقیقاً ۳۲ کاراکتر)22
API_EXTERNAL_URL	آدرسی که فرانت‌اند برای فراخوانی APIها به آن متصل می‌شود24	آدرس دامنه یا IP سرور + پورت ۸۰۰۰24

فاز چهارم: سناریوهای استقرار فرانت‌اند (Frontend Deployment)

فایل‌های پروژه‌های مبتنی بر React و ابزار Vite، در حالت توسعه حاوی هزاران ماژول و فایل هستند که برای بارگذاری روی مرورگر کاربران بهینه نیستند. پیش از انتقال به هاست، این فایل‌ها باید فرآیند کامپایل و فشرده‌سازی (Minification) را طی کرده و به مجموعه‌ای از فایل‌های استاتیک HTML، CSS و JS تبدیل شوند. این عملیات با اجرای دستور npm run build در ترمینال سیستم انجام می‌شود11. خروجی این فرآیند پوشه‌ای به نام dist (مخفف Distribution) یا build است که تمامی محتویات مورد نیاز برای اجرای سایت در آن قرار دارد17.

در اکوسیستم ایران، توسعه‌دهندگان می‌توانند از طیف وسیعی از زیرساخت‌های میزبانی بهره‌مند شوند. انتخاب هر بستر نیازمند پیکربندی خاص خود است.

سناریوی اول: استقرار در هاست‌های اشتراکی سی‌پنل (cPanel) یا دایرکت‌ادمین

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

مراحل استقرار در cPanel:

1. آپلود فایل‌های بیلد: ابتدا محتویات درون پوشه dist (دقت شود که خود پوشه dist زیپ نشود، بلکه محتویات داخل آن انتخاب شوند) به یک فایل با فرمت ZIP فشرده می‌گردد26. سپس توسعه‌دهنده با ورود به داشبورد هاست خود و باز کردن File Manager، به دایرکتوری اصلی وب‌سایت یعنی public_html مراجعه می‌کند26. فایل ZIP آپلود شده و گزینه Extract برای خروج فایل‌ها از حالت فشرده انتخاب می‌گردد26.
2. حل چالش مسیریابی سمت کلاینت (SPA Routing): برنامه‌های تولید شده توسط Lovable در معماری به نام Single Page Application (SPA) توسعه می‌یابند. در این الگو، زمانی که کاربر روی لینک‌های داخلی سایت کلیک می‌کند، صفحات بدون رفرش شدن مرورگر و توسط جاوا اسکریپت (به کمک ابزارهایی نظیر React Router) بارگذاری و آدرس مرورگر تغییر می‌کند17. مشکل زمانی بروز می‌کند که کاربر مستقیماً آدرسی مانند domain.com/about-us را در نوار آدرس تایپ کرده یا صفحه را Refresh می‌کند. وب‌سرور آپاچی مستقر در هاست اشتراکی، به دنبال پوشه‌ای به نام about-us در سرور می‌گردد و از آنجا که این محتوا صرفاً در فایل‌های جاوا اسکریپت تعریف شده و به صورت فیزیکی در سرور وجود ندارد، وب‌سرور خطای مهلک ۴۰۴ (Not Found) را به کاربر نمایش می‌دهد17.
3. تنظیم فایل .htaccess برای بازنویسی آدرس‌ها: برای رفع این معضل، وب‌سرور باید پیکربندی شود تا در مواجهه با هر درخواستی که منجر به یافتن فایل واقعی نمی‌شود، درخواست را به فایل اصلی index.html هدایت کند تا موتور جاوا اسکریپتی اپلیکیشن مسیر را تفسیر نماید26. بدین منظور، در محیط File Manager سی‌پنل، باید از بخش تنظیمات (Settings) در بالای صفحه، تیک گزینه “Show Hidden Files (dotfiles)” فعال شود تا فایل‌های مخفی سرور پدیدار شوند11. سپس یک فایل متنی با نام دقیق .htaccess در مسیر public_html ایجاد می‌گردد (در صورتی که از قبل وجود ندارد)26. با باز کردن ویرایشگر متنی این فایل (Edit)، کدهای اساسی زیر که دستورات ماژول mod_rewrite آپاچی هستند، در آن درج شده و فایل ذخیره می‌گردد11:

 

Apache

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.html$ – [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-l
  RewriteRule . /index.html [L]
</IfModule>

 

این بلوک کد به صورت منطقی بررسی می‌کند که اگر درخواست ارسال شده مربوط به یک فایل (-f)، دایرکتوری (-d) یا لینک نمادین (-l) واقعی نبود، ترافیک بدون تغییر مسیر ظاهری کاربر به فایل index.html ریدایرکت شود11. با این اقدام، عملکرد سایت‌های ری‌اکت در هاست‌های سنتی تثبیت می‌گردد. همچنین در برخی تنظیمات خاص، افزودن تگ <base href=”/”> در بخش <head> فایل index.html برای حل مشکل آدرس‌دهی نسبی فایل‌های استاتیک توصیه می‌شود26.

سناریوی دوم: استقرار در پلتفرم‌های ابری ایرانی (لیارا PaaS)

برای تیم‌هایی که قصد دارند درگیر پیچیدگی‌های تنظیم وب‌سرور نشوند و هم‌زمان از زیرساخت‌های پایدار، مقیاس‌پذیر و با زمان پاسخگویی (Ping) بسیار پایین برای کاربران ایرانی بهره‌مند گردند، استفاده از پلتفرم‌های ارائه‌دهنده سرویس به عنوان بستر (PaaS) نظیر پلتفرم ابری لیارا (Liara)، یک راه‌حل انقلابی است33. لیارا به صورت بومی از پلتفرم‌های React و فریم‌ورک‌های مدرن پشتیبانی می‌کند34.

مراحل استقرار بهینه در لیارا:

1. پاکسازی کد منبع: بر خلاف هاست‌های اشتراکی که نسخه بیلد شده آپلود می‌شد، در لیارا سورس‌کد اصلی آپلود می‌گردد. پیش از آپلود، حذف پوشه‌های سنگین و حجیمی نظیر node_modules و dist الزامی است، چرا که سیستم هوشمند لیارا در فرآیند استقرار خود این وابستگی‌ها را نصب خواهد کرد34.
2. پیکربندی فایل package.json: اطمینان از وجود ساختار استاندارد اسکریپت‌ها در این فایل بسیار مهم است. برای پروژه‌های Lovable که با Vite توسعه یافته‌اند، باید دستورات “start”: “vite preview” و “build”: “vite build” در فایل تنظیم شده باشند35. همچنین در فایل vite.config.js، مسیر خروجی بیلد باید به درستی مشخص گردد35.
3. ایجاد و بارگذاری برنامه: توسعه‌دهندگان می‌توانند وارد داشبورد گرافیکی لیارا (Liara Console) شده و پس از ایجاد یک برنامه با پلتفرم React و تعیین منابع سخت‌افزاری مورد نیاز (حافظه رم و پردازنده)، پوشه فشرده‌شده پروژه را با تکنیک کشیدن و رها کردن (Drag and Drop) در پنل بارگذاری کنند35. در روشی حرفه‌ای‌تر، برنامه‌نویسان با استفاده از رابط خط فرمان اختصاصی لیارا (Liara CLI)، می‌توانند کدهای خود را مستقیماً از محیط ترمینال و با دستوراتی ساده به سرور پوش کنند35. پس از آپلود، پلتفرم به صورت خودکار سرور را پیکربندی کرده، فرآیند نصب وابستگی‌ها و بیلد را اجرا نموده، تنظیمات Nginx داخلی برای رفع مشکل SPA Routing را اعمال کرده و در نهایت وب‌اپلیکیشن را روی دامنه‌های موقتی نظیر liara.run بارگذاری می‌کند تا آماده اتصال به دامنه اصلی گردد33. مزیت اصلی این پلتفرم، اعمال تغییرات و به‌روزرسانی‌ها بدون حتی یک ثانیه قطعی (Zero Downtime Deployment) است33.

سناریوی سوم: استقرار در سرور مجازی لینوکس (VPS مجهز به Nginx)

برای استارتاپ‌های در حال رشد، اپلیکیشن‌های پرترافیک تجاری، و پروژه‌هایی که نیازمند کنترل کامل و سطح پایین (Low-level) روی منابع سیستم عامل و وب‌سرور هستند، تهیه یک سرور مجازی لینوکس (Ubuntu) و راه‌اندازی دستی بستر، حرفه‌ای‌ترین مسیر است.

1. انتقال ایمن فایل‌ها: در این روش نیز ابتدا فرآیند npm run build در سیستم توسعه‌دهنده انجام می‌شود17. برای انتقال محتویات پوشه dist به سرور لینوکس، استفاده از پروتکل‌های انتقال امن فایل نظیر SCP (scp -r dist/* user@your-server:/var/www/html/) یا نرم‌افزارهای کلاینت FTP مانند FileZilla بهترین رویکرد است17.
2. پیکربندی حرفه‌ای وب‌سرور Nginx: انجین‌ایکس (Nginx) قدرتمندترین و سبک‌ترین وب‌سرور مدرن است که معماری رویدادمحور آن، مدیریت همزمان هزاران درخواست را تضمین می‌کند. پس از نصب این نرم‌افزار، توسعه‌دهندگان باید یک فایل پیکربندی برای سایت در مسیر /etc/nginx/sites-available/ ایجاد کنند17. برای خدمت‌رسانی به فایل‌های استاتیک پروژه React و رفع مشکل هدایت آدرس‌ها (مشابه کاری که .htaccess در آپاچی انجام می‌داد)، بلوک پیکربندی (Server Block) به شکل زیر تنظیم می‌گردد17:

 

Nginx

server {
    listen 80;
    server_name your-domain.com www.your-domain.com;
    root /var/www/html;
    index index.html;

    # تنظیمات پیشرفته کش برای افزایش سرعت بارگذاری فایل‌های استاتیک
    location /assets/ {
        expires 1y;
        add_header Cache-Control “public, immutable”;
    }

    # حل مشکل مسیریابی کلاینت‌ساید در اپلیکیشن‌های تک‌صفحه‌ای (SPA)
    location / {
        try_files $uri $uri/ /index.html;
    }
}

 

در این بلوک، دستور try_files به صورت سلسله‌مراتبی بررسی می‌کند که آیا فایل درخواستی وجود دارد یا خیر و در صورت عدم وجود، کنترل را با ارسال index.html به روتر فرانت‌اند می‌سپارد17. این تنظیمات تضمین‌کننده عملکرد یکپارچه اپلیکیشن روی معماری لینوکسی است.

 

ویژگی بررسی‌شده	هاست اشتراکی لینوکس (cPanel)	پلتفرم ابری ایرانی (PaaS نظیر لیارا)	سرور مجازی اختصاصی (VPS با Nginx)
میزان پیچیدگی راه‌اندازی	پایین (تنها آپلود و ساخت فایل htaccess)26	بسیار پایین (خودکارسازی فرآیند ساخت)35	بالا (نیازمند تسلط بر خط فرمان لینوکس)17
دسترسی به ریشه و سفارشی‌سازی	بسیار محدود	متوسط (از طریق متغیرهای محیطی)36	دسترسی کامل و نامحدود (Root)37
هزینه تقریبی نگهداری	بسیار اقتصادی و مقرون‌به‌صرفه	اقتصادی تا متوسط (بر اساس پلن انتخابی)	بالا (نیازمند دانش فنی نگهداری سرور)
موارد استفاده مناسب	پروژه‌های شخصی، پورتفولیو و تست‌های اولیه	استارتاپ‌ها، برنامه‌های مقیاس‌پذیر و چابک	پروژه‌های کلان، ترافیک انبوه و معماری پیچیده

فاز پنجم: پیکربندی دامنه اختصاصی و معماری امنیتی کلودفلر (Cloudflare)

برای تبدیل یک پروژه کدنویسی‌شده به یک محصول تجاری معتبر، اتصال اپلیکیشن به یک دامنه اختصاصی (اعم از دامنه‌های ملی با پسوند .ir یا پسوندهای بین‌المللی نظیر .com) ضروری است. در معماری مدرن وب، استقرار مستقیم دامنه روی سرور میزبان به دلایل امنیتی و سرعت توصیه نمی‌شود؛ در عوض، استفاده از شبکه‌های توزیع محتوا (CDN) به عنوان یک سپر میانی به یک الزام تبدیل شده است. پلتفرم کلودفلر (Cloudflare) با توزیع فایل‌های استاتیک سایت در سرورهای لبه (Edge Nodes) خود در سراسر جهان، نقش بسزایی در کاهش فاکتور زمان پاسخگویی (TTFB)، بهینه‌سازی حرفه‌ای برای موتورهای جستجو (SEO) و آماده‌سازی محتوا برای موتورهای جستجوی مبتنی بر هوش مصنوعی (AI Search Engines) ایفا می‌کند38. علاوه بر این، سیستم‌های حفاظتی کلودفلر، سرورها را در برابر حملات توزیع‌شده محروم‌سازی از سرویس (DDoS) مصون می‌دارند39.

فرآیند اتصال دامنه به کلودفلر به صورت زیر تدوین شده است:

1. ثبت‌نام و افزودن سایت: مالکین دامنه با ورود به پرتال کلودفلر، روی دکمه “Add a site” کلیک کرده و نام دامنه بدون پیشوندهای اضافی (مانند example.ir) را وارد می‌کنند38.
2. انتخاب پلن: کلودفلر طرح‌های متفاوتی را پیشنهاد می‌دهد. برای اکثریت قریب به اتفاق پروژه‌ها، انتخاب پلن کاملاً رایگان (Free Plan) تمامی امکانات اساسی اعم از گواهینامه SSL، فایروال ضد DDoS، و کشینگ جهانی را به خوبی تامین می‌کند39.
3. اسکن رکوردهای DNS: کلودفلر به صورت هوشمند رکوردهای DNS فعلی سرور (مانند رکوردهای A برای نگاشت نام به IP سرور و CNAME برای زیردامنه‌ها) را جستجو و شناسایی می‌کند40. در این قسمت، در مجاورت هر رکورد آیکون ابری وجود دارد؛ فعال بودن آن (ابر نارنجی رنگ) نشانگر عبور ترافیک از بستر شبکه توزیع محتوای کلودفلر است و خاموش بودن آن (ابر خاکستری)، بیانگر اتصال مستقیم و بی‌واسطه کاربر به سرور اصلی است40. به صورت پیش‌فرض رکوردهای اصلی وب باید روی وضعیت نارنجی تنظیم شوند40.
4. تنظیم نیم‌سرورها (Nameservers): در گام نهایی، کلودفلر دو آدرس نیم‌سرور اختصاصی جدید تولید می‌کند. مالکین دامنه باید به کنترل‌پنل ثبت‌کننده دامنه خود (به عنوان مثال سامانه ایرنیک برای دامنه‌های ملی) مراجعه نموده و دی‌ان‌اس‌های قبلی را حذف و با دی‌ان‌اس‌های جدید جایگزین نمایند39. زمان لازم برای انتشار تغییرات در سراسر اینترنت و اتصال قطعی برای دامنه‌های بین‌المللی معمولاً چند دقیقه، و برای دامنه‌های .ir ممکن است بین ۲۴ تا ۷۲ ساعت به طول بینجامد38.
5. ارتقای امنیت با گواهینامه SSL/TLS: پس از تغییر وضعیت دامنه به حالت فعال (Active)، تنظیم سطح رمزنگاری ضروری است. در منوی تنظیمات SSL کلودفلر، چنانچه سرور میزبان فاقد گواهینامه امنیتی نصب شده است، باید از حالت “Flexible” استفاده شود تا کلودفلر ترافیک بین کاربر و خود را رمزنگاری کند43. اما برای تامین حداکثر سطح امنیت سایبری، نصب یک گواهینامه در سرور اصلی و انتخاب حالت “Full” یا “Strict” توصیه می‌گردد تا ترافیک در طول کل مسیر مبدأ تا مقصد به صورت کامل رمزنگاری شود41.

فاز ششم: نقش حیاتی دستیاران هوش مصنوعی و معرفی «فروشگاه هوش مصنوعی ای آی کارت»

انتقال معماری یک نرم‌افزار، تنظیمات ظریف سرورهای لینوکس، نوشتن قوانین ریدایرکت، عیب‌یابی (Debugging) خطاهای وب‌سرور مانند خطای کلافه‌کننده CORS یا محدودیت‌های امنیتی، و پیاده‌سازی قواعد سطح دسترسی در پایگاه‌های داده‌ای نظیر تنظیمات RLS در Supabase، فرآیندهای بسیار پیچیده‌ای هستند که حتی برای توسعه‌دهندگان مجرب و مهندسان ارشد نیز زمان‌بر و چالش‌برانگیز محسوب می‌شوند4. در فضای مدرن مهندسی نرم‌افزار، استفاده از دستیاران برنامه‌نویسی مبتنی بر هوش مصنوعی برای سرعت بخشیدن به فرآیند توسعه، رفع سریع خطاها (بدون ساعت‌ها جستجو در تالارهای گفتگو)، و ارائه قطعه‌کدهای پیکربندی دقیق، به یک استاندارد جدایی‌ناپذیر تبدیل شده است21. مدل‌های پیشرفته زبانی (LLMs) قادرند با تجزیه و تحلیل سریع لاگ‌های سیستم، راهکارهای مهندسی‌شده و کدهای رفع اشکال را پیشنهاد دهند.

با این حال، با توجه به چالش‌های پرداخت ارزی و محدودیت دسترسی مستقیم کاربران و توسعه‌دهندگان ایرانی به خدمات پریمیوم بین‌المللی، تهیه حساب‌های کاربری امن و پایدار این مدل‌ها چالشی مداوم بوده است. در این تقاطع استراتژیک، «فروشگاه هوش مصنوعی ای آی کارت» (AI Card) به عنوان یکی از پلتفرم‌های پیشگام و خوش‌نام داخلی وارد عمل شده است تا این موانع را از سر راه متخصصین فناوری اطلاعات بردارد45.

این فروشگاه دسترسی به جامع‌ترین سبد ابزارهای طراز اول جهانی را با ضمانت و پشتیبانی کامل فراهم می‌آورد:

• اشتراک‌های تخصصی برنامه‌نویسی و حل مسئله: دسترسی بدون قطعی به اکانت‌های ChatGPT Plus (مجهز به قابلیت‌های تحلیل کدهای سرور و توسعه ساختارهای پایگاه داده)، Claude (دستیار ایده‌آل برای پردازش مستندات بلند سرورها و کانفیگ‌های پیچیده زیرساختی) و اشتراک گوگل جمینای پیشرفته (Gemini Advanced) که به برنامه‌نویسان قدرت پردازش و عیب‌یابی عمیقی می‌بخشد45.
• ابزارهای تحقیقاتی و ارائه (Presentation): پلتفرم‌هایی نظیر Perplexity Pro که به عنوان موتورهای جستجوی مبتنی بر هوش مصنوعی عمل کرده و امکان تحقیقات عمیق پیرامون معماری‌های نرم‌افزاری را تسهیل می‌بخشند، در کنار ابزارهایی مانند Gamma برای خلق پرزنتیشن‌ها و مستندات بصری خیره‌کننده از نتایج پروژه‌ها با کمترین زمان ممکن45.

وجه تمایز کلیدی و مزیت رقابتی «فروشگاه هوش مصنوعی ای آی کارت»، تمرکز بر ارائه اکانت‌های اصطلاحاً “فول‌اکتیو” است45. برخلاف برخی ارائه‌دهندگان که اکانت‌ها را با محدودیت‌های پنهان عرضه می‌کنند، خدمات این فروشگاه امکان استفاده از تمامی ظرفیت‌ها و ابزارهای هوش مصنوعی را برای مشتریان فراهم می‌سازد45. این محصولات به صورت حساب‌های قانونی آماده به همراه کد بک‌آپ عرضه شده و حتی امکان فعال‌سازی ایمن بر روی آدرس‌های جیمیل (Gmail) شخصی کاربران با ضمانت کارکرد و پشتیبانی سریع وجود دارد45. توسعه‌دهندگانی که پروژه‌های مدرن خود را از پلتفرم‌هایی نظیر Lovable به زیرساخت‌های شخصی مهاجرت می‌دهند، با سرمایه‌گذاری اندک و تهیه ابزارهای هوش مصنوعی قدرتمند از «ای آی کارت»، می‌توانند بهره‌وری تیم‌های خود را به شدت افزایش داده و سرعت رفع خطاهای احتمالی در زمان استقرار روی سرورهای ابری، داکر یا شبکه‌های کلودفلر را به سطح بی‌سابقه‌ای ارتقا دهند.

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

این فرآیند با استخراج ایمن پایگاه کد از طریق گیت‌هاب یا فایل فشرده آغاز شده و با دور زدن هوشمندانه تحریم‌های اینترنتی با به‌کارگیری سرویس‌های رفع تحریم داخلی (مانند 403.online یا شکن) جهت نصب وابستگی‌های نرم‌افزاری ادامه می‌یابد. در گام‌های بعدی، تصمیم‌گیری پیرامون معماری سرویس‌های بک‌اند و انتخاب میان اتصال به Supabase Cloud یا استقرار شخصی (Self-hosted) آن روی داکر، نقش اساسی در هزینه‌ها و پایداری بلندمدت پروژه ایفا می‌کند. استقرار امن و اصولی کدهای فرانت‌اند در محیط‌های اقتصادی چون هاست سی‌پنل (همراه با تنظیمات حساس .htaccess برای مدیریت مسیریابی)، پلتفرم‌های ابری چابک مانند لیارا و یا سرورهای مجازی لینوکس، تنوع انتخاب را برای تمامی بودجه‌ها و نیازها فراهم می‌سازد.

افزون بر این، اتصال پروژه به سرویس‌های CDN نظیر کلودفلر، ارکان اساسی امنیت، سرعت لود و سئوی سایت را تضمین می‌کند. در تمام طول این مسیر پر پیچ‌وخم، بهره‌مندی مداوم از قابلیت‌های آخرین نسل‌های هوش مصنوعی با استفاده از مراجع معتبر و پشتیبان‌هایی چون «فروشگاه هوش مصنوعی ای آی کارت» می‌تواند به مثابه حضور یک معمار ارشد نرم‌افزار در کنار تیم‌های توسعه عمل کند و موانع استقرار، کدنویسی و انتقال زیرساخت را با کمترین اصطکاک برطرف نماید. این ترکیب قدرتمند از مالکیت مطلق زیرساخت و دستیاری هوشمند، ضامن مقیاس‌پذیری، استقلال و موفقیت بلندمدت محصولات توسعه‌یافته در زیست‌بوم پویای فناوری اطلاعات خواهد بود.