qq58945591/jumpserver

JumpServer Docker镜像文档

镜像概述

JumpServer是一款开源跳板机项目，本Docker镜像为简化部署而构建，集成了jumpserver、coco、luna组件及nginx服务，并使用supervisor进行进程守护管理。由于supervisor不支持Python3，镜像中同时包含Python2和Python3环境。

项目地址：https://github.com/jumpserver/jumpserver

核心功能与特性

• 集成jumpserver核心服务、coco（SSH终端）、luna（Web终端）及nginx反向代理
• 使用supervisor实现多进程管理与守护
• 支持通过环境变量灵活配置数据库连接信息
• 需外部提供数据库（MySQL）和队列服务

使用场景

适用于需要快速部署JumpServer跳板机的场景，如企业服务器运维管理、多用户权限控制、操作审计等场景。

使用方法

1. 准备数据库

启动MariaDB容器，设置超级管理员密码（替换xxx为实际密码）：

bash
docker run -d --name mariadb -v /opt/mysql:/var/lib/mysql -e MYSQL_ROOT_PASSWORD='xxx' mariadb

2. 登录数据库控制台

bash
docker run -it --rm --link mariadb:mysql-server mariadb '/bin/sh'
mysql -uroot -p -h mysql-server

3. 创建数据库并授权

在数据库控制台执行以下命令（替换xxx为实际用户密码）：

sql
create database jumpserver default charset 'utf8';
grant all on jumpserver.* to 'jumpserver'@'%' identified by 'xxx';
flush privileges;
quit

执行完成后退出容器：

bash
exit

4. 生成数据库表结构和初始化数据

bash
docker run --rm -it --link mariadb:mysql-server -e DB_USER='jumpserver' -e DB_PASSWORD='xxx' qq58945591/jumpserver 'init_db'

5. 停止并移除临时数据库容器

bash
docker stop mariadb
docker rm mariadb

6. 配置docker-compose文件

创建jms.yaml文件，修改数据库连接信息及挂载路径（仅修改冒号前的本地路径）：

yaml
version:  "2"
services:
  jumpserver:
    image:  qq58945591/jumpserver
    ports:
      - "127.0.0.1:80:80"
      - "127.0.0.1:8080:8080"
      - "2222:2222"
    volumes:
      - /opt/jumpserver/logs:/opt/jumpserver/logs  # 本地日志路径
      - /opt/coco/logs:/opt/coco/logs              # coco日志路径
    user: root
    restart:  always
    environment:
        DB_ENGINE: "mysql"
        DB_HOST: "mysql-server"
        DB_PORT: "3306"
        DB_USER: "jumpserver"       # 替换为实际数据库用户
        DB_PASSWORD: "xxx"          # 替换为实际数据库密码
        DB_NAME: "jumpserver"
    container_name: "jumpserver"
    hostname: jms.example.com
    links:
      - mariadb:mysql-server
      - redis:redis-server
    depends_on:
      - mariadb
      - redis

  redis:
    image:  redis
    container_name: "redis"
    user: root
    restart:  always
    ulimits:
      mem_limit: 512m

  mariadb:
    image:  mariadb
    ports:
      - "127.0.0.1:3306:3306"
    container_name: "mariadb"
    volumes:
        - "/opt/mysql:/var/lib/mysql"  # 本地数据库数据路径
    user: root
    restart:  always
    environment:
        MYSQL_ROOT_PASSWORD: "xxx"    # 替换为实际MySQL root密码
    command:
        - "--character-set-server=utf8mb4"
        - "--collation-server=utf8mb4_unicode_ci"

7. 使用docker-compose启动服务

bash
docker-compose -f jms.yaml up -d

环境变量配置

支持通过环境变量（docker run -e或docker-compose的environment）配置以下参数：