@aws-cdk/aws-route53resolver-alpha

中文文档
2.275.0-alpha.0发布于 2026/10/27Apache-2.0TypeScriptCommonJS零依赖近 30 天下载 1.2万

AWS 的 CDK 构造库: Route53 解析器

中文使用文档
文档目录3 节
  1. DNS 防火墙
  2. 域列表
  3. 规则组

Amazon Route53 解决方案构建库


cdk-constructs: Experimental

本单元中更高层次的构件的API是实验性的并正在积极开发中. 在今后任何版本中,它们都须作非背向相容的修改或去除。 这些是 不适用 语义版本 模型和断开的更改 在发行笔记中宣布. 这意味着虽然你可能使用它们,但可能需要更新 当更新到此软件包的更新版本时,您的源代码.


DNS 防火墙

路线53 解析器 DNS 防火墙,您可以过滤和调节 DNS 流量 虚拟私人连接(VPC). 要做到这一点,您创建可重复使用的过滤规则集 在DNS防火墙规则组中 将规则组与你的VPC联系起来.

DNS防火墙为您的 VPC 的出入境 DNS 请求提供保护. 这些请求的路线 用于域名解析。 DNS防火墙保护的主要用途是帮助 防止 DNS 过滤您的数据。 当一个坏角色妥协时, DNS 退出可能发生 您的 VPC 中的应用程序实例, 然后使用 DNS 搜索将数据从 VPC 发送到一个域 他们控制。 通过 DNS 防火墙,您可以监视和控制您的应用程序的域 可以查询。 您可以拒绝访问您所知的不良域, 并允许其它所有查询 通过。 另外,你可以拒绝所有域的进入,除了那些你 明确的信任.

域列表

域列表可以使用字符串列表、存储在亚马逊 S3 的文本文件或本地 文本文件 :

const blockList = new route53resolver.FirewallDomainList(this, 'BlockList', {
  domains: route53resolver.FirewallDomains.fromList(['bad-domain.com', 'bot-domain.net']),
});

const s3List = new route53resolver.FirewallDomainList(this, 'S3List', {
  domains: route53resolver.FirewallDomains.fromS3Url('s3://bucket/prefix/object'),
});

const assetList = new route53resolver.FirewallDomainList(this, 'AssetList', {
  domains: route53resolver.FirewallDomains.fromAsset('/path/to/domains.txt'),
});

文件必须是文本文件,每行必须包含一个单一域.

使用 FirewallDomainList.fromFirewallDomainListId() 以导入现有或 AWS 管理域列表数字 :

// AWSManagedDomainsMalwareDomainList in us-east-1
const malwareList = route53resolver.FirewallDomainList.fromFirewallDomainListId(
  this,
  'Malware',
  'rslvr-fdl-2c46f2ecbfec4dcc',
);

规则组

创建规则组 :

declare const myBlockList: route53resolver.FirewallDomainList;
new route53resolver.FirewallRuleGroup(this, 'RuleGroup', {
  rules: [
    {
      priority: 10,
      firewallDomainList: myBlockList,
      // block and reply with NODATA
      action: route53resolver.FirewallRuleAction.block(),
    },
  ],
});

规则可在施工时添加或使用 addRule()数字 :

declare const myBlockList: route53resolver.FirewallDomainList;
declare const ruleGroup: route53resolver.FirewallRuleGroup;

ruleGroup.addRule({
  priority: 10,
  firewallDomainList: myBlockList,
  // block and reply with NXDOMAIN
  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.nxDomain()),
});

ruleGroup.addRule({
  priority: 20,
  firewallDomainList: myBlockList,
  // block and override DNS response with a custom domain
  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.override('amazon.com')),
});

使用 associate() 将规则组与VPC联系起来:

import * as ec2 from 'aws-cdk-lib/aws-ec2';

declare const ruleGroup: route53resolver.FirewallRuleGroup;
declare const myVpc: ec2.Vpc;

ruleGroup.associate('Association', {
  priority: 101,
  vpc: myVpc,
})

版本与发布记录

@aws-cdk/aws-route53resolver-alpha 共发布 380 个版本,首次发布于 2021/10/14;过去 12 个月发布了 64 个版本。

版本发布日期距今
2.275.0-alpha.0latest2026/10/2712 天前
2.274.0-alpha.02026/10/2018 天前
2.273.0-alpha.02026/10/0929 天前
2.272.0-alpha.02026/09/301 个月前
2.271.0-alpha.02026/09/261 个月前
2.270.0-alpha.02026/09/181 个月前

关于 @aws-cdk/aws-route53resolver-alpha 的常见问题

@aws-cdk/aws-route53resolver-alpha 是什么?

AWS 的 CDK 构造库: Route53 解析器

如何安装 @aws-cdk/aws-route53resolver-alpha?

在项目目录运行 npm install @aws-cdk/aws-route53resolver-alpha,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:constructs(^10.5.0)、aws-cdk-lib(^2.275.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aws-cdk/aws-route53resolver-alpha 支持 TypeScript 吗?

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

@aws-cdk/aws-route53resolver-alpha 支持 ESM 还是 CommonJS?

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

@aws-cdk/aws-route53resolver-alpha 需要什么版本的 Node.js?

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

@aws-cdk/aws-route53resolver-alpha 可以商用吗?

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

@aws-cdk/aws-route53resolver-alpha 的下载量有多少?

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

@aws-cdk/aws-route53resolver-alpha 还在维护吗?

最新版本 2.275.0-alpha.0 发布于 2026/10/27(12 天前);至今共发布 380 个版本,其中过去 12 个月发布了 64 个;首次发布于 2021/10/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。