JumpServer 开源 PAM 平台(堡垒机)快速上手与组件架构深度解析
JumpServer 开源 PAM 平台(堡垒机)快速上手与组件架构深度解析
JumpServer 是一个开源的特权访问管理(PAM)平台(常称堡垒机),为 DevOps 与 IT 团队提供通过 Web 浏览器按需、安全访问 SSH、RDP、Kubernetes、数据库和 RemoteApp 端点的能力。本文以 readmes/README.ja.md 的日文版项目说明为骨架,结合当前仓库源码,为你梳理 JumpServer 的核心定位、一条命令完成部署的快速开始流程、背后的多组件协作架构(Web UI、Web 终端、协议连接器等),以及服务启动、配置加载等底层实现,帮助你快速评估、部署并理解这套 PAM 系统。
一、JumpServer 是什么?
原文定位:JumpServer は、DevOps および IT チームに対して、SSH、RDP、Kubernetes、データベースおよび RemoteApp エンドポイントへのオンデマンドで安全なアクセスを提供するオープンソースの特権アクセス管理 (PAM) プラットフォームです。
JumpServer 是一款面向 DevOps 与 IT 团队的开源 PAM(Privileged Access Management)平台。其核心价值在于:运维人员不再需要直接掌握目标资产的账号密码,而是统一通过 JumpServer 发起连接,由平台完成认证、授权、审计与工单审批,从而实现对敏感资产访问的集中管控。
- 多协议接入:原生支持 SSH、RDP、Kubernetes、数据库(MySQL、PostgreSQL、SQL Server、Oracle 等)以及 RemoteApp 远程应用。
- Web 化访问:所有访问入口收敛到浏览器,配合 Web 终端(Luna)与 Web 数据库(Chen)组件,实现"零客户端"运维。
- 全量审计:会话录像、命令记录、操作日志均可追溯,满足合规审计要求。
- 开放架构:以 Django 为核心核心服务(Core),外围由多个独立组件协同完成协议代理与界面呈现。
在仓库中,JumpServer 的核心服务代码位于 apps/ 目录,采用 Django 5.2.15 构建(见 pyproject.toml),并依赖 Celery 5.6.0 处理异步任务、gunicorn 23.0.0 提供 Web 服务。核心常量(版本号、配置加载)定义在 apps/jumpserver/const.py,当前源码标注版本为 2.0.0,而 pyproject.toml 的项目版本为 v4.0,均以仓库实际内容为准。
PAM 平台解决了什么问题?
从源码结构(apps/ 下 20 余个 Django app)可以推断,JumpServer 覆盖了 PAM 平台最典型的几大能力域:
| 能力域 | 对应应用目录 | 典型能力 |
|---|---|---|
| 资产与账号管理 | apps/assets/、apps/accounts/ | 资产纳管、账号凭据、自动改密、账号收集 |
| 权限与策略 | apps/perms/、apps/acls/、apps/rbac/ | 授权规则、命令过滤、登录限制、RBAC |
| 会话与连接 | apps/terminal/、apps/ops/ | 会话生命周期、连接令牌、批量任务 |
| 审计与日志 | apps/audits/ | 登录日志、操作日志、命令记录 |
| 认证与用户 | apps/authentication/、apps/users/ | 本地认证、LDAP/SSO/OTP/MFA、用户生命周期 |
| 工单审批 | apps/tickets/ | 申请-审批流程 |
二、快速开始:一条命令部署 JumpServer
原文给出的快速开始方式非常简洁:
准备一台干净的 Linux 服务器(64 位,建议 >= 4 核 8G),执行:
curl -sSL https://github.com/jumpserver/jumpserver/releases/latest/download/quick_start.sh | bash
部署完成后,在浏览器访问
http://your-jumpserver-ip/:
- 用户名:
admin- 密码:
ChangeMe
快速开始背后的容器化实现
quick_start.sh 脚本本质上是拉取官方发布版本并基于 Docker 编排启动 JumpServer 全组件。当前仓库的 Dockerfile 展示了核心服务的容器化构建方式:
- 两阶段构建:先基于
jumpserver/core-base构建阶段镜像,安装 Python 依赖(uv pip install -r pyproject.toml)、编译国际化消息;再基于python:3.14-slim运行镜像,安装libldap2-dev、postgresql-client、sshpass、docker-cli等运行依赖。 - 默认启动命令:
CMD ["start", "all"],即容器启动即拉起全部服务。 - 暴露端口:
EXPOSE 8080 8088,其中 8080 为 Web 访问端口。 - 入口脚本:entrypoint.sh 作为容器 ENTRYPOINT,处理信号回收(
cleanup函数避免僵尸进程)、清理旧 pid 文件,并最终调用python jms "${action}" "${service}"。
从源码手动启动(源码部署方式)
除容器化部署外,JumpServer 也支持直接基于源码启动,核心入口是仓库根目录下的 jms 脚本。其用法(来自脚本的 argparse 定义,jms):
python jms <action> [service] [-d] [-w N] [-f]
- action:
start/stop/restart/status/upgrade_db/collect_static - service:
all(默认)/web/task/ai - -d / --daemon:后台守护方式运行
- -w / --worker N:指定 worker 数量
- -f / --force:强制模式
典型用法:
python jms start all -d # 后台启动全部服务
python jms start web # 仅启动 Web 服务
python jms status # 查看各服务运行状态
python jms upgrade_db # 升级数据库结构(等价于 migrate)
启动过程中,jms 会依次执行 prepare() 阶段的检查与初始化(jms):
check_database_connection():轮询最多 60 秒等待数据库就绪;perform_db_migrate():执行 Djangomigrate同步表结构;collect_static():收集静态文件;expire_caches():清理过期缓存;download_ip_db():下载 GeoIP/IPIP 地理位置数据库;install_builtin_applets():安装内置 Applet;init_oauth2_provider():初始化 OAuth2 Provider。
提示:若
jms脚本提示找不到配置文件,按 jms 中的提示先执行cp config_example.yml config.yml。
三、组件架构:多组件协作的功能框架
原文指出:
JumpServer は、複数の主要コンポーネントで構成されており、これらが集まって JumpServer の機能的なフレームワークを形成し、ユーザーに対して運用管理およびセキュリティ制御の包括的な機能を提供します。
JumpServer 由多个关键组件构成,共同形成其功能框架。核心组件(Core)负责业务逻辑与 API,周边组件则各自承担界面或协议接入职责。下表整理了原文档组件清单及各自职责:
| 组件 | 类型 | 职责说明 |
|---|---|---|
| Lina | 开源 | JumpServer Web UI(前端控制台界面) |
| Luna | 开源 | JumpServer Web 终端(浏览器内 SSH/RDP 会话界面) |
| KoKo | 开源 | 字符协议连接器(SSH 等基于字符的协议代理) |
| Lion | 开源 | 图形协议连接器(RDP/VNC 等图形会话代理) |
| Chen | 开源 | Web 数据库(浏览器内访问数据库) |
| Tinker | 私有 | 远程应用连接器(Windows 平台) |
| Panda | 私有 | 远程应用连接器(Linux 平台,EE 版本) |
| Razor | 私有 | RDP 代理连接器(EE 版本) |
| Magnus | 私有 | 数据库代理连接器(EE 版本) |
| Nec | 私有 | VNC 代理连接器(EE 版本) |
| Facelive | 私有 | 人脸识别(EE 版本) |
说明:表中"私有"组件对应原文档
release-private-red状态标识,即相关仓库不对外开源,属于企业版(EE)能力。开源组件(Lina、Luna、KoKo、Lion、Chen)均可独立获取。
从核心服务代码看组件协作
当前仓库是 JumpServer 的**核心服务(Core)**仓库,它通过注册机制与上述组件对接。从源码可以印证若干协作细节:
- 终端组件注册:核心服务通过
BOOTSTRAP_TOKEN预共享令牌接受 KoKo、Lion 等连接器注册(见 config_example.yml 中"预共享Token coco和guacamole用来注册服务账号"的注释)。 - 协议开关配置:核心服务可控制各协议连接器是否启用,例如 apps/jumpserver/conf.py 中的
TERMINAL_KOKO_SSH_ENABLED、TERMINAL_RAZOR_ENABLED、TERMINAL_OMNIDB_ENABLED等。 - WebSocket 会话:终端会话的实时通道依赖核心服务暴露的 WS 端口(默认 8070,见 config_example.yml),会话数据经由 Redis 中转。
核心服务自身的进程模型
jms start all 会拉起哪些进程?从 apps/common/management/commands/services/services/ 目录可以确认核心服务内部的服务单元:
| 服务单元 | 文件 | 角色 |
|---|---|---|
| Gunicorn | gunicorn.py | Web(HTTP)服务 |
| Celery Default | celery_default.py | 默认异步任务 worker |
| Celery Ansible | celery_ansible.py | Ansible 自动化任务 worker |
| Celery Combine | celery_combine.py | 合并型 worker |
| Beat | beat.py | 定时任务调度 |
| Flower | flower.py | Celery 任务监控面板(默认 127.0.0.1:5555) |
这些进程统一由 base.py 中的 BaseService 管理:通过 pid 文件跟踪进程、日志写入 data/logs 目录、每 3 次重试守护、每日 23:59 轮转日志并保留 7 天。
四、关键配置:部署与运维必读
部署前需要重点关注的核心配置集中在 config_example.yml,该文件是源码部署方式下 config.yml 的模板。以下是与快速部署直接相关的必配项:
4.1 安全密钥(必配)
# 生产环境请修改为随机字符串,可使用命令生成:
# cat /dev/urandom | tr -dc A-Za-z0-9 | head -c 49; echo
SECRET_KEY:
# 预共享 Token,KoKo/Lion 等连接器用于注册服务账号
BOOTSTRAP_TOKEN:
SECRET_KEY 用于 Django 签名与会话加密;BOOTSTRAP_TOKEN 是核心服务与终端组件之间的信任凭据。这两项在 apps/jumpserver/conf.py 中均有默认值定义,生产环境必须显式配置。
4.2 数据库与 Redis(必配)
# PostgreSQL 示例
DB_ENGINE: postgresql
DB_HOST: 127.0.0.1
DB_PORT: 5432
DB_USER: jumpserver
DB_PASSWORD:
DB_NAME: jumpserver
# Redis(Celery broker 与 WebSocket 通道)
REDIS_HOST: 127.0.0.1
REDIS_PORT: 6379
# REDIS_PASSWORD:
# REDIS_DB_CELERY: 3
# REDIS_DB_CACHE: 4
从源码默认值(apps/jumpserver/conf.py)可见:默认 DB_ENGINE 为 mysql,Redis 按用途拆分多个 DB(Celery=3、Cache=4、Session=5、WS=6),生产环境建议按需调整。
4.3 服务监听端口
HTTP_BIND_HOST: 0.0.0.0
HTTP_LISTEN_PORT: 8080
WS_LISTEN_PORT: 8070
Web 服务默认监听 8080(对应浏览器访问地址),WebSocket 服务监听 8070。
4.4 可选增强:Vault 凭据保险库与 SSH CA
# 内置 OpenBao 作为默认 Vault backend
VAULT_ENABLED: true
VAULT_BACKEND: openbao
VAULT_OPENBAO_ADDR: http://openbao:8200
VAULT_OPENBAO_MOUNT_POINT: pam
VAULT_OPENBAO_TOKEN:
VAULT_OPENBAO_TIMEOUT: 10
# OpenBao SSH CA(独立地址、Token 与挂载点)
SSH_CA_ENABLED: false
SSH_CA_OPENBAO_ADDR: http://openbao:8200
SSH_CA_OPENBAO_MOUNT_POINT: ssh-client-signer
SSH_CA_OPENBAO_ROLE: jumpserver
SSH_CA_OPENBAO_TTL: 300
从 apps/accounts/backends/ 目录看,JumpServer 的 Vault 后端支持 OpenBao、AWS、Azure、HCP 等多种实现;SSH CA 用于动态签发 SSH 客户端证书,实现免密登录资产(apps/jumpserver/conf.py)。
4.5 认证与安全策略(节选)
# LDAP/AD 定时同步
AUTH_LDAP_SYNC_IS_PERIODIC: True
AUTH_LDAP_SYNC_INTERVAL: 12 # 单位:小时
AUTH_LDAP_SYNC_CRONTAB: '* 6 * * *' # 或使用 Crontab 表达式
# OTP/MFA
OTP_VALID_WINDOW: 0
OTP_ISSUER_NAME: JumpServer
# 会话与安全
SESSION_EXPIRE_AT_BROWSER_CLOSE: False
SECURITY_WATERMARK_ENABLED: False # Luna 水印
ONLY_ALLOW_EXIST_USER_AUTH: False # 仅允许已存在用户登录
# 人脸识别(默认关闭,需先下载模型)
# uv run python requirements/download_face_models.py
# FACE_RECOGNITION_ENABLED: true
从 apps/jumpserver/conf.py 的 defaults 字典可以看到,JumpServer 的安全配置非常细密,包括:MFA 策略(SECURITY_MFA_AUTH:0 关闭/1 全局/2 仅管理员)、命令黑名单(默认含 reboot、shutdown、dd 等危险命令)、密码强度策略、登录失败锁定(SECURITY_LOGIN_LIMIT_COUNT)、登录 IP 黑白名单等,均可在 config.yml 中覆盖。
五、贡献与许可证
贡献指南
欢迎通过提交 Pull Request 参与贡献,贡献规范请参考仓库根目录的 CONTRIBUTING.md。
许可证
JumpServer 采用 GNU General Public License version 3(GPLv3) 开源协议(Copyright (c) 2014-2025 FIT2CLOUD, All rights reserved.),详见仓库根目录 LICENSE。
六、结语
通过本文,你应当已经掌握:
- JumpServer 的定位:面向 DevOps/IT 团队的开源 PAM 平台,统一入口纳管 SSH、RDP、K8s、数据库与 RemoteApp;
- 快速部署路径:
quick_start.sh一行命令即可拉起官方容器化版本;源码方式则通过python jms start all启动,并理解其背后的数据库检查、migrate、静态资源收集等初始化流程; - 组件架构:Lina/Luna 负责界面,KoKo/Lion/Chen 负责协议接入,Magnus/Razor/Nec 等 EE 组件扩展企业能力,核心服务通过
BOOTSTRAP_TOKEN与连接器互信; - 关键配置项:
SECRET_KEY、BOOTSTRAP_TOKEN、数据库/Redis、Vault 保险库、LDAP 与安全策略等均可通过 config_example.yml 模板按需调整。
后续建议深入阅读仓库中的 apps/terminal/(会话管理)、apps/perms/(授权引擎)与 apps/audits/(审计日志),进一步理解 JumpServer 从"连接"到"审计"的完整闭环实现。