机器人用户指南

上次更新日期 2024年11月11日

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

如果您的机器人处于封闭网络或并非是 Orchestrator 所使用的网络中，则将无法实现两个 UiPath 产品之间的通信。因此，要实现这种通信，您可以为机器人使用代理服务器。

如要通过代理服务器重定向机器人，则您必须在机器人计算机上完成一些配置。具体步骤如下：

配置您的首选网页浏览器，以确保机器人计算机可通过指定的代理服务器访问 Orchestrator。
编辑 UiPath.config 文件，确保通过提供的代理服务器路由机器人和 Orchestrator 之间的连接，以及通过指定的代理服务器下载活动包和自动化流程。
注意：用户模式机器人从“Internet 选项”继承代理设置，而服务模式机器人需要在 Studio 安装文件夹的 uipath.config 文件中进行特定的配置。
要在用户模式机器人上应用代理设置，您需要重新启动用户主机服务。为此，您可以注销 Windows 用户会话然后重新登录。

配置代理设置

可以从“Internet 选项”的“连接”部分或“Windows 设置”的“代理设置”菜单中设置代理脚本或代理地址的配置。

配置网页浏览器

在 Internet Explorer 中，依次单击“工具”>“Internet 选项”。系统将显示“Internet 选项”窗口。
在“连接”选项卡中，单击“局域网设置”。系统将显示“局域网设置”窗口。根据您的设置，您可以设置代理配置脚本或代理服务器。
配置“代理服务器”或“自动配置”（用于代理脚本）。
单击“确定”。您的设置已保存。
在网页浏览器中，输入 Orchestrator URL 以测试连接。

配置 Windows 代理设置

打开开始菜单，然后搜索“代理设置”。
配置“自动代理设置”（用于代理脚本）或“手动代理设置”（用于代理服务器）。
保存设置。
在网页浏览器中，输入 Orchestrator URL 以测试连接。
重要提示：
设置或编辑代理地址时，请勿将 http:// 前缀添加到代理地址。这将为 HTTP 调用启用代理，并且由于大多数调用是 HTTPS，代理配置将失败。

要解决此问题，请确保完全删除 http:// 前缀，或专门添加同时带有 http:// 和 https:// 前缀的代理地址。

示例：
- http=proxyaddress -> incorrect
- http=proxyaddress;https=proxyaddress -> correct
- http://proxyaddress;https://proxyaddress -> correct

编辑 uipath.config 文件

导航至安装文件夹 %ProgramFiles%\UiPath\Studio。
搜索 uipath.config 文件，然后使用 Notepad++ 等文本编辑器打开该文件。
添加 <webProxySettings> 标签并根据您的代理环境设置值。
1. 要使用代理脚本，请提供以下键值对：
```
<webProxySettings>
    <add key="ScriptAddress" value="http://localhost/proxy.pac" />
</webProxySettings><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><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>
```
注意：从 Robot v2021.4 开始，绕过列表应包含正则表达式字符串数组，其中包含要绕过的服务器 URI。
保存 uipath.config 文件，然后重新启动机器人服务以使更改生效。

Windows 凭据代理身份验证

从 v2021.4.4 开始，机器人可以处理通过 Windows 凭据使用身份验证的代理配置。要启用此功能，请在计算机中添加 UIPATH_PROXY_USE_DEFAULT_CREDENTIALS 系统环境变量。

备注：

只能设置 ScriptAddress 和 ProxyAddress。如果两者都设置，则 ScriptAddress 优先。

只有设置 ProxyAddress 后，才能设置 BypassList 和 BypassLocalAddresses。

基本身份验证

从 2021.10 版本开始，当使用服务模式安装时，Uipath 机器人服务支持使用基本身份验证协议的代理服务器。要启用此功能，您需要编辑 uipath.config 文件中的 webProxySettings 部分，并添加以下信息：

<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><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>

重要通知：机器人执行程序不支持使用基本身份验证方法的代理配置。这意味着，您可以使用基本身份验证连接到 Orchestrator 并下载包，但不能用于实际的工作流。

检查代理服务器连接

将 Robot 连接到 Orchestrator。
将一些包部署到包含先前所配置机器人的环境中。
导航至 %userprofile%\.nuget\ 文件夹，查看是否已下载相应的流程和活动包。
运行相应作业，检查是否能成功运行。
注意：从 v2021.4 之前的版本更新时，代理配置将从 proxy.config 文件迁移到 uipath.config，以匹配新格式。