Linux 代理安装指南

引导您如何在 Linux 系服务器上安装 GIIP 代理 (Agent) 并开始管理。

📋 概述

GIIP Linux 代理以轻量且强大的二进制格式提供，支持 Ubuntu、CentOS、Debian、RHEL 等所有主流发行版。仅需一行命令即可完成安装与服务注册。

🛠️ 安装前准备

操作系统: 64 bit Linux (建议内核版本 3.10 或更高)
权限: 需要 sudo 或 root 权限
认证信息: 请提前从 GIIP 控制台的 [个人资料] 菜单中获取并准备好
```
CSN
```
、
```
Access Key (AK)
```
和
```
Secret Key (SK)
```
。

🚀 安装步骤

1. 运行安装脚本

打开终端并运行以下命令（请使用从 GIIP 控制台复制的唯一安装地址）：

wget -O install_giip.sh https://api.giip.io/download/agent/linux/install.sh
chmod +x install_giip.sh
sudo ./install_giip.sh --csn=[CSN] --ak=[AK] --sk=[SK]

2. 确认安装选项

自启动: 安装脚本会将代理自动注册为
```
systemd
```
服务。
路径: 默认安装路径为
```
/opt/giip-agent
```
。

🔍 验证运行状态

1. 检查服务状态

通过以下命令确认代理是否正常运行：

systemctl status giip-agent

若状态显示为

active (running)

，则表示运行正常。

2. 控制台确认

Online

(在线)。

🛠️ 手动修改配置

若认证密钥发生变更或需要添加代理设置，请修改以下路径的配置文件：

文件路径:
```
/opt/giip-agent/config.yaml
```
修改后重启服务:
```
sudo systemctl restart giip-agent
```

💡 注意事项

必须开放 443 端口 (HTTPS) 以进行外部通信。
必须安装有
```
wget
```
或
```
curl
```
。

🔧 故障排除

症状	原因	解决方法
`systemctl status giip-agent` 未显示 `active (running)`	`config.yaml` 中的认证信息(CSN/AK/SK)填写错误	检查并修正 `/opt/giip-agent/config.yaml` ，然后运行 `sudo systemctl restart giip-agent`
运行安装脚本时出现 `command not found` 错误	未安装 `wget` 或 `curl`	先通过发行版的包管理器安装 `wget` 或 `curl`
安装过程中出现 `Permission denied`	未使用 sudo 或 root 权限运行	以 `sudo ./install_giip.sh ...` 形式用管理员权限重新运行
控制台 [服务器列表] 中服务器未显示为 `Online`	出站 443 (HTTPS) 端口被阻止	在防火墙中开放 443 端口并运行 `sudo systemctl restart giip-agent` 重启

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

giipv3/public/help/agent-setup-linux.zh-CN.md