通过

FTP 主机名支持 <hostNameSupport>

概述

<hostNameSupport> 元素指定支持将域名语法用于虚拟主机名。

FTP 虚拟主机名是在 FTP 7.0 中引入的，FTP 虚拟主机名是作为绑定的一部分指定的，其指定方式与指定 HTTP 主机标头名称的方式相同。 例如，可以使用主机名来指定绑定，如 www.contoso.com 或 www.fabrikam.com 用于 HTTP 绑定，ftp.contoso.com 或 ftp.fabrikam.com 用于 FTP 绑定。 HTTP 提供了一种在客户端和服务器之间传递的标头中传递主机名的方法，但 FTP 目前未提供相同的功能。 由于 FTP 的这一限制，虚拟主机名在登录过程中用作用户名的一部分。 默认情况下，FTP 客户端需要使用管道（竖线）字符和语法（如 ftp.contoso.com|username 或 ftp.fabrikam.com|username）来指定其登录凭据。 通过将 useDomainNameAsHostName 属性设置为 true，可以使用域名语法指定虚拟主机和用户名。因此您可以使用反斜杠字符而不是竖线字符。所以语法类似于 ftp.contoso.com\username 或 ftp.fabrikam.com\username。

注意

FTP 7.0 和 FTP 7.5 都支持建议的 FTP HOST 命令，该命令不需要将虚拟主机名用作用户名的一部分。

兼容性

版本 说明
IIS 10.0 <hostNameSupport> 元素在 IIS 10.0 中未进行修改。
IIS 8.5 <hostNameSupport> 元素在 IIS 8.5 中未进行修改。
IIS 8.0 <hostNameSupport> 元素在 IIS 8.0 中未进行修改。
IIS 7.5 <system.ftpServer> 元素的 <hostNameSupport> 元素作为 IIS 7.5 的功能提供。
IIS 7.0 <system.ftpServer> 元素的 <hostNameSupport> 元素是在 IIS 7.0 的独立下载项 FTP 7.5 中引入的。
IIS 6.0 空值

注意

FTP 7.0 和 FTP 7.5 服务是 IIS 7.0 带外提供的，需要从以下 URL 下载和安装模块：

https://www.iis.net/expand/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 服务器”。

    注意

    若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，除“FTP 服务”外还需选择“FTP 扩展性”。
    Image of Web Server I I S and F T P Server pane expanded with F T P Service and F T P Extensibility selected.

  5. 单击“下一步”，然后在“选择功能”页上，再次单击“下一步”。

  6. 在“确认安装选择”页上，单击“安装”。

  7. 在“结果” 页面中单击“关闭” 。

Windows 8 或 Windows 8.1

  1. 在“开始”屏幕上，将指针一直移动到左下角，右键单击“开始”按钮，然后单击“控制面板”。

  2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。

  3. 展开“Internet Information Services”，然后选择“FTP 服务器”。

    注意

    若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，还需选择“FTP 扩展性”。 Screenshot of Internet Information Services and F T P Server pane expanded showing F T P Extensibility selected.

  4. 单击“确定”。

  5. 单击“关闭” 。

Windows Server 2008 R2

  1. 在任务栏上，单击“开始”，指向“管理工具”，然后单击“服务器管理器”。

  2. 在“服务器管理器”层次结构窗格中，展开“角色”，然后单击“Web 服务器 (IIS)”。

  3. 在“Web 服务器 (IIS)”窗格中，滚动到“角色服务”部分，然后单击“添加角色服务”。

  4. 在“添加角色服务向导”的“选择角色服务”页，展开“FTP 服务器”。

  5. 选择“FTP 服务”。

    注意

    若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，还需选择“FTP 扩展性”。 Image of Select Role Services page in Add Role Services Wizard displaying F T P Server pane expanded and F T P Service selected.

  6. 单击 “下一步” 。

  7. 在“确认安装选择”页中，单击“安装”。

  8. 在“结果” 页面中单击“关闭” 。

Windows 7

  1. 在任务栏上，单击“开始”，然后单击“控制面板”。

  2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。

  3. 展开“Internet Information Services”，然后展开“FTP 服务器”。

  4. 选择“FTP 服务”。

    注意

    若要支持 FTP 服务使用 ASP.Membership 身份验证或 IIS 管理器身份验证，还需选择“FTP 扩展性”。
    Image of Turn Windows Features on or off page showing F T P Server pane expanded with both F T P Extensibility and F T P Service selected.

  5. 单击“确定”。

Windows Server 2008 或 Windows Vista

  1. 从以下 URL 下载安装包：

  2. 按照以下演练中的说明安装 FTP 服务：

操作方式

如何为虚拟主机名配置域名语法

注意

没有可用于配置 <hostNameSupport> 元素的直接用户界面；因此，以下步骤将使用 IIS 配置编辑器功能。

  1. 打开 Internet Information Services (IIS) 管理器：

    • 如果使用的是 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. 在“主页”窗格中，双击“配置编辑器”功能。

  4. 在“分区”下拉菜单中 ，展开 sytem.ftpServer，然后单击 serverRuntime。

  5. 在列表视图中展开 hostNameSupport。
    Screenshot of Section drop down menu in Configuration Editor feature displaying host Name Support pane expanded in the list view.

  6. 在 useDomainNameAsHostName 属性的下拉列表中选择 True 或 False。

  7. 在“操作”窗格中，单击“应用”。

注意

本部分介绍如何使用 IIS 配置编辑器修改 IIS 设置。 错误编辑 IIS 配置设置可能会严重损坏 IIS 安装。 因此，按以下步骤操作时请务必谨慎。 为提高安全性，在使用 IIS 配置编辑器进行任何修改之前，必须备份 IIS 配置设置。 有关如何备份 IIS 配置设置以及如何使用 IIS 配置编辑器的详细信息，请参阅以下主题：

配置

<serverRuntime> 元素的 <hostNameSupport> 元素在 ApplicationHost.config 中配置，并且是在全局级别配置。

特性

属性 说明
useDomainNameAsHostName 可选的 Boolean 属性。

如果支持将域名语法用于虚拟主机名，则为 true；否则为 false。

默认值为 false。

子元素

无。

配置示例

以下示例显示一个 <serverRuntime> 元素，该元素配置服务器允许虚拟主机名的域名语法。

<system.ftpServer>
    <serverRuntime>
        <hostNameSupport useDomainNameAsHostName="true" />
    </serverRuntime>
</system.ftpServer>

代码示例

以下示例配置 FTP 服务器的 <serverRuntime> 元素，以允许 FTP 虚拟主机名的域名语法。

AppCmd.exe

appcmd.exe set config -section:system.ftpServer/serverRuntime /hostNameSupport.useDomainNameAsHostName:"True" /commit:apphost

注意

使用 AppCmd.exe 配置这些设置时，必须确保将 commit 参数设置为 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 serverRuntimeSection = config.GetSection("system.ftpServer/serverRuntime");

         ConfigurationElement hostNameSupportElement = serverRuntimeSection.GetChildElement("hostNameSupport");
         hostNameSupportElement["useDomainNameAsHostName"] = true;

         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 serverRuntimeSection As ConfigurationSection = config.GetSection("system.ftpServer/serverRuntime")

      Dim hostNameSupportElement As ConfigurationElement = serverRuntimeSection.GetChildElement("hostNameSupport")
      hostNameSupportElement("useDomainNameAsHostName") = True

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

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

var serverRuntimeSection = adminManager.GetAdminSection("system.ftpServer/serverRuntime", "MACHINE/WEBROOT/APPHOST");
var hostNameSupportElement = serverRuntimeSection.ChildElements.Item("hostNameSupport");
hostNameSupportElement.Properties.Item("useDomainNameAsHostName").Value = true;

adminManager.CommitChanges();

VBScript

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

Set serverRuntimeSection = adminManager.GetAdminSection("system.ftpServer/serverRuntime", "MACHINE/WEBROOT/APPHOST")
Set hostNameSupportElement = serverRuntimeSection.ChildElements.Item("hostNameSupport")
hostNameSupportElement.Properties.Item("useDomainNameAsHostName").Value = True

adminManager.CommitChanges()