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. 控制台確認

登錄 GIIP Web 控制台，在 [伺服器列表] 中確認該伺服器的主機名及 IP 已顯示，且狀態為

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