wojiushixiaobai/jms_koko

JumpServer 堡垒机 Docker 镜像

镜像概述

JumpServer 是一款开源堡垒机，专为多云环境设计，提供服务器访问控制、操作审计、权限管理等核心功能。本 Docker 镜像封装了 JumpServer 及其依赖组件，支持快速部署和灵活配置，适用于企业 IT 基础设施的安全管控。

核心功能与特性

• 集中式访问控制：统一管理服务器账号，支持细粒度权限分配
• 全面操作审计：记录用户所有操作行为，支持录像回放和日志导出
• 多协议支持：兼容 SSH、RDP、Telnet、VNC 等多种远程访问协议
• 多云环境适配：支持私有云、公有云和混合云环境部署
• Docker 化部署：简化安装流程，便于版本管理和升级
• 高扩展性：支持集成 LDAP、Radius 等身份认证系统

使用场景与适用范围

• 企业 IT 基础设施服务器管理
• 多云环境下的服务器集中管控
• 运维操作审计与合规性检查
• 远程服务器安全访问控制
• 开发/测试环境资源隔离与权限管理

环境要求

• MariaDB Server ≥ 10.6
• Redis Server ≥ 6.0

使用方法

快速部署（测试环境）

适用于测试环境，内置数据库和 Redis，不建议生产环境使用：

sh
# 克隆仓库
git clone --depth=1 https://github.com/wojiushixiaobai/docker-jumpserver.git
cd Dockerfile

# 复制配置文件
cp config_example.conf .env

# 启动依赖服务并初始化数据库
docker-compose -f docker-compose-network.yml -f docker-compose-redis.yml -f docker-compose-mariadb.yml -f docker-compose-init-db.yml up -d

# 升级数据库
docker exec -i jms_core bash -c './jms upgrade_db'

# 启动 JumpServer 服务
docker-compose -f docker-compose-network.yml -f docker-compose-redis.yml -f docker-compose-mariadb.yml -f docker-compose.yml up -d

标准部署（生产环境）

生产环境推荐使用外置数据库和 Redis，按以下步骤部署：

1. 部署数据库和 Redis

创建 MySQL 数据库：

sh
mysql -u root -p

mysql
# 创建数据库和用户（替换密码为自定义安全密码）
create database jumpserver default charset 'utf8';
create user 'jumpserver'@'%' identified by 'nu4x599Wq7u0Bn8EABh3J91G';
grant all on jumpserver.* to 'jumpserver'@'%';
flush privileges;

部署 Redis：按官方文档部署 Redis 服务（≥6.0版本）

2. 配置并启动 JumpServer

sh
# 克隆仓库
git clone --depth=1 https://github.com/wojiushixiaobai/docker-jumpserver.git
cd Dockerfile

# 复制并编辑配置文件
cp config_example.conf .env
vi .env

配置文件关键参数说明：

vim
# 版本号（可根据项目版本修改）
VERSION=v3.10.2

# 架构（支持 amd64/arm64/ppc64le/s390x）
TARGETARCH=amd64

# 项目名称
COMPOSE_PROJECT_NAME=jms

# 持久化存储路径
VOLUME_DIR=/opt/jumpserver

# 数据库配置（替换为外置数据库信息）
DB_HOST=mysql
DB_PORT=3306
DB_USER=jumpserver
DB_PASSWORD=nu4x599Wq7u0Bn8EABh3J91G  # 替换为实际密码
DB_NAME=jumpserver

# Redis 配置（替换为外置 Redis 信息）
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=8URXPL2x3HZMi7xoGTdk3Upj  # 替换为实际密码

# 安全配置（首次安装必须修改）
SECRET_KEY=B3f2w8P2PfxIAS7s4URrD9YmSbtqX4vXdPUL217kL9XPUOWrmy  # 生成随机字符串
BOOTSTRAP_TOKEN=7Q11Vz6R2J6BLAdO  # 生成随机字符串
DEBUG=FALSE
LOG_LEVEL=ERROR

# 端口配置
HTTP_PORT=80        # Web 访问端口
SSH_PORT=2222       # SSH 访问端口
RDP_PORT=3389       # RDP 访问端口

注意：SECRET_KEY 用于保护签名数据，首次安装必须修改并牢记，后续不可更改；BOOTSTRAP_TOKEN 用于组件认证，建议随机生成。

启动服务：

sh
# 初始化数据库
docker-compose -f docker-compose-network.yml -f docker-compose-init-db.yml up -d
docker exec -i jms_core bash -c './jms upgrade_db'

# 启动 JumpServer
docker-compose -f docker-compose-network.yml -f docker-compose.yml up -d

手动构建镜像

如需自定义构建镜像，执行以下命令：

sh
cd Dockerfile
cp config_example.conf .env
vi .env  # 配置 TARGETARCH 等构建参数

# 构建镜像
docker-compose -f docker-compose-build.yml up

配置参数说明