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이 설치되어 있어야 합니다.

🔧 문제 해결

증상	원인	해결
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.ko.md