نصب و استقرار روی هاست

بازگشت به فهرست

این راهنما نحوه آپلود نسخه HTML قالب Novira روی هاست اشتراکی (cPanel، DirectAdmin، Plesk) یا سرور اختصاصی را توضیح می‌دهد.

اگر نسخه Next.js را مستقر می‌کنید، به فصل ۱۴: استقرار نسخه Next.js بروید. آن نسخه یک مرحله بیلد دارد و نکته مهمی درباره نصب در زیرپوشه.

پیش‌نیازهای هاست

• پشتیبانی از فایل‌های HTML استاتیک
• Apache یا Nginx (هر دو مناسب هستند)
• فضای دیسک: حداقل ۵۰ مگابایت (با تصاویر دمو)
• SSL (HTTPS) — strongly recommended

مرحله ۱ — آماده‌سازی فایل‌ها

قبل از آپلود، این موارد را آپلود نکنید (حجم اضافی و غیرضروری):

• node_modules/
• .git/ (در صورت وجود)
• .cursor/
• theme.zip (آرشیو فشرده)

حتماً آپلود کنید:

• همه فایل‌های *.html در ریشه
• پوشه کامل assets/
• پوشه _profile-mains/ (در صورت استفاده از اسنیپت‌های پروفایل)
• پوشه help/ (اختیاری — برای مستندات روی سرور)

مرحله ۲ — انتخاب مسیر نصب

نصب در ریشه دامنه (پیشنهادی)

فایل‌ها را در public_html یا www یا httpdocs قرار دهید:

public_html/
├── index.html      ← صفحه اصلی: https://example.com/
├── demo.html
├── assets/
└── ...

نصب در زیرپوشه

مثلاً public_html/shop/:

public_html/shop/
├── index.html      ← https://example.com/shop/
└── assets/

لینک‌های نسبی قالب (assets/css/...) بدون تغییر کار می‌کنند، چون نسبت به همان پوشه HTML هستند.

مرحله ۳ — آپلود با cPanel File Manager

1. وارد cPanel شوید
2. File Manager → public_html
3. Upload → فایل‌های ZIP را آپلود کنید
4. روی ZIP راست‌کلیک → Extract
5. مطمئن شوید index.html مستقیماً در public_html است (نه داخل پوشه تودرتو اضافی)

مرحله ۴ — آپلود با FTP (FileZilla)

1. به public_html متصل شوید
2. کل محتوای قالب را از سمت چپ (لوکال) به راست (سرور) بکشید
3. منتظر اتمام آپلود بمانید (تصاویر ممکن است چند دقیقه طول بکشد)

مرحله ۵ — تنظیم SSL (HTTPS)

در cPanel:

1. SSL/TLS Status یا Let's Encrypt
2. دامنه را انتخاب کنید → Issue یا Install
3. پس از فعال‌سازی، سایت را با https:// باز کنید

مرحله ۶ — صفحه پیش‌فرض

Apache معمولاً index.html را به‌عنوان صفحه پیش‌فرض می‌شناسد. اگر index.html باز نمی‌شود:

• فایل examples/.htaccess را در public_html کپی کنید
• یا در cPanel → Indexes → Directory Index را بررسی کنید

مرحله ۷ — چک‌لیست پس از استقرار

فایل .htaccess (اختیاری)

نمونه آماده در help/examples/.htaccess:

• تنظیم DirectoryIndex index.html
• فشرده‌سازی gzip
• Cache برای فایل‌های استاتیک

# کپی از help/examples/.htaccess به public_html/.htaccess

نکات هاست ایرانی

• اگر Google Fonts فیلتر است، فونت Vazirmatn را محلی هاست کنید → شخصی‌سازی
• برای سرعت، از CDN هاست یا Cloudflare استفاده کنید
• assets/images/ را فشرده نگه دارید؛ از آپلود مجدد تصاویر بزرگ غیرضروری خودداری کنید

استقرار روی Nginx

اگر سرور Nginx دارید، یک بلوک ساده:

server {
    listen 80;
    server_name example.com;
    root /var/www/novira;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~* \.(css|js|png|jpg|jpeg|gif|webp|svg|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }
}

به‌روزرسانی قالب

1. از نسخه فعلی روی سرور بکاپ بگیرید
2. تغییرات شخصی‌سازی‌شده را یادداشت کنید
3. فایل‌های جدید را آپلود کنید (یا فقط فایل‌های تغییرکرده)
4. Cache مرورگر و CDN را پاک کنید

گام بعدی

• ساختار پوشه‌ها
• عیب‌یابی
• استقرار نسخه Next.js