SFTP (Secure File Transfer Protocol) به شما امکان میدهد به سرور بازی خود متصل شوید و فایلها را مستقیماً از کامپیوتر خود انتقال دهید — از جمله فایلهای بزرگ، پوشههای کامل ماد و نسخههای پشتیبان. اگر نیاز به آپلود چیزی دارید که فایل منیجر GPanel قادر به مدیریت آن نیست (مانند دایرکتوریهای کامل یا فایلهای بالاتر از محدودیت حجم مرورگر)، SFTP ابزار مناسب است.
چه زمانی از SFTP استفاده کنید: از SFTP زمانی استفاده کنید که نیاز به آپلود پوشهها، فایلهای بزرگ (مثلاً ذخیرههای جهان، پکیجهای ماد، نسخههای پشتیبان) یا چندین فایل به صورت همزمان دارید. برای ویرایش سریع تک فایل، فایل منیجر GPanel ممکن است کافی باشد.
جزئیات اتصال
اتصال SFTP شما از آدرس IP سرور و اطلاعات اعتبارنامه از GPanel استفاده میکند.
جزئیات اتصال SFTP شما
| Host / آدرس | آدرس IP سرور شما (در داشبورد GPanel یا تب Console نمایش داده میشود) |
|---|---|
| Port | 2022 |
| پروتکل | SFTP (SSH File Transfer Protocol) |
| نام کاربری | نام کاربری GPanel شما |
| رمز عبور | در تب Settings در GPanel موجود است |
مهم: همیشه از port 2022 استفاده کنید، نه port پیشفرض SFTP یعنی 22. اتصال از طریق port 22 کار نخواهد کرد.
گزینه ۱ — FileZilla (پیشنهادی)
FileZilla یک کلاینت رایگان و چند پلتفرمی FTP/SFTP است که برای Windows، macOS و Linux در دسترس است.
مرحله ۱ — دانلود و نصب FileZilla
- به filezilla-project.org بروید و FileZilla Client را دانلود کنید (نه FileZilla Server).
- نصبکننده را اجرا کنید و دستورالعملهای روی صفحه را دنبال کنید.
مرحله ۲ — باز کردن Site Manager
- FileZilla را اجرا کنید.
- روی File → Site Manager کلیک کنید (یا Ctrl+S را فشار دهید).
- روی New Site کلیک کنید و نامی مانند Legion Hosting برای آن انتخاب کنید.
مرحله ۳ — وارد کردن تنظیمات اتصال
- Protocol را روی
SFTP - SSH File Transfer Protocolتنظیم کنید. - Host را روی آدرس IP سرور خود تنظیم کنید (در داشبورد GPanel موجود است).
- Port را روی
2022تنظیم کنید. - Logon Type را روی
Normalتنظیم کنید. - Username و Password GPanel خود را وارد کنید (رمز عبور در تب Settings در GPanel است).
- روی Connect کلیک کنید.
مرحله ۴ — پذیرش کلید میزبان
- در اولین اتصال، FileZilla یک دیالوگ Unknown host key نمایش میدهد.
- Always trust this host را تیک بزنید و روی OK کلیک کنید.
مرحله ۵ — آپلود فایلها
- پنل سمت چپ کامپیوتر محلی شما را نشان میدهد. به فایلها یا پوشههایی که میخواهید آپلود کنید بروید.
- پنل سمت راست سیستم فایل سرور شما را نشان میدهد. به پوشه مقصد بروید (مثلاً
/home/container/mods/). - فایلها یا پوشهها را از پنل چپ به پنل راست بکشید و رها کنید، یا روی یک فایل راستکلیک کرده و Upload را انتخاب کنید.
- پیشرفت انتقال را در پنل صف پایین مانیتور کنید.
گزینه ۲ — WinSCP (فقط Windows)
WinSCP یک کلاینت رایگان و محبوب SFTP برای Windows با رابط کاربری آشنای دو پنلی فایل اکسپلورر است.
مرحله ۱ — دانلود و نصب WinSCP
- به winscp.net بروید و نصبکننده را دانلود کنید.
- نصبکننده را اجرا کنید. وقتی از شما سبک رابط کاربری پرسیده شد، Commander را برای نمای دو پنلی یا Explorer را اگر نمای تک پنلی ترجیح میدهید انتخاب کنید.
مرحله ۲ — ایجاد یک نشست جدید
- WinSCP را اجرا کنید. دیالوگ Login به صورت خودکار باز میشود.
- File protocol را روی
SFTPتنظیم کنید. - آدرس IP سرور خود را در فیلد Host name وارد کنید (در داشبورد GPanel موجود است).
- Port number را روی
2022تنظیم کنید. - User name و Password GPanel خود را وارد کنید (رمز عبور در تب Settings در GPanel است).
- روی Login کلیک کنید.
مرحله ۳ — پذیرش کلید میزبان و آپلود
- در اولین اتصال، هشدار کلید میزبان سرور را بپذیرید.
- فایلهای محلی شما در سمت چپ و فایلهای سرور در سمت راست ظاهر میشوند.
- به پوشه مقصد روی سرور بروید، سپس فایلها را از پنل چپ به راست بکشید، یا از F5 برای کپی فایلهای انتخاب شده استفاده کنید.
وظایف رایج آپلود
آپلود یک فایل تنظیمات
فایلهای تنظیمات (مثلاً servertest.ini، server.properties) معمولاً در یک زیرپوشه خاص از دایرکتوری اصلی سرور شما قرار دارند. مسیرهای رایج:
- Project Zomboid:
/home/container/.cache/server/ - ARK: Survival Ascended:
/home/container/ShooterGame/Saved/Config/WindowsServer/ - Minecraft:
/home/container/
در کلاینت SFTP خود به مسیر صحیح بروید، سپس فایل تنظیمات ویرایش شده خود را روی پنل سرور بکشید تا فایل موجود جایگزین شود.
ابتدا سرور را متوقف کنید قبل از جایگزینی فایلهای تنظیمات فعال. آپلود یک فایل تنظیمات در حالی که سرور در حال اجرا است ممکن است باعث شود سرور هنگام خاموش شدن فایل شما را بازنویسی کند.
آپلود مادها
- سرور خود را از GPanel متوقف کنید.
- از طریق SFTP متصل شوید و به پوشه مادهای بازی خود بروید (مثلاً
/home/container/mods/یا مسیر مخصوص بازی). - کل پوشه ماد یا فایل
.jar/.pakرا از کامپیوتر محلی خود به دایرکتوری مادهای سرور بکشید. - پس از تکمیل آپلود، سرور را از GPanel استارت کنید.
آپلود ذخیره جهان یا نسخه پشتیبان
- سرور خود را از GPanel متوقف کنید.
- از طریق SFTP متصل شوید و به دایرکتوری ذخیرههای بازی خود بروید.
- کل پوشه ذخیره را آپلود کنید (خود پوشه را بکشید، نه فقط محتویات آن، مگر اینکه در حال ادغام با یک ذخیره موجود باشید).
- تأیید کنید که ساختار پوشه با آنچه قبلاً وجود داشت مطابقت دارد.
- سرور را از GPanel استارت کنید.
نکته: قبل از بازنویسی یک ذخیره، ابتدا نام پوشه موجود سمت سرور را تغییر دهید (مثلاً
_backup را به انتهای آن اضافه کنید) تا در صورت بروز مشکل بتوانید آن را بازیابی کنید.
عیبیابی
- دوباره بررسی کنید که port روی 2022 تنظیم شده، نه 22.
- بررسی کنید که آدرس IP با آنچه در داشبورد GPanel نمایش داده میشود مطابقت داشته باشد.
- مطمئن شوید سرور شما در حال اجرا است — دسترسی SFTP در برخی پلنها ممکن است نیاز به فعال بودن فرآیند سرور بازی داشته باشد.
- بررسی کنید که فایروال یا آنتیویروس شما اتصالات خروجی روی port 2022 را مسدود نکرده باشد.
- از همان نام کاربری و رمز عبوری استفاده کنید که برای ورود به gpanel.legionhosting.net استفاده میکنید.
- نامهای کاربری حساس به حروف بزرگ و کوچک هستند. اگر مطمئن نیستید، نام کاربری را مستقیماً از GPanel کپی کنید.
- اگر اخیراً رمز عبور GPanel خود را تغییر دادهاید، آن را در نشست ذخیره شده کلاینت SFTP خود بهروزرسانی کنید.
- اگر رمز عبور خود را فراموش کردهاید، رمز عبور GPanel را از بخش کلاینت ریست کنید.
- پکیجهای ماد بزرگ یا ذخیرههای جهان ممکن است چندین دقیقه طول بکشد. بگذارید انتقال تا پایان ادامه یابد.
- در FileZilla، میتوانید تعداد انتقالهای همزمان را افزایش دهید: به Edit → Settings → Transfers بروید و حداکثر انتقالهای همزمان را روی 3 تنظیم کنید.
- اگر اتصال در میانه انتقال قطع شد، FileZilla میتواند ادامه دهد: روی فایل ناموفق در صف راستکلیک کنید و Reset and requeue failed transfers را انتخاب کنید.
- دایرکتوری اصلی شما
/home/container/است. اگر کلاینت شما را به دایرکتوری دیگری میبرد، این مسیر را به صورت دستی در نوار مسیر ریموت تایپ کنید. - مطمئن شوید که با نام کاربری صحیح متصل شدهاید — هر حساب GPanel فقط به فایلهای سرور خودش دسترسی دارد.
همچنان به کمک نیاز دارید؟ یک تیکت پشتیبانی ارسال کنید و آدرس IP سرور، کلاینت SFTP مورد استفاده و توضیح خطا را ذکر کنید.
