关于虚拟主机

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

在 Edge 中，路由器会处理所有传入的 API 流量。也就是说，所有 HTTP 和 HTTPS 发送到 API 代理的请求首先由边缘路由器处理。

虚拟主机可让您在一台服务器上托管多个域名。 对于 Edge，服务器对应于边缘路由器。通过在路由器上定义多个虚拟主机， 路由器可以处理对多个域名的 API 请求。

Edge 上的虚拟主机定义访问协议（HTTP 或 HTTPS）、开放的路由器端口和主机 别名。主机别名通常是映射到路由器 IP 地址的 DNS 域名。

例如，下图显示了具有两个虚拟主机定义的路由器：

第一个虚拟主机会在 域 domainName1，第二个域处理 domainName2 上的 HTTP 请求。

在对 API 代理发出请求时，路由器会将传入请求的 Host 标头与 由所有虚拟主机定义的主机别名列表，用于确定哪个 主机处理请求。

关于虚拟主机定义

虚拟主机包含以下信息：

  • 虚拟主机的内部名称。您可以使用该名称引用 代理主机。
  • 虚拟主机的主机别名。通常，主机别名是 DNS 映射到路由器上的 IP 地址的域名。网页的 Host 标头 API 代理请求必须包含虚拟主机的主机别名。
  • 路由器上的开放端口。
  • 是否启用 TLS（HTTPS 访问）（HTTP 访问）。

例如，您在创建虚拟主机时需要指定以下信息：

  • name = myvhost
  • 主机别名 = apis.acme.com
  • 端口 = 443
  • TLS 已启用
。

根据上述针对虚拟主机的设置，对 API 代理的请求会使用 表单：

https://apis.acme.com/{proxy-base-path}/{resource-path}

其中：

  • {proxy-base-path} 是在您创建 API 代理时定义的，对于每个 API 代理而言都是唯一的。 例如： 
    https://apis.acme.com/characters
  • {resource-path} 表示可通过 API 代理访问的资源的路径。例如： 
    https://apis.acme.com/characters/coyote
https://apis.acme.com/characters/roadrunner

关于 Google Cloud 中的 面向云的边缘

每个 Edge 组织都会自动包含两种环境 (test 和 prod），每个环境中有两个虚拟主机（默认和安全）， 和 DNS 记录。

Apigee 提供的每个虚拟主机的主机别名都包含组织的名称和 environment，如下表所示：

环境 虚拟主机名 主机别名 Port（端口） 已启用 TLS
prod 默认 {org-name}-prod.apigee.net 80 否
安全 {org-name}-prod.apigee.net 443 是
测试 默认 {org-name}-test.apigee.net 80 否
安全 {org-name}-test.apigee.net 443 是

例如，名为“myorg”的组织的默认域名 在 prod 环境中为“myorg-prod.apigee.net”。 因此，要访问该组织中的 API 代理，您需要使用以下形式的网址：

http://myorg-prod.apigee.net/{proxy-base-path}/{resource-path}
https://myorg-prod.apigee.net/{proxy-base-path}/{resource-path}

Apigee 付费方案：包含“apigee.net”的域名并不是您想要向 客户。您可以使用 DNS 条目和 CNAME 记录将域名映射到 支持贵组织在 Edge 上执行操作。您还必须创建一个虚拟主机，将主机别名设置为该主机别名。 域名。这样，开发者就可以通过您公司的专用网域访问您的 API。

以下是 Edge 中的自定义网域的示例：

https://apis.acme.com/{proxy-base-path}/{resource-path}

关于虚拟主机 适用于私有云的 Edge

安装适用于私有云的 Apigee Edge 时，没有默认组织， 或为您创建的虚拟主机。完成 Edge 安装过程后， 您的第一项操作通常是创建组织、环境和虚拟主机（通过 “入门培训”过程。

如需执行初始配置，请在边缘管理服务器节点上运行以下命令：

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

其中 configFile 包含创建 用户、组织、环境和虚拟主机。

例如，您创建：

  • 您选择的担任组织管理员的用户
  • 名为 example 的组织
  • 组织中名为“prod”的环境
  • 名为 default 的环境中允许通过端口进行 HTTP 访问的虚拟主机 9,001
  • 用于访问路由器的 DNS 名称的主机别名，或路由器的 IP 地址， 虚拟主机的端口，格式为 IP:9001。

以后，您可以将任意数量的组织、环境和虚拟主机添加到您的 本地版本的 Edge。如需了解详情，请参阅：

虚拟主机在边缘路由器上打开。因此，您必须确保 为虚拟主机指定的配置在路由器上处于打开状态。您可以使用以下形式的命令 打开端口：

iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 9001 -j ACCEPT --verbose

运行该命令后，您可以使用采用以下格式的网址访问 API：

http://<router-ip>:9001/{proxy-base-path}/{resource-path}

通常，您不会将 API 发布给具有 IP 地址和 端口号。而是为路由器和端口定义 DNS 条目。例如：

http://myAPI.myCo.com/{proxy-base-path}/{resource-path}

定义 DNS 条目时，您还必须创建一个虚拟主机，其主机别名为 与 DNS 条目的域名匹配。在上面的示例中，您需要指定一个主机别名 myAPI.myCo.com 的一部分。

主机别名和 DNS 名称简介

您为虚拟主机设置的一个属性是主机别名。主机别名为 通常是虚拟主机的 DNS 名称。如何设置主机别名取决于您使用的 边缘安装：云端或私有云。

主机别名和 Edge for the Cloud 中的 DNS 名称

在 Edge for the Cloud 中，当您首次创建 Edge 组织时，Apigee 会自动 创建两个环境（test 和 prod）， 每个环境（默认和安全）以及每个环境的 DNS 记录 虚拟主机。

虚拟主机的主机别名包含组织和环境的名称。 因此，通过虚拟主机发出的请求采用以下格式：

  • http://{org-name}-prod.apigee.net/{proxy-base-path}/{resource-path}
  • https://{org-name}-prod.apigee.net/{proxy-base-path}/{resource-path}
  • http://{org-name}-test.apigee.net/{proxy-base-path}/{resource-path}
  • https://{org-name}-test.apigee.net/{proxy-base-path}/{resource-path}

通常情况下，您可以创建使用您的域名的虚拟主机，而不是使用 默认 apigee.net 网域。待办事项 因此，您必须先创建自己的 DNS 条目和 CNAME 记录。

下图显示了 Edge 处理 API 请求的典型配置：

在此示例中：

  • api.acme.com 是您所需的域名。
  • 您需要定义一个 DNS 条目和 CNAME 记录，将 api.acme.com 指向 acme-prod.apigee.net.
  • 请求包含 Host 标头，路由器将使用该标头 确定处理请求的虚拟主机。

在此示例中，您在虚拟主机定义中指定以下信息：

  • name = myvhost
  • 主机别名 = apis.acme.com
  • 端口 = 443
  • 启用 TLS 访问

如需了解详情，请参阅为 Cloud 配置虚拟主机。

主机别名 Edge for Private Cloud 中的 DNS 名称

与适用于 Cloud 的 Edge 一样，您可以创建使用您自己的域名作为主机的虚拟主机 别名。然后，您可以创建自己的 DNS 条目和 CNAME 记录来访问这些虚拟主机。

云和私有云的一个区别在于，在 Cloud Apigee 中 为您的组织自动创建的 DNS 名称，格式为：

  • name=default：http://{org-name}-{env-name}.apigee.net （路由器端口 80）
  • name=secure：https://{org-name}-{env-name}.apigee.net （路由器端口 443）

在私有云的 Edge 中，您必须创建指向 IP 地址和端口的 DNS 条目 。

例如，您可以在虚拟主机定义中指定以下信息：

  • name = myvhost
  • 主机别名 = apis.acme.com
  • 端口 = 9001
  • 启用 TLS 访问

下图显示了 Edge 处理 API 请求的典型配置：

在此示例中：

  • api.acme.com 是您所需的域名。
  • 您需要定义一个 DNS 条目和 CNAME 记录，将 api.acme.com 指向 IP 地址和端口
  • 请求包含 Host 标头，路由器将使用该标头 确定处理请求的虚拟主机。

如需了解详情，请参阅为私有云配置虚拟主机。

主机别名和通配符

您可以在通配符。“*”通配符可以 只能位于主机别名的开头（第一个“.”之前），且不能与其他 字符。

以下是使用通配符的有效主机别名的示例：

*.example.com

以下示例无效：

  www.*.example.com
  w*.example.com

在虚拟主机别名中使用通配符可以 API 代理负责处理发送到多个子网域的调用，例如 alpha.example.com、beta.example.com 或 live.example.com。使用通配符别名也有助于减少 以保持在产品范围内 限制，因为使用通配符的虚拟主机仅计为一个虚拟主机。

虚拟主机的 TLS 证书的 CN 名称中必须包含匹配的通配符。 例如 *.example.com。

虚拟主机属性简介

在 Edge 中，虚拟主机由 XML 对象表示。例如， 以下 XML 对象定义了一个虚拟主机：

<VirtualHost name="vhostName">
    <HostAliases>
        <HostAlias>hostAlias</HostAlias>
    </HostAliases>
    <Interfaces>
        <!-- Private Cloud only -->
        <Interface>interfaceName</Interface>
    <Port>portNumber</Port>
    <BaseURL>http://myCo.com<</BaseUrl>
    <OCSPStapling>off</OCSPStapling>
    <RetryOptions/>
   <SSLInfo>
        <Enabled>trueFalse</Enabled>
        <ClientAuthEnabled>trueFalse</ClientAuthEnabled>
        <KeyStore>ref://keystoreRef</KeyStore>
        <KeyAlias>keyAlias</KeyAlias>
        <TrustStore>ref://truststoreRef</TrustStore>
        <IgnoreValidationErrors>trueFalse</IgnoreValidationErrors>
    </SSLInfo>
    <Properties>
        <Property name="proxy_read_timeout">timeout</Property>
        <Property name="keepalive_timeout">timeout</Property>
        <Property name="proxy_request_buffering">onOff</Property>
        <Property name="proxy_buffering">onOff</Property>
        <Property name="ssl_protocols">protocolList</Property>
        <Property name="ssl_ciphers">cipherList</Property>
    </Properties>
</VirtualHost>

您可以设置的属性列表取决于您是否使用适用于 Cloud 的 Edge 适用于私有云的 Edge如果您为私有云使用 Edge， 还取决于您的 Edge 版本。 有关虚拟主机所有属性的完整说明，请参阅 虚拟主机属性参考。

如需详细了解如何为特定版本的 Edge 创建虚拟主机，请参阅：