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

配置 UiPath 机器人，以便使用代理脚本、Windows 设置或 uipath.config 文件，通过代理服务器与 Orchestrator 通信。

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

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

可用的配置选项如下：

• 配置网页浏览器
• 配置 Windows 代理设置
• 通过命令行参数配置代理设置
• 编辑 uipath.config 文件
  重要提示：

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

用户模式机器人的代理

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

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

重要提示：

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

服务模式机器人的代理

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

基于用户类型的代理设置（执行程序）

在 UiPath 的上下文中，Windows 流程可以在两个不同的身份下运行：

• 本地用户 — 这些流程会以当前登录到 Windows 会话的用户的身份运行。
• 本地系统用户 — 这些流程通常是使用系统级权限运行的服务或后台任务。

在 Windows 中配置代理时，代理设置与执行流程的用户绑定。根据发出 HTTP 请求的流程的身份，有两种可能的代理配置方案：

• 使用在 Windows 中为用户定义的代理。
• 从 uipath.config 文件加载代理设置。

下表汇总了与 Robot 相关的 Windows 流程、运行流程的用户身份以及流程执行的 HTTP 请求：

Windows 流程	用户身份	HTTP 请求
UiPath.ServiceHost.exe	本地系统	负责与 Orchestrator 的服务通信，包括： 获取心跳 获取作业并提交作业状态 处理 Unattended 流程的日志 管理服务的身份验证 正在下载包
UiPath.UserHost.exe	用户	在用户模式下安装时，负责与 Orchestrator 的服务通信，包括： 获取心跳 管理流程日志 处理 Assistant 的身份验证 正在下载包
UiPath.Executor.exe	本地系统（运行后台作业时） 用户（运行常规作业时）	负责处理特定于自动化的 HTTP 请求，包括： 管理资产和队列项目 发送特定于活动的请求（对外部服务的 HTTP 请求）
UiPath.Assistant.exe	用户	负责处理与 Assistant 相关的流量，包括： 流程列表管理 触发器处理 Marketplace 交互
UiPath.RemoteDebugging.Agent.exe	用户	负责通过 SignalR 处理远程调试流量。
UiPath.UpdateService.Worker.exe	本地系统	负责从 Orchestrator 下载 MSI。

代理配置的自动更新流程

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

Unattended 安装无更新代理。代理配置是通过修改UiPath.config文件来手动处理的。UiPath 机器人服务和更新服务均使用 Windows 服务运行，独立于用户。

对于 Attended 安装，代理配置也是通过修改UiPath.config文件来手动处理的。但是，用户会启动 UiPath 机器人服务和更新代理。更新服务使用 Windows 服务运行。

为了快速安装，代理配置将从现有用户设置中继承。 用户启动所有服务：UiPath 机器人服务、更新代理和更新服务。

Windows 凭据代理身份验证

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

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

基本身份验证

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

用户模式机器人 - 使用基本身份验证，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>

代理设置中的实时流式传输和远程控制

警告：

在早于 2024.10.5 的机器人版本中，实时流式传输和远程控制功能在代理设置状态下无法使用。将您的机器人升级到 2024.10.5 以上版本，以在代理设置状态下使用这些功能。

使用网页浏览器配置代理

1. 打开“互联网属性”窗口。

2. 在“连接”选项卡上，选择 LAN 设置。 系统将打开“局域网 (LAN) 设置”窗口。 根据您的设置，您可以设置代理配置脚本或代理服务器。

   

   1. 要使用代理脚本，请选择“使用自动配置脚本”，然后提供脚本的地址。
   2. 要手动设置代理服务器，请选择『为您的 LAN 使用代理服务器』，然后提供代理服务器的地址和端口。

3. 要保存设置，请选择“确定”。

4. 在网页浏览器中，通过访问 Orchestrator URL 来测试连接。

使用 Windows 设置配置代理

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

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

   • 不正确 - 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. 重新启动 UiPath 机器人服务或设备。

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

要在安装 Unattended Robot（服务模式）时添加代理设置，请使用安装命令中的专用命令行参数。

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

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

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

UiPathStudio.msi ADDLOCAL=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. 运行相应作业，检查是否能成功运行。