为 Qlik Data Gateway - Direct Access 配置 AWS PrivateLink
上次更新日期：2026/10/9本主题介绍了通过 AWS 网络上的私网连接将 Amazon Web Services (AWS) VPC 中的 Direct Access gateway 连接到 Qlik Cloud 的 AWS PrivateLink 工作流程。
Qlik 不提供以下内容：
-
针对客户 AWS 控制台、VPC 或 PrivateLink 设置的任何配置协助。Qlik 不提供 AWS 咨询服务。
-
如果在确认设置正常运行后出现异常并产生技术问题，Qlik 支持团队会调查客户配置以查明集成未能按预期运行的原因，但不会对客户的 AWS 端设置进行故障排查或协助配置。
客户 AWS 端设置的参考文档将共享给支持团队以了解背景信息，但支持范围仅限于客户侧 Direct Access Gateway 的操作。
理解模式
该模式使用您 VPC 中的 AWS 接口 VPC 终端节点来连接到 Qlik Cloud AWS 终端节点服务。Direct Access gateway 运行在您的 VPC 中。Route 53 私有 DNS 可以从 VPC 解析服务名称，且流量保留在 AWS 骨干网上，而不是经过公共互联网。
- Qlik 提供并运营 Qlik Cloud 端点服务。
- 您在自己的 AWS 账户中创建并操作接口 VPC 终端节点、私有 DNS 和网络控制。
- 您在您的 VPC 中安装并运行 Direct Access gateway，并保持其与数据源的连接可用。
检查范围
- 此模式适用于 AWS 以及 Direct Access gateway 到 Qlik Cloud 的连接。
- Azure 专用连接不属于本主题的讨论范围。
- 在实施之前，必须确认所请求的租户和 AWS 区域的可用性。
准备您的环境
实施前，请与您的 AWS 和 Qlik Cloud 管理员协调。确认您的租户和 AWS 区域的以下信息：
- Direct Access gateway 已安装在 EC2 实例上，且该实例正在运行。
- 您拥有 AWS 控制台访问权限，并具有创建 VPC 终端节点和修改安全组的权限。
- Qlik 已确认该租户和区域的 PrivateLink 可用性，并已提供确切的区域服务名称和接入要求。
- 您可以联系 x 提供端点 ID 并请求接受端点服务。
配置工作流
与您的 AWS 和 Qlik Cloud 管理员一起执行以下操作：
- 从 EC2 实例中，确定运行 Direct Access gateway 的 VPC。
- 在 AWS 控制台中，转到 VPC > PrivateLink 和 Lattice > 端点，然后单击创建端点。
- 选择终端节点服务选项，并输入为您的租户确认的确切 Qlik 区域服务名称。
- 联系 Qlik 支持团队 并提供您的 AWS 账户 ID 以及发起连接的 AWS 区域。请等待 Qlik 支持团队确认 Qlik 已添加您的 AWS 账户 ID。
- 选择为该 EC2 实例指定的 VPC。在 Qlik 接受端点之前，保持清除启用私有 DNS 名称。
- 选择与 EC2 实例的可用区相匹配的子网。
- 分配一个在端口
443上允许入站 HTTPS 的安全组。将源设置为安全组本身；请勿使用子网或开放的 IP 范围作为源。 -
点击创建端点。
-
在创建端点页面上：
-
为端点输入 Name 标签（例如 dag-privatelink-test ）。
-
在类型下，选择使用 NLB 和 GWLB 的终端节点服务。
-
-
在服务设置下：
-
输入 Qlik 为您所在区域提供的 服务名称（例如 com.amazonaws.vpce.us-east-1.vpce-svc-0afc69d0635aef748）。有关按区域列出的服务名称列表，请参阅 各区域的服务名称 (VPC ID) 列表。
-
单击 验证服务。您应该会看到绿色的“服务名称已验证”确认横幅。
-
-
选择您的 VPC：
-
在网络设置下，单击 VPC 下拉菜单并选择与您的 EC2 实例的 VPC ID 相匹配的 VPC（例如 vpc-0abc1234def56789a）。
-
-
- 在 Qlik 接受终端节点后，启用私有 DNS。在启用它之前，请确认 VPC 已启用 启用 DNS 主机名 和 启用 DNS 支持。
-
根据您的部署方法，运行以下命令之一以在网关上启用私有连接：
-
Windows 服务器安装：
connectoragent qcs set_config --private_connection true --tenant_url https://<tenantName>.<region>.qlikcloud.com
（将 <tenantName> 和 <region> 替换为由 Qlik 确认的租户值。）
-
容器化安装：
dotnet ConnectorAgent.dll qcs set_config --private_connection true --tenant_url https://<tenantName>.<region>.qlikcloud.com
（将 <tenantName> 和 <region> 替换为由 Qlik 确认的租户值。）
-
- 通过 DAG 连接运行加载脚本，并通过终端节点服务监控确认流量。
验证与故障排查
首先确定问题是在 AWS 终端节点路径中，还是在 Direct Access gateway 应用程序连接中。请与您的 AWS 管理员联系，检查终端节点状态、私有 DNS 解析、路由和安全控制。与 Direct Access gateway 管理员一起检查网关服务状态和日志。有关特定网关的故障排除，请参阅 配置和故障排除 Qlik Data Gateway - Direct Access。
PrivateLink 连接本身并不定义所有 Qlik Cloud 允许列表要求。请参阅 允许列出域名和 IP 地址 了解通用允许列表指南。
各区域的服务名称 (VPC ID) 列表
本部分列出了每个区域对应的服务名称。在配置 AWS PrivateLink 设置时需要服务名称，如 配置工作流 中所述。
| Region | Service name | Availability zones |
|---|---|---|
| us-east-1 | com.amazonaws.vpce.us-east-1.vpce-svc-00a485f00a94df90d |
|
| eu-west-3 | com.amazonaws.vpce.eu-west-3.vpce-svc-0f914c285c80d92c1 |
|
| ap-southeast-2 | com.amazonaws.vpce.ap-southeast-2.vpce-svc-084ba78d527a91749 |
|
| eu-central-1 | com.amazonaws.vpce.eu-central-1.vpce-svc-0d184b720e97c3888 |
|
| ap-south-1 | com.amazonaws.vpce.ap-south-1.vpce-svc-0baadb0cb3dd12848 |
|
| ap-southeast-1 | com.amazonaws.vpce.ap-southeast-1.vpce-svc-0f808f9f48d12a6bf |
|
| ap-northeast-1 | com.amazonaws.vpce.ap-northeast-1.vpce-svc-0291b1c14bd3353ce |
|
| eu-west-1 | com.amazonaws.vpce.eu-west-1.vpce-svc-0a1084ab9a085760a |
|
| eu-west-2 | com.amazonaws.vpce.eu-west-2.vpce-svc-0b29ae1d28b35237c |
|
| eu-north-1 | com.amazonaws.vpce.eu-north-1.vpce-svc-095b4ac47699f0ef5 |
|
| il-central-1 | com.amazonaws.vpce.il-central-1.vpce-svc-0d3e2075d594af3df |
|
| sa-east-1 | com.amazonaws.vpce.sa-east-1.vpce-svc-01916a7fa8fd86bfd |
|