giip

Windows 代理安裝指南

引導您如何在 Windows 伺服器或工作站上安裝 GIIP 代理 (Agent) 並開始管理。

📋 概述

GIIP Windows 代理基於 PowerShell 運行，執行伺服器性能採集、日誌分析及安全監控等功能。安裝過程非常簡單，無需重啟伺服器。

🛠️ 安裝前準備

  • 作業系統: Windows Server 2012 R2 或更高版本 (支援 Windows 10/11)
  • 權限: 需要管理員 (Administrator) 權限
  • 認證資訊: 請提前從 GIIP 控制台的 [個人資料] 菜單中獲取並準備好 
    CSN
    、
    Access Key (AK)
    和 
    Secret Key (SK)
    。

🚀 安裝步驟

1. 下載代理檔案

從 GIIP 控制台的 [代理管理] 頁面下載 

giipAgent_Windows.zip
檔案，或複製並運行提供的 PowerShell 命令。

2. 解壓及路徑設置

  • 將檔案解壓到易於存取的路徑，如 
    C:\giipAgent
    。
  • 注意: 建議使用純英文的短路徑，避免包含中文字元或空格。

3. 配置認證資訊

使用記事本打開 

giipAgent.cfg
檔案，填寫以下項並保存：

  • CSN
    : 客戶編號
  • AK
    : Access Key
  • SK
    : Secret Key

4. 運行代理

  • 以管理員身分運行 PowerShell 或命令提示字元 (CMD)。
  • 進入代理資料夾並運行 
    giipAgent3.bat
    檔案。
cd C:\giipAgent
.\giipAgent3.bat

🔍 驗證運行狀態

  • 控制台確認: 確認 GIIP Web 控制台的 [伺服器列表] 中該伺服器的狀態是否變為 
    Online
    (在線)。
  • 查閱日誌: 檢查代理資料夾內 
    logs
    目錄下的執行日誌，確認無錯誤。

💡 注意事項

  • 必須在防火牆中允許向 GIIP 伺服器地址 (API 端點) 的出站 443 (HTTPS) 端口存取。

🔧 疑難排解

症狀原因解決方法
執行 
giipAgent3.bat
時 PowerShell 指令碼被封鎖		PowerShell 執行原則 (ExecutionPolicy) 設定為 Restricted在管理員 PowerShell 中放寬執行原則，或以管理員身分執行 CMD
伺服器在控制台 [伺服器列表] 中未變為 
Online
giipAgent.cfg
中的 CSN/AK/SK 仍為範例值 (placeholder)		開啟 
giipAgent.cfg
，填寫真實的 CSN/AK/SK 值後重新執行
執行時出現存取被拒 (Access denied) 錯誤未以管理員身分執行 PowerShell/CMD以管理員身分重新執行 PowerShell 或 CMD
logs
目錄的日誌中出現通信錯誤		防火牆封鎖了出站 443 (HTTPS) 連接埠允許向 GIIP 伺服器地址的出站 443 連接埠

版本: 1.0 最後更新: 2026-03-19 源文件: 

giipv3/public/help/agent-setup-win.zh-TW.md

← Previous
AI URL測試代理
Next →
Windows 智能體安裝 (Antigravity 模式)