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

← Previous
AI URL测试代理
Next →
Windows 智能体安装 (Antigravity 模式)