giip

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

← Previous
Windows 에이전트 설치 (Gemini 모드)
Next →
Linux 에이전트 설치 (Claude 모드)