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(최초 로그인 후 반드시 변경해야 합니다.)