njqaaa/jumpserver

Jumpserver Docker镜像文档

镜像概述和主要用途

Jumpserver是一款开源堡垒机，提供服务器集中管理、细粒度权限控制、会话记录与审计等功能。本Docker镜像基于Jumpserver源码构建，支持通过Docker Swarm和overlay网络快速部署，集成MySQL数据库、Redis缓存及coco（SSH终端）、luna（Web界面）组件，适用于企业级服务器管理场景。

核心功能和特性

• 集中化管理：统一管理多台服务器资源，支持批量操作
• 权限控制：细粒度用户权限分配，实现最小权限原则
• 会话审计：记录并审计所有操作会话，满足合规要求
• Docker化部署：基于Docker容器化部署，简化环境配置
• 组件集成：包含coco（SSH访问）和luna（Web界面）核心组件
• 灵活配置：通过环境变量自定义系统参数，适应不同场景需求

使用场景和适用范围

• 企业级服务器集群管理与运维
• 多用户环境下的权限隔离与控制
• 运维操作审计与安全合规管理
• 需要快速部署堡垒机的中小规模企业
• 开发测试环境的服务器访问控制

详细使用方法和配置说明

环境准备

所有操作需在宿主机执行，需预先安装Docker和Docker Compose。

初始化Docker Swarm

bash
docker swarm init

创建Overlay网络

创建用于容器通信的overlay网络，支持容器名解析为IP：

bash
docker network create -d overlay --attachable jumpserver --subnet=192.168.100.0/24

环境变量配置

设置必要的环境变量（根据实际情况修改）：

bash
export DB_HOST=jumpserver-mysql
export DB_USER=root
export DB_PASSWORD=mypassword
export DB_PORT=3306
export DB_NAME=jumpserver_db
export REDIS_HOST=jumpserver-redis
export SITE_URL=http://jumpserver.xxx.com
export EMAIL_PORT=587
export EMAIL_HOST=smtp.xxx.com
export EMAIL_HOST_USER=jumpserver@xxx.com
export EMAIL_HOST_PASSWORD=
export JUMPSERVER_ENDPOINT=http://myjumpserver.com

部署依赖服务

启动MySQL数据库

bash
docker run -d --restart=always --name $DB_HOST -e MYSQL_ROOT_PASSWORD=$DB_PASSWORD --network jumpserver mysql:5.7

创建数据库

等待MySQL启动完成（约10秒）后执行：

bash
docker exec -it $DB_HOST mysql -u$DB_USER -p$DB_PASSWORD -e 'CREATE DATABASE '$DB_NAME' DEFAULT CHARACTER SET utf8 ';

启动Redis缓存

bash
docker run -d --restart=always --name $REDIS_HOST --network jumpserver redis

配置环境变量文件

创建环境变量配置文件：

bash
echo -e "DB_HOST=$DB_HOST\nDB_USER=$DB_USER\nDB_PASSWORD=$DB_PASSWORD\nDB_NAME=$DB_NAME\nREDIS_HOST=$REDIS_HOST\nSITE_URL=$SITE_URL\nEMAIL_PORT=$EMAIL_PORT\nEMAIL_HOST=$EMAIL_HOST\nEMAIL_HOST_USER=$EMAIL_HOST_USER\nEMAIL_HOST_PASSWORD=$EMAIL_HOST_PASSWORD" > /tmp/envinfo

配置文件内容示例：

DB_HOST=jumpserver-mysql
DB_USER=root
DB_PASSWORD=mypassword
DB_NAME=jumpserver_db
REDIS_HOST=jumpserver-redis
SITE_URL=http://jumpserver.xxx.com
EMAIL_PORT=587
EMAIL_HOST=smtp.xxx.com
EMAIL_HOST_USER=jumpserver@xxx.com
EMAIL_HOST_PASSWORD=

环境变量参数说明

部署Jumpserver服务

启动Jumpserver主服务，映射到宿主机80端口：

bash
docker run -d --restart=always --name jumpserver -p 80:80 --env-file=/tmp/envinfo -v /var/log/jumpserver:/root/jumpserver/logs --network jumpserver njqaaa/jumpserver

初始化数据库

执行数据库初始化脚本：

bash
docker exec -it jumpserver bash /root/jumpserver/init_db.sh

验证服务状态

验证服务是否正常启动：

bash
docker exec -it jumpserver curl -i 127.0.0.1

部署组件服务

部署coco组件（SSH终端服务）

bash
docker run -d --restart=always -e 'JUMPSERVER_ENDPOINT='$JUMPSERVER_ENDPOINT'' --name coco -p 2222:2222 --network jumpserver njqaaa/coco

部署luna组件（Web界面服务）

bash
docker run -d --restart=always -e 'JUMPSERVER_ENDPOINT='$JUMPSERVER_ENDPOINT'' --name luna -p 5000:5000 --network jumpserver njqaaa/luna

访问与登录

默认管理员账号密码：

• 用户名：admin
• 密码：admin

通过SITE_URL配置的地址访问Web界面，或通过2222端口使用SSH客户端连接coco服务。

源码信息

• 源码地址：https://github.com/jumpserver/jumpserver
• 分支：dev
• 提交SHA1：***