ویرایش مستقیم فایل‌های هاست با SFTP در VS Code

اگه برای تغییر یک خط کد مجبور می‌شید فایل رو از هاست دانلود کنید، ویرایشش کنید و دوباره روی سرور بفرستید، اتصال مستقیم می‌تونه کارتون رو سریع‌تر کنه. با ویرایش مستقیم فایل‌های هاست با FTP یا SFTP، فایل سرور داخل ویرایشگری مثل VS Code باز می‌شه و بعد از ذخیره، نسخه تازه روی هاست قرار می‌گیره.

توی این راهنما اول اتصال امن SFTP رو آماده می‌کنیم، بعد فایل‌های هاست رو داخل VS Code باز می‌کنیم و سراغ ویرایش فایل‌های وردپرس می‌ریم. روش جایگزین با Pulsar، خطاهای رایج و راه برگردوندن سایت بعد از یک ویرایش اشتباه رو هم بررسی می‌کنیم. چون تغییر مستقیم روی سایت اصلی خطر داره، قبل از هر کاری یک نسخه پشتیبان سالم می‌گیریم.

ویرایش مستقیم فایل‌های هاست با FTP و SFTP یعنی چی؟

FTP یک روش انتقال فایل بین کامپیوتر و سروره. SFTP هم برای انتقال فایل استفاده می‌شه، ولی ارتباط رو از مسیر رمزنگاری‌شده SSH برقرار می‌کنه. SSH به زبان ساده همون راه امنیه که اجازه می‌ده با نام کاربری و رمز یا کلید مخصوص به سرور وصل بشید.

وقتی از ویرایش مستقیم حرف می‌زنیم، یعنی فایل راه دور رو داخل ویرایشگر باز می‌کنید و نسخه تغییرکرده رو با همون ابزار روی سرور می‌فرستید. فایل همچنان برای ویرایش به‌صورت موقت دریافت می‌شه؛ پس «مستقیم» بودن به معنی حذف کامل انتقال فایل نیست.

تفاوت ویرایش مستقیم با دانلود و بارگذاری فایل

در روش دستی باید وارد فایل منیجر هاست بشید، فایل رو دانلود کنید، تغییر بدید و دوباره بارگذاری کنید. در اتصال مستقیم، ویرایشگر بیشتر این رفت‌وبرگشت رو مدیریت می‌کنه. این روش برای اصلاح یک فایل CSS یا تغییر کوچک PHP سریع‌تره، ولی اگه فایل اشتباهی رو ذخیره کنید، همون اشتباه می‌تونه فوری روی سایت اصلی دیده بشه.

چرا SFTP انتخاب امن‌تری از FTP هست؟

FTP معمولی اطلاعات اتصال و داده‌ها رو بدون رمزنگاری مناسب جابه‌جا می‌کنه. SFTP ارتباط رو روی SSH رمزنگاری می‌کنه و برای همین انتخاب مناسب‌تریه. اگه هاستتون SFTP داره، بهتره FTP معمولی رو کنار بذارید.

قبل از ویرایش فایل‌های هاست چه چیزهایی لازم دارید؟

• اطلاعات اتصال SFTP یا FTP
• یک نسخه پشتیبان سالم از سایت
• ویرایشگر VS Code
• حسابی که اجازه خواندن و نوشتن فایل‌های لازم رو داره

قبل از شروع مطمئن بشید شرکت هاستینگ اتصال SFTP رو فعال کرده. SFTP با FTP امن یا FTPS یکی نیست؛ پس نوع اتصال رو حدس نزنید و اطلاعات دقیق رو از پنل یا پشتیبانی هاست بگیرید.

اطلاعات Host، Username، Password و Port رو از کجا بگیرید؟

این اطلاعات معمولاً در ایمیل فعال‌سازی سرویس، بخش حساب‌های FTP یا قسمت SSH پنل هاست دیده می‌شن. Host آدرس سروره و ممکنه نام دامنه یا یک زیردامنه مخصوص باشه. Username و Password اطلاعات حساب اتصال هستن و Port هم درگاه ارتباطه. پورت رایج SFTP عدد ۲۲ هست، ولی هاستتون ممکنه پورت دیگه‌ای تعیین کرده باشه.

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

قبل از شروع از کدوم فایل‌ها نسخه پشتیبان بگیرید؟

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

آموزش ویرایش مستقیم فایل‌های هاست با SFTP در VS Code

مرحله اول: نصب VS Code

VS Code رو فقط از صفحه رسمی دانلود VS Code بگیرید و مثل هر نرم‌افزار دیگه‌ای نصب کنید. بعد یک پوشه خالی برای پروژه بسازید و از مسیر File و گزینه Open Folder همون پوشه رو باز کنید.

مرحله دوم: انتخاب و نصب افزونه SFTP معتبر

از ستون کناری VS Code بخش Extensions رو باز کنید و عبارت SFTP رو جست‌وجو کنید. قبل از نصب، نام ناشر، تاریخ به‌روزرسانی، مستندات، مجوزها و گزارش‌های امنیتی افزونه رو ببینید. این مشخصات ممکنه با گذشت زمان عوض بشن؛ پس فقط به تعداد نصب اکتفا نکنید.

برای نمونه، صفحه افزونه SFTP در Visual Studio Marketplace رو می‌تونید بررسی کنید. قبل از استفاده روی سایت اصلی، سازگاری نسخه فعلی افزونه با نسخه VS Code و روش نگهداری اطلاعات ورود رو دوباره بررسی کنید.

مرحله سوم: ساخت فایل تنظیمات اتصال

بعد از نصب افزونه، کلیدهای Ctrl + Shift + P رو بزنید تا Command Palette یا کادر اجرای دستور باز بشه. دستور مربوط به ساخت تنظیمات SFTP رو انتخاب کنید. افزونه معمولاً پوشه‌ای به نام .vscode و فایلی مثل sftp.json داخل پروژه می‌سازه.

مرحله چهارم: وارد کردن اطلاعات هاست

Host، Username، Port و مسیر پوشه سایت رو با اطلاعات هاستتون جایگزین کنید. مسیر اصلی سایت در بعضی هاست‌ها /public_html هست، ولی این مسیر برای همه سرویس‌ها یکسان نیست. اگه مسیر رو اشتباه وارد کنید، ممکنه پوشه خالی یا فایل‌های مربوط به دامنه دیگه‌ای رو ببینید.

مرحله پنجم: باز کردن فایل‌های سرور در VS Code

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

مرحله ششم: ویرایش و ذخیره تغییرات روی هاست

اول یک فایل کم‌خطر رو باز کنید و تغییر کوچیکی انجام بدید. بعد فایل رو با Ctrl + S ذخیره کنید و پیام موفقیت افزونه رو ببینید. بهتره بارگذاری خودکار موقع ذخیره رو در شروع خاموش نگه دارید تا هر تغییر آزمایشی ناخواسته روی سرور نره.

نمونه تنظیمات اتصال SFTP

ساختار تنظیمات بین افزونه‌ها فرق داره. نمونه زیر با کلیدهای رایج نوشته شده و باید اون رو با مستندات نسخه فعلی افزونه انتخابی و اطلاعات واقعی هاستتون هماهنگ کنید:

{
  "name": "My Website",
  "host": "sftp.example.com",
  "protocol": "sftp",
  "port": 22,
  "username": "your-username",
  "remotePath": "/public_html",
  "uploadOnSave": false
}

مقدارهای نمونه مثل example.com و your-username واقعی نیستن. اون‌ها رو با اطلاعاتی جایگزین کنید که شرکت هاستینگ بهتون داده.

هر گزینه در فایل تنظیمات چه معنی‌ای داره؟

• name: اسم دلخواه اتصال که فقط برای تشخیص پروژه استفاده می‌شه.
• host: آدرس سروری که هاستینگ اعلام کرده.
• protocol: نوع اتصال که برای روش امن روی sftp قرار می‌گیره.
• port: پورت SFTP که باید از هاستینگ بگیرید.
• username: نام کاربری حساب اتصال.
• remotePath: مسیر پوشه‌ای که روی سرور باز می‌شه.
• uploadOnSave: تعیین می‌کنه فایل بعد از هر ذخیره خودکار روی سرور بره یا نه.

چطور اطلاعات ورود رو امن نگه دارید؟

رمز رو داخل فایلی که ممکنه وارد GitHub، فایل پشتیبان اشتراکی یا مخزن تیمی بشه ننویسید. اگه افزونه از کلید SSH یا محل امن نگهداری رمز سیستم‌عامل پشتیبانی می‌کنه، همون روش رو انتخاب کنید. پوشه .vscode یا فایل تنظیمات حساس رو هم به .gitignore اضافه کنید تا ناخواسته وارد Git نشه.

ویرایش فایل‌های وردپرس از طریق SFTP

فایل‌های قالب و افزونه‌ها کجا هستن؟

بعد از ورود به پوشه اصلی وردپرس، قالب‌ها داخل wp-content/themes و افزونه‌ها داخل wp-content/plugins هستن. فایل‌های بارگذاری‌شده رسانه هم معمولاً داخل wp-content/uploads قرار می‌گیرن. برای آشنایی بیشتر با قالب می‌تونید راهنمای تغییر قالب وردپرس رو بخونید.

کدوم فایل‌های وردپرس حساس‌تر هستن؟

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

چطور جلوی خراب شدن سایت رو بگیرید؟

• هر بار فقط یک تغییر کوچیک انجام بدید.
• نسخه سالم فایل رو با نامی مشخص روی کامپیوتر نگه دارید.
• بعد از هر ذخیره، صفحه مرتبط و بخش مدیریت وردپرس رو آزمایش کنید.
• فایل‌های هسته وردپرس رو مستقیم تغییر ندید، چون به‌روزرسانی بعدی تغییرتون رو پاک می‌کنه.
• برای تغییر قالب از چایلد تم یا روش مناسب همون تغییر استفاده کنید.

اگه بعد از تغییر PHP خطایی دیدید، راهنمای دیباگ کردن وردپرس بهتون کمک می‌کنه سرنخ دقیق‌تری پیدا کنید.

استفاده از Pulsar برای ویرایش فایل‌های هاست

Pulsar یک ویرایشگر متن متن‌بازه که ظاهر و روش کارش برای کاربران Atom آشناست. اگه قبلاً آموزش ویرایش مستقیم کد با Atom رو دنبال می‌کردید، Pulsar مسیر نزدیک‌تری به همون محیط در اختیارتون می‌ذاره.

نصب پکیج FTP Remote Edit در Pulsar

Pulsar رو از سایت رسمی نصب کنید. بعد وارد Settings و بخش Install بشید، عبارت ftp-remote-edit رو جست‌وجو کنید و قبل از نصب، صفحه پکیج، ناشر، نسخه و گزارش‌های فعلی رو بررسی کنید. راهنمای رسمی مدیریت پکیج‌ها در Pulsar مسیر نصب و مدیریت پکیج‌ها رو توضیح می‌ده.

اضافه کردن اتصال SFTP یا FTP

بعد از نصب پکیج، پنل FTP Remote Edit رو از منوی Packages باز کنید و یک سرور تازه بسازید. Host، Username، Password، Port و مسیر پروژه رو وارد کنید. اگه هاستتون SFTP داره، نوع اتصال رو روی SFTP قرار بدید و پورت اعلام‌شده از طرف هاستینگ رو بنویسید.

باز کردن، ویرایش و ذخیره فایل‌های سرور

اتصال ساخته‌شده رو باز کنید و از درخت پوشه‌ها به مسیر سایت برید. فایل موردنظر رو باز کنید، تغییر کوچیکی انجام بدید و ذخیره کنید. بعد از پیام موفقیت، نتیجه رو در سایت بررسی کنید. تنظیمات و نام گزینه‌ها ممکنه بین نسخه‌های پکیج فرق کنن؛ پس راهنمای نسخه نصب‌شده رو هم ببینید.

رفع خطاهای رایج اتصال و ذخیره فایل

حل خطای نام کاربری یا رمز اشتباه

اطلاعات رو دوباره از پنل هاست کپی کنید و فاصله اول یا آخر مقدارها رو پاک کنید. اگه رمز حساب اصلی هاست جواب نمی‌ده، ممکنه اتصال به حساب FTP یا SSH جداگانه نیاز داشته باشه. بعد از چند تلاش ناموفق صبر کنید و از پشتیبانی بخواید مسدود شدن IP رو بررسی کنه.

حل مشکل پورت و نوع اتصال

پورت ۲۲ برای SFTP رایجه، ولی قطعی نیست. FTP، FTPS و SFTP سه تنظیم یکسان نیستن و انتخاب نوع اشتباه باعث شکست اتصال می‌شه. نوع پروتکل، Host و Port درست رو از هاستینگ بگیرید.

حل خطای Permission Denied

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

حل مشکل قطع شدن یا کندی اتصال

اول اینترنت و دسترسی به هاست رو آزمایش کنید. بعد اتصال VPN، فایروال سیستم و محدودیت IP هاست رو بررسی کنید. تعداد اتصال‌های هم‌زمان رو کم کنید و فایل‌های بزرگ رو یکی‌یکی بفرستید. اگه افزونه گزینه timeout یا keep-alive داره، فقط طبق مستندات همون نسخه مقدارش رو تنظیم کنید.

برگردوندن سایت بعد از ذخیره کد اشتباه

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

نکات امنیتی ویرایش مستقیم فایل‌های هاست

• هر وقت ممکنه از SFTP به‌جای FTP استفاده کنید.
• یک حساب جدا با دسترسی محدود به پوشه موردنیاز بسازید.
• رمز رو داخل فایل پروژه یا مخزن Git ذخیره نکنید.
• تغییرهای مهم رو اول در محیط آزمایشی انجام بدید.
• قبل از ویرایش، نسخه سالم فایل رو نگه دارید.
• بعد از پایان کار، اتصال‌های بلااستفاده و حساب‌های موقت رو غیرفعال کنید.

افزونه ویرایشگر به فایل‌های سایت دسترسی پیدا می‌کنه؛ پس فقط افزونه‌ای رو نصب کنید که ناشر، کد یا سابقه نگهداری اون قابل‌بررسی باشه. VS Code، Pulsar و افزونه‌های اتصال رو هم به‌روز نگه دارید.

ویرایش مستقیم بهتره یا کار روی نسخه محلی؟

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

ویرایش مستقیم برای چه تغییرهایی مناسبه؟

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

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

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

جمع‌بندی انتخاب روش مناسب

برای ویرایش مستقیم فایل‌های هاست با FTP یا SFTP، پیشنهاد اصلی استفاده از SFTP، یک حساب محدود و نسخه پشتیبان سالمه. VS Code محیط راحتی برای باز کردن و ویرایش فایل‌ها داره و Pulsar هم برای کسانی مناسبه که رابط شبیه Atom رو دوست دارن.

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

سؤال‌های متداول درباره ویرایش فایل‌های هاست با FTP و SFTP

تیم تولید محتوا

ما در تیم تولید محتوای میهن وردپرس در تلاش هستیم تا بهترین مقالات آموزشی در زمینه وردپرس و کسب‌و‌کارهای اینترنتی را تهیه کنیم. صحت محتوای این صفحه توسط رضا راد بررسی خواهد شد.