📁 آموزش کاربردی cPanel

آموزش File Manager در cPanel؛ مدیریت فایل‌ها، آپلود سایت و رفع خطاهای رایج

File Manager در cPanel یکی از مهم‌ترین ابزارهای مدیریت هاست است. با این بخش می‌توانید بدون FTP و بدون SSH فایل‌های سایت را آپلود، ویرایش، حذف، فشرده‌سازی، استخراج و مدیریت کنید. در این آموزش، File Manager را از پایه تا نکات حرفه‌ای یاد می‌گیرید؛ همراه با خطاهای رایج، نکات امنیتی، مسیرهای مهم مثل public_html و پاسخ به سوالاتی که معمولاً کاربران هنگام کار با فایل منیجر دارند.

این آموزش برای چه کسانی مناسب است؟

  • کاربرانی که می‌خواهند فایل سایت وردپرسی یا HTML خود را روی هاست cPanel آپلود کنند.
  • افرادی که می‌خواهند فایل‌هایی مثل wp-config.php، .htaccess یا index.php را پیدا و ویرایش کنند.
  • کاربرانی که سایتشان خطای 403، 404 یا 500 می‌دهد و می‌خواهند فایل‌ها و permissionها را بررسی کنند.
  • افرادی که می‌خواهند بدون FTP و SSH، فایل ZIP سایت را آپلود و Extract کنند.

File Manager در cPanel چیست؟

File Manager یا فایل منیجر، ابزار مدیریت فایل داخل cPanel است. این بخش مثل یک مدیر فایل آنلاین عمل می‌کند و اجازه می‌دهد فایل‌ها و پوشه‌های هاست را ببینید، فایل جدید بسازید، فایل را آپلود کنید، پوشه بسازید، فایل ZIP را Extract کنید، فایل‌ها را Compress کنید، نام فایل‌ها را تغییر دهید، permission تنظیم کنید و بعضی فایل‌ها را مستقیم ویرایش کنید.

File Manager برای کارهای سریع و روزمره عالی است؛ اما برای پروژه‌های بزرگ، انتقال تعداد زیادی فایل یا آپلود فایل‌های خیلی حجیم، گاهی FTP، SFTP یا SSH انتخاب بهتر و پایدارتر است.

قبل از ویرایش فایل مهم، یک کپی بگیرید

اگر فایل‌هایی مثل .htaccess، wp-config.php، functions.php یا فایل‌های اصلی قالب وردپرس را اشتباه ویرایش کنید، ممکن است سایت با خطای 500 یا صفحه سفید روبه‌رو شود. قبل از هر تغییر، همان فایل را Copy یا Download کنید.

نحوه ورود به File Manager در cPanel

وارد cPanel شویدبا اطلاعات هاست وارد پنل cPanel شوید. معمولاً آدرس ورود به شکل yourdomain.com/cpanel یا پورت cPanel است.
بخش Files را پیدا کنیددر صفحه اصلی cPanel، بخش Files را پیدا کنید.
روی File Manager کلیک کنیدبعد از ورود، ساختار پوشه‌های هاست نمایش داده می‌شود.
مسیر درست را انتخاب کنیدبرای سایت اصلی معمولاً باید وارد public_html شوید. برای Addon Domain یا Subdomain ممکن است مسیر متفاوت باشد.

اگر آیکون File Manager را نمی‌بینید، ممکن است مدیر هاست این قابلیت را در Feature Manager غیرفعال کرده باشد یا سطح دسترسی سرویس شما محدود باشد.

public_html چیست و فایل‌های سایت کجا هستند؟

در بیشتر هاست‌های cPanel، فایل‌های سایت اصلی در پوشه public_html قرار می‌گیرند. هر فایلی که داخل این پوشه باشد، بسته به تنظیمات وب‌سرور می‌تواند از طریق مرورگر در دسترس باشد.

مسیر کاربرد نکته مهم
/home/username Home Directory اکانت همه چیز نباید داخل وب قابل مشاهده باشد.
public_html ریشه سایت اصلی فایل index.php یا index.html معمولاً اینجاست.
public_ftp فایل‌های FTP عمومی برای سایت اصلی معمولاً استفاده نمی‌شود.
mail فایل‌های ایمیل بدون آگاهی فایل‌های این بخش را حذف نکنید.
logs لاگ‌های اکانت برای عیب‌یابی مفید است.

فایل بکاپ را داخل public_html رها نکنید

اگر فایل‌هایی مثل backup.zip، site-full.zip یا خروجی دیتابیس را داخل public_html بگذارید، ممکن است با لینک مستقیم قابل دانلود باشد. بعد از Extract یا انتقال، فایل ZIP و بکاپ را حذف یا به مسیر امن خارج از public_html منتقل کنید.

نمایش فایل‌های مخفی مثل .htaccess

بسیاری از فایل‌های مهم با نقطه شروع می‌شوند و به همین دلیل مخفی هستند؛ مثل .htaccess، .user.ini یا فایل‌های تنظیمات بعضی ابزارها. اگر این فایل‌ها را نمی‌بینید، از گزینه Settings در File Manager، نمایش Hidden Files یا dotfiles را فعال کنید.

  • .htaccess برای rewrite، ریدایرکت، تنظیمات وردپرس و بعضی قوانین امنیتی استفاده می‌شود.
  • .user.ini گاهی برای تنظیمات PHP در بعضی محیط‌ها استفاده می‌شود.
  • فایل‌های مخفی را بدون شناخت حذف نکنید؛ چون ممکن است سایت یا برنامه شما به آن‌ها وابسته باشد.

آپلود فایل، ZIP کردن و Extract در File Manager

یکی از رایج‌ترین کارها در File Manager، آپلود فایل ZIP قالب، افزونه، بکاپ یا فایل‌های سایت است. روش بهتر برای انتقال تعداد زیادی فایل این است که ابتدا آن‌ها را روی سیستم خود به ZIP تبدیل کنید، سپس همان ZIP را در مسیر درست آپلود و در هاست Extract کنید.

وارد مسیر درست شویدبرای سایت اصلی معمولاً public_html را باز کنید.
Upload را بزنیدفایل ZIP یا فایل موردنظر را انتخاب و آپلود کنید.
فایل ZIP را انتخاب کنیدبعد از پایان آپلود، به File Manager برگردید و فایل ZIP را انتخاب کنید.
Extract را اجرا کنیدمسیر مقصد را بررسی کنید تا فایل‌ها اشتباهی داخل پوشه اضافه مثل site/site/files استخراج نشوند.
بعد از Extract بررسی و پاک‌سازی کنیداگر همه چیز درست بود، فایل ZIP را از مسیر عمومی حذف کنید.

چرا آپلود پوشه مستقیم انجام نمی‌شود؟

در File Manager معمولاً آپلود مستقیم Folder مثل سیستم‌عامل انجام نمی‌شود. راه بهتر این است که پوشه را ZIP کنید، فایل ZIP را آپلود کنید و سپس Extract بزنید.

ویرایش فایل‌ها در File Manager؛ Edit یا Code Editor؟

برای ویرایش فایل‌های متنی می‌توانید فایل را انتخاب کنید و گزینه Edit را بزنید. برای فایل‌های PHP، CSS، JS و HTML، بهتر است با دقت بالا و بعد از بکاپ این کار را انجام دهید. یک کاراکتر اشتباه در فایل PHP می‌تواند باعث خطای 500 یا صفحه سفید شود.

  • برای تغییرات کوچک مثل اصلاح یک خط در .htaccess یا wp-config.php مناسب است.
  • برای فایل‌های بزرگ یا تغییرات زیاد، بهتر است فایل را دانلود و با ویرایشگر حرفه‌ای مثل VS Code اصلاح کنید.
  • اگر متن فارسی یا کاراکترهای عجیب دیدید، Encoding را اشتباه ذخیره نکنید.
  • بعد از ذخیره فایل، سایت را در تب جدید تست کنید و در صورت خطا سریع نسخه قبلی را برگردانید.

سطح دسترسی فایل‌ها و پوشه‌ها در cPanel

Permissions مشخص می‌کند چه کسی اجازه خواندن، نوشتن یا اجرای فایل را دارد. تنظیم اشتباه permission یکی از دلایل رایج خطای 403، مشکل آپلود، اجرا نشدن اسکریپت و حتی خطر امنیتی است.

مورد مقدار رایج توضیح
فایل‌های معمولی 644 برای بیشتر فایل‌های PHP، HTML، CSS و JS مناسب است.
پوشه‌ها 755 برای ورود و خواندن پوشه توسط وب‌سرور کاربرد دارد.
فایل‌های حساس 600 یا محدودتر در بعضی محیط‌ها بسته به سرور و مالکیت فایل، برای فایل‌های حساس بررسی شود.
Permission خطرناک 777 تا حد امکان استفاده نشود؛ می‌تواند خطر امنیتی ایجاد کند.

آیا 777 مشکل را حل می‌کند؟

گاهی کاربران برای رفع خطا، پوشه یا فایل را 777 می‌کنند. این کار شاید موقتاً خطا را پنهان کند، اما از نظر امنیتی خطرناک است. اول مالکیت فایل، مسیر، تنظیمات PHP و لاگ خطا را بررسی کنید.

حذف فایل، Trash و اهمیت بکاپ

وقتی در File Manager فایلی را حذف می‌کنید، بسته به تنظیمات، ممکن است ابتدا به Trash منتقل شود. تا وقتی Trash را خالی نکرده‌اید، احتمال بازیابی وجود دارد. با این حال، به Trash به‌عنوان بکاپ مطمئن اعتماد نکنید.

  • قبل از حذف پوشه‌های بزرگ مثل wp-content، حتماً بکاپ بگیرید.
  • اگر فایل را اشتباه حذف کردید، گزینه View Trash را بررسی کنید.
  • برای تغییرات مهم، یک ZIP از فایل یا پوشه بسازید و خارج از public_html نگه دارید.
  • Trash پر می‌تواند فضای هاست را مصرف کند؛ هرچند نباید بدون بررسی آن را خالی کنید.

مشکلات رایج File Manager در cPanel و راه‌حل‌ها

مشکل ۱: فایل .htaccess را نمی‌بینم

از Settings گزینه نمایش فایل‌های مخفی یا Show Hidden Files را فعال کنید. اگر باز هم وجود ندارد، ممکن است فایل ساخته نشده باشد یا در مسیر دیگری باشید.

مشکل ۲: بعد از ویرایش فایل، سایت خطای 500 می‌دهد

احتمالاً در فایل PHP، .htaccess یا تنظیمات سایت اشتباه syntax یا قانون ناسازگار وارد شده است. فایل را به نسخه قبلی برگردانید، Error Log را بررسی کنید و تغییر را مرحله‌ای انجام دهید.

مشکل ۳: فایل ZIP آپلود می‌شود ولی Extract خطا می‌دهد

ممکن است فایل ناقص آپلود شده باشد، فضای هاست کافی نباشد، فرمت آرشیو پشتیبانی نشود یا ابزار ZIP روی سرور مشکل داشته باشد. یک بار فایل را دوباره آپلود کنید، فضای هاست را بررسی کنید و اگر فایل خیلی بزرگ است از FTP/SSH کمک بگیرید.

مشکل ۴: بعد از آپلود سایت، صفحه Index of نمایش داده می‌شود

معمولاً فایل اصلی سایت مثل index.php یا index.html در مسیر درست نیست. بررسی کنید فایل‌ها داخل پوشه اضافه Extract نشده باشند؛ مثلاً public_html/site/index.php به جای public_html/index.php.

مشکل ۵: تغییر permission مشکل را حل نکرد

همیشه مشکل از permission نیست. ممکن است مالکیت فایل، تنظیمات PHP، قوانین امنیتی، محدودیت هاست یا خطای برنامه باعث مشکل باشد. قبل از 777 کردن فایل‌ها، Error Log و مسیر فایل را بررسی کنید.

مشکل ۶: فایل ویرایش‌شده فارسی را خراب نشان می‌دهد

احتمالاً Encoding اشتباه انتخاب شده یا فایل با کاراکترهای نامناسب ذخیره شده است. اگر متن عجیب و نامفهوم دیدید، فایل را ذخیره نکنید و با encoding درست مثل UTF-8 دوباره باز کنید.

مشکل ۷: گزینه‌های Upload یا File Manager وجود ندارد

ممکن است این قابلیت توسط مدیر هاست غیرفعال شده باشد، محدودیت پکیج هاست وجود داشته باشد، یا دسترسی کاربر کافی نباشد. در این حالت باید از پشتیبانی هاست بخواهید وضعیت Feature Manager یا محدودیت اکانت را بررسی کند.

چک‌لیست امن قبل از تغییر فایل‌های مهم

  • از فایل موردنظر یک Copy در همان پوشه یا یک Download روی سیستم خود بگیرید.
  • اگر فایل مربوط به وردپرس است، قبل از تغییر cache را در نظر بگیرید.
  • در فایل‌های PHP، بعد از ذخیره، سایت را فوراً تست کنید.
  • فایل ZIP یا بکاپ را داخل مسیر عمومی رها نکنید.
  • برای تغییرات بزرگ، از FTP، Git یا بکاپ کامل استفاده کنید.

سوالات متداول درباره File Manager در cPanel

آیا File Manager جایگزین FTP است؟

برای کارهای سریع بله، اما برای انتقال تعداد زیادی فایل یا فایل‌های بسیار حجیم، FTP/SFTP یا SSH معمولاً بهتر است.

فایل‌های سایت اصلی در cPanel کجا هستند؟

در بیشتر هاست‌ها فایل‌های سایت اصلی داخل پوشه public_html قرار دارند. برای Addon Domain یا Subdomain ممکن است مسیر متفاوت باشد.

چرا فایل .htaccess دیده نمی‌شود؟

چون فایل‌های نقطه‌دار مخفی هستند. از Settings در File Manager گزینه نمایش فایل‌های مخفی یا dotfiles را فعال کنید.

Permission مناسب برای فایل و پوشه چیست؟

در بسیاری از هاست‌ها فایل‌ها 644 و پوشه‌ها 755 هستند. مقدار 777 معمولاً خطرناک است و نباید به‌عنوان راه‌حل عمومی استفاده شود.

چرا بعد از Extract سایت بالا نمی‌آید؟

ممکن است فایل‌ها داخل پوشه اضافه استخراج شده باشند یا فایل index در ریشه public_html نباشد. مسیر فایل‌ها را بررسی کنید.

آیا می‌توان فایل‌های بزرگ را داخل File Manager ویرایش کرد؟

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

اگر فایل را اشتباهی حذف کنم چه کنم؟

اول Trash را بررسی کنید. اگر آنجا نبود، باید از بکاپ هاست یا بکاپ شخصی خود استفاده کنید.

جمع‌بندی

File Manager در cPanel ابزاری ساده اما بسیار مهم برای مدیریت فایل‌های هاست است. اگر مسیرها را درست بشناسید، فایل‌های مخفی را فعال کنید، قبل از ویرایش بکاپ بگیرید، permissionها را با دقت تغییر دهید و فایل‌های ZIP را بعد از Extract از مسیر عمومی حذف کنید، بسیاری از مشکلات رایج مثل خطای 500، 403، نمایش Index of، خراب شدن متن فارسی و خطر افشای بکاپ قابل پیشگیری هستند.