跳转到主要内容
有时，你在安装 Gorelo Agent 时可能会遇到问题。以下是需要考虑的几个方面。

​
支持的操作系统

Gorelo 仅支持供应商（Microsoft/Apple）当前支持的操作系统。

​
通过 PowerShell 进行先决条件检查

Gorelo 提供了一个简单的 PowerShell 先决条件检查，你可以运行它。
  1. 在遇到代理问题的计算机上打开提升权限的 PowerShell 窗口。
  2. 粘贴以下命令并按 Enter：
Invoke-Expression (Invoke-WebRequest -Uri "https://gist.githubusercontent.com/mikelgorelo/e5bcac91d2fddd165a2fd56a675ebb3a/raw/dd21bcf13480e366a569ae06fa43b9f3c57fa5d8/gorelo-check.ps1" -UseBasicParsing).Content
  1. 按以下方法解决任何失败，并确保它们在 PowerShell 会话和重启之间持久。
检查❌ 失败消息✅ 故障排除
PowerShell 版本检查FAIL: PowerShell version X.X is below the required version 5.1
  • 从 Microsoft 下载并安装 Windows Management Framework 5.1
  • 对于 Windows 10/11，使用 Windows Update 更新 PowerShell
  • 使用 $PSVersionTable.PSVersion 验证安装
系统驱动器空间检查
  • FAIL: Free space is less than 300 MB (Current: X MB)
  • FAIL: Unable to get drive info
  • FAIL: Unable to get System Drive
  • 运行磁盘清理释放空间
  • 检查并删除大量不必要的文件
  • 验证系统驱动器可访问并正确挂载
  • 使用 chkdsk /f 检查磁盘健康状况
处理器体系结构检查FAIL: Non-64-bit processor architecture detected: X
  • 验证系统满足 64 位要求
  • 检查是否在 64 位硬件上运行 32 位 Windows
支持 ARM64，例如 Snapdragon
注册表权限检查FAIL: Registry read/write permission check. Error: [specific error]
  • 以管理员身份运行脚本
  • 检查 HKLM:\SOFTWARE\Gorelo 的权限
  • 验证防病毒软件未阻止注册表访问
  • 使用 RegEdit 检查注册表项的可访问性
URL 可访问性检查FAIL: URL check for [Description] ([URL]). Error: [specific error]
  • 检查互联网连接
  • 验证 DNS 解析（对域执行 nslookup）
  • 检查防火墙设置
  • 如适用，验证代理设置
事件日志权限检查FAIL: Event log read/write permission check. Error: [specific error]
  • 以管理员身份运行脚本
  • 检查 Event Log 服务正在运行（Get-Service EventLog）
  • 验证 Application 事件日志的权限
  • 手动检查事件查看器功能
环境变量检查
  • FAIL: The PATH environment variable contains 'system32' but not 'System32\WindowsPowerShell\v1.0'
  • FAIL: The PATH environment variable contains 'System32\WindowsPowerShell\v1.0' but not 'system32'
  • FAIL: The PATH environment variable does not contain 'system32' or 'System32\WindowsPowerShell\v1.0'
  • 在系统属性中检查 System PATH 变量
  • 验证 Windows 目录结构
  • 如果被修改，修复/恢复系统 PATH
  • 与工作系统的 PATH 变量进行比较
时间同步检查FAIL: Time mismatch detected! [time details]
  • 检查 Windows Time 服务正在运行
  • 强制时间同步：w32tm /resync
  • 验证时区设置
  • 检查与 time.windows.com 的网络连接
  • 在 Windows 设置中配置自动时间同步

​
日志

Gorelo 将所有内容记录到： 
%programfiles%\Gorelo\LogFiles\
随着安装过程的进行，安装程序会在每个阶段创建额外的文件夹，里面有日志文件： InstallerHandler > Installer > Shell > Agent 请随意查看以下日志——这是最常见问题出现的位置： 
%programfiles%\Gorelo\LogFiles\Installer\diagnostics**.log

%programfiles%\Gorelo\LogFiles\Agent\diagnostics**.log
如果 Gorelo 支持人员要求日志文件，请将整个 LogFiles 文件夹作为 .zip 发送。

​
仍有问题？

如果你在解决 Gorelo Agent Check 中所有失败后仍遇到安装问题，请直接联系 Gorelo 支持。通过左下角菜单中的 ”?” 图标使用支持聊天。