

AWS App Runner 从 2026 年 4 月 30 日起，将不再向新客户开放。如果您想使用 App Runner，请在该日期之前注册。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS App Runner 可用性变更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# IPv6 为传入流量启用
<a name="network-dual-stack"></a>

如果您希望您的服务接收来自 IPv6 地址或两个 IPv4 地址的传入网络流量，请为端点选择**双栈**地址类型。 IPv6 创建新应用程序时，可以在**配置服务** > **网络**部分下找到此设置。以下过程说明了如何使用 App Runner 控制台 IPv4 或 App Runner API 启用或双堆栈（IPv6 和 IPv4）。

## 管理传入流量的双堆栈
<a name="network-dual-stack-manage"></a>

使用以下方法之一管理传入流量的双栈地址类型：
+ [应用程序运行器控制台](#network-dual-stack-manage.console)
+ [应用程序运行器 API 或 AWS CLI](#network-dual-stack-manage.api)

**注意**  
以下过程说明如何管理**公共**传入流量的网络地址类型。有关管理**私**有终端节点的双栈或 IPv4 地址类型的信息，请参阅[管理私有终端节点](network-pl-manage.md)。

### 应用程序运行器控制台
<a name="network-dual-stack-manage.console"></a>

当你使用 App Runner 控制台创建服务时，或者稍后更新服务配置时，你可以为传入的互联网流量选择双栈地址类型。

**要启用双栈地址，请键入**

1.  [创建](manage-create.md)或[更新](manage-configure.md)服务时，请展开 “**配置服务**” 下的 “**网络**” 部分。

1. 为**传入网络流量**选择**公共端点**。如果您选择**公共终端节点**，则会打开**端点 IP 地址类型**选项。

   [管理私有终端节点](network-pl-manage.md)有关管理双堆栈或私有端点 IPv4地址类型的程序，请参阅。

1. 展开**端点 IP 地址类型**以查看以下 IP 地址类型。
   + **IPv4**
   + **双栈（IPv4 和 IPv6）**
**注意**  
如果您没有展开**端点 IP 地址类型**来进行选择，则 App Runner 会将默认配置分配 IPv4 为默认配置。

1. 选择**双堆栈（IPv4 和 IPv6）。**

1. 如果要**创建服务，请选择 “**下一步**”，然后选择 “创建并部署**”。否则，如果您要更新服务，请选择 “**保存更改**”。

   部署服务后，您的应用程序将开始接收来自 IPv6 终端节点 IPv4 和终端节点的网络流量。

**更改地址类型**

1.  按照步骤[更新](manage-configure.md)服务并导航到 “网络”。

1. 导航到 “**传入网络流量**” 下的 “**端点 IP 地址类型**”，然后选择所需的地址类型。

1. 选择**保存更改**。您的服务已根据您的选择进行更新。

### 应用程序运行器 API 或 AWS CLI
<a name="network-dual-stack-manage.api"></a>

当您调用[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)或 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)App Runner API 操作时，请使用`NetworkConfiguration`参数的`IpAddressType`成员来指定地址类型。您可以指定的支持的值为`IPv4`和`DUAL_STACK`。指定您`DUAL_STACK`是否希望您的服务接收来自 IPv4 和 IPv6 端点的互联网流量。如果您没有为指定任何值`IpAddressType`，则默认情况下会应用 IPv4 该值。

**注意**  
有关私有终端节点的示例，请参阅[应用程序运行器 API 或 AWS CLI](network-pl-manage.md#network-pl-manage.api)。

以下是创建以双堆栈作为 IP 地址的服务的示例。这个例子调用一个`input.json`文件。

**Example 请求创建支持双堆栈的服务**  

```
aws apprunner create-service \
 --cli-input-json file://input.json
```

**Example `input.json` 的内容**  

```
{
  "ServiceName": "example-service",
  "SourceConfiguration": {
    "ImageRepository": {
      "ImageIdentifier": "public.ecr.aws/aws-containers/hello-app-runner:latest",
      "ImageConfiguration": {
        "Port": "8000"
      },
      "ImageRepositoryType": "ECR_PUBLIC"
    },
    "NetworkConfiguration": {
      "IpAddressType": "DUAL_STACK"
    }
  }
}
```

**Example 响应**  

```
{
  "Service": {
    "ServiceName": "example-service",
    "ServiceId": "<service-id>",
    "ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/example-service/<service-id>",
    "ServiceUrl": "1234567890.us-east-2.awsapprunner.com",
    "CreatedAt": "2023-10-16T12:30:51.724000-04:00",
    "UpdatedAt": "2023-10-16T12:30:51.724000-04:00",
    "Status": "OPERATION_IN_PROGRESS",
    "SourceConfiguration": {
      "ImageRepository": {
        "ImageIdentifier": "public.ecr.aws/aws-containers/hello-app-runner:latest",
        "ImageConfiguration": {
          "Port": "8000"
        },
        "ImageRepositoryType": "ECR_PUBLIC"
      },
      "AutoDeploymentsEnabled": false
    },
    "InstanceConfiguration": {
      "Cpu": "1024",
      "Memory": "2048"
    },
    "HealthCheckConfiguration": {
      "Protocol": "TCP",
      "Path": "/",
      "Interval": 5,
      "Timeout": 2,
      "HealthyThreshold": 1,
      "UnhealthyThreshold": 5
    },
    "AutoScalingConfigurationSummary": {
      "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001",
      "AutoScalingConfigurationName": "DefaultConfiguration",
      "AutoScalingConfigurationRevision": 1
    },
    "NetworkConfiguration": {
      "IpAddressType": "DUAL_STACK",
      "EgressConfiguration": {
        "EgressType": "DEFAULT"
      },
      "IngressConfiguration": {
        "IsPubliclyAccessible": true
      }
    }
  },
  "OperationId": "24bd100b1e111ae1a1f0e1115c4f11de"
}
```

有关 API 参数的更多信息，请参阅[NetworkConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_NetworkConfiguration.html)。