通过代理服务器重定向机器人

要使机器人与 Orchestrator 建立直接通信，两者需要位于同一网络上或使用开放式网络。 否则，您需要设置代理服务器以方便通信。

通过使用代理脚本或向代理服务器地址提供要绕过的地址列表来设置代理。 只能使用一种方法。 如果两者都已配置，则代理脚本优先。

可用的配置选项如下：

• 配置网页浏览器

• 配置 Windows 代理设置

• 通过命令行参数配置代理设置

• 编辑uipath.config文件

重要提示：从 v2021.4 之前的版本更新时， 代理配置将从proxy.config文件迁移到uipath.config ，以匹配新格式。

使用模式机器人代理

用户模式机器人会继承为您的网页浏览器配置的代理设置。

对于需要基本非 Windows 身份验证的代理设置，请将必要的凭据存储在计算机的凭据管理器中。

重要提示：

要在用户模式机器人上应用代理设置，您需要重新启动用户主机服务。为此，您可以注销 Windows 用户会话然后重新登录。

服务模式机器人的代理

要为具有交互式登录和实时流式传输功能的服务模式机器人正确使用代理设置，您需要同时修改uipath.config文件和运行机器人的用户帐户的相应 Windows 设置。

The auto-update process for proxy configurations

您可以为在代理后运行的机器人配置自动更新过程，具体取决于机器人安装类型：

For unattended installations, the Update Agent is absent. Configurations for proxy are manually handled by modifying the UiPath.config file. Both the Robot Service and the Update Service run using a Windows Service, independent of a user.

For attended installations, configurations for proxy are also manually handled by modifying the UiPath.config file. However, the user starts both the Robot Service and the Update Agent. The Update Service runs using a Windows Service.

For quick installations, configurations for the proxy are inherited from the existing user settings. The user initiates all services: Robot Service, Update Agent, and Update Service.

Windows 凭据代理身份验证

代理服务器可能需要凭据才能允许流量。 您可以将代理配置为使用已登录的 Windows 用户的凭据进行身份验证。

要启用此功能，请在运行机器人的计算机上添加系统环境变量UIPATH_PROXY_USE_DEFAULT_CREDENTIALS ，并将其值设置为true 。 该操作将告知机器人使用当前用户的 Windows 凭据进行代理身份验证。

基本身份验证

从 2021.10 版本开始，机器人服务支持使用基本身份验证协议的代理服务器。

用户模式机器人- 使用基本身份验证，Assistant 会识别计算机上是否实施了代理配置，并提示用户输入其凭据。

服务模式机器人- 机器人执行程序不支持代理配置的基本身份验证方法。 虽然您可以使用基本身份验证连接到 Orchestrator 并下载包，但不能在实际的工作流执行中使用它。 要为服务模式机器人启用基本身份验证，请使用以下代理参数更新UiPath.config文件：

<webProxySettings>
<add key="ProxyAddress" value="http://my.proxy.net:8008" />
<add key="UserName" value="myUser" />
<add key="Password" value="myPassword" />
<add key="Domain" value="myDomain" />
</webProxySettings>

Live streaming and remote control in a proxy setup

警告：

Live streaming and remote control features do not work in a proxy setup for Robot versions older than 2024.10.5. Upgrade your Robot to versions 2024.10.5+ to access these features in a proxy setup.

配置网页浏览器

1. 打开“ Internet 属性”窗口。
2. 在“连接” 选项卡上，选择“局域网设置”。 系统将打开“局域网设置”窗口。 根据您的设置，您可以设置代理配置脚本或代理服务器。
   
   1. 要使用代理脚本，请选择 “使用自动配置脚本”，并提供脚本的地址。
   2. 要手动设置代理服务器，请选择“为局域网使用代理服务器” ，然后提供代理服务器的地址和端口。
3. 要保存设置，请选择“确定” 。
4. 在网页浏览器中，通过访问 Orchestrator URL 来测试连接。

配置 Windows 代理设置

1. 打开“代理设置”窗口。
2. 要使用代理脚本，请在“自动代理设置” 下，打开“使用设置脚本” 。 提供脚本的地址。
3. 要手动设置代理服务器，请在“手动代理设置”下，打开“使用代理服务器”。 提供代理服务器的地址和端口。
   重要提示：

   将http://前缀添加到代理服务器地址可防止机器人发出 HTTPS 调用。 为确保代理按预期工作，请完全删除http://前缀，或添加同时带有http://和https://前缀的代理地址。

   例如：

   • 不正确 - http=proxyaddress
   • 正确 - http=proxyaddress;https=proxyaddress
   • 正确 - http://proxyaddress;https://proxyaddress
4. 要保存设置，请选择 “保存”。

编辑 uipath.config 文件

1. 导航至安装文件夹 %ProgramFiles%\UiPath\Studio。
2. 搜索 uipath.config 文件，然后使用 Notepad++ 等文本编辑器打开该文件。
3. 添加 <webProxySettings> 标签并根据您的代理环境设置值。
   1. 要使用代理脚本，请提供以下键值对：

      <webProxySettings>
          <add key="ScriptAddress" value="http://localhost/proxy.pac" />
      </webProxySettings>

   2. 要提供代理地址，请提供以下键值对：

      <webProxySettings>
          <add key="ProxyAddress" value="http://1.1.1.1:1234/" />
          <add key="BypassLocalAddresses" value="True" />
          <add key="BypassList" value="server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}" />
      </webProxySettings>

4. 保存 uipath.config 文件。
5. 重新启动机器人服务。

在机器人安装期间配置代理设置

要在安装服务模式机器人时添加代理设置，请在安装命令中使用专用命令行参数。

例如，以下命令将在服务模式下安装机器人，并使用脚本配置代理：

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac

以下命令将在服务模式下安装机器人，并设置代理设置的基本身份验证：

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_ADDRESS=http://my.proxy.net:8008 PROXY_USERNAME="myUser" PROXY_PASSWORD="myUser" PROXY_DOMAIN="myUser"

检查代理服务器连接

1. 将机器人连接到 Orchestrator
2. 将一些包部署到包含先前所配置机器人的环境中。
3. 导航至 %userprofile%\.nuget\ 文件夹，查看是否已下载相应的流程和活动包。
4. 运行相应作业，检查是否能成功运行。