共用方式為

FTP 要求限制 < requestLimits>

  • 發行項

元素 <requestLimits> 會指定 FTP 伺服器所處理的 FTP 要求限制。 這些限制包括要求的大小上限，以及命令順序的最大長度。

注意

當要求篩選因為 FTP 要求超過要求限制而封鎖 FTP 要求時，FTP 7 會將 FTP 錯誤傳回給用戶端，並記錄下列其中一個 FTP 子狀態，以識別要求遭到拒絕的原因：

FTP 子狀態 描述
12 路徑根據要求篩選規則太長。
51 命令篩選規則拒絕存取。

這些子狀態可讓 FTP 系統管理員分析其 IIS 記錄，並識別潛在的威脅。

相容性

版本 備註
IIS 10.0 在 <requestLimits> IIS 10.0 中未修改專案。
IIS 8.5 未 <requestLimits> 在 IIS 8.5 中修改專案。
IIS 8.0 在 IIS 8.0 中未修改專案 <requestLimits> 。
IIS 7.5 元素 <requestLimits> 的 <requestFiltering> 元素會隨附為 IIS 7.5 的功能。
IIS 7.0 元素 <requestLimits> 的 <requestFiltering> 元素是在 FTP 7.0 中引進，這是 IIS 7.0 的個別下載。
IIS 6.0 IIS 6.0 中的 FTP 服務不支援要求篩選。

注意

FTP 7.0 和 FTP 7.5 服務針對 IIS 7.0 隨附頻外，需要從下列 URL 下載並安裝模組：

https://www.iis.net/downloads/microsoft/ftp

使用 Windows 7 和 Windows Server 2008 R2 時，FTP 7.5 服務會隨附為 IIS 7.5 的功能，因此不再需要下載 FTP 服務。

安裝程式

若要支援 Web 服務器的 FTP 發佈，您必須安裝 FTP 服務。 若要這樣做，請使用下列步驟。

Windows Server 2012 或 Windows Server 2012 R2

  1. 在工作列上，按一下 [伺服器管理員]。

  2. 在伺服器管理員中，按一下 [管理]功能表，然後按一下 [新增角色和功能]。

  3. 在 [ 新增角色和功能 精靈] 中，按 [下一步]。 選取安裝類型，然後按 [ 下一步]。 選取目的地伺服器，然後按 [ 下一步]。

  4. 在 [ 伺服器角色] 頁面上，展開 [Web 服務器] ([IIS) ]，然後選取 [ FTP 伺服器]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，除了FTP 服務之外，您還需要選取FTP 擴充性。 Web Server I S 和 F T P 伺服器節點展開的影像，並醒目提示 F T P 擴充性。

  5. 按 [下一步]，然後在 [ 選取功能 ] 頁面上，再次按 [ 下一步 ]。

  6. 在 [確認安裝選項] 頁面上，按一下 [安裝]。

  7. 在 [結果] 頁面上，按一下 [關閉]。

Windows 8 或Windows 8.1

  1. 在 [開始] 畫面上，將指標全部移至左下角，以滑鼠右鍵按一下 [開始] 按鈕，然後按一下[主控台]。

  2. 在主控台中，按一下 [程式和功能]，然後按一下 [開啟或關閉 Windows 功能]。

  3. 展開 [Internet Information Services]，然後選取 [FTP 伺服器]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。 [網際網路資訊服務和 F T P 伺服器] 窗格的螢幕擷取畫面，其中已醒目提示 F T P 擴充性。

  4. 按一下 [確定]。

  5. 按一下 [關閉] 。

Windows Server 2008 R2

  1. 在工作列上，按一下 [開始]，指向 [系統管理工具]，然後按一下[伺服器管理員]。

  2. 在[伺服器管理員階層] 窗格中，展開 [角色]，然後按一下 [Web 服務器] (IIS) 。

  3. 在 [Web 服務器 (IIS) ] 窗格中，捲動至 [ 角色服務 ] 區段，然後按一下 [ 新增角色服務]。

  4. 在 [新增角色服務精靈] 的 [選取角色服務] 頁面上，展開[FTP 伺服器]。

  5. 選取 [FTP 服務]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。 [選取角色服務] 頁面的螢幕擷取畫面，其中已展開 F T P 伺服器窗格，並已選取 F T P 服務。

  6. 按一下 [下一步] 。

  7. 在 [確認安裝選項] 頁面上，按一下 [安裝]。

  8. 在 [結果] 頁面上，按一下 [關閉]。

Windows 7

  1. 在工作列上，按一下 [開始]，然後按一下[主控台]。

  2. 在主控台中，按一下 [程式和功能]，然後按一下 [開啟或關閉 Windows 功能]。

  3. 展開 [Internet Information Services]，然後展開 [FTP 伺服器]。

  4. 選取 [FTP 服務]。

    注意

    支援 ASP。FTP 服務的成員資格驗證或 IIS 管理員驗證，您也必須選取 [FTP 擴充性]。 已選取 F T P 服務和 F T P 擴充性的 Internet Information Services 和 F T P 伺服器節點影像。

  5. 按一下 [確定]。

Windows Server 2008 或 Windows Vista

  1. 從下列 URL 下載安裝套件：

    https://www.iis.net/downloads/microsoft/ftp

  2. 請遵循下列逐步解說中的指示來安裝 FTP 服務：

    安裝和疑難排解 FTP 7

作法

注意

FTP 要求篩選在 FTP 7.0 版本中沒有使用者介面;FTP 要求篩選 UI 已在 FTP 7.5 版本中新增。

如何編輯要求篩選功能設定和要求限制

  1. (IIS) 管理員開啟 Internet Information Services：

    • 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：

      • 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。

    • 如果您使用 Windows 8 或 Windows 8.1：

      • 按住Windows鍵，按字母X，然後按一下[主控台]。
      • 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

    • 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：

      • 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。

    • 如果您使用 Windows Vista 或 Windows 7：

      • 在工作列上，按一下 [開始]，然後按一下[主控台]。
      • 按兩下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

  2. 在 [ 連線 ] 窗格中，移至您要修改要求篩選設定的月臺或目錄。

  3. 在 [ 首頁] 窗格中，按兩下 [FTP 要求篩選]。

  4. 按一下 [動作] 窗格中的[編輯功能設定]。

    F T P 要求篩選頁面的影像，其中顯示 [動作] 窗格中的 [編輯功能設定]。

  5. 指定您的選項。 例如，您可以進行下列變更：

    • 藉由指定 2048，將 URL 長度上限變更為 2KB。
    • 藉由指定 1024，將命令長度上限變更為 1KB。

    注意

    建議您不要清除 [ 允許未列出的命令 ] 核取方塊。
    [編輯 F T P 要求篩選設定] 對話方塊的影像，其中顯示 [允許未列出的命令] 和 [允許同時選取的高位字元]。

  6. 按一下 [確定]。

組態

專案的 <requestLimits> 元素 <requestFiltering> 是在全域、網站或 URL 層級設定。

屬性

屬性 描述
maxAllowedContentLength 選擇性 int64 屬性。

指定要求中內容的最大長度，以位元組為單位。

預設值為 0 無限制) (。
maxUrl 選擇性 uint 屬性。

指定要求的最大長度，以位元組為單位。

注意： 此值必須介於 32 到 32768 之間。

預設值是 4096。

子元素

無。

組態範例

下列範例說明 FTP 月臺元素 <system.ftpServer> 中的數個安全性相關組態設定。 更具體來說， <location> 此範例中的設定會示範如何：

  • 為系統管理員群組指定讀取和寫入權限的 FTP 授權規則。
  • 指定拒絕 *.exe、*.bat和 *.cmd 檔案的 FTP 要求篩選選項。
  • 指定最大內容長度為 10000000 個位元組的 FTP 要求限制，以及 URL 長度上限為 1024 個位元組。
  • 封鎖對_vti_bin虛擬目錄的 FTP 存取，此目錄會與 FrontPage 伺服器延伸模組搭配使用。
  • 指定 FTP IP 篩選選項，允許從 127.0.0.1 存取，並拒絕從 169.254.0.0/255.255.0.0 範圍存取 IP 位址。
<location path="ftp.example.com">
  <system.ftpServer>
    <security>
      <authorization>
        <add accessType="Allow" roles="administrators" permissions="Read, Write" />
      </authorization>
      <requestFiltering>
        <fileExtensions allowUnlisted="true">
          <add fileExtension=".exe" allowed="false" />
          <add fileExtension=".bat" allowed="false" />
          <add fileExtension=".cmd" allowed="false" />
        </fileExtensions>
        <requestLimits maxAllowedContentLength="1000000" maxUrl="1024" />
        <hiddenSegments>
          <add segment="_vti_bin" />
        </hiddenSegments>
      </requestFiltering>
      <ipSecurity enableReverseDns="false" allowUnlisted="true">
        <add ipAddress="127.0.0.1" allowed="true" />
        <add ipAddress="169.254.0.0" subnetMask="255.255.0.0" allowed="false" />
      </ipSecurity>
    </security>
  </system.ftpServer>
</location>

範例程式碼

下列範例會指定最大內容長度為 1000000 位元組的 FTP 要求限制，以及 URL 長度上限為 1024 個位元組。

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.ftpServer/security/requestFiltering /requestLimits.maxAllowedContentLength:"1000000" /requestLimits.maxUrl:"1024" /commit:apphost

注意

當您使用AppCmd.exe設定這些設定時，請務必將 認可 參數 apphost 設定為 。 這會將組態設定認可至ApplicationHost.config檔案中適當的位置區段。

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
  private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection requestFilteringSection = config.GetSection("system.ftpServer/security/requestFiltering", "Default Web Site");

         ConfigurationElement requestLimitsElement = requestFilteringSection.GetChildElement("requestLimits");
         requestLimitsElement["maxAllowedContentLength"] = 1000000;
         requestLimitsElement["maxUrl"] = 1024;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim requestFilteringSection As ConfigurationSection = config.GetSection("system.ftpServer/security/requestFiltering", "Default Web Site")

      Dim requestLimitsElement As ConfigurationElement = requestFilteringSection.GetChildElement("requestLimits")
      requestLimitsElement("maxAllowedContentLength") = 1000000
      requestLimitsElement("maxUrl") = 1024

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var requestFilteringSection = adminManager.GetAdminSection("system.ftpServer/security/requestFiltering", "MACHINE/WEBROOT/APPHOST/Default Web Site");
var requestLimitsElement = requestFilteringSection.ChildElements.Item("requestLimits");
requestLimitsElement.Properties.Item("maxAllowedContentLength").Value = 1000000;
requestLimitsElement.Properties.Item("maxUrl").Value = 1024;

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set requestFilteringSection = adminManager.GetAdminSection("system.ftpServer/security/requestFiltering", "MACHINE/WEBROOT/APPHOST/Default Web Site")
Set requestLimitsElement = requestFilteringSection.ChildElements.Item("requestLimits")
requestLimitsElement.Properties.Item("maxAllowedContentLength").Value = 1000000
requestLimitsElement.Properties.Item("maxUrl").Value = 1024

adminManager.CommitChanges()