OpenNET: статья - Возможности vsftpd и примеры их использования. (vsftpd ftp)

Ключевые слова: vsftpd, ftp, (найти похожие документы)
From: Александр Головин aka screenn, <alex.golovin@mail.ru.> 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, <alex.golovin@mail.ru.>; Andrew Clark <andrewclarkii@gmail.com.> Полезные ссылки: 1. http://vsftpd.beasts.org - домашняя страница vsftpd 2. http://vsftpd.devnet.ru -- альтернативные сборки vsftpd 3. http://viki.brainsware.org - viki - vsftpd Wiki

2.12, screenn (ok), 11:01, 18/07/2008 [^] [^^] [^^^] [ответить]

+/–

>Есть ли шансы в lenny (следующем стабильном релизе Debian) увидеть в man'е
>этот русский перевод?
>Было бы приятно.

Я думаю есть такие шансы, если добавить его в manpages-ru к примеру, только я смотрю этот пакет не очень активно развивается сегодня:

Package manpages-ru
    * sarge (oldstable) (doc): Russian translations of Linux manpages
      0.7d-3: all
    * etch (stable) (doc): Russian translations of Linux manpages
      0.98-4: all
    * etch-m68k (doc): Russian translations of Linux manpages
      0.98-4: all
    * lenny (testing) (doc): Russian translations of Linux manpages
      0.98-4: all
    * sid (unstable) (doc): Russian translations of Linux manpages
      0.98-4: all

А это идея - добавить man по vsftpd и довести пакет до версии 1.0.

2.20, screenn (ok), 21:04, 21/01/2011 [^] [^^] [^^^] [ответить]

+/–

> Перевод нуждается в серьезной корректировке.
> Например, пункт касающийся "chroot_local_user" переведён с точностью до наоборот.

chroot_local_user
If set to YES, local users will be (by default) placed in a chroot() jail in their home directory after login. Warning: This option has security implications (носит характер безопасности), especially if the users have upload permission, or shell access. Only enable if you know what you are doing. Note that these security implications are not vsftpd specific. They apply to all FTP daemons which offer to put local users in chroot() jails.
Default: NO

Вижу: This option has security implications (носит характер безопасности),

Какие еще недароботки вы нашли, возможно предложите свой вариант перевода по этой опции?

3.21, Аноним (-), 23:03, 21/01/2011 [^] [^^] [^^^] [ответить]

+/–

Примерно так:

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

3.22, Аноним (-), 23:20, 21/01/2011 [^] [^^] [^^^] [ответить]	+/–
Или может быть даже лучше так: chroot_local_user Если установлено "YES", локальные пользователи будут (по умолчанию) переведены в свой домашний каталог и ограничены им (при помощи chroot() "заточения") после логина. Предостережение: Эта опция несёт потенциальную уязвимость, особенно если у пользователей есть права на загрузку файлов на сервер или shell доступ. Включайте опцию только если осознаёте эти риски. Обратите внимание, что данная проблема характерна не только для vsftpd. Ни один FTP-сервер не защищен от потенциальной уязвимости при использовании chroot() "заточения". Default: NO

4.23, screenn (ok), 14:01, 24/01/2011 [^] [^^] [^^^] [ответить]	+/–
новая версия перевода находится в очереди на публикацию у администрации сайта.