IIS 7.0 及更高版本中的 FTP 状态代码

IIS (Internet Information Services) 7.0 及更高版本中的 FTP 状态代码是 FTP 协议的一部分，用于指示 FTP 命令执行的结果。这些状态码与 RFC 959 和后续扩展标准保持一致，但 IIS 也提供了一些特有的或更详细的代码。

状态码是一个三位数字，第一位数字表示响应的类别：

• 1yz - 积极初步回复：命令已被接受，但需要进一步操作才能完成。
• 2yz - 积极完成回复：命令已成功完成。
• 3yz - 积极中间回复：命令已被接受，但需要更多信息（例如密码）。
• 4yz - 瞬时消极完成回复：命令未成功，但错误可能是暂时的，可以重试。
• 5yz - 永久消极完成回复：命令失败，不应重试。

以下是 IIS 7.0+ 中常见且一些关键的 FTP 状态代码列表：

常用成功代码 (2xx, 3xx)

• 125：数据连接已打开，传输即将开始。
• 150：文件状态良好，正在打开数据连接。
• 200：命令成功。
• 212：目录状态。
• 213：文件状态。
• 214：帮助消息。
• 220：服务就绪（FTP 服务器欢迎信息）。
• 221：服务正在关闭控制连接。
• 226：关闭数据连接，请求的文件操作已成功（例如，文件传输完成或目录列表已发送）。
• 227：进入被动模式（提供服务器IP和端口）。
• 230：用户已登录，继续进行。
• 250：请求的文件操作正常，已完成。
• 257：已创建“PATHNAME”。

需要更多信息的代码 (3xx)

• 331：用户名正确，需要密码。
• 332：需要登录帐户。
• 350：请求的文件操作需要更多信息。

常见错误代码 (4xx, 5xx)

• 421：服务不可用，正在关闭控制连接。
• 425：无法打开数据连接。
• 426：连接关闭，传输被中止。
• 450：请求的文件操作未执行，文件不可用（例如，文件正被占用）。
• 451：请求的操作被中止：正在处理本地错误。
• 500：语法错误，命令无法识别。
• 501：参数或变元中的语法错误。
• 502：命令未实现。
• 503：命令顺序错误（例如，需要先登录）。
• 504：命令参数未实现。
• 530：未登录（用户名/密码错误，或需要登录）。
• 532：存储文件需要帐户。
• 550：请求的操作未执行，文件不可用（例如，文件未找到，无访问权限）。
• 551：请求的操作被中止：页面类型未知。
• 552：请求的文件操作被中止：超出存储分配。
• 553：请求的操作未执行：文件名不允许。

IIS 特有的或重要的扩展代码

IIS 在遵循标准的同时，会使用一些代码来提供更具体的诊断信息，尤其是在与 Windows 身份验证、授权和文件系统权限集成时：

• 530 系列：登录失败是 IIS FTP 中最常见的错误之一。除了标准的 530，底层原因可能通过子状态码或日志条目来体现，例如：
  • 530 User cannot log in.：通常表示用户名或密码错误。
  • 530 Not logged in.：可能因为 FTP 身份验证设置（如要求 SSL）或用户权限问题。
• 550：权限被拒绝。这通常意味着：
  • 文件/文件夹不存在。
  • 用户对目标文件或目录没有足够的 NTFS 权限（读取、写入、修改）。
  • 尝试覆盖只读文件。
• 426 或 425：常见于被动模式问题。这可能是因为防火墙/路由器没有正确配置以允许数据连接端口范围，或 Windows 防火墙阻止了 FTP 数据流量。

故障排除关键点

当在 IIS 中遇到 FTP 问题时，检查状态码是第一步：

• 默认位置：%SystemDrive%\inetpub\logs\ftpsvc<站点ID>\
• 日志会记录每个会话和操作的状态码（sc-status 字段），这是最准确的诊断依据。
• 日志还包含 sc-win32-status（Windows 状态码），它能将 FTP 错误映射到底层的系统错误（例如，5 = 访问被拒，2 = 文件未找到）。

• 登录失败 (530)：检查用户名/密码、FTP 身份验证设置、用户是否有“登录”权限。
• 上传/下载失败 (550)：检查目标目录的 NTFS 权限。确保 FTP 用户（或用户组）至少具有“修改”或“写入”权限。
• 目录列表失败 (425/426)：通常是被动模式问题。确保在 IIS FTP 的“防火墙支持”中配置了正确的外部 IP 地址，并在防火墙中打开了指定的端口范围。

通过理解这些状态码，可以快速定位 IIS FTP 服务中遇到的大多数连接、认证和文件传输问题。