서버가온 도움말

화면 모드

에이전트 설치 ​

서버를 서버가온에 연결하려면 그 서버에 에이전트를 설치합니다. 에이전트는 서버에서 콘솔로 연결을 시작하므로(발신형) 서버에 별도 포트를 열 필요가 없습니다.

최고관리자만 설치 명령을 발급할 수 있습니다

설치 명령과 설치 파일에는 서버 연결 권한이 들어 있습니다. 다른 사람에게 공유하거나 공개된 곳에 붙여 넣지 마세요.

지원 운영체제 ​

운영체제지원 범위
Linux 최신 (x64·ARM64, 권장 Ubuntu 22.04+ / Debian 12+)모니터링, 사이트 탐지·점검 전환, 웹 터미널, 파일 탐색
Linux 구형 호환 (x86 등)CPU·메모리·디스크·네트워크·연결 수 모니터링
Windows 10 1809 이상 / Server 2019 이상모니터링, IIS·Nginx·Apache 사이트 탐지, 웹 터미널, 파일 탐색
그 이전 Windows모니터링·사이트 탐지만(웹 터미널·탐색기 없음)
macOS 14 이상 (Intel·Apple Silicon)모니터링(디스크 I/O·GPU 제외), 사이트 탐지(조회 전용), 웹 터미널, 파일 탐색

설치 창에서 운영체제를 고르면 그 항목에서 쓸 수 있는 기능이 ✓/✕로 보입니다. glibc 2.27 미만의 아주 오래된 Linux는 문의 안내만 나옵니다.

한 줄 명령으로 설치하기 ​

  1. 서버 관리에서 서버 추가로 서버를 등록합니다. 이름과 IP·도메인만 넣으면 됩니다. 자세한 내용은 서버 관리를 보세요.
  2. 서버 카드나 서버 개요에서 에이전트 다운로드·설치를 엽니다.
  3. 운영체제를 고르고 한 줄 설치 명령 발급을 누른 뒤 명령 복사를 누릅니다.
  4. 대상 서버에서 명령을 실행합니다.
    • Linux·macOS: 터미널에서 실행합니다. sudo 권한이 필요합니다.
    • Windows: 관리자 권한 PowerShell에서 실행합니다.
  5. 잠시 뒤 서버 개요에서 상태가 연결됨으로 바뀌면 끝입니다.

Linux 명령은 다음과 같은 모양입니다. 실제 값은 화면에서 복사하세요.

bash
curl -fsSL https://get.servergaon.io/agent.sh | sudo bash -s -- --server <콘솔 주소> --token <토큰> --platform <플랫폼>

설치형 서버는 명령이 다르게 나올 수 있습니다

위 형식은 일반형·전용 클라우드형 기준입니다. 설치형 콘솔에서는 get.servergaon.io를 거치지 않고, 회사 콘솔 도메인에서 설치 스크립트를 직접 받는 명령이 나옵니다. 화면에 나온 명령을 그대로 복사해 쓰세요. 이때 대상 서버는 회사 콘솔 주소로 HTTPS 연결이 되어야 합니다.

설치 명령은 15분 동안 한 번만 쓸 수 있습니다

시간이 지났거나 설치에 실패했으면 명령을 다시 발급하세요. 같은 서버에 다시 발급하면 이전 명령은 쓸 수 없게 됩니다.

콘솔 계정 정하기 (선택) ​

설치 창의 **콘솔 계정 (선택)**에 웹 터미널·파일 탐색을 실행할 기존 계정을 넣을 수 있습니다. 비워 두면 다음 계정을 씁니다.

환경기본 계정
Linuxsudo를 실행한 계정
Docker전용 계정 servergaon-console
Windows전용 일반 계정 ServerGaonConsole

보안을 위해 관리자 계정(root·Administrators 그룹)은 콘솔 계정으로 쓸 수 없습니다. 지정한 계정이 없거나 관리자 계정이면 설치 중 경고가 나오고 모니터링만 설치되며, 서버 콘솔 카드에 이유가 표시됩니다.

설치 파일로 설치하기 ​

인터넷 명령을 쓸 수 없는 환경이면 설치 창에서 ZIP을 내려받아 설치합니다.

  • Windows: 압축을 풀고 관리자 PowerShell에서 powershell -ExecutionPolicy Bypass -File .\install.ps1
  • Linux: 압축을 풀고 sudo bash install.sh

운영체제 패키지(Windows MSI, Linux deb·rpm·tar.gz)로 관리하고 싶다면 공용 설치본을 먼저 설치한 뒤, 콘솔에서 받은 설치 파일을 연결 파일로 지정합니다.

  • Windows: 시작 메뉴 ServerGaon Agent - Connect
  • Linux: sudo servergaon-agent connect <파일>

macOS 추가 설정 ​

데스크탑·문서 폴더를 파일 탐색기로 보려면 설치가 끝날 때 안내되는 대로 시스템 설정 → 개인정보 보호 및 보안 → 전체 디스크 접근 권한에서 에이전트를 허용합니다.

에이전트 업데이트와 제거 ​

  • 에이전트가 오래되어 새 기능을 지원하지 않으면 화면에 업데이트 안내가 나옵니다. 서버 관리에서 에이전트를 업데이트하세요.
  • 서버를 제거할 때 에이전트도 함께 제거가 기본으로 선택됩니다. 자동 제거를 할 수 없으면 제거 창에 운영체제별 수동 제거 명령이 나옵니다.
  • 패키지로 설치했다면 Windows는 앱 및 기능, Linux는 apt remove·dnf remove로 제거합니다.

에이전트를 제거해도 직접 지정한 기존 콘솔 계정은 지우지 않습니다.

도움말 내용은 서비스 업데이트에 따라 바뀔 수 있습니다.

© ServerGaon