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

For a Robot to establish direct communication with Orchestrator, it needs to be on the same network or use an open one. Otherwise, you need to set up a proxy server to facilitate the communication.

Set up a proxy by either using a proxy script or supplying the proxy server address with a list of addresses to bypass. Only one method can be used. If both are configured, the proxy script takes precedence.

The following configuration options are available:

• Configuring the web browser

• Configuring the Windows proxy settings

• Configuring the proxy setting through command line parameters

• Editing the uipath.config file

Important: When updating from versions previous to v2021.4, proxy configurations are migrated from the proxy.config file to the uipath.config in order to match the new format.

Proxy for Use Mode robots

User Mode robots inherit the proxy settings configured for your web browser.

For proxy settings that require basic non-Windows authentication, store the necessary credentials in the Credential Manager of the machine.

重要提示：

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

Proxy for Service Mode robots

To correctly use proxy settings for Service Mode robots with the Interactive Sign In and Live Streaming features, you need to modify both the uipath.config file and the corresponding Windows Settings of the user account running the Robot.

The auto-update process for proxy configurations

You can configure the auto-update process for robots operating behind a proxy, depending on the on the Robot installation type:

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 凭据代理身份验证

The proxy server might require credentials to allow traffic. You can configure the proxy to authenticate using the credentials of the logged-in Windows user.

To enable this feature, add the system environment variable UIPATH_PROXY_USE_DEFAULT_CREDENTIALS on the machine running the Robot and set its value to true. This tells the Robot to use the Windows Credentials of the current user for proxy authentication.

基本身份验证

Starting with version 2021.10, the Robot Service supports proxy servers using Basic Authentication protocols.

User Mode robots - With Basic Authentication, the Assistant identifies if a proxy configuration is implemented on the machine and prompts the user for their credentials.

Service Mode robots - The Robot Executor does not support Basic Authentication methods for proxy configurations. While you can use Basic Authentication for connecting to Orchestrator and downloading packages, you cannot use it within the actual workflow execution. To enable Basic Authentication for Service Mode robots, update the UiPath.config file with the following proxy parameters:

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

Configuring the web browser

1. Open the Internet Properties window.
2. On the Connections tab, select LAN settings. The Local Area Network (LAN) Settings window opens. Depending on your setup, you can set a proxy configuration script or a proxy server.
   
   1. To use a proxy script, select Use automatic configuration script, and provide the address to the script.
   2. To manually set up the proxy server, select Use a proxy server for your LAN, then provide the address of the proxy server and the port.
3. To save your settings, select OK.
4. In your web browser, test the connection by accessing the Orchestrator URL.

Configuring the Windows proxy settings

1. Open the Proxy settings window.
2. To use a proxy script, under Automatic proxy setup, switch on the Use setup script. Provide the address to the script.
3. To manually set up the proxy server, under Manual proxy setup, switch on the Use a proxy server. Provide the address of the proxy server and the port.
   重要提示：

   Adding the http:// prefix to the proxy server address prevents Robot from making HTTPS calls. To ensure the proxy works as expected, remove the http:// prefix entirely or add the proxy address with both http:// and https:// prefixes.

   例如：

   • Incorrect - http=proxyaddress
   • Correct - http=proxyaddress;https=proxyaddress
   • Correct - http://proxyaddress;https://proxyaddress
4. To save your settings, select Save.

Editing the uipath.config file

1. 导航至安装文件夹 %ProgramFiles%\UiPath\Studio。
2. 搜索 uipath.config 文件，然后使用 Notepad++ 等文本编辑器打开该文件。
3. 添加 <webProxySettings> 标签并根据您的代理环境设置值。
   1. To use a proxy script, provide the following key-value pair:

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

   2. To provide a proxy address, provide the following key-value pairs:

      <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. 重新启动机器人服务。

Configuring the proxy settings during Robot installation

To add the proxy settings while installing Service Mode robots, use the dedicated command line parameters in your installation command.

For example, the following command installs the Robot in Service Mode and uses a script to configure proxy:

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

The following command installs the Robot in Service Mode and sets up the Basic Authentication for proxy settings:

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

Checking the proxy server connection

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