PureFTPd 系列中文文档之PureFTPd 配置文件

############################################################
#                                                          #
#         Configuration file for pure-ftpd wrappers        #
#                                                          #
############################################################

# If you want to run Pure-FTPd with this configuration  
# instead of command-line options, please run the
# following command :
#
# /usr/local/pure-ftpd/sbin/pure-config.pl /usr/local/pure-ftpd/etc/pure-ftpd.conf  使用配置文件代替命令行选项来运行 Pure-FTPd
#
# Please don't forget to have a look at documentation at
# http://www.pureftpd.org/documentation.shtml for a complete list of
# options.

# Cage in every user in his home directory  限制所有用户在其主目录中

ChrootEveryone              no

 

# If the previous option is set to "no", members of the following group
# won't be caged. Others will be. If you don't want chroot()ing anyone,
# just comment out ChrootEveryone and TrustedGID.

 TrustedGID                   100              因为前一个指令被设置为了 "no"，下面组的成员(GID)就不受主目录的限制了。而其他的用户还是
会被限制在自己的主目录里

 

# Turn on compatibility hacks for broken clients      兼容ie等比较非正规化的ftp客户端

BrokenClientsCompatibility  no

 

# Maximum number of simultaneous users           服务器总共允许同时连接的最大用户数

MaxClientsNumber            50

 

# Fork in background                          做为守护(doemon)进程运行(Fork in background)
 

Daemonize                   yes

 

# Maximum number of sim clients with the same IP address   同一IP允许同时连接的用户数

MaxClientsPerIP             1

 

# If you want to log all client commands, set this to "yes".
# This directive can be duplicated to also log server responses. 记录所有客户的命令

VerboseLog                  no

 

# List dot-files even when the client doesn't send "-a". 可以列出隐藏的文件

DisplayDotFiles             yes

 

# Don't allow authenticated users - have a public anonymous FTP only.不允许认证用户 - 仅作为一个公共的匿名FTP

AnonymousOnly               no

 

# Disallow anonymous connections. Only allow authenticated users. 不允许匿名连接，仅允许认证用户使用

NoAnonymous                 yes

 

# Syslog facility (auth, authpriv, daemon, ftp, security, user, local*)
# The default facility is "ftp". "none" disables logging.

SyslogFacility              ftp          缺省的功能( facility )是 "ftp

 

# Display fortune cookies               用户登陆后的显示信息

# FortunesFile              /usr/share/fortune/zippy

 

# Don't resolve host names in log files. Logs are less verbose, but
# it uses less bandwidth. Set this to "yes" on very busy servers or
# if you don't have a working DNS.

DontResolve                 yes

 

# Maximum idle time in minutes (default = 15 minutes)         客户端允许的最大的空闲时间（分钟，缺省15分钟

MaxIdleTime                 15

 

# LDAP configuration file (see README.LDAP)    

# LDAPConfigFile                /etc/pureftpd-ldap.conf

 

# MySQL configuration file (see README.MySQL)

# MySQLConfigFile               /etc/pureftpd-mysql.conf

# Postgres configuration file (see README.PGSQL)

# PGSQLConfigFile               /etc/pureftpd-pgsql.conf

# PureDB user database (see README.Virtual-Users)

# PureDB                        /etc/pureftpd.pdb

# Path to pure-authd socket (see README.Authentication-Modules)

# ExtAuth                       /var/run/ftpd.sock

 

# If you want to enable PAM authentication, uncomment the following line  启用PAM认证

# PAMAuthentication             yes

 

# If you want simple Unix (/etc/passwd) authentication, uncomment this  启用简单的unix用户认证

 UnixAuthentication            yes

 

# Please note that LDAPConfigFile, MySQLConfigFile, PAMAuthentication and
# UnixAuthentication can be used only once, but they can be combined
# together. For instance, if you use MySQLConfigFile, then UnixAuthentication,
# the SQL server will be asked. If the SQL authentication fails because the
# user wasn't found, another try # will be done with /etc/passwd and
# /etc/shadow. If the SQL authentication fails because the password was wrong,
# the authentication chain stops here. Authentication methods are chained in
# the order they are given.

 

# 'ls' recursion limits. The first argument is the maximum number of
# files to be displayed. The second one is the max subdirectories depth

LimitRecursion              2000 8 'ls' 命令的递归限制。第一个参数给出文件显示的最大数目。第二个参数给出最大的子目录深度。

 

# Are anonymous users allowed to create new directories ? 是否允许匿名用户创建新目录

AnonymousCanCreateDirs      no

 

# If the system is more loaded than the following value,如果系统被 loaded 超过下面的值，匿名用户会被禁止下载
# anonymous users aren't allowed to download.

MaxLoad                     4

 

# Port range for passive connections replies. - for firewalling.被动连接响应的端口范围。-

# PassivePortRange          30000 50000

 

# Force an IP address in PASV/EPSV/SPSV replies. - for NAT.强制一个IP地址使用被动响应
# Symbolic host names are also accepted for gateways with dynamic IP
# addresses.

# ForcePassiveIP                192.168.0.1

 

# Upload/download ratio for anonymous users. 匿名用户的上传/下载的比率。

# AnonymousRatio                1 10

 

# Upload/download ratio for all users.  所有用户的上传/下载的比率
# This directive superscedes the previous one.

# UserRatio                 1 10

 

# Disallow downloading of files owned by "ftp", ie. 不接受所有者为 "ftp" 的文件的下载。例如：那些匿名用户上传后未被本地管理员验证的文件。

# files that were uploaded but not validated by a local admin.

AntiWarez                   yes

 

# IP address/port to listen to (default=all IP and port 21). 服务监听的IP 地址和端口

# Bind                      127.0.0.1,21

 

# Maximum bandwidth for anonymous users in KB/s    匿名用户的最大带宽（KB/s）。

# AnonymousBandwidth            8

 

# Maximum bandwidth for *all* users (including anonymous) in KB/s所有用户的最大带宽（KB/s），包括匿名用户
# Use AnonymousBandwidth *or* UserBandwidth, both makes no sense.

# UserBandwidth             8

 

# File creation mask. <umask for files>:<umask for dirs> .新建目录及文件的属性掩码值
# 177:077 if you feel paranoid.

Umask                       133:022

 

# Minimum UID for an authenticated user to log in.  认证用户允许登陆的最小组ID（UID）

MinUID                      100

 

# Allow FXP transfers for authenticated users.仅允许认证用户进行 FXP 传输。

AllowUserFXP                no

 

# Allow anonymous FXP for anonymous and non-anonymous users.对匿名用户和非匿名用户允许进行匿名 FXP 传输

AllowAnonymousFXP           yes

 

# Users can't delete/write files beginning with a dot ('.')用户不能删除和写点文件（文件名以 '.' 开头的文件），即使用户是文件的所有者也不行。
# 如果 TrustedGID 指令是 enabled ，文件所属组用户能够访问点文件(dot-files)。

# even if they own them. If TrustedGID is enabled, this group
# will have access to dot-files, though.

ProhibitDotFilesWrite       yes

 

# Prohibit *reading* of files beginning with a dot (.history, .ssh...) 禁止读点文件（文件名以 '.' 开头的文件） (.history, .ssh...)

ProhibitDotFilesRead        yes

 

# Never overwrite files. When a file whoose name already exist is uploaded,永不覆盖文件。当上传的文件，其文件名已经存在时，自动重命名
# it get automatically renamed to file.1, file.2, file.3, ...

AutoRename                  no

 

# Disallow anonymous users to upload new files (no = upload is allowed)不接受匿名用户上传新文件( no = 允许上传)

AnonymousCantUpload         no

 

# Only connections to this specific IP address are allowed to be仅允许来自以下IP地址的非匿名用户连接。你可以使用这个指令来打开几个公网IP来提供匿名FTP
# non-anonymous. You can use this directive to open several public IPs for
# anonymous FTP, and keep a private firewalled IP for remote administration.保留一个私有的防火墙保护的IP来进行远程管理。你还可以只允许一内网地址进行认证，而在另外
# You can also only allow a non-routable local IP (like 10.x.x.x) to一个IP上提供纯匿名的FTP服务。
# authenticate, and keep a public anon-only FTP server on another IP.

#TrustedIP                  10.1.1.1

 

# If you want to add the PID to every logged line, uncomment the following如果你要为日志每一行添加 PID 去掉下面行的注释。

# line.

#LogPID                     yes

 

# Create an additional log file with transfers logged in a Apache-like format :
# fw.c9x.org - jedi [13/Dec/1975:19:36:39] "GET /ftp/linux.tar.bz2" 200 21809338
# This log file can then be processed by www traffic analyzers. 这个日志文件能被 www 流量分析器处理。

# AltLog                     clf:/var/log/pureftpd.log

 

# Create an additional log file with transfers logged in a format optimized 使用优化过的格式为统计报告创建一个额外的日志文件。

# for statistic reports.

# AltLog                     stats:/var/log/pureftpd.log

 

# Create an additional log file with transfers logged in the standard W3C
# format (compatible with most commercial log analyzers)

# AltLog                     w3c:/var/log/pureftpd.log

 

# Disallow the CHMOD command. Users can't change perms of their files.不接受 CHMOD 命令。用户不能更改他们文件的属性

NoChmod                     yes

 

# Allow users to resume and upload files, but *NOT* to delete them.允许用户恢复和上传文件，却不允许删除他们

KeepAllFiles                yes

 

# Automatically create home directories if they are missing 用户主目录不存在的话，自动创建。

#CreateHomeDir               yes

 

# Enable virtual quotas. The first number is the max number of files. 启用虚拟的磁盘限额。第一个数字是最大的文件数。
# The second number is the max size of megabytes. 第二个数字是最大的总的文件大小(单位：Mb)。
# So 1000:10 limits every user to 1000 files and 10 Mb.所以，1000:10 就限制每一个用户只能使用 1000 个文件，共10Mb。

#Quota                       1000:10

 

# If your pure-ftpd has been compiled with standalone support, you can change如果你的 pure-ftpd 编译时加入了独立服务器( standalone )支持，你能够改变 pid 文件
的位置。缺省位置是 /var/run/pure-ftpd.pid 。

# the location of the pid file. The default is /var/run/pure-ftpd.pid

#PIDFile                     /var/run/pure-ftpd.pid

 

# If your pure-ftpd has been compiled with pure-uploadscript support,如果你的 pure-ftpd 编译时加入了 pure-uploadscript 支持，
# this will make pure-ftpd write info about new uploads to这个指令将会使 pure-ftpd 发送关于新上传的情况信息到 /var/run/pure-ftpd.upload.pipe，
# /var/run/pure-ftpd.upload.pipe so pure-uploadscript can read it and这样 pure-uploadscript
就能读然后调用一个脚本去处理新的上传。

# spawn a script to handle the upload.

#CallUploadScript yes

 

# This option is useful with servers where anonymous upload is 这个选项对允许匿名上传的服务器是有用的。当 /var/ftp 在 /var 里时，需要保留一定磁盘空间
来保护日志文件。当所在磁盘分区使用超过百分之 X 时，将不在接受新的上传。
# allowed. As /var/ftp is in /var, it save some space and protect
# the log files. When the partition is more that X percent full,
# new uploads are disallowed.

MaxDiskUsage               99

 

# Set to 'yes' if you don't want your users to rename files. 如果你不想要你的用户重命名文件的话，就设置为 'yes' 。

#NoRename                  yes

 

# Be 'customer proof' : workaround against common customer mistakes like
# 'chmod 0 public_html', that are valid, but that could cause ignorant
# customers to lock their files, and then keep your technical support busy
# with silly issues. If you're sure all your users have some basic Unix
# knowledge, this feature is useless. If you're a hosting service, enable it.

CustomerProof              yes

 

# Per-user concurrency limits. It will only work if the FTP server has 每一个用户的并发限制。只有在添加了 --with-peruserlimits 编译选项进行编译后，这个指令才起 作用
# been compiled with --with-peruserlimits (and this is the case on
# most binary distributions) .
# The format is : <max sessions per user>:<max anonymous sessions><每一个用户最大允许的进程>;:<最大的匿名用户进程>;

# For instance, 3:20 means that the same authenticated user can have 3 active
# sessions max. And there are 20 anonymous sessions max.

# PerUserLimits            3:20

 

# When a file is uploaded and there is already a previous version of the file
# with the same name, the old file will neither get removed nor truncated.
# Upload will take place in a temporary file and once the upload is complete,
# the switch to the new version will be atomic. For instance, when a large PHP
# script is being uploaded, the web server will still serve the old version and
# immediatly switch to the new one as soon as the full file will have been
# transfered. This option is incompatible with virtual quotas.

# NoTruncate               yes