跳转到主要内容
偶爾你可能會遇到 Gorelo Agent 安裝問題。以下是一些需要考慮的事項。

​
支援的作業系統

Gorelo 僅支援目前仍受供應商（Microsoft/Apple）支援的作業系統。

​
透過 PowerShell 進行前置條件檢查

Gorelo 提供可透過 PowerShell 執行的簡單前置條件檢查。
  1. 在發生 agent 問題的電腦上開啟一個提升權限的 PowerShell 視窗。
  2. 貼上下列指令並按 Enter：
Invoke-Expression (Invoke-WebRequest -Uri "https://gist.githubusercontent.com/mikelgorelo/e5bcac91d2fddd165a2fd56a675ebb3a/raw/dd21bcf13480e366a569ae06fa43b9f3c57fa5d8/gorelo-check.ps1" -UseBasicParsing).Content
  1. 依下表逐一解決失敗項目，並確保修復在 PowerShell 工作階段與重新開機後仍然存在。
Check❌ 失敗訊息✅ 疑難排解
PowerShell Version CheckFAIL: 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 驗證安裝
System Drive Space Check
  • 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 檢查磁碟健康度
Processor Architecture CheckFAIL: Non-64-bit processor architecture detected: X
  • 確認系統符合 64 位元需求
  • 檢查是否在 64 位元硬體上執行 32 位元 Windows
支援 ARM64，例如 Snapdragon
Registry Permission CheckFAIL: Registry read/write permission check. Error: [specific error]
  • 以系統管理員執行指令稿
  • 檢查 HKLM:\SOFTWARE\Gorelo 的權限
  • 確認防毒軟體未封鎖登錄存取
  • 使用 RegEdit 檢查登錄機碼的可存取性
URL Accessibility ChecksFAIL: URL check for [Description] ([URL]). Error: [specific error]
  • 檢查網際網路連線
  • 確認 DNS 解析（對網域執行 nslookup）
  • 檢查防火牆設定
  • 如適用，確認 proxy 設定
Event Log Permission CheckFAIL: Event log read/write permission check. Error: [specific error]
  • 以系統管理員執行指令稿
  • 檢查 Event Log 服務是否執行中（Get-Service EventLog）
  • 確認 Application event log 的權限
  • 手動檢查 Event Viewer 功能
Environment Variable Check
  • 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 變數比較
Time Synchronization CheckFAIL: 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 支援團隊。透過左下角選單的「?」圖示使用支援聊天。