How to Edit FTP Server Configuration from the Command Line

This article explains how to manually edit FTP server configuration from the command line, determine which FTP service is running, and apply configuration changes for both ProFTP and Pure-FTP. It also covers managed_settings options and how to apply updates using force rebuild commands.

FTP ConfigurationProFTPPure-FTP

~3 min read • Updated Feb 18, 2026

1. مقدمه


این راهنما نحوه ویرایش دستی تنظیمات FTP سرور را از طریق خط فرمان توضیح می‌دهد. با استفاده از این روش، مدیران سرور می‌توانند رفتار سرویس‌های ProFTP و Pure-FTP را مطابق نیاز خود سفارشی‌سازی کنند.


نکته: برای روش‌های بیشتر پیکربندی، می‌توانید به مستندات تنظیمات سرور FTP در WHM مراجعه کنید.


2. تشخیص نوع سرور FTP


برای اینکه بدانید سرور شما از کدام سرویس FTP استفاده می‌کند، از طریق SSH با کاربر root وارد شوید و دستور زیر را اجرا کنید:


grep ftpserver /var/cpanel/cpanel.config

خروجی یکی از موارد زیر خواهد بود:


  • ftpserver=proftpd
  • ftpserver=pure-ftpd

بر اساس نوع سرویس، مراحل مربوطه را دنبال کنید.


3. تنظیمات ProFTP


برای ویرایش تنظیمات ProFTP مراحل زیر را انجام دهید:


  1. فایل /var/cpanel/conf/proftpd/local را با ویرایشگر دلخواه خود ایجاد یا ویرایش کنید.
  2. تنظیمات موردنظر خود را در این فایل وارد کنید.
  3. برای اعمال تغییرات، دستور زیر را اجرا کنید:

/scripts/setupftpserver proftpd --force

4. تنظیمات ProFTP با managed_settings


فایل /usr/local/cpanel/Cpanel/FtpUtils/Config/Proftpd.pm شامل گزینه‌های managed_settings است که می‌توان آن‌ها را از طریق خط فرمان پیکربندی کرد.


این گزینه‌ها شامل موارد زیر هستند:


  • گزینه‌هایی که در رابط تنظیمات FTP در WHM نمایش داده می‌شوند.
  • گزینه‌های مربوط به مدیریت NAT.

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


cat /usr/local/cpanel/Cpanel/FtpUtils/Config/Proftpd.pm

در این فایل، گزینه‌های managed_settings در تابع new قرار دارند. نمونه‌ای از این بخش:


sub new {
    my $class = shift;
    my $self  = $class->SUPER::_init();
    $self->{'managed_settings'} = {
        'maxinstances' => {
            'name'    => 'MaxInstances',
            'context' => { 'server' => 2, },
            'default' => 'none',
}

پس از اعمال تغییرات، دستور زیر را اجرا کنید:


/scripts/setupftpserver proftpd --force

5. تنظیمات Pure-FTP


برای ویرایش تنظیمات Pure-FTP مراحل زیر را انجام دهید:


  1. فایل /var/cpanel/conf/pureftpd/local را ایجاد یا ویرایش کنید.
  2. تنظیمات موردنظر را وارد کنید. برای مثال، برای تنظیم مقدار ForcePassiveIP:

ForcePassiveIP: 203.0.113.0

برای حذف مقدار:


ForcePassiveIP: ~

برای اعمال تغییرات، دستور زیر را اجرا کنید:


/scripts/setupftpserver pure-ftpd --force

6. نتیجه‌گیری


ویرایش تنظیمات FTP از طریق خط فرمان امکان کنترل کامل بر رفتار سرویس‌های ProFTP و Pure-FTP را فراهم می‌کند. با ویرایش فایل‌های محلی و اجرای به‌روزرسانی اجباری، مدیران می‌توانند عملکرد، امنیت و رفتار شبکه را مطابق نیاز خود تنظیم کنند.


Written & researched by Dr. Shahin Siami