Перевод мануала FTP-сервера vsftpd

Раздел: FreeBSD
Написано: 15.06.2008
Автор: Antonio

Настраивал новый vsftpd, внимательно прошелся по документации, еще разок чтобы вдруг чего не упустить, нашел статью с переводом и описанием, решил это дело сохранить у себя (потом если что проще искать)

———————————————————————————-

From: Александр Головин aka screenn, <[email protected].>
Newsgroups: email
Date: Mon, 24 Mar 2008 14:31:37 +0000 (UTC)
Subject: Возможности vsftpd и примеры их использования.

Введение

В этой статье я подробно опишу возможности использования VSFTPD. 

VSFTPD — FTP сервер являющийся безопасным, эффективным, стабильным, полностью готовым и
проверенным решением в мире FTP серверов.

Совмещая функциональность с безопасностью, он все больше привлекает к себе внимание,
подтверждением тому служит (неполный) список проектов доверивших ему свои сервера:

        * ftp.debian.org
        * ftp.freebsd.org
        * ftp.suse.com   
        * ftp.openbsd.org
        * ftp.gnu.org
        * ftp.kernel.org
        * ftp.gnome.org
        * ftp.gimp.org
        * rpmfind.net
        * ftp.linux.org.uk
        * ftp-stud.fht-esslingen.de
        * gd.tuwien.ac.at
        * ftp.sunet.se
        * ftp.ximian.com
        * ftp.engardelinux.org
        * ftp.sunsite.org.uk
        * ftp.isc.org
        * ftp.redhat.com
        * ftp.kde.org 


Разработчик Chris Evans, являясь профессиональным исследователем в области информационной
безопасности, обнаруживший достаточное количество уязвимостей в других программах
www.scary.beasts.org/security , не забыл при этом позаботиться о усилении безопасности
своего продукта. При этом ему удалось сильно расширить возможности VSFTPD, наделив его
такими функциями как: 

 

  • Virtual IP configurations — возможность назначения виртуальных IP;
  • Virtual users — возможность создания виртуальных пользователей;
  • Standalone or inetd operation — возможность автономного пуска без inetd/xinetd;
  • Powerful per-user configurability — конфигурация пользователей;
  • Bandwidth throttling — контроль скорости полосы пропускания;
  • Per-source-IP configurability — конфигурация по IP адресу;
  • Per-source-IP limits — конфигурация лимита по IP адресу;
  • IPv6 — релизация поддержки IPv6;
  • Encryption support through SSL integration — поддержка SSL шифрования данных;
  • и многими другими возможностями описанными мной далее…Исходный код программы можно получить по адресу ftp://vsftpd.beasts.org/users/cevans/ .
    Но скорее всего этого делать не придется, поскольку обычно сервер уже включен в дистрибутив Linux.Выпуски новых версий случаются не так часто, потому как сообщения об ошибках остаются очень
    редким явлением для VSFTPD. 

    К примеру в Debian GNU/Linux, программный пакет устанавливается одной командой:


            apt-get install vsftpd. 


    После установки следует обратить внимание на файлы документации в каталоге /usr/share/doc/vsftpd,
    каталог EXAMPLE уже содержит различные примеры конфигурационного файла vsftpd.conf. Также будет
    полезно посмотреть man vsftpd.conf — в этом мане подробно расписываются все возможности программы.
    Единственный недостаток (а возможно преимущество) руководства, в том что оно написано на английском
    языке, в конце этой статьи я добавил русский перевод этого руководства.

    Сама программа располагается в каталоге /usr/sbin/vsftpd, возможно в разных дистрибутивах
    файл vsftpd.conf находится в разных местах, узнать его расположение к примеру можно
    командой — whereis vsftpd.

    В дистрибутиве Debian GNU/Linux, пакет vsftpd размещает свои файлы следующим образом:


            /.
            /var
            /var/run
            /var/run/vsftpd
            /usr
            /usr/share
            /usr/share/doc
            /usr/share/doc/vsftpd
            /usr/share/doc/vsftpd/AUDIT
            /usr/share/doc/vsftpd/BENCHMARKS
            /usr/share/doc/vsftpd/BUGS
            /usr/share/doc/vsftpd/EXAMPLE
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE_NOINETD
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE_NOINETD/README
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE_NOINETD/vsftpd.conf
            /usr/share/doc/vsftpd/EXAMPLE/README
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS_2
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS_2/README
            /usr/share/doc/vsftpd/EXAMPLE/PER_IP_CONFIG
            /usr/share/doc/vsftpd/EXAMPLE/PER_IP_CONFIG/README
            /usr/share/doc/vsftpd/EXAMPLE/PER_IP_CONFIG/hosts.allow
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_HOSTS
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_HOSTS/README
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS/logins.txt
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS/vsftpd.pam
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS/vsftpd.conf
            /usr/share/doc/vsftpd/EXAMPLE/VIRTUAL_USERS/README.gz
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE/vsftpd.xinetd
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE/vsftpd.conf
            /usr/share/doc/vsftpd/EXAMPLE/INTERNET_SITE/README.gz
            /usr/share/doc/vsftpd/README
            /usr/share/doc/vsftpd/README.security
            /usr/share/doc/vsftpd/README.ssl
            /usr/share/doc/vsftpd/REWARD
            /usr/share/doc/vsftpd/SECURITY
            /usr/share/doc/vsftpd/SECURITY/TRUST.gz
            /usr/share/doc/vsftpd/SECURITY/IMPLEMENTATION
            /usr/share/doc/vsftpd/SECURITY/OVERVIEW
            /usr/share/doc/vsftpd/SECURITY/DESIGN.gz
            /usr/share/doc/vsftpd/SIZE
            /usr/share/doc/vsftpd/SPEED
            /usr/share/doc/vsftpd/TODO
            /usr/share/doc/vsftpd/TUNING
            /usr/share/doc/vsftpd/README.Debian
            /usr/share/doc/vsftpd/copyright
            /usr/share/doc/vsftpd/changelog.gz
            /usr/share/doc/vsftpd/FAQ.gz
            /usr/share/doc/vsftpd/changelog.Debian.gz
            /usr/share/man
            /usr/share/man/man5
            /usr/share/man/man5/vsftpd.conf.5.gz
            /usr/share/man/man8
            /usr/share/man/man8/vsftpd.8.gz
            /usr/sbin
            /usr/sbin/vsftpd
            /etc
            /etc/init.d
            /etc/init.d/vsftpd
            /etc/pam.d
            /etc/pam.d/vsftpd
            /etc/logrotate.d
            /etc/logrotate.d/vsftpd
            /etc/vsftpd.conf
            /etc/ftpusers 


    Как уже стало понятно для работы сервера необходимо отредактировать конфигурационный файл:
    /etc/vsftpd.conf, итак рассмотрим этот вопрос более подробней.

    Файл vsftpd.conf состоит из трех видов опций:


    * BOOLEAN OPTIONS — основные опции, которые могут содержать значения: YES, NO;
    * NUMERIC OPTIONS — опции содержащие разные цифровые значения, например время в секундах или
      номер порта соединения;
    * STRING OPTIONS —  содержат строку, например путь к каталогу на диске: /var/run/vsftpd;  


    Стоит заметить что опции могут отсутствовать в конфигурационном файле, это означает что
    используется значение заданное по умолчанию, обозначаемое как «Default:» в man vsftpd.conf.
    Многие не зная этого думают что опции надо указывать напрямую, поэтому их конфигурационный
    файл вырастает до больших размеров, хотя на самом деле обычно необходимо записать в файл
    всего лишь несколько строк, остальные настройки приемлемы по умолчанию и поэтому не нуждаются
    в добавлении.

    Многие настройки зависят от других опций, если те опции от которых они зависят отключены,
    то настройки не будут работать. Некоторые опции являются взаимоисключающими, значит не будут
    работать в паре с другими включенными опциями.

    А также (на всякий случай), # — этот знак превращает следующую за ним строку в комментарий
    не используемый программой.

    Ниже я приведу примеры vsftpd.conf с описанием для различных вариантов работы. Любой из этих
    примеров, подходящий под ваши конкретные нужды, может быть использован прямо сейчас, для быстрого
    пуска сервера, особо не углубляясь в подробности возможных настроек. После чего можно будет
    продолжать читать статью уже с работающим VSFTPD, изменяя или добавляя другие настройки по мере
    необходимости.

    ПРИМЕРЫ КОНФИГУРАЦИИ

    1. Конфигурация для загрузки с анонимным доступом, без проверки пароля.
    a)inetd/xinetd.


            anonymous_enable=YES
            no_anon_password=YES
            guest_enable=YES
            guest_username=ftp
            xferlog_enable=YES
            ftpd_banner=Hello! 


    Можно указать другой путь к каталогу с файлами для загрузки (по умолчанию /home/ftp),
    в /etc/passwd, отредактировав строку «ftp:» следующим образом:


            ftp:x:107:65534::/home/diretory/way/:/bin/false (где /home/diretory/way/ — путь) 


    Проверьте, разрешены ли входящие соединения в настройках брандмауэра, если надо
    создайте соответствующие правила. Попробуйте подключиться к серверу.

    б)независимый режим.


            listen=YES
            background=YES
            anonymous_enable=YES
            no_anon_password=YES
            guest_enable=YES
            guest_username=ftp
            xferlog_enable=YES
            ftpd_banner=Hello! 


    Опция listen=YES позволит VSFTPD работать самостоятельно, без помощи inetd/xinetd.
    В этом случае необходимо запускать сервер вручную или при помощи загрузочных стартовых
    скриптов. Для запуска необходимо ввести в консоли команду /usr/sbin/vsftpd и FTP будет
    запущен в фоновом режиме благодаря опции background=YES.

    Если сервер предназначен для работы в интернет, полезно добавить некоторые ограничения.


            anonymous_enable=YES
            no_anon_password=YES
            anon_world_readable_only=YES
            connect_from_port_20=YES
            no_anon_password=YES
            hide_ids=YES
            pasv_min_port=50000
            pasv_max_port=60000
            xferlog_enable=YES
            ascii_download_enable=NO
            async_abor_enable=YES
            one_process_model=YES
            idle_session_timeout=120
            data_connection_timeout=300
            accept_timeout=60
            connect_timeout=60
            anon_max_rate=15000 


    Для работы в интернет в независимом от inetd/xinetd режиме


            listen=YES
            max_clients=200
            max_per_ip=4
            anonymous_enable=YES
            no_anon_password=YES
            anon_world_readable_only=YES
            connect_from_port_20=YES
            hide_ids=YES
            pasv_min_port=50000
            pasv_max_port=60000
            xferlog_enable=YES
            async_abor_enable=YES
            one_process_model=YES
            idle_session_timeout=120
            data_connection_timeout=300
            accept_timeout=60
            connect_timeout=60
            anon_max_rate=15000 


    При переходе в независимый от inetd режим работы (listen=YES), я столкнулся с проблемой,
    при попытке запуска сервера получал сообщение «500 OOPS: could not bind listening IPv4 socket».
    Решение оказалось простым, нужно закомментировать строку ftp в /etc/inetd.conf и
    перезапустить inetd. Также при переходе в режим listen=NO, пришлось раскоментировать строку ftp
    в /etc/inetd.conf и перезапустить inetd иначе при попытке подключиться я получал такое
    сообщение — «ftp: connect: Connection refused».

    Я не буду описывать все возможные варианты примеров конфигурации сервера, потому что на самом
    деле их может быть очень много, вместо этого ниже хочу добавить мой перевод man vsftpd.conf,
    который был написан для удобства изучения возможностей vsftpd, а сегодня вырос в полноценный
    перевод.
    Выражаю благодарность Andrew Clark, который согласился принять участие в переводе и внес
    свои корректировки.

    Если вы найдете в переводе какие либо, пусть даже и незначитальные ошибки,
    свяжитесь со мной по e-mail.

    ==========

    VSFTPD.CONF(5)                                                  VSFTPD.CONF(5)

    NAME
           vsftpd.conf — конфигурационный файл для vsftpd

    Описание

    vsftpd.conf используется для управления различными аспектами поведения vsftpd. По
    умолчанию vsftpd ищет этот файл в по адресу /etc/vsftpd.conf. Однако, вы можете
    изменить местоположение файла, через аргументы командной строки. Аргументы командной
    строки это путь и имя конфигураци онного файла для vsftpd. Такая возможность полезна,
    если вы пожелаете использовать улучшенный inetd, такой как xinetd, для запуска vsftpd с
    разными конфигурационными файлами на каждый виртуальный хост.

    Формат

    Формат vsftpd.conf очень простой. Каждая строка это коментарий или директива. Командные
    строки начинающиеся с символа # игнорируются. Директивы имеют формат опция=значение.
    Важным фактом является пробел между опцией или значением, что приведет к ошибке. Каждое
    значение по умолчанию может быть изменено в конфигурационном файле.

    СПОСОБЫ ЗАПУСКА

    listen                     
    Если опция включена сервер стартует в независимом от inetd/xinetd режиме
    «standalone mode». В этом случае он сам заботится о прослушивании и
    определении входящих соединений.
    Default: NO

    listen_ipv6                        
    Тоже самое что listen, за исключением того что vsftpd слушает IPv6 протокол включительно.
    Этот параметр и listen взаимно исключаемые.
    Default: NO

    background        
    При включении, vsftpd стартуя в режиме listen, работает в фоновом режиме.
    Т.е. контроль передается той оболочке в которой был запущен vsftpd.
    Default: NO

    listen_port
    Если запущен в standalone mode, указанный порт прослушивается на предмет
    входящих FTP соединений.
    Default: 21

    listen_address
    Если запущен в standalone mode, обычно слушает все адреса (или все локальные интерфейсы).
    Что может быть отменено указанием определенных ip адресов в этой строке.
    Default: (none)

    listen_address6
    Тоже что и listen_address, но прослушивает адреса соединений на основе IPv6 протокола
    (который используется если выбрана опция listen_ipv6), формат в виде стандартного IPV6 адреса.
    Default: (none)

    max_clients
    Если vsftpd находится в standalone_mode, это максимальное количество клиентов,
    которые могут быть подключены. Попытки подключения сверх указанного количества,
    получат сообщение об ошибке.
    Default: 0 (unlimited)

    max_per_ip
    Если vsftpd находится в standalone mode, эта опция указывает максимально
    возможное количество клиентов с одинаковыми ip адресами. Клиентские подключения
    пытающиеся превысить этот лимит, получат сообщение об ошибке.
    Default: 0 (unlimited)

    run_as_launching_user
    Включите для возможности запуска vsftpd от пользователя vsftpd. Это полезно когда root
    доступ недопустим. Важное предупреждение! Не разрешайте эту опцию если вы полностью не
    уверены что вы делаете, наивное использование этой опции может создать множество проблем
    связанных с безопасностью. В особенности, vsftpd не может использовать chroot технологию для
    разграничения доступа к файлам (даже если при этом сервер запущен от root). В некоторой степени
    можно ограничить доступ при помощи параметра deny_file, указав шаблон запрещенных файлов,
    такой как {/*,*..*}, но надежность этого не сравнима с chroot, поэтому не стоит возлагать на
    это больших надежд. С использованием этой опции, также проявляются ограничения в других опциях.
    Для примера, в опциях требующих привилегии, не анонимные входы, изменение владельца закачанных
    на сервер файлов, подключение по 20 порту и прослушивание портов менее 1024. Возможно и другие
    опции пересекаются с включением этой опции.
    Default: NO

    ПРАВИЛА ДЛЯ АНОНИМНЫХ ПОЛЬЗОВАТЕЛЕЙ

    anonymous_enable
    Разрешает или запрещает вход анонимных пользователей. Если разрешено, пользователи
    с именами ftp и anonymous распознаются как анонимные пользователи.
    Default: YES

    anon_max_rate             
    Максимальная допустимая скорость передачи данных для анонимных
    пользователей, выражена в байтах
    в секунду .
    Default: 0 (unlimited)

    anon_root
    В этой строке указывается каталог, в который vsftp будет переводить
    анонимных пользователей после входа. При неудаче просто игнорируется.
    Default: NO

    no_anon_password
    Если опция установлена, vsftp не спрашивает пароль у анонимных
    пользователей, позволяя им подключаться сразу.
    Default: NO

    anon_mkdir_write_enable
    Включение этой опции, позволяет анонимным пользователям создавать новые каталоги в
    соответствии с определенными для этого условиями. Для того чтобы это работало опция
    write_enable должна быть включена, и анонимный пользователь должен иметь права на
    запись в данном каталоге.
    Default: NO

    anon_other_write_enable
    Если выбрано YES, анонимные пользователи могут выполнять операции записи отличные от
    загрузки на сервер и создания каталогов, такие как удаление и переименование. Это обычно
    не рекомендуется, но все таки такая возможность присутствует для полноты.
    Default: NO

    anon_upload_enable
    Включение этой опции позволяет анонимным пользователям загружать файлы на сервер, в
    соответствии с определенными для этого условиями. Для того чтобы это работало опция
    write_enable должна быть активирована, и анонимный ftp пользователь должен иметь права
    на запись в каталоге для загрузки. Включение опции также необходимо для предоставления
    возможности загружать на сервер файлы виртуальным пользователям; по умолчанию виртуальные
    пользователи имеют одинаковые привилегии с анонимными пользователями
    (т.е. максимально ограниченные привилегии).
    Default: NO 

    anon_world_readable_only
    При включение этой опции, анонимным пользователям будет разрешено скачивать только
    видимые ими из мира файлы. Предполагается полезным, если пользователи могут загружать
    на сервер и хранить на нем собственные файлы.
    Default: YES

    deny_email_enable
    Активация опции, позволяет использовать список анонимных паролей типа e-mail, при
    использовании которых попытки подключения будут отвергнуты. По умолчанию, файл содержащий
    этот список располагается в /etc/vsftpd.banned_emails, но имеется возможность изменить путь,
    указав альтернативный путь в banned_email_file.
    Default: NO

    banned_email_file
    Эта опция указывает имя файла в котором содержится список анонимных e-mail паролей
    не принимаемых сервером. Сервер сверяется с этим файлом если опция
    deny_email_enable включена.
    Default: /etc/vsftpd.banned_emails

    guest_enable
    Если опция включена, подключения всех не анонимных локальных пользователей
    рассматриваются как «гостевые» («guests»). «Гостям» назначаются параметры
    указванные в опции  guest_username.
    Default: NO

    guest_username
    Опция содержит имя «гостевого» пользователя, определяющее его
    домашнюю директорию.
    Работает при включенной guest_enable.
    Default: ftp

    secure_email_list_enable
    Активируйте опцию, если хотите разрешать вход анонимным пользователям только на основе
    проверки паролей указанных в e-mail листе. Это простой путь ограничения доступа к
    низко безопасному содержимому без необходимости в виртуальных пользователях. При включении,
    анонимные входы блокируются если пароль не содержится в файле указанном опцией
    email_password_file. Формат файла — один пароль на строку. По умолчанию файл располагается
    в /etc/vsftpd.email_passwords.  
    Default: NO

    email_password_file
    Эта опция может быть использована для предоставления альтернативного пути файла
    используемого secure_email_list_enable опцией.
    Default: /etc/vsftpd.email_passwords

    anon_umask
    Значение накладываемой маски на создаваемые анонимными пользователями файлы.
    Замечание! Если вы решили указать цифровое значение, надо помнить о
    нулевом «0» префиксе, иначе значение будет рассмотрено как десятизначное.
    Default: 077

    ftp_username
    Имя назначаемое анонимным пользователям. Пользователи с
    назначенным именем привязаны к своему домашнему каталогу, который
    является корневым каталогом анонимного пространства FTP.
    Default: ftp

    ПРАВИЛА РАБОТЫ С ПОЛЬЗОВАТЕЛЯМИ
                                                        
    local_enable
    Разрешает или запрещает вход для локальных пользователей. Если включено
    обычные пользовательские акаунты в /etc/passwd могут быть использованы для входа.
    Должно быть включено для разрешения любых не анонимных входов, включая вход
    виртуальных пользователей.
    Default: NO

    local_root
    Эта опция указывает каталог в который vsftpd должен перевести пользователя после
    локального не анонимного входа. В случае неудачи просто игнорируется.
    Default: (none)

    user_config_dir
    Эта опция позволяет задавать дополнительные параметры относительно к отдельным
    пользователям. Например если в user_config_dir выбрать /etc/vsftpd_user_conf, тогда
    вход пользователя «chris», означает что vsftpd будет использовать настройки
    из конфигурационного файла /etc/vsftpd_user_conf/chris
    для этой сессии. Обратите внимание, не все настройки применимы
    к отдельным пользователям, например listen_address, banner_file,
    max_per_ip, max_clients, xferlog_file, и другие.
    Default: (none)

    chroot_local_user       
    Если выбрано локальные пользователи будут (по умолчанию) перенесены в chroot () «заточение»
    в их домашнем каталоге после входа. Внимание: эта опция имеет смысл быть включенной из
    соображений безопасности, особенно если пользователи имеют права позволяющие загрузку
    файлов на сервер, или shell доступ. Включать только если вы действительно уверены что
    знаете зачем вам это нужно. Заметим что эта опция безопасности в системах класса unix,
    характерна не только для vsftpd, используется и в других FTP серверах.     
    Default: NO

    passwd_chroot_enable
    Работает при включенном параметре chroot_local_user. Пользователи
    помещаются в свои домашние директории, которые указаны в файле /etc/passwd.
    Точное указание пути /./ указывает что пользователь будет перемещен при входе
    в директорию в этом пути.
    Default: NO

    chroot_list_enable
    Если включить, вы можете использовать список локальных пользователей помещаемых в
    chroot() заточение в их домашнем каталоге после входа. Если используется совместно
    с включенным chroot_local_user означает список пользователей которые не помещаются
    в chroot() заточение. По умолчанию список содержится в файле /etc/vsftpd.chroot_list,
    но можно указать любой другой путь к файлу используя опцию chroot_list_file.
    Default: NO

    chroot_list_file
    Опция является дополнением к chroot_list_enable указывает альтернативный путь
    к файлу содержащему список локальных пользователей которые будут перемещены в chroot()
    заточение в их домашние каталоги при входе. Эта опция уместна только при разрешенной
    chroot_list_enable. Если опция chroot_local_user включена, наоборот указывает
    файл списка пользователей не помещаемых в chroot() заточение.
    Default: /etc/vsftpd.chroot_list

    chmod_enable
    Включение этой опции разрешает использование SITE CHMOD команд устанавливающих
    права доступа для файла. ВНИМАНИЕ! Применимо только к локальным пользователям.
    Анонимные пользователи никогда не используют SITE CHMOD команды.
    Default: YES

    check_shell
    Замечание! Опция эффективна только для non-PAM сборок vsftpd. Если запрещена,
    vsftpd не проверяет файл /etc/shells на допустимость пользовательских shell
    оболочек для локальных входов.
    Default: YES

    virtual_use_local_privs
    Если включено, виртуальные пользователи будут использовать одинаковые с
    локальными пользователями привилегии. По умолчанию, виртуальные пользователи
    используют одинаковые с анонимными пользователями привилегии, предполагающие
    большие ограничения, (особенно условия доступа на запись).
    Default: NO 

    user_sub_token
    Используется для автоматической генерации домашнего каталога виртуального
    пользователя базируясь на шаблоне. К примеру, если домашний каталог реального
    пользователя указанного в guest_username это /home/virtual/$USER, и в
    user_sub_token выбрать $USER, тогда при входе виртуального пользователя fred,
    он будет направлен, (обычно в chroot) директорию /home/virtual/fred. Эта опция
    также работает если local_root содержит user_sub_token.
    Default: (none)

    local_max_rate
    Максимальная скорость передачи данных, выраженная в байтах в секунду, для
    локально аутентифицированных пользователей.
    Default: 0 (unlimited)

    local_umask
    Значение маски назначения прав доступа к файлам созданным локальными
    пользователями. Помните! Если вы хотите указать параметр в качестве
    цифрового значения, указывайте «0» (нулевую) приставку, иначе
    значение будет определено как целое десятизначное.
    Default: 077

    session_support
    session_support
    Эта опция определяет, будет ли vsftpd поддерживать установленные соединения.
    Если vsftpd поддерживает сессии, он будет пытаться обновить utmp и wtmp.
    Он также откроет pam_session, если используется PAM аутентификация и закроет
    соединение только после отключения. Можно отключить эту опцию, если не
    требуется журналирование сессии и есть желание предоставить vsftpd больше
    возможностей для запуска с меньшими привилегиями.
    Замечание — utmp и wtmp поддерживаются только в сборках с включенным PAM.
    Default: NO

    userlist_enable
    Если разрешено, vsftpd загружает список имен пользователей, из файла
    указанного userlist_file параметром. Если пользователь пытается войти
    используя имя взятое из этого файла, вход будет отклонен перед запросом
    пароля. Это может быть полезно для предотвращения передачи пустого поля
    в качестве пароля. Смотри также userlist_deny.
    Default: NO

    userlist_file
    Этот параметр указывает путь к файлу списка пользователей, загружаемому
    если userlist_enable параметр включен.
    Default: /etc/vsftpd.user_list

    userlist_deny
    Эта опция работает если userlist_enable включен. Если выбрано
    значение NO, значит вход пользователей будет отклонен если они
    не найдены в файле указанном usrlist_file. Если вход отклоняется,
    отказ производится перед тем как у пользователя будет запрошен пароль.
    Default: YES

    КОМАНДЫ
                                                                             
    dirlist_enable
    Если выбрать NO, все команды листинга каталогов будут запрещены.
    Default: YES

    async_abor_enable
    При включении, специальные FTP команды известные как «async ABOR»
    будут разрешены. Только плохо продуманные FTP клиенты используют эту функцию.
    В добавок эта функция неудобна в управлении, поэтому отключена по умолчанию.
    К сожалению, некоторые FTP клиенты могут зависать в момент отмены передачи,
    если эта функция выключена. Если это происходит можно попробовать включить
    эту функцию.
    Default: NO

    write_enable
    Разрешает FTP команды изменяющие файловую систему. Такие команды как:
    STOR,  DELE,  RNFR, RNTO, MKD, RMD, APPE, SITE.
    Default: NO

    ls_recurse_enable
    При включении, разрешает рекурсивный листинг «ls -R». Включение немного
    рискованно исходя из соображений безопасности, так как выполнение «ls -R» в
    верхнем уровне большого сайта может поглощать много ресурсов.
    Default: NO

    mdtm_write
    Если включить, разрешает обновления времени модификации файла
    через MDTM ftp команды.
    Default: YES

    cmds_allowed
    В этой опции указывается список разделенных запятыми команд разрешенных
    FTP (post login. USER, PASS и QUIT pre-login всегда разрешены).
    Другие команды запрещены. Пример: cmds_allowed=PASV,RETR,QUIT
    Default: (none)

    DOWNLOAD/UPLOAD

    file_open_mode
    Маска файлов назначаемая при загрузке файлов на сервер. При желании
    возможно изменить на 0777 если есть необходимость сделать исполняемыми
    загружаемые на сервер файлы.
    Default: 0666
       
    ascii_download_enable
    Если включить, ASCII режим передачи данных будет разрешен при download.
    Default: NO

    ascii_upload_enable
    Если включить, ASCII режим передачи будет разрешен при uploads.
    Default: NO

    chown_uploads
    Если включить, у всех анонимно закачанных файлов на сервер будут
    изменены владельцы на  пользователя в указанного в chown_username.
    Это может быть полезно при администрировании, и возможно из соображений
    безопасности.
    Default: NO

    chown_username
    В этом параметре указывается имя пользователя, назначаемого хозяином
    анонимно загруженных на сервер файлов. Эта опция уместна только при
    включенной опции chown_uploads.
    Default: root

    download_enable
    Если выбрано значение NO, все запросы на скачивание файлов с
    сервера будут отклонены.
    Default: YES

    lock_upload_files
    При включении опции, все загрузки на сервер происходят с блокировкой
    записи загружаемого файла. Все загрузки с сервера совершаются с общей
    блокировкой чтения скачиваемых файлов.
    Default: NO

    ОСНОВНЫЕ ПРАВИЛА

    tcp_wrappers
    Если включено, и vsftpd был скомпилирован с поддержкой tcp_wrappers,
    входящие соединения контролируются через tcp_wrappers. Этот механизм
    предоставляет возможность контролировать соединения по ip адресам,
    назначая конкретному подключению отдельный конфигурационный файл vsftpd.
    Параметры tcp_wrappers устанавливаются в конфигурационных
    файлах /etc/hosts.allow и /etc/hosts.deny, среди них есть
    переменная окружения VSFTPD_LOAD_CONF, указывающая на
    месторасположения файла с альтернативными vsftpd.conf параметрами  для
    определенного правила (ip адреса) напротив которого она указана.
    Default: NO

    idle_session_timeout
    Временной промежуток в секундах указывающий для удаленного клиента
    максимальное время которое он может бездействовать не выполняя FTP команды.
    Если время исчерпано, соединение отбрасывается.
    Default: 300

    data_connection_timeout
    Максимальный временной промежуток в секундах, разрешенного замирания процесса
    передачи данных. Если перерыв превышен, соединение с удаленным клиентом отбрасывается.
    Default: 300

    accept_timeout
    Максимальное время в секундах для выделения подключения с PASV стилем
    передачи данных.
    Default: 60

    connect_timeout
    Максимальное время в секундах, отведенное на выделение соединения
    PORT стиля передачи данных.
    Default: 60

    deny_file
    Эта опция может быть использована для выбора шаблона имен файлов к которым необходимо
    ограничить доступ. Обозначенный в шаблоне элемент не скрывается, но любая попытка
    сделать с ним что нибудь (скачать, изменить и др.) будет отклонена. Эта опция очень
    проста и не должна использоваться для серьезного контроля доступа. Может быть использована
    с настройками виртуальных пользователей. Пример: deny_file={*.mp3,*.mov,.private}       
    Default: (none)

    hide_file
    Эта опция может быть использована для выбора шаблона имен файлов и каталогов
    которые должны быть скрыты от просмотра. Несмотря на то что они скрыты, они остаются
    полностью доступными для клиентов которые знают их имена. Элементы будут скрыты если
    их имена содержат строки заданные в hide_file или если их шаблоны указаны в hide_file.
    Пример: hide_file={*.mp3.,.hidden,hide*,h?}
    Default: (none)

    banner_file
    Эта опция указывает на имя банер-файла содержащего текст выводимый
    на экран клиента при подключении к серверу. Если выбрано, отменяет
    банер-строку предоставленную ftpd_banner опцией.
    Default: (none)

    ftpd_banner
    В этой опции можно указать банер-строку выводимую на экран клиента при подключении к серверу.
    Default: (none — default vsftpd banner is displayed)

    dirmessage_enable
    Если разрешено, при входе в каталог пользователям показывается сообщение
    из файла .message. По умолчанию, директория сканируется на наличие
    сообщения в файле .message, что можно изменить задав имя другого файла
    параметром message_file.
    Default: NO (but the sample config file enables it)

    message_file
    Эта опция указывает на имя файла в котором содержится сообщение показываемое пользователям
    при входе в каталог. Работает только если опция dirmessage_enable включена.
    Default: .message

    use_localtime
    При включении, vsftpd производит листинг каталогов с отображением времени лично
    вашей временной зоны. По умолчанию в листинге отображается GMT временная зона.
    Времена обновляемые MDTM командами также затрагиваются этой опцией.
    Default: NO

    force_dot_files
    Если включено, файлы и каталоги имена которых начинаются с «.» будут
    показаны при листинге каталогов, даже если флаг «a» не был использован клиентом.
    Default: NO

    text_userdb_names
    По умолчанию в полях листинга каталогов пользователей и групп отображаются цифровые ID.
    Включив эту опцию можно задать текстовые отображения. Это выключено по умолчанию
    по причине производительности.
    Default: NO

    hide_ids
    Включение скрывает информацию о именах владельцев файлов и группах, при
    листинге отображается как «ftp».
    Default: NO

    secure_chroot_dir           
    Эта опция указывает на имя пустого каталога. Также, каталог не должен быть записываемый
    для ftp пользователя. Этот каталог используется как безопасный chroot(), когда vsftpd не
    нужен доступ к файловой системе.
    Default: /var/run/vsftpd

    delay_failed_login
    Время ожидания в секундах, перед выводом отчета о неудачном входе.
    Default: 1

    delay_successful_login
    Время ожидания в секундах, перед разрешением успешного входа.
    Default: 0    

    connect_from_port_20
    Включение этой опции указывает исходящим с сервера соединениям использовать
    20 порт. Из соображений безопасности, некоторые клиенты могут настаивать
    на этом значении. Отключение этой опции позволяет vsftpd стартовать с немного
    меньшими привилегиями.
    Default: NO (but the sample config file enables it)

    ftp_data_port
    Указывается порт для входящих соединений с сервером (пока connect_from_port_20 включен).
    Default: 20

    port_enable
    Отключите при желании запретить PORT метод организации соединения.
    Default: YES

    port_promiscuous
    При включении выключается PORT security check гарантирующий что исходящие
    соединения могут быть установлены только с клиентами. Включайте только
    если действительно знаете что делаете!
    Default: NO

    one_process_model
    Начиная с ядра Linux 2.4, возможно использование различных моделей
    безопасности, так включение этой опции позволяет использовать только один процесс
    на одно пользовательское подключение. Обычно нет нужды включать это если вы точно
    не уверены что делаете, и сайт не поддерживает большое количество одновременно
    подключенных пользователей.
    Default: NO 

    setproctitle_enable
    При включении, vsftpd будет показывать информацию о статусе сессии
    в списке системных процессов. Другими словами, в списке процессов будут подробно
    отображаться события происходящие с vsftpd (скачивания и др.)
    Default: NO  

    max_login_fails
    Количество неудачных попыток входа, после которых сессия прекращается.
    Default: 3

    pasv_max_port
    Значение указывает максимальный порт до которого размещены порты для PASV
    стиля передачи данных. Может быть использовано для указания подробного
    размещения портов помогая файрволлингу.
    Default: 0 (use any port)

    pasv_min_port
    Значение номера порта начиная с которого размещаются порты для PASV стиля
    передачи данных. Может быть использовано для указания подробного размещения
    портов помогая файрволлингу.
    Default: 0 (use any port)

    pasv_address
    Этой опцией задается ip адрес для ответа на запрос PASV команды. Адрес
    указывается в цифровом виде, если не включен pasv_addr_resolve. По умолчанию,
    берётся адрес сокета входящего соединения.
    Default:  (none  —  the  address  is  taken  from  the  incoming connected socket)

    pasv_addr_resolve
    Необходимо включить если вы хотите использовать имя хоста (вместо ip адреса)
    в pasv_address опции.
    Default: NO

    pasv_enable
    Отключите, если вы хотите запретить PASV метод соединения.
    Default: YES

    pasv_promiscuous
    Включите, если хотите запретить  PASV security check, контролирующую
    подключения с одинаковыми ip адресами. Включайте это, только если вы
    знаете что делаете! Используется в некоторых туннельных соединениях,
    возможно в FXP.
    Default: NO

    use_sendfile
    Внутренняя настройка используемая для определения пользы
    использования sendfile().
    Default: YES

    trans_chunk_size
    Вы возможно не хотите менять это, но можете попытаться выбрать что нибудь
    наподобие 8192 для более плавного ограничения полосы пропускания.
    Default: 0 (let vsftpd pick a sensible setting)

    tilde_user_enable
    При включении, vsftpd распознает имена каталогов с тильдой «~» в начале как папки
    пользователей, папки будут распознаны только если файл /etc/passwd находится в
    _current_ chroot().
    Default: NO

    nopriv_user
    Указывает имя пользователя под которым работает сервер, когда ему не нужны привилегии.
    Для этого предпочтительней выделить отдельного пользователя, чем использовать nobody.
    Default: nobody

    pam_service_name
    В этой строке можно указать имя PAM сервиса который будет использоваться для
    vsftpd.
    Default: vsftpd
        
    SSL ШИФРОВАНИЕ ДАННЫХ

    ssl_enable
    Если включено, и vsftpd был скомпилирован с поддержкой OpenSSL, vsftpd
    будет поддерживать безопасность соединения с помощью SSL.
    Это позволяет контролировать соединения (включая входы в систему)
    и также передачу данных. Для этого также необходим клиент с поддержкой SSL.
    Замечания!! Включайте, если это действительно вам необходимо.
    Надо понимать тот факт, что vsftpd не может гарантировать безопасность
    OpenSSL библиотек. Включая эту опцию вы доверяете безопасность
    установленной OpenSSL библиотеке.
    Default: NO

    ssl_sslv2
    Разрешено только при включенной ssl_enable. Включение этой опции
    делает возможными подключения по протоколу SSL v2.
    TLS v1 подключения оптимальны.
    Default: NO

    ssl_sslv3
    Разрешается только при включенном ssl_enable. Если разрешено,
    эта опция позволяет подключения по протоколу SSL v3.
    TLS v1 подключения оптимальны.
    Default: NO

    ssl_tlsv1
    Разрешено только если ssl_enable включено. Если разрешено,
    эта опция разрешает соединения по протоколу TLS v1 который
    является оптимальным.
    Default: YES

    allow_anon_ssl
    Разрешено только если ssl_enable включено. При включении этой опции,
    анонимным пользователям также будет разрешено использование
    безопасных SSL соединений.
    Default: NO

    force_anon_data_ssl
    Разрешено только если ssl_enable включено. При включении, все
    анонимные подключения будут использовать SSL безопасные соединения
    для приема и передачи данных.
    Default: NO

    force_anon_logins_ssl
    Разрешено только при включенном ssl_enable. При включении, все анонимные
    подключения будут использовать безопасные SSL соединения при посылке паролей.
    Default: NO

    force_local_data_ssl
    Разрешено только если ssl_enable активно. При включении, все не анонимные
    подключения используют безопасные SSL соединения для приема
    и передачи данных.
    Default: YES

    force_local_logins_ssl
    Разрешено только если ssl_enable включено. При включении, все не
    анонимные подключения используют безопасное SSL соединение при
    передачи паролей.
    Default: YES

    dsa_cert_file
    Эта опция указывает местонахождение DSA сертификата для использования
    в SSL зашифрованных соединениях.
    Default: (none — an RSA certificate suffices)

    dsa_private_key_file
    Эта опция задает расположение личного DSA ключа для использования в
    SSL зашифрованных соединениях. Если эта опция не выбрана,
    сертификат предусматривается как личный ключ.
    Default: (none)

    rsa_cert_file
    Эта опция задает расположения RSA сертификата для использования в
    SSL зашифрованных соединениях.
    Default: /usr/share/ssl/certs/vsftpd.pem

    rsa_private_key_file
    Эта опция задает расположения личного RSA ключа для использования в
    SSL зашифрованных соединениях.
    Если эта опция не выбрана, сертификат предусматривается как личный ключ.
    Default: (none)

    ssl_ciphers
    Эта опция может быть использована для выбора того, какие SSL шифры будут разрешены для
    шифрования SSL соединений. Смотрите страницу man ciphers для детального ознакомления.
    Заметьте, такие ограничения шифров могут использоваться в целях предосторожности,
    предотвращая использования отдаленными сторонами шифра с которым были обнаружены проблемы.
    Default: DES-CBC3-SHA                                                                                   

    ЖУРНАЛИРОВАНИЕ

    syslog_enable
    При включении, все выводы журнала направляемые ранее в /var/log/vsftpd.log будут
    направляться в системный журнал вместо этого. 
    Default: NO

    no_log_lock
    Если включено, запрещает vsftpd блокировку файла журнала при записи в него.
    Этот параметр обычно не разрешен.
    Default: NO

    log_ftp_protocol
    При включении, все FTP запросы и ответы журналируются, включение с опцией
    xferlog_std_format запрещено. Используется для выявления ошибок.
    Default: NO

    dual_log_enable
    При включении, два файла с журналами генерируются параллельно, по умолчанию они
    располагаются в /var/log/xferlog и /var/log/vsftpd.log. Первый генерируется
    в стиле журнала wu-ftpd, анализируемый стандартными средствами.
    Другой в стиле журнала vsftpd.
    Default: NO

    xferlog_enable
    Если включено, журнал будет включать детальные отчеты о закачках на сервер,
    и закачках с сервера (uploads, downloads). По умолчанию, этот файл будет
    располагаться в /var/log/vsftpd.log, но расположение может быть изменено
    используя опцию vsftpd_log_file.
    Default: NO (but the sample config file enables it)

    xferlog_std_format
    Если включено, запись в журнал производится в стандартном wu-ftpd стиле,
    xferlog формата. Полезно при желании использования уже существующих
    привычных способов генерации статистики. Однако с другой стороны,
    формат используемый по умолчанию лучше читается. Расположение журнала
    по умолчанию /var/log/xferlog, что может быть изменено при
    помощи опции xferlog_file.
    Default: NO

    xferlog_file
    В параметре этой опции можно указать альтернативный путь к файлу
    журнала записываемому в стиле wu-ftpd. Запись в этот журнал производится
    только при включенной xferlog_eneble опции, включительно с xferlog_std_format.
    Также журнал ведется если включена опция dual_log_enable.
    Default: /var/log/xferlog

    vsftpd_log_file
    В этой строке можно указать альтернативный путь к файлу журнала, записываемому в
    стиле vsftpd. Этот журнал ведется если опция xferlog_enable включена, и
    xferlog_std_format остается не выбрана. Также журнал ведется если включена
    опция dual_log_enable. Важно не забыть, при включенной syslog_enable опции,
    этот файл не записывается и вывод вместо этого напрвляется в системный журнал.
    Default: /var/log/vsftpd.log

    АВТОРЫ
      автор оригинального текста: [email protected]
      авторы русского перевода: Александр Головин aka screenn, <[email protected].>; Andrew Clark <[email protected].>

  • ———————————————————————————-

    P.S. спасибо авторам за их труд

    Поделиться с друзьями или в соц.сетях (спасибо)
    Ещё похожие заметки:

    14 комментариев

    Анюта
    Июл 28, 2008 02:56

    Кстати это все придумали приблизительно лет 10 назад .:

     
    Ленок
    Авг 2, 2008 21:50

    Да уж… Жизнь — как вождение велосипеда. Чтобы сохранить равновесие, ты должен двигаться.

     
    PlanetaJob
    Авг 7, 2008 03:19

    О! Интересно интересно

     
    каталог мотоциклов английского производства
    Авг 8, 2008 05:38

    Странно, что здесь еще не обсуждают запуск большого адронного коллайдера. По-моему, это страшно!

     
    Виктория
    Авг 14, 2008 23:45

    Действительно интересно написано. Почти за душу берет, ну и заставляет подумать над собственным блогом.

     
    microsoft windows defender
    Авг 15, 2008 16:53

    Урррра!!! Наконец-то хоть кто-то об этом написал.

     
    Твое Казань
    Авг 17, 2008 18:06

    Думается, можно и поинтереснее вещи найти, чем писать об этом :)

     
    Puma Казань
    Авг 18, 2008 01:19

    Написано хорошо. Но у меня, возможно, лучше получилось бы! :)

     
    disel
    Авг 25, 2008 12:01

    Ну ничё так.

     
    Dexter
    Авг 26, 2008 23:10

    Автор, а у вас никто записи не тырит c блога? А то у меня достали уже — копируют и копируют. И главное, что ссылку на мой сайт никто не удосужится поставить.

     
    Бруно
    Сен 3, 2008 09:24

    Опять-таки побочная проблема. Вряд ли она кому-то мешает, мне вот лично как то пофиг :)

     
    IvanS
    Сен 5, 2008 18:59

    Я так понимаю, в самом последнем абзаце как раз вся соль и изложена ;)

     
    николай
    Авг 27, 2011 06:37

    Интересно, хоть половина комментировавших поняли о чём речь??? :) Автору респект!!! Хороший мануал, мне очень пригодился!!!

     
    Antonio
    Авг 28, 2011 14:13

    Николай, то все проделки ботов-спаммеров, когда еще капчи не было =) ,
    ссылки я убрал, а комменты оставил по-приколу =),
    рад что пригодился мануал *THUMBS UP*

     

    Написать

    Копирование информации с сайта возможно только с указанием прямой ссылки - https://nemcd.com