jumpserver/jms_koko

Jumpserver Docker Compose 部署文档

镜像概述

Jumpserver Docker Compose 部署方案提供了一种便捷的方式来搭建Jumpserver堡垒机环境。通过Docker Compose编排容器，实现快速部署、配置灵活的堡垒机服务，适用于需要集中管理服务器访问权限的场景。

核心功能与特性

• 便捷部署：基于Docker Compose实现一键部署，简化环境配置流程
• 灵活配置：通过.env文件自定义环境变量，适配不同部署需求
• 部署模式：支持基础部署（使用预构建镜像）和本地构建（自定义镜像）两种模式
• 服务扩展：可配置外置MySQL数据库和Redis服务，满足生产环境需求

使用场景

• 企业服务器集群的访问权限管理
• 开发/测试环境的堡垒机快速搭建
• 需要集中审计服务器操作日志的场景
• 对部署灵活性有较高要求的堡垒机应用场景

使用方法

基础部署步骤

1. 克隆仓库

   sh
   git clone https://github.com/jumpserver/Dockerfile.git
   cd Dockerfile
   

2. 查看环境变量配置

   sh
   cat .env
   

   可根据需求编辑.env文件修改配置参数

3. 启动服务

   sh
   docker-compose up
   

本地构建镜像

若需自定义镜像，可使用构建专用的Compose文件：

sh
cd Dockerfile
cat .env  # 确认环境变量配置
docker-compose -f docker-compose-build.yml up

编译时如需指定版本，可在docker-compose的environment部分添加Version: $Version，以覆盖Dockerfile中的ARG参数

配置外置数据库和Redis

1. 准备MySQL数据库

登录MySQL服务器执行以下SQL：

mysql
create database jumpserver default charset 'utf8' collate 'utf8_bin';
grant all on jumpserver.* to 'jumpserver'@'%' identified by 'weakPassword';

建议将'weakPassword'替换为强密码

2. 配置环境变量

sh
cd Dockerfile
vi .env  # 编辑文件，设置外置MySQL和Redis的连接信息

3. 启动服务

使用外置服务专用的Compose文件：

sh
docker-compose -f docker-compose-external.yml up

注意事项

• .env文件中的变量将直接应用于Docker Compose配置，请在部署前仔细检查
• 生产环境中建议使用外置数据库和Redis，并确保网络安全
• 首次部署可能存在未检测到的问题，建议先在测试环境调试通过后再用于生产环境