Docker를 이용한 JumpServer 4.7.0 배포 안내

1. 환경 요구사항

JumpServer의 올인원 Docker 이미지인 jms_all은 다음 외부 서비스들을 필요로 합니다. 이들은 JumpServer와 함께 실행될 컨테이너들입니다.

  • MariaDB: 버전 10.6 이상
  • Redis: 버전 6.2 이상

본 가이드에서는 JumpServer v4.7.0 버전 배포를 기준으로 진행합니다.

2. 필요한 Docker 이미지 다운로드

아래 명령어를 사용하여 JumpServer, Redis, MariaDB 이미지를 다운로드합니다.

docker pull jumpserver/jms_all:v4.7.0
docker pull redis:7
docker pull mariadb:11

3. 데이터 영속성을 위한 디렉토리 구조 생성

JumpServer 및 관련 서비스의 데이터가 컨테이너 재시작 시에도 유지되도록 호스트 시스템에 영구 저장 디렉토리를 생성합니다. 여기서는 /srv/jumpserver 경로를 기준으로 설정합니다.

mkdir -p /srv/jumpserver
mkdir -p /srv/jumpserver/mariadb_data
mkdir -p /srv/jumpserver/redis_config
mkdir -p /srv/jumpserver/redis_data
mkdir -p /srv/jumpserver/app_data/core
mkdir -p /srv/jumpserver/app_data/koko
mkdir -p /srv/jumpserver/app_data/lion
mkdir -p /srv/jumpserver/app_data/kael
mkdir -p /srv/jumpserver/app_data/chen
mkdir -p /srv/jumpserver/app_data/web_log

4. Redis 컨테이너 설정 및 실행

먼저 Redis 설정 파일을 생성하고, 이를 마운트하여 Redis 컨테이너를 실행합니다. 비밀번호를 설정하여 보안을 강화합니다.

echo "bind 0.0.0.0" > /srv/jumpserver/redis_config/redis.conf
echo "maxmemory-policy allkeys-lru" >> /srv/jumpserver/redis_config/redis.conf
echo "requirepass mySecureRedisPassword" >> /srv/jumpserver/redis_config/redis.conf
docker run -d \
 --name jms_redis_cache \
 --restart=always \
 -p 6379:6379 \
 -v /srv/jumpserver/redis_config/redis.conf:/etc/redis/redis.conf \
 -v /srv/jumpserver/redis_data:/data \
 redis:7 \
 redis-server /etc/redis/redis.conf

5. MariaDB 컨테이너 실행 및 데이터베이스 초기화

MariaDB 컨테이너를 실행한 후, JumpServer가 사용할 데이터베이스와 사용자 계정을 생성하고 권한을 부여합니다.

docker run -d \
 --name jms_mariadb \
 --restart=always \
 -e MYSQL_ROOT_PASSWORD=myStrongRootPass \
 -p 3306:3306 \
 -v /srv/jumpserver/mariadb_data:/var/lib/mysql \
 mariadb:11

컨테이너가 완전히 시작될 때까지 잠시 기다린 후, 다음 명령어로 MariaDB 컨테이너에 접속하여 데이터베이스를 설정합니다.

docker exec -it jms_mariadb mariadb -uroot -pmyStrongRootPass

MariaDB 셸에서 다음 SQL 명령어를 실행하여 JumpServer용 데이터베이스와 사용자를 생성합니다:

CREATE DATABASE jumpserver_db DEFAULT CHARACTER SET 'utf8mb4';
CREATE USER 'jms_user'@'%' IDENTIFIED BY 'MyJumpServerDBPass';
GRANT ALL ON jumpserver_db.* TO 'jms_user'@'%';
FLUSH PRIVILEGES;
EXIT;

6. JumpServer (jms_all) 컨테이너 실행

이제 JumpServer 올인원 컨테이너를 실행할 차례입니다. 데이터베이스 및 Redis 연결 정보, 그리고 영구 저장 경로를 환경 변수와 볼륨 마운트로 설정합니다.

docker run --name jumpserver_app -d \
 --restart=always \
 -p 80:80 \
 -p 2222:2222 \
 -p 30000-30100:30000-30100 \
 -e SECRET_KEY="YourRandomSecretKeyHere_MustBeLongAndComplex" \
 -e BOOTSTRAP_TOKEN="AnotherRandomBootstrapToken_LongAndUnique" \
 -e LOG_LEVEL=ERROR \
 -e DB_ENGINE=mysql \
 -e DB_HOST=127.0.0.1 \
 -e DB_PORT=3306 \
 -e DB_USER=jms_user \
 -e DB_PASSWORD=MyJumpServerDBPass \
 -e DB_NAME=jumpserver_db \
 -e REDIS_HOST=127.0.0.1 \
 -e REDIS_PORT=6379 \
 -e REDIS_PASSWORD=mySecureRedisPassword \
 --privileged=true \
 -v /srv/jumpserver/app_data/core:/opt/jumpserver/data \
 -v /srv/jumpserver/app_data/koko:/opt/koko/data \
 -v /srv/jumpserver/app_data/lion:/opt/lion/data \
 -v /srv/jumpserver/app_data/kael:/opt/kael/data \
 -v /srv/jumpserver/app_data/chen:/opt/chen/data \
 -v /srv/jumpserver/app_data/web_log:/var/log/nginx \
 jumpserver/jms_all:v4.7.0

중요 환경 변수 설명:

  • SECRET_KEY: 임의의 긴 문자열 (특수 문자 포함 금지, 50자 이상 권장).
  • BOOTSTRAP_TOKEN: 임의의 긴 문자열 (특수 문자 포함 금지, 24자 이상 권장).
  • DB_HOST: MariaDB 컨테이너의 IP 주소 또는 컨테이너 이름. 단일 호스트 배포 시 127.0.0.1을 사용하거나, Docker 네트워크 설정에 따라 컨테이너 이름을 사용할 수 있습니다.
  • DB_PORT, DB_USER, DB_PASSWORD, DB_NAME: 위에서 설정한 MariaDB 정보와 일치해야 합니다.
  • REDIS_HOST: Redis 컨테이너의 IP 주소 또는 컨테이너 이름. 단일 호스트 배포 시 127.0.0.1을 사용합니다.
  • REDIS_PORT, REDIS_PASSWORD: 위에서 설정한 Redis 정보와 일치해야 합니다.
  • 볼륨 마운트: /srv/jumpserver/app_data/... 경로를 호스트의 영구 저장소로 사용합니다.

7. JumpServer 웹 인터페이스 접속

모든 컨테이너가 성공적으로 시작되면, 웹 브라우저를 통해 JumpServer에 접속할 수 있습니다.

접속 주소: http://<JumpServer_서버_IP>:80

초기 로그인 정보:

  • 사용자명: admin
  • 비밀번호: ChangeMe (최초 로그인 후 반드시 변경해야 합니다.)

태그: Jumpserver docker MariaDB Redis linux

10월 31일 05:51에 게시됨