william0wang/jumpserver

Jumpserver all in one Docker镜像文档

镜像概述和主要用途

该镜像为Jumpserver项目的all in one Docker镜像构建代码，旨在提供一种快速部署Jumpserver的方式。注意：此镜像不建议在生产环境中使用，主要用于测试或开发场景。

不建议生产环境使用的原因

• 数据库集成在Docker容器内，建议通过环境变量配置外部数据库
• 几乎丧失横向扩展能力
• 无高可用（HA）解决方案
• 可能存在未知问题

核心功能和特性

• 集成Jumpserver所需的所有组件，简化部署流程
• 支持通过环境变量配置外部数据库和Redis
• 提供基本的数据持久化卷配置

使用场景和适用范围

• 开发环境快速搭建Jumpserver
• 测试环境验证Jumpserver功能
• 非生产环境的临时部署需求

使用方法和配置说明

基本启动步骤

1. 生成随机加密密钥

Linux/macOS系统：

bash
# 生成SECRET_KEY（勿外泄）
if [ "$SECRET_KEY" = "" ]; then SECRET_KEY=`cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 50`; echo "SECRET_KEY=$SECRET_KEY" >> ~/.bashrc; echo $SECRET_KEY; else echo $SECRET_KEY; fi

# 生成BOOTSTRAP_TOKEN（勿外泄）
if [ "$BOOTSTRAP_TOKEN" = "" ]; then BOOTSTRAP_TOKEN=`cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 16`; echo "BOOTSTRAP_TOKEN=$BOOTSTRAP_TOKEN" >> ~/.bashrc; echo $BOOTSTRAP_TOKEN; else echo $BOOTSTRAP_TOKEN; fi

macOS系统特殊说明： 若上述命令生成密钥失败，可使用以下命令：

bash
# 生成SECRET_KEY
if [ "$SECRET_KEY" = "" ]; then SECRET_KEY=`LC_CTYPE=C tr -dc A-Za-z0-9 < /dev/urandom | head -c 50`; echo "SECRET_KEY=$SECRET_KEY" >> ~/.bash_profile; echo $SECRET_KEY; else echo $SECRET_KEY; fi

# 生成BOOTSTRAP_TOKEN
if [ "$BOOTSTRAP_TOKEN" = "" ]; then BOOTSTRAP_TOKEN=`LC_CTYPE=C tr -dc A-Za-z0-9 < /dev/urandom | head -c 16`; echo "BOOTSTRAP_TOKEN=$BOOTSTRAP_TOKEN" >> ~/.bash_profile; echo $BOOTSTRAP_TOKEN; else echo $BOOTSTRAP_TOKEN; fi

2. 启动容器（默认配置）

bash
docker run --name jms_all -d -p 80:80 -p 2222:2222 -e SECRET_KEY=$SECRET_KEY -e BOOTSTRAP_TOKEN=$BOOTSTRAP_TOKEN jumpserver/jms_all:1.4.8

使用外置数据库和Redis

环境变量配置说明

数据卷配置

• /opt/jumpserver/data: Jumpserver数据持久化目录
• /var/lib/mysql: MySQL数据目录（仅内置数据库时使用）

启动命令示例（使用外置数据库和Redis）

bash
docker run --name jms_all -d \
  -v /opt/jumpserver/data:/opt/jumpserver/data \
  -p 80:80 \
  -p 2222:2222 \
  -e SECRET_KEY=xxxxxx \
  -e BOOTSTRAP_TOKEN=xxxxxx \
  -e DB_HOST=192.168.x.x \
  -e DB_PORT=3306 \
  -e DB_USER=root \
  -e DB_PASSWORD=xxx \
  -e DB_NAME=jumpserver \
  -e REDIS_HOST=192.168.x.x \
  -e REDIS_PORT=6379 \
  -e REDIS_PASSWORD=password \
  jumpserver/jms_all:2.1.0

注意事项

• 环境迁移和更新升级时，必须确保SECRET_KEY与之前设置一致，否则数据库中所有加密字段将无法解密
• 生产环境建议使用独立部署的数据库和Redis，而非容器内置组件
• 端口映射可根据实际需求调整，默认80端口为Web访问端口，2222端口为SSH访问端口