Jumpserver 설치 및 기초 설정 가이드 (도커 기반)

도커를 활용한 Jumpserver 빠른 설치

본 가이드는 초보자 대상으로, 도커 기반의 간편한 방식으로 Jumpserver를 설치하고 초기 설정하는 절차를 단계별로 설명합니다. 모든 과정은 명령어 중심이며, 주요 리눅스 배포판(예: Ubuntu 20.04, CentOS 7+)에서 동작합니다.

사전 준비 사항

  • 공인 IP가 있는 리눅스 서버 (최소 2코어, 4GB RAM 이상 권장)
  • 포트 열기: 80, 443, 2222
  • dockerdocker-compose 설치 완료

1. 시스템 업데이트 및 환경 준비

sudo apt update && sudo apt upgrade -y
sudo apt install curl docker.io docker-compose -y
sudo usermod -aG docker $USER

2. Jumpserver 설치 스크립트 다운로드 및 실행

curl -L https://github.com/jumpserver/jumpserver/releases/latest/download/jumpserver-installer.sh -o jumpserver-installer.sh
chmod +x jumpserver-installer.sh
./jumpserver-installer.sh

설치 프로세스 중에 필요한 설정값(예: 관리자 계정, 데이터베이스 비밀번호)을 입력하면 자동으로 컨테이너가 생성됩니다.

3. 초기 설정 및 데이터베이스 초기화

설치 후 아래 명령어로 초기 관리자 계정을 생성합니다:

docker exec -it jumpserver_core /bin/bash
python manage.py createsuperuser

4. 웹 인터페이스 접근 및 첫 로그인

브라우저에서 다음 주소로 접속:

https://<서버_IP>

이전에 생성한 관리자 계정으로 로그인하고, 다음 작업을 수행합니다:

  • 새로운 사용자 계정 추가
  • 서버 자산(예: 테스트용 가상 머신) 등록
  • 접근 권한 정책 설정
  • 웹 터미널을 통한 원격 접속 테스트

5. 주요 문제 해결 팁

  • 포트 충돌 발생 시: netstat -tulpn | grep :80로 포트 점유 확인 후 서비스 종료
  • SSL 인증서 오류: 공인 인증서를 적용하거나 self-signed 옵션 활성화
  • SSH 연결 실패: 서버의 sshd_config에서 PermitRootLogin yesPasswordAuthentication yes 확인

6. 확장 구성 제안

기본 기능 익숙해진 후 고급 설정을 시도해 보세요:

  • LDAP/AD 연동을 통한 사용자 동기화
  • 2단계 인증(구글 앱, TOTP) 설정
  • 고가용성 아키텍처 구성 (복제된 컨테이너 + 로드 밸런서)
  • 커스텀 브랜딩 및 로그인 페이지 수정

Jumpserver는 오픈소스 기반의 강력한 서버 접근 관리 시스템으로, 조직 내 보안 감사와 권한 제어를 효율적으로 지원합니다. 초보자도 쉽게 시작할 수 있도록, 공식 문서와 커뮤니티 자료를 적극 활용하세요.

태그: Jumpserver docker SSH 보안 접근 제어 오픈소스 보안

6월 2일 20:58에 게시됨