Linux 에이전트 설치 가이드

Linux 계열 서버에 GIIP 에이전트를 설치하여 관리를 시작하는 방법을 안내합니다.

📋 개요

GIIP Linux 에이전트는 가볍고 강력한 바이너리 형태로 제공되며, Ubuntu, CentOS, Debian, RHEL 등 주요 배포판을 모두 지원합니다. 한 줄의 명령어로 설치와 서비스 등록이 완료됩니다.

🛠️ 설치 전 준비 사항

운영체제: 64-bit Linux (Kernel 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 웹 콘솔의 [서버 목록]에서 해당 서버의 호스트명과 IP가 나타나며

Online

상태인지 확인합니다.

🛠️ 수동 설정 변경

인증 키가 변경되었거나 프록시 설정을 추가해야 하는 경우, 다음 경로의 설정 파일을 수정하세요.

파일 경로:
```
/opt/giip-agent/config.yaml
```
수정 후 서비스 재시작:
```
sudo systemctl restart giip-agent
```

💡 유의 사항

외부 통신을 위해 443번 포트(HTTPS)가 개방되어 있어야 합니다.
```
wget
```
또는
```
curl
```
이 설치되어 있어야 합니다.

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일:

giipv3/public/help/agent-setup-linux.ko.md