ioftpd中文版文档.docx

1、ioftpd中文版文档索引 1. 目录结构 2. 安装指南 3. 虚拟文件系统(VFS) 基本VFS设置 子目录加载 用于存档的Raid目录加载 不同用户和/或不同组的VFS文件 私有目录 符号链接 目录权限设置 4. 设备 5. 作为系统服务启动 ioFTPD的缺省端口 服务布置 Services详细设置 取消服务 自定义Devices和Services 通过HTTP和TELNET连接 6. site命令 Add/Delete/Rename/Kick Users Groups IP CHMOD/CHOWN/Stats及其他 Stats SITE CHANGE SITE CHATTR SITE

2、 CONFIG 7. 标识和权限 8. SECTIONS 9. SCHEDULER 10. USERFILES和GROUPFILES : ioFTPD 文档 : index - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 : 1. 目录结构 ioFTPD主目录包括以下文件：Changelog, TODO, README.1ST 更新记录文件包含了ioFTPD的最新更新内容，可使您及时了解软件的bug修正及新增特征等。 TODO文档列出了ioFTPD未来版本中要添加的内容。 README.1ST文件为一些必要的法律公告。 - ioFTPD下的目录包括： /cac

3、he 包括缓存文件，您不能改动此目录下的任何文件。 /etc 目录内文件包括 UserIdTable -用户及其UID(用户ID)列表 GroupIdTable - 组及其GID（组ID）列表 default.vfs和admin.vfs - VFS示例文件 ioftpd.env - 定义环境变量 /groups 组数据文件。文件名即为GID（组ID） /help 帮助文件。 /lib TCL库 /logs 服务器运行记录文件如Error.log及Sysop.log等. /scripts ioFTPD的第三方脚本。 /site 您的site的缺省根目录。 /source 可能对脚本编写有用的源代

4、码。 /system ioFTPD.exe, ioFTPD.ini, tcl84.dll /text 用户登陆时显示的信息文件，以及运行命令时显示的状态信息等文件。 /users 用户数据文件。文件名为UID(用户ID）。 : ioFTPD 文档 : index - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 : 2. 安装指南 此文档可让您在几分钟内最快速成功配置ioFTPD！ 1. 解压ioFTPD文件包。 2. 编辑 .etcdefault.vfs. 注意根目录必须加载为：;/;. 如：: d:ftp / - 用已有的空目录作根目录。 e:mp3 /mp

5、3 - 在根目录加载为/mp3 注意组ioftpd(缺省用户ioFTPD所在的组）的虚拟目录文件缺省为admin.vfs。要让ioftpd组使用default.vfs，可用命令： site change ioftpd groupvfsfile .etcdefault.vfs 或将.groups目录下0文件内的VFSFILE行删除即可。 3. 打开.systemioFTPD.ini. 在ioFTPD.ini中，注释行用“#”，取消选项/设置用分号;。 # Comment ;Disabled = True 3a. 设置DEVICES。. 在多数情况下可用缺省设置。 缺省device名为;Any;.

6、 Any Host = 0.0.0.0 - 未定义IP，则允许在任何IP上连接。 Ports = 1024-2048 - 数据传输端口。 Random = True - 使用随机端口。 3b. 设置SERVICES（示例仅用于FTP_Service) FTP_Service Type = FTP Device_Name = Any - 使用的Device。缺省为;Any; Port = 9999 - 连接端口 Description = My FTP Service User_Limit = 10 - 最大连接用户数。 Allowed_Users = * Messages = .textftp

7、 Require_Encrypted_Auth = !* - 无用户使用加密请求。 Require_Encrypted_Data = !* ;Certificate_Name = 192.168.1.11 - SLL认证名（CN）:若不使用认证，请注释此行，否则你的ftpd不会运行！ Explicit_Encryption = True Encryption_Protocol = SSL3 Min_Cipher_Strength = 128 Max_Cipher_Strength = 384 ;Get_External_Ident = False - True/False. 保护支持 ;Dat

8、a_Devices = - 流量平衡设备 ;Random_Devices = False - True/False. Data_Devices使用随机次序。 需要更高级的devices及services，如NAT及流量平衡等设置样例文件，请参见ioFTPD-Advanced.ini。 4. 用缺省的管理员（Master）帐号登陆，注意在ioFTPD下，用户名、密码、组名、标识名及其他名称均区分大小写！ 用户名：ioFTPD 密码：ioFTPD 5. 使用SITE PASSWD 更改缺省的ioFTPD密码。 6. 打开并编辑 .etcHosts.Rules，使其可由外部IP连接。 在最新的未注册

9、版本中，缺省规则为禁止（DENY）. 注释此缺省行，并去掉ALLOW行的注释。若ioFTPD.exe正在运行，则需重启（修改Hosts.Rules需要完全重启)。 完成！现在请阅读此文档其余部分，提高您的配置技巧。 问：什么是Master帐号？ 答：Master权限帐号登陆后可做几乎任何事。可浏览所有目录，传输任何文件，即使其被别的用户限制。可以更改别的用户或组（但不能更改别的Master帐号）的设置。Master的旗标是M。 其他FAQ，请见ioFTPD主页的知识基地. - 提示#1: 好的脚本、sfv校验、sitebot、已知bug及其他ioFTPD信息，请查看论坛. 提示 #2: 在登陆

10、服务器时出现错误，请检查.logsError.log文件。 提示 #3: 要学会如何用site命令控制ioFTPD。 提示#4: 请阅读此文档的其他部分，更多了解ioFTPD。 - : ioFTPD 文档 : index - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 : 3. 虚拟文件系统(VFS) VFS文件用来创建服务器的文件目录结构，用户登陆后即可见。示例的VFS文件为default.vfs和admin.vfs，均位于.etc目录下。 基本VFS设置 子目录加载 用于存档的Raid目录加载 不同用户和/或不同组的VFS文件 私有目录 符号链接 目录权限

11、设置 - 基本VFS设置 最快的VFS文件设置法是将一空目录设置为根目录，这样必须在你的VFS文件中将此目录加载为：;/; 如下： c:ioFTPDsite / 在.site目录下有些示例目录，你可以删除它们。 然后你可指定VFS根目录下要显示的目录。 如： c:ioFTPDsite / d:games /games e:mp3 /mp3 也支持驱动器盘符的直接加载，但不推荐此设置，因为不能隐藏象系统卷标信息之类的系统目录。 如： f: /f-drive g: /g-drive 要设置这些目录的权限（这样用户就可上传等），请用SITE CHMOD. 这些是ioftpd新手需要了解的基本设置，高

12、级VFS设置请参见下面内容 - 加载子目录 ioFTPDs VFS十分灵活，你可指定某些目录作为子目录。 但要确保你的上级目录存在（此处为/mnt）。 如： c:ioFTPDsite / c:ioFTPDmnt /mnt c: /mnt/c-drive d: /mnt/d-drive e: /mnt/cdrom - 用于文件存储目的的Raid目录加载 可合并两个或更多目录内容，如下： 注意：对于只读目的！尽管可写，但上传的文件（在Raided VFS目录下）会被存储在最后一个指定的设备下，此处为e:dir2。 如： d:目录1 /存档文件 e:目录2 /存档文件 - 不用用户和/或组的VFS文

13、件 要为用户指定不同的VFS文件，仅需新建一VFS文件，并使用此命令来更改用户的VFS文件 site change vfsfile .etccustom.vfs 你也可改变某个组的VFS，该组下所有用户均自动使用此组VFS文件 如： site change groupvfsfile .etcgroup1.vfs 重要！用户VFS文件会覆盖组VFS文件。你已用一指定的组VFS文件更改了组内某用户的VFS文件，且你想让此用户使用此组VFS文件，可清除.users目录下的用户 user文件中的VFSFILE行，或者用命令更改此用户的VFS文件至此组VFS文件：site change vfsfile

14、.etcgroup1.vfs 记住若将用户的VFS文件改变为与组VFS文件的文件，且然后又将此组VFS文件改变为另一个文件，你需要再一次改变用户的VFS文件。 - 私有目录 另一种不同目录的权限设置（包括不同的VFS）方法为私有路径。私有路径对其他用户隐藏，即使这些目录也存在于他们的VFS中。这样便很容易地设置VFS，而不必设置多重VFS文件（使某些用户使用某些目录）。除了Master,其他用户无权进入私有目录。私有目录不对Master隐藏。 SITE命令site chattr用于设置私有目录，此命令也可将目录转换为符号链接。 用法： site chattr +h 示例： site chatt

15、r +h 私有目录 -用户2 -用户5 =组11 若目录名包含空格，或你指定多个用户和/或组权限时，则需要用引号(; ;) 引用。旗标也可在权限列表中使用。 使用以下命令查看当前私有目录的权限： site chattr +h 目录 联想到+h是指;hidden;， 很容易便可记住+h是指私有目录，+l指目录链接。 - 符号链接 符号链接是一个快捷目录，可指向你的虚拟文件系统中的任何指定位置。 使用SITE命令site chattr将目录转换成符号链接。 用法： site chattr +l 示例： site chattr +l mp3-today /mp3/0525 使用以下命令查看当前路径的

16、链接指向： site chattr +l 符号链接名 符号链接也可设置为私有路径。 - 目录权限的详细设置 如果你想禁止某些目录的上传，那么VFS的此部分设置是很有用的。权限前缀;!; 表示禁止，如!-user !=group !F。也可指定多个用户和/或组，如!-user1 -user2 =group1，此处仅user1被禁止。 以下是ioFTPD.ini里的缺省设置： VFS . # # 目录权限的详细设置 # # priviledge = # Upload = * * Resume = * * Download = * * MakeDir = * * RemoveDir = * * Re

17、moveOwnDir = * * Rename = * 1VM RenameOwn = * * Overwrite = * VM Delete = * 1VM DeleteOwn = * * NoStats = * !* 虚拟路径用此格式：/目录/* - 规则为首个匹配即生效。 在虚拟目录和权限间，仅可使用空格，不要用tab键空格。 最后的*是必须的，表示允许其他所有人。 - 示例： # 所有GuestGroup组的用户不可创建目录 # 也不可在mp3目录内上传文件，但其他用户被允许此二项。 # MakeDir = /mp3/* !=GuestGroup * MakeDir = * * Upl

18、oad = /mp3/* !=GuestGroup * Upload = * * ioFTPD 4.9.0（包含RemoviOwnDir）后的版本有一个新功能NoStats，NoStats取消指定用户和/或组的状态统计。NoStats是路径相关的。记住，在这些指定目录下，这些用户和/或组的活动不被计入统计。 总将NoStats = * !*放在最底部，否则活动统计对其他用户也会失效。可在此行上方加入你自己的NoStats行。 : ioFTPD 文档 : index - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 : 4. 设备 在设备区，你将指定ioFTPD使

19、用哪些IP和数据端口。 会在配置ioFTPD的services区时使用设备名（Device Name). 配置相当简单： DeviceName Host = Ports = Random = Bind = # 以下摘自示例ioFTPD.ini Any Host = 0.0.0.0 Ports = 1024-2048 Random = True Any - 设备名（此处为Any） Host - 外部主机，此地址会显示给用户。 Host = 0.0.0.0使用sockets连接的那个IP，取决于你主机的IP及你的用户连接的IP。 表示允许在任何IP上连接，如127.0.0.1，你的内部LAN IP

20、如192.168.0.1及你的外部IP等。 Ports - 用于数据传输的端口，可包括逗号将端口范围列表分开。 如： Ports = 1024-2048, 3355, 5000-5999, 25001-26000, 31337 Random - True/False. 数据传输使用随机次序端口 Bind - 内部主机。若指定，则连接绑定于此地址，而不是HOST。若你在路由后方则使用BIND，BIND是你的内部IP。 #ioFTPD-Advanced.ini中使用绑定设置的例子 Nat Host = 212.146.42.251 - 奜晹IP/楬桼婍IP Ports = 25001-26000

21、Random = True Bind = 192.168.1.10 Device_Name、MaxUsers - User_Limit、Req_Encrypted_Auth - Require_Encrypted_Auth 等等 FTP_Service Type = FTP Device_Name = Any Port = 9999 Description = My FTP Service User_Limit = 10 Allowed_Users = * ;Messages = .textftp # 加密 # # Require_Encrypted_Auth = !* Require_Enc

22、rypted_Data = !* Certificate_Name = 192.168.1.11 Explicit_Encryption = True Encryption_Protocol = SSL3 Min_Cipher_Strength = 128 Max_Cipher_Strength = 384 # IDNT 命令处理 # # ;Get_External_Ident = False # 负载均衡 # # ;Data_Devices = ;Random_Devices = False - 服务细节 FTP_Service - 服务名称 Type = FTP - 键入FTP，HTTP或

23、者TELNET Device_Name = Any - 所使用设备名称 Port = 9999 - 连接端口！ Description = My FTP Service - 描述 User_Limit = 10 - 最大用户连接数 Allowed_Users = * - 拥有这些标记的用户有登录权限. * = 所有人 ;Messages = .textftp - 使用其他信息替代默认信息？ Require_Encrypted_Auth = !* - 强制这些用户使用安全登录.!* 表示无人 Require_Encrypted_Data = !* - 强制安全数据传输。 Certificate_Name = 192.168.1.11 - SSL 证书名(CN). Explicit_Encryption = True Encryption_Protocol = SSL3 - TLS/SSL3/SSL2/SSL1/SSL Min_Cipher_Strength = 128 - 128-bit Max_Cipher_Strength = 384 - 384-bit ;Get_External_Ident = False - True/False. IDN命令处理.保镖支持.(?) ;Data_Devices = - 负载均衡设备 ;Random_Devices