# @aws-cdk/aws-globalaccelerator 中文文档

规范地址：https://npmcn.com/package/%40aws-cdk/aws-globalaccelerator/

版本：1\.204\.0
npm 元数据更新时间：2023-11-21T10:15:27.975Z
中文译文更新时间：2026-11-07T11:52:54.484Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aws-cdk/aws-globalaccelerator
原文对照：https://npmcn.com/package/%40aws-cdk/aws-globalaccelerator/?lang=original
项目主页：https://github.com/aws/aws-cdk
源码仓库：https://github.com/aws/aws-cdk

弃用说明：AWS CDK v1 has reached End-of-Support on 2023-06-01\. This package is no longer being updated, and users should migrate to AWS CDK v2\. For more information on how to migrate, see https://docs\.aws\.amazon\.com/cdk/v2/guide/migrating-v2\.html

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：583 kB，25 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 14\.15\.0
- 运行依赖：4 个
- peer 依赖：@aws-cdk/aws-ec2 1\.204\.0，@aws-cdk/core 1\.204\.0，@aws-cdk/custom-resources 1\.204\.0，constructs ^3\.3\.69
- 首次发布：2020-05-27T12:47:33.944Z
- 最新版本发布：2023-06-19T21:09:58.061Z
- 近 30 天下载量：109621（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：187（近 12 个月 0 个）

## 中文简介

AWS 的 CDK 构建库: 全球加速器

## 安装

```sh
npm install @aws-cdk/aws-globalaccelerator
```

也可以使用：`pnpm add @aws-cdk/aws-globalaccelerator`、`yarn add @aws-cdk/aws-globalaccelerator`、`bun add @aws-cdk/aws-globalaccelerator`

## README

# AWS: 全球加速器构建库

* * *

![End-of-Support](https://img.shields.io/badge/End--of--Support-critical.svg?style=for-the-badge)

> AWS CDK v1在2023-06-01上达到了支持结束. 此软件包不再更新,用户应该迁移到 AWS CDK v2.
> 
> 关于如何移徙的更多信息,请参见: [_移动到 AWS CDK v2_ 指南](https://docs.aws.amazon.com/cdk/v2/guide/migrating-v2.html)。 。 。 .

* * *

## 导言

AWS Global Accelerator(AGA)是一种服务,可以改善可用性并改进服务 用于本地或全局用户的应用程序.

它拦截了用户在靠近边缘位置的网络连接 它们,并引导它到 一个潜在的多重,冗余的后端 更可靠、更不拥挤的AWS全球网络.

AGA 可用于路由流量到应用程序负载平衡器, 网络负载 平衡器,EC2实例和弹性IP地址.

更多信息,请参见 [AWS 全球 加速开发者指南](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_GlobalAccelerator.html)。 。 。 .

## 示例

以下是为两个应用程序加载设置全球加速器的例子 两个不同AWS区域的平衡器:

```ts
// Create an Accelerator
const accelerator = new globalaccelerator.Accelerator(this, 'Accelerator');

// Create a Listener
const listener = accelerator.addListener('Listener', {
  portRanges: [
    { fromPort: 80 },
    { fromPort: 443 },
  ],
});

// Import the Load Balancers
const nlb1 = elbv2.NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, 'NLB1', {
  loadBalancerArn: 'arn:aws:elasticloadbalancing:us-west-2:111111111111:loadbalancer/app/my-load-balancer1/e16bef66805b',
});
const nlb2 = elbv2.NetworkLoadBalancer.fromNetworkLoadBalancerAttributes(this, 'NLB2', {
  loadBalancerArn: 'arn:aws:elasticloadbalancing:ap-south-1:111111111111:loadbalancer/app/my-load-balancer2/5513dc2ea8a1',
});

// Add one EndpointGroup for each Region we are targeting
listener.addEndpointGroup('Group1', {
  endpoints: [new ga_endpoints.NetworkLoadBalancerEndpoint(nlb1)],
});
listener.addEndpointGroup('Group2', {
  // Imported load balancers automatically calculate their Region from the ARN.
  // If you are load balancing to other resources, you must also pass a `region`
  // parameter here.
  endpoints: [new ga_endpoints.NetworkLoadBalancerEndpoint(nlb2)],
});
```

## 概念

这个 **加速器** 构造定义了全球加速器资源.

加速器包括一个或多个 **听众** 接受入境 在一个或多个端口上连接.

每个听众都有一个或一个以上 **终点组**,表示多个 您申请的地理分布。 有一个终点 每区组,用户流量默认会与最接近的区域接通.

端点组由一个或多个组成 **终点**,这里是 用户流量进入收听器 最终发送。 端点端口 和收听器的流量一样 除非被推翻.

## 终点类型

终点有4个类型,可以在 `@aws-cdk/aws-globalaccelerator-endpoints` 软件包 :

-   应用程序负载平衡器
-   网络负载平衡器
-   EC2 实例
-   弹性 IP 地址

### 应用程序负载平衡器

```ts
declare const alb: elbv2.ApplicationLoadBalancer;
declare const listener: globalaccelerator.Listener;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.ApplicationLoadBalancerEndpoint(alb, {
      weight: 128,
      preserveClientIp: true,
    }),
  ],
});
```

### 网络负载平衡器

```ts
declare const nlb: elbv2.NetworkLoadBalancer;
declare const listener: globalaccelerator.Listener;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.NetworkLoadBalancerEndpoint(nlb, {
      weight: 128,
    }),
  ],
});
```

### EC2 实例

```ts
declare const listener: globalaccelerator.Listener;
declare const instance: ec2.Instance;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.InstanceEndpoint(instance, {
      weight: 128,
      preserveClientIp: true,
    }),
  ],
});
```

### 弹性 IP 地址

```ts
declare const listener: globalaccelerator.Listener;
declare const eip: ec2.CfnEIP;

listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.CfnEipEndpoint(eip, {
      weight: 128,
    }),
  ],
});
```

## 客户端 IP 地址保存和安全组

使用时 `preserveClientIp` 特性, AGA 创建 **弹性网络接口** 在您的 AWS 账户中, 即 和AGA安全组有关 你可以用这个 由AGA作为其他安全小组的源组设立的安全小组 (例如EC2或弹性负载平衡器),如果你想 根据AGA安全小组规则限制流量.

AGA 创建特定的安全小组 `GlobalAccelerator` 用于每个VPC 它在(这种行为不能改变)中有一个ENI. 云阵不会 支持引用 AGA 创建的安全小组,但此构造 库带有自定义资源, 允许您引用 AGA 安全小组.

打电话 `endpointGroup.connectionsPeer()` 以便查阅安全小组的资料 用于关联规则。 你必须通过一个参考 的VPC 在谁 上下文将查找安全小组。 示例

```ts
declare const listener: globalaccelerator.Listener;

// Non-open ALB
declare const alb: elbv2.ApplicationLoadBalancer;

const endpointGroup = listener.addEndpointGroup('Group', {
  endpoints: [
    new ga_endpoints.ApplicationLoadBalancerEndpoint(alb, {
      preserveClientIp: true,
    }),
  ],
});

// Remember that there is only one AGA security group per VPC.
declare const vpc: ec2.Vpc;
const agaSg = endpointGroup.connectionsPeer('GlobalAcceleratorSG', vpc);

// Allow connections from the AGA to the ALB
alb.connections.allowFrom(agaSg, ec2.Port.tcp(443));
```

## 常见问题

### @aws-cdk/aws-globalaccelerator 是什么？

AWS 的 CDK 构建库: 全球加速器注意：该包已被作者标记为弃用——AWS CDK v1 has reached End-of-Support on 2023-06-01\. This package is no longer being updated, and users should migrate to AWS CDK v2\. For more information on how to migrate, see https://docs\.aws\.amazon\.com/cdk/v2/guide/migrating-v2\.html

### 如何安装 @aws-cdk/aws-globalaccelerator？

在项目目录运行 npm install @aws-cdk/aws-globalaccelerator，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@aws-cdk/aws-ec2（1\.204\.0）、@aws-cdk/core（1\.204\.0）、@aws-cdk/custom-resources（1\.204\.0）、constructs（^3\.3\.69）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aws-cdk/aws-globalaccelerator 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aws-cdk/aws-globalaccelerator 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aws-cdk/aws-globalaccelerator 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 14\.15\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aws-cdk/aws-globalaccelerator 可以商用吗？

@aws-cdk/aws-globalaccelerator 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aws-cdk/aws-globalaccelerator 的下载量有多少？

根据 npm 官方下载统计，@aws-cdk/aws-globalaccelerator 在 2026/10/08 – 2026/11/06 这 30 天内被下载 109,621 次，日均约 3,654 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aws-cdk/aws-globalaccelerator 还在维护吗？

最新版本 1\.204\.0 发布于 2023/06/20（3 年前）；至今共发布 187 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/05/27。作者已将其标记为弃用，新项目建议寻找替代方案。