gikoluo/jumpserver

Jumpserver Docker镜像文档

镜像概述

Jumpserver Docker镜像基于Docker Compose实现开源堡垒机Jumpserver的快速部署，简化传统部署流程，提供灵活的配置选项，支持内置或外置数据库与Redis，适用于企业级服务器管理、运维审计和权限控制场景。

核心功能与特性

• 快速部署：通过Docker Compose一键启动，无需复杂环境配置
• 自定义配置：通过.env文件管理环境变量，灵活调整部署参数
• 构建支持：提供自定义构建镜像的配置文件，满足个性化需求
• 外置服务兼容：支持对接外部MySQL数据库和Redis，提升数据安全性与可扩展性

使用场景与适用范围

• 企业服务器集群的集中管理与权限控制
• 运维操作审计与日志记录
• 多环境（开发、测试、生产）堡垒机快速部署
• 需要简化堡垒机部署流程的场景

使用方法与配置说明

基础部署流程

1. 克隆仓库并进入目录：

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

2. 查看环境变量配置（可选修改）：

   sh
   cat .env  # 查看默认环境变量，可根据需求调整
   

3. 启动服务：

   sh
   docker-compose up
   

自定义构建镜像

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

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';  # 建议使用强密码

2. 配置环境变量

修改.env文件，设置外置MySQL和Redis连接信息：

sh
cd Dockerfile
vi .env  # 编辑文件，配置MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASSWORD、REDIS_HOST、REDIS_PORT等参数

3. 使用外置服务启动

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

注意事项

• .env文件中的变量将应用于docker-compose配置，部署前建议仔细检查并调整参数
• 首次部署可能存在未检测到的问题，建议先进行本地调试再正式使用
• 外置数据库时需确保网络通畅且数据库用户权限配置正确