名称
ftpaccess;-;ftpd;的配置档

描述
这个;ftpaccess;档案是用来配置下述功能的运作

存取功能(Access;Capabilities)
autogroup;<群组名称>;<类别>;[<类别>;...]
如果一个匿名的(ANONYMOUS);使用者是任何;<类别>;的成员，
那麽;ftp;;伺服器将会实行一次;setegid();到该;<群组名称>
。这允许特殊类别的匿名使用者存取;group-and-owner-read-
only;的档案以及目录。<群组名称>;是;/etc/group;里的一个
有效群组（或是你的;getgrent();呼叫所查阅的地方）。

class;<类别>;<类型列表>;<全球位址>;[<全球位址>;...]
定义使用者的;<类别>;，使用;<全球位址>;格式的来源位址。
可以定义;<类别>;多个成员。可以有多个;"class";;指令列出
该类别额外的成员。如果多个;"calss";;指令可以应用到该次
的连线期间，会使用在;access;档案中第一个列出的。尝试为
一台主机定义一个有效的类别失败的话将会引起存取被拒绝。
<类型列表>;是一个以任何;"anonymous",;"guest";及;"real"
关键字所组成使用逗点隔开的列表。如果包含;"real";关键字
，该类别可以符合使用;FTP;;存取真实的帐号的使用者，而如
果包含;"anonymous";关键字该类别可以符合使用匿名;FTP;的
使用者。而;"guest";关键字符合访客存取帐号（参阅;"guest
group";;以取得更多资讯）

<全球位址>;;可以是一个全球的领域名称或是一个全球的数字
位址。

deny;<全球位址>;<讯息档案>
永远拒绝符合;<全球位址>;主机的存取。显示;<讯息档案>;。
<全球位址>;可以是;"!nameserved";用来拒绝没有名称伺服器
服务中的节点的存取。

guestgroup;<群组名称>;[<群组名称>;...]
如果一个真实的(REAL)使用者是任何;<群组名称>;的成员，该
次连线期间的设立完全如同匿名的;FTP;;一般。换句话说，会
执行一次;chroot();，而且该使用者不再被允许发出;USER;及
PASS;指令。<群组名称>;是;/etc/group;里的一个有效群组（
或是你的;getgrent();呼叫所查阅的地方）。

该使用者的;home;目录必须适当地加以设定，跟匿名;FTP;;所
要做的完全一样。在;passwd;项目里的;home;目录栏位被分成
两个目录。第一个栏位将是;chroot();呼叫的根目录参数。第
二个部份是相对於该根目录的使用者;home;目录。这两半是以
"/./";分隔开的。

范例：

在;/etc/passwd;里，该真实的项目：

guest1::100:92:Guest
Account:/ftp/./incoming:/etc/ftponly

当;guest1;成功地签入的时候，此;ftp;;伺服器将会执行一次
chroot("/ftp");然後接著;chdir("/incoming");。该;;guest
使用者将只能够存取;/ftp;下的目录结构（此目录对;;guest1
而言看起来跟用起来就像是;/;目录），就如同一个匿名;;FTP
使用者所见到的。

limit;<类别>;<时间>;<讯息档案>
在某;<时间>;将某;<类别>;限制为;个使用者，若使用者
的存取被拒绝则显示;<讯息档案>;内容。限制的检查只在签入
时期实行。如果多个;"limit";;指令可以应用到该次连线期间
的话，会使用第一个适合的。尝试定义一个有效的限制失败，
或是值为;-1;的限制，等於不设限。<时间>;使用;UUCP;L.sys
档案相同的格式。

loginfails;<数字>
在;<数字>;签入失败後，记录一个″重复签入失败;(repeated
login;failures)讯息″并且终止该;FTP;连线。预设值是;5。

private;
使用者签入之後，SITE;GROUP;及;SITE;GPASS;;指令可以用来
指定一增强存取的群组以及与之有关的密码。如果该群组名称
以及密码是有效的，该使用者变成（经由;setegid()）一个在
群组存取档案;/etc/ftpgroups;中所指定群组的成员。

该群组存取档案的格式是：

存取群组名称：经编码的密码：真实群组名称

其中的存取群组是一个随意的（文数字＋标点）字串。经编码
的密码是经由;crypt(3);编码过的密码，与;/etc/passwd;;里
的完全一样。真实群组名称是;/etc/group;里所列出有效群组
其中的一个名称。

注意：要使这个选项能运作於匿名的;FTP;使用者，该;FTP;伺
服器必须保持使;/etc/group;永久开启而且将群组存取档案载
入记忆体。这意指;(1);该;ftp;伺服器现在使一个额外的档案
描述子(file;descriptor);开启，以及;(2);经由;SITE;GROUP
使用者必须的密码以及存取权利的承认在一次;FTP;;连线期间
以内将会是静态的。如果你有紧急的需求要＊现在＊改变存取
群组以及／或是密码，那麽你只要砍掉(kill)所有正在执行中
的;FTP;;伺服器。

资讯功能(Informational;Capabilities)
banner;<路径>
作用与;message;;指令类似，除了此;banner;是在使用者键入
使用者名称／密码之前显示以外。该;<路径>;系相对於真实的
系统根目录，不是匿名;FTP;;所使用的根目录。

警告：这个指令的使用可以完全地防止不相容的;FTP;;客户端
程式使用该;FTP;;伺服器。并非所有的客户端都能够处理多行
回应(multi-line;responses)（这正是;banner;显示的方式）

email;<名称>
定义;ftp;档案处(archive)维护者的电子邮递位址。这个字串
将会在每一次使用;%E;代换变数(magic;cookie)的时候印出。

message;<路径>;{<时机>;{<类别>;...}}
定义一个配合;<路径>;的档案名称在使用者签入时或是在使用
切换工作目录指令的时候;ftpd;将会显示该档案的内容。该项
<时机>;参数可以是;"LOGIN";或;"CWD=<目录>"。如果;<时机>
是;"CWD=<目录>";的话，<目录>;指定将会引发该通知的新预设
目录。

该选择性的;<类别>;指定允许该讯息只对特殊类别的成员显示
。可以指定超过一个类别。

在说明档中可以有″代换变数(magic;cookies)″;这会使;ftp
伺服器以指定的文字字串取代该变数：

%T;;;;;;本地时间;;;(form;Thu;;Nov;;15;;17:12:42
1990)
%F;;;;;;CWD;所在分割区的剩馀空间;(kbytes)
[并非所有系统都有支援]
%C;;;;;;目前的工作目录
%E;;;;;;定义在;ftpaccess;中维护者的电子邮递位址
%R;;;;;;远端主机名称
%L;;;;;;本地主机名称
%U;;;;;;签入时所给的使用者名称
%M;;;;;;这个类别所允许的最大使用者数目
%N;;;;;;这个类别目前的使用者数目

此项;message;;将只显示一次以避免惹使用者讨厌。要记得当
MESSAGEs;被一匿名的;FTP;使用者引发时，该;<路径>;必须是
相对於匿名;FTP;;目录树的根目录。

readme;<路径>;{<时机>;{<类别>}}
定义一个配合;<路径>;的档案名称在使用者签入时或是在使用
切换工作目录指令的时候;ftpd;将会告知使用者该档案存在及
修改的日期。;<时机>;参数可以是;"LOGIN";或;"CWD=<目录>"
。若;<时机>;是;"CWD=<目录>";的话，<目录>;;指定将会引发
该通知的新预设目录。此项讯息将只显示一次以避免打扰使用
者。要记得当;README;讯息被一匿名的;FTP;;使用者引发时，
该;<路径>;必须是相对於匿名;FTP;;目录树的根目录。

该选择性的;<类别>;指定允许该讯息只对特殊类别的成员显示
。可以指定超过一个类别。

记录功能(Logging;Capabilities)
log;commands;<类型列表>
以使用者启动个别的记录指令。;<类型列表>;是一个以任何的
"anonymous",;"guest";;及;"real";关键字所组成使用逗点隔
开的列表。如果包含;"real";关键字，将会为使用;FTP;;存取
真实帐号的使用者做记录，而如果包含;"anonymous";;关键字
则将会为使用匿名;FTP;;的使用者做记录。;"guest";;关键字
符合访客存取帐号（参阅;"guestgroup";以取得更多资讯）

log;transfers;<类型列表>;<目录>
启动对真实的或匿名的;FTP;;使用者的档案传输记录。对传输
到伺服器（进来）的记录可以跟从伺服器传输（出去）分开来
启动。;<类型列表>;是一个以任何的;"anonymous",;;"guest"
及;"real";关键字所组成使用逗点隔开的列表。如果其中包含
有;"real";关键字，将会为使用;FTP;;存取真实帐号的使用者
做记录，而如果包含;"anonymous";;关键字则将会为使用匿名
FTP;的使用者做记录。而;"guest";;关键字符合访客存取帐号
（参阅;"guestgroup";以取得更多资讯）。;<目录>;是一个以
任何的;"inbound";;以及;"outbound";两个关键字所组成以逗
点隔开的列表，而且将会分别引发对送往该伺服器以及从该伺
服器送出的传输记录。

其它功能(Miscellaneous;Capabilities)
alias;<字串>;<目录>
为一个目录定义一个别名，<字串>。可以用来加入逻辑目录的
其它概念。

例如：
alias;;;rfc:;;;;/pub/doc/rfc

允许使用者从任何目录以指令;"cd;rfc:";存取;/pub/doc/rfc
。别名只应用於;cd;指令上。

cdpath;<目录>
定义;cdpath;里的一个项目。这定义一个在改变目录时使用的
搜寻路径。

例如：

cdpath;/pub/packages
cdpath;/.aliases

允许使用者直接;cd;到任何;/pub/packages;或;/.alias;目录
以下的目录。该搜寻路径系以该行出现在;ftpaccess;;档案里
的顺序定义。

如果使用者所下的指令是：

cd;foo

则会以下列的顺序搜寻该目录：

./foo
一个称为;"foo";的别名
/pub/packages/foo
/.aliases/foo

该;cd;path;;只能够配合;cd;指令使用。如果你有数量很大的
别名那麽你可能想要设立一个目录别名链结到所有你希望能让
使用者使用的区域。

compress;[...]

tar;[...]
为任何符合任何;的类别启动压缩(compress)或
包裹(tar)功能。实际的转换(conversions)定义在外部的档案
FTPLIB/ftpconversions;;之中。

shutdown;<路径>
如果;<路径>;所指的档案存在，伺服器将会规律地检查该档案
以便得知该伺服器是否将要被停机。如果计画一次停机，则会
通告使用者，新的连线在停机之前的一段指定的时间之後会被
拒绝且目前的连线在停机之前的一段指定的时间之後会被停止
。<路径>指到一个结构如下的档案：

<年>;<月>;<日>;<时>;;<分>;;<拒绝_期间>
<抛弃_期间>
<本文>

<年>;任何;>;1970;的年份
<月>;0-11;<----;注意!
<时>;0-23
<分>;0-59

<拒绝_期间>;;以及;<抛弃_期间>;是在停机之前新的连线将会
被拒绝以及存在的连线将会被抛弃的一段格式为;HHMM;的期间
。

<本文>;;跟从任何讯息（参阅;"message"）的一般规则，配合
下列额外可用的代换变数：

%s;;;;;;系统将要停机的时间
%r;;;;;;新的连线将会被拒绝的时间
%d;;;;;;目前的连线将会被抛弃的时间

所有时间的格式都是：;ddd;MMM;DD;hh:mm:ss;YYYY;。在该配
置档中只能有一个;"shutdown";指令。

外部程式;ftpshut(8);可以用来自动化产生这个档案的程序。

许可功能(Permission;Capabilities)
chmod;<类型列表>

delete;<类型列表>

overwrite;<类型列表>

umask;<类型列表>
允许或不允许执行指定功能的能力。依照预设值，允许所有的
使用者执行。

<类型列表>;是一个以任何;"anonymous",;"guest";及;"real"
关键字所组成使用逗点隔开的列表。

passwd-check;()
定义该伺服器对匿名;ftp;;密码检查的层级与执行。

none;;;;;;不执行密码检查。
trivial;;;密码中必须包含一个;'@';字元。
rfc822;;;;密码必须是一个;rfc822;相容的位址。

warn;;;;;;警告该使用者，但是允许他们签入。
enforce;;;警告该使用者，并且接著将之踢出。

path-filter;<类型列表>;<讯息>;<允许的字元集>
{<不允许的正规表示式>;...}
对於属於;<类型列表>;的使用者，path-filter;定义控制何种
档案名称允许或不允许的正规表示式;(regular;expressions)
。可以有多个不允许的正规表示式。如果一个档案名称因为不
符合正规表示式的标准而无效的话，将会显示;<讯息>;给该使
用者。例如：

path-filter;;;anonymous;;;;/etc/pathmsg;;;;^[-A-Za-
z0-9._]*$;^.;^-

指定所有匿名使用者所上传的档案名称只能以;A-Z,;a-z,;0-9
以及;"._-";;组成而且不能以一个;".";或是一个;"-";开始。
如果该档案名称是不合法的，则将会显示;/etc/pathmsg;给该
使用者。

upload;;;;;<拥有者>;;;<群组>
["dirs"|"nodirs"]
配合;定义一个认可或拒绝上传的目录。

如果其认可上传，所有档案将会由;<拥有者>;以及;<群组>;所
拥有而且将会具有根据;设置的权限(permission)。

目录系以最佳-符合(best-match)为基础。

例如：

upload;;*;;;;;;;no
upload;;/incoming;;;;;;;yes;;ftp;;daemon;;0666
upload;;;/incoming/gifs;;;yes;;;jlc;;;guest;;;;0600
nodirs

这将仅允许上传到;/incoming;以及;/incoming/gifs。上传到
/incoming;的档案将由;ftp/daemon;所拥有并且具有;0666;的
权限。上传到;/incoming/gifs;的档案将由;jlc/guest;;拥有
并且具有;0600;的权限。

选择性的;"dir";以及;"nodir";关键字可以指定允许或不允许
使用;mkdir;指令建立新的子目录。

该;upload;关键字只应用於匿名的使用者。

档案
FTPLIB/ftpaccess

参阅

标签： linux