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