配置文件

编辑配置文件后，您需要重新启动相关的机器人组件以使更改生效。下表根据机器人的安装模式总结了如何重新启动多个组件。

请记住在重新启动之前保存任何正在进行的工作，以避免丢失任何未保存的进度。

组件	服务模式安装	用户模式安装
机器人服务	打开“任务管理器” >“服务”。查找`UiPathRobotSvc`服务。右键单击该服务，然后选择“重新启动”。	退出，然后重新启动 Assistant 或者打开“任务管理器” > “详细信息”。选择`UiPath.Service.UserHost.exe`流程。选择“结束任务” 。
更新服务	打开“任务管理器” >“服务”。查找`UiPath.UpdateService.Agent`服务。右键单击该服务，然后选择“重新启动”。
UiPath RobotJS 服务主机	打开“任务管理器” >“服务”。查找`UiPath.RobotJS.ServiceHost`服务。右键单击该服务，然后选择“重新启动”。
UiPath Assistant	在 Assistant 中，选择“首选项” ，然后选择“退出”。重新启动 Assistant。
微件	重新启动 Assistant。或者右键单击任务栏中的 Assistant 图标。选择“重新加载微件” 。

uipath.config

UiPath.config文件包含机器人的基本配置参数。作为管理员，您可以通过编辑配置文件中的参数列表来自定义机器人的行为。

备注：

每个环境可能都需要特定的通知，因此 UiPath 允许您根据机器人的当前环境（无论是开发、临时环境还是生产环境）应用不同的配置。编辑此文件时请务必小心，因为配置不正确可能会导致应用程序出现问题。

访问文件

安装机器人时，系统会创建UiPath.config文件。

要访问它，请导航到C:\Program Files\UiPath\Studio\UiPath.config 。

可自定义的设置

UiPath.config文件包含以下参数：

配置部分	数据类型 + 参数名称	描述	默认	示例
`connectionSettings`	字符串`DefaultServiceUrl`	设置机器人用于连接到 Orchestrator 的默认地址。	不适用	`string DefaultServiceUrl = "https://cloud.uipath.com"`string DefaultServiceUrl = "https://cloud.uipath.com"
	Bool `AutoSignIn`	为 Assistant 启用自动登录功能。	False	`bool AutoSignIn = true.`bool AutoSignIn = true.
	Bool `EnforceDefaultServiceUrl`	强制将向所有用户提供的地址作为“默认服务 URL”。	False	`bool EnforceDefaultServiceUrl = true.`bool EnforceDefaultServiceUrl = true.
`communicationSettings`	字节`MaxMessageSizeInMegabytes`	设置系统可以发送或接收的最大消息大小 (以 MB 为单位)。这用于防止由于处理太大的消息而导致的超载或流程崩溃。	10MB	`byte MaxMessageSizeInMegabytes = 10;`byte MaxMessageSizeInMegabytes = 10;
	时间跨度`InstallPackageTimeout`	设置包安装的时限。如果包的安装时间超过定义的时间，系统将中止安装。以时间跨度表示。	20 分钟	`TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);`TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	时间跨度`RequestTimeout`	定义系统等待通信响应的时长。如果系统未在设置的时间内收到响应，它将停止并向前移动。这可以防止系统挂起。以时间跨度表示。	40 秒	`TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);`TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
`packageSettings`	字符串`PackagesInstallationFolder`	设置安装包的默认目录。	`C:\UiPath\Packages`
	Bool `SkipHttpConfigurationSources`	使系统能够忽略通过 HTTP 配置的包来源，例如 NuGet 订阅源。这意味着系统不会从这些来源检索包，这在来源不可靠或不安全时非常有用。	False
	Bool `DisableSecureXaml`	允许机器人运行可能不安全的工作流。	False
	Bool `DirectDownload`	允许直接下载包，而不会提示用户。	False
	Bool `PackageSaveWithoutNupkg`	允许保存不带`.nupkg`文件的包。这有助于减小下载大小。	False
`analyticsSettings`	Bool `Telemetry.Enabled`	允许 UiPath 收集和发送使用情况数据以进行分析。	False
`webProxySettings`	字符串`ScriptAddress`	设置用于确定使用代理的方式和时间的脚本地址。
	字符串`ProxyAddress`	设置代理服务器的地址，可以是 IP 或域名。
	字符串`BypassList`	包含绕过代理服务器直接连接到互联网的地址列表。
	Bool `BypassLocalAddresses`	允许绕过代理服务器直接连接本地地址。	False
	字符串`UserName`	设置用于代理服务器身份验证的用户名凭据。
	字符串`Password`	设置与用于代理服务器身份验证的用户名关联的密码。
	字符串`Domain`	设置身份验证所必需的代理服务器所在的域。
`robotCacheSettings`	时间跨度`SessionCacheDuration`	定义特定会话中的数据应在缓存中保留多长时间后被丢弃。这对于重用变量值或操作详细信息等数据非常有用，而不是重新创建或重新提取数据。以时间跨度表示。	30 秒	`TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);`TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
`robotCacheSettings`	时间跨度`GetResourceUrlCacheDuration`	定义资源（例如 API 或网页）的 URL 在缓存中存储的时间。在机器人需要定期访问某些资源的情况下，这对于优化性能非常有用。以时间跨度表示。	1 小时	`TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);`TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
`robotJsSettings`	整数`ListenerPort`	设置 Robot.js 侦听传入连接的端口号。这允许机器人服务与在本地或远程服务器上运行的网页应用程序交互。	2323	`int ListenerPort = 2323;`int ListenerPort = 2323;
	整数`TokenExpiryInDays`	设置机器人服务生成的身份验证令牌的有效期（以天为单位）。机器人服务在与其他软件组件或服务交互时使用这些令牌进行自身身份验证。	30 天	`int TokenExpiryInDays = 30;`int TokenExpiryInDays = 30;
	字符串`AllowUrlList`	设置机器人服务可以访问的 URL 列表。这有助于确保机器人服务仅与已批准的服务交互。		`string AllowUrlList = "https://cloud.uipath.com";`string AllowUrlList = "https://cloud.uipath.com";

重要提示：

在进行任何更改之前，请始终创建原始UiPath.config文件的备份。如果出现问题，这有助于恢复原始设置。
如要应用对UiPath.config文件进行的更新，请重新启动 UiPath 服务或系统。
UiPath.config文件中的本地设置优先于在 Orchestrator 中配置的设置。
为了提高安全性，可以加密UiPath.config文件中的敏感数据。

UiPath Robot 系统变量

可以通过系统环境变量配置进一步的自定义行为。

修改任意系统变量后，请重新启动机器人服务。

以下列表总结了最常见的用例：

系统变量	用法	示例
`UIPATH_SESSION_TIMEOUT`	更改创建交互式会话时的默认 60 秒超时。调整此值，以根据与之交互的系统的性能和加载时间调整机器人的行为。	`UIPATH_SESSION_TIMEOUT=75`UIPATH_SESSION_TIMEOUT=75
`UIPATH_SESSION_LEGACY`
`UIPATH_PIP_SESSION_TIMEOUT`	更改在 Robot 会话中启动流程的默认 180 秒超时。	`UIPATH_PIP_SESSION_TIMEOUT=60`UIPATH_PIP_SESSION_TIMEOUT=60
`UIPATH_USER_SERVICE_PATH`	设置用户服务的安装路径。	`UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe`UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
`UIPATH_LANGUAGE`	设置机器人的操作语言。确定语言的顺序是： `UIPATH_LANGUAGE`值计算机环境变量当前线程用户界面文化默认 UiPath 语言（英语）	`UIPATH_LANGUAGE=French`UIPATH_LANGUAGE=French
`UIPATH_DISABLE_MARKETPLACE_WIDGET`	由 Assistant 指定，用于禁用 Marketplace 微件。	`// On Windows OS UIPATH_DISABLE_MARKETPLACE_WIDGET=True //On Mac OS, run the following command: launchctl setenv UIPATH_DISABLE_MARKETPLACE_WIDGET TRUE`// On Windows OS UIPATH_DISABLE_MARKETPLACE_WIDGET=True //On Mac OS, run the following command: launchctl setenv UIPATH_DISABLE_MARKETPLACE_WIDGET TRUE
`UIPATH_HEADLESS_WITH_USER`	使用先前在 Orchestrator 中配置的特定用户的凭据。	`UIPATH_HEADLESS_WITH_USER=True`UIPATH_HEADLESS_WITH_USER=True
`UIPATH_PRE_LOADED_EXECUTOR`	默认情况下，会在机器人启动时启动预加载的执行程序。此变量将覆盖默认行为，预加载的执行程序会在第一个流程运行时启动。选项包括： Windows 旧版便携式无	`UIPATH_PRE_LOADED_EXECUTOR=None`UIPATH_PRE_LOADED_EXECUTOR=None
`UIPATH_DISABLE_PRE_LOADED_EXECUTOR`	禁用预加载的执行程序功能。	`UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True`UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
`UIPATH_ROBOTJS_ALLOWLIST`	在机器人 JS SDK 和机器人执行程序之间建立连接时，自动接受机器人同意对话框。该变量接受用分号分隔的自定义应用程序 URL。如果使用非标准端口，请确保包括端口号。
`UIPATH_DNS_MACHINENAME`	允许在创建 RDP 会话时使用本地主机的 DNS 主机名。要在对 RDP 使用 Kerberos 身份验证的环境中执行 Unattended 作业，请将此值设置为 True。	`UIPATH_DNS_MACHINENAME=True`UIPATH_DNS_MACHINENAME=True
`UIPATH_PROXY_USE_DEFAULT_CREDENTIALS`	使机器人能够处理使用 Windows 凭据进行身份验证的代理配置。	`UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True`UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
`NUGET_FALLBACK_PACKAGES`	配置回退包文件夹的路径。使用分号分隔多个路径。如果没有此变量，机器人在`Nuget.config`文件中搜索回退包文件夹。
`NUGET_SCRATCH`	允许同一台计算机上的多个用户模式机器人共享用于存储包的本地路径。该值必须是不同于 Nuget 安装文件夹的路径，并且充当 NuGet 的临时文件夹。备注：应只有`NUGET_SCRATCH`变量使用已配置的临时文件夹。	`NUGET_SCRATCH=C:\NuGetTempFolder`NUGET_SCRATCH=C:\NuGetTempFolder
`UIPATH_PRESERVE_CREDENTIALS_CASE`	保留日志记录凭据的原始大小写 (域\用户名)。	`UIPATH_PRESERVE_CREDENTIALS_CASE = True`UIPATH_PRESERVE_CREDENTIALS_CASE = True