有关配置代理设置的分步指南

如果你的工作环境需要 Microsoft 本地数据网关通过代理服务器连接到服务，请按照以下步骤配置代理设置。

配置代理设置

1. 创建代理定义元素。 要了解有关 .NET 配置文件代理元素配置的详细信息，请转到 defaultProxy 元素（网络设置）。

   以下示例在端口 8888 上通过 IP 地址为 192.168.0.1 的特定代理路由所有请求：

   <defaultProxy useDefaultCredentials="true">
       <proxy  
           autoDetect="false"  
           proxyaddress="http://192.168.0.1:8888"
           bypassonlocal="false"
           usesystemdefault="false"
       />
   </defaultProxy>
   

2. 浏览本地数据网关的安装文件夹，例如 *C:\Program Files\On-premises data gateway*。

3. 打开用于配置网关的配置屏幕的第一个文件，即 EnterpriseGatewayConfigurator.exe.config。

4. 找到 defaultProxy 元素并将其替换为在上述步骤 1 中创建的代理配置，然后保存对文件的更改。

5. 打开用于通过网关与云服务交互并处理请求的实际 Windows 服务的第二个文件，即 Microsoft.PowerBI.EnterpriseGateway.exe.config，然后重复步骤 4。

6. 对于用于连接到数据源（通常是云数据源）的网关的第三个配置文件，请打开安装文件夹中的子文件夹 m，然后打开文件 Microsoft.Mashup.Container.NetFX45 .exe.config。重复步骤 4 以将代理配置插入到此文件中。

   如果文件处于默认状态，则需要添加 system.net 标记以及代理定义，如以下示例所示：

   <system.net>
       <defaultProxy useDefaultCredentials="true">
           <proxy  
               autoDetect="false"  
               proxyaddress="http://192.168.0.1:8888"
               bypassonlocal="false"
               usesystemdefault="false"
           />
       </defaultProxy>
   </system.net>
   

7. 打开本地数据网关应用程序，导航到“服务设置”选项卡，然后选择“立即重启”以重启网关服务并应用新的代理设置。

验证代理配置是否一致

1. 确保运行 2022 年 9 月版本或更高版本。

2. 打开本地数据网关应用程序。

3. 导航到“诊断”选项卡。

4. 在“网络端口测试”下，选择“启动新测试”。

5. 网络端口测试完成后，选择“打开上次完成的测试结果”。

6. 如果代理配置在三个必需的配置文件中保持一致，则会显示 Proxy configuration : Proxy settings match for all Gateway process configurations. 消息。

7. 否则，如果代理配置不一致，则会显示以下信息：

   Proxy configuration : Proxy settings are not consistent. Please ensure that the proxy configuration matches across the files listed below:
   C:\Program Files\On-premises data gateway\EnterpriseGatewayConfigurator.exe.config
   C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config
   C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config
   Review <https://docs.microsoft.com/data-integration/gateway/service-gateway-proxy>  for additional information about configuring proxies for the Gateway.
   

从本地数据网关（个人模式）运行代理配置一致性验证时，将验证以下配置文件：

%LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config

代理配置行为不一致或缺失

如果代理定义缺失或不一致，在使用本地数据网关时，你可能会遇到不同的行为。 下面是一些示例：

• 语义模型或数据流刷新失败，错误消息示例：Error: Unable to connect to the remote server。
• 在启动本地数据网关时无法登录并显示登录提示，但其内容无法显示，或显示错误消息页。
• 网络端口测试结果报告连接到服务器失败。

后续步骤

• 防火墙信息