轻量级 Java 权限认证框架 · v1.46.0 本地 Docker 从源码构建实测
项目描述(源自官方仓库与官网,2026-11-19 核对):开源、免费的一站式 Java 权限认证框架,让鉴权变得简单、优雅——一个 jar 包解决:
登录认证权限认证分布式 Session 会话微服务网关鉴权SSO 单点登录OAuth2.0 统一认证JWT 集成API 参数签名API Key 秘钥授权踢人下线二级认证临时 Token
国产认证框架人气王——登录鉴权一行代码搞定、踢人下线开箱即用,Gitee 近 5 万星、39 个官方插件覆盖 SSO/OAuth2/微服务全场景。
国产认证框架的头部标杆:Gitee ★49,570 + GitHub ★19,122 双平台人气第一梯队,评测当日仍在推送代码;14 项核心接口链路(登录/鉴权/权限/角色/通配/注解/踢人下线/并发登录)在本地 Docker 实测 14/14 全通,117,832 行源码仅 3 个超百行方法、644 个测试文件是同类项目罕见的工程纪律;代价是 doLogin 写 Redis 场景 P99 1.17s(Windows Docker VM 口径)、两个 2023 年严重 CVE 已修复但暴露过框架级风险面、demo 工程存在 SaTokenContext 兼容坑。综合 8.7 / 10:任何 Java 项目要加认证鉴权,它都是默认首选;需要开箱即用的完整产品化单点登录(而非框架)的团队请看官方付费衍生品 Sa-Pro。
出身与定位:Sa-Token 由 dromara 开源社区成员「ゞ瞎折腾、容唔下蓝颜」等人发起维护,2018 年开源至今 8 年,定位是「一站式 Java 权限认证框架」——登录认证、权限认证、单点登录、OAuth2.0、分布式会话、踢人下线、微服务网关鉴权等 30+ 能力一个 jar 包解决;以「简单到极致」为设计哲学,官方口号是把权限认证做成「一行代码」的事。Gitee ★49,570GitHub ★19,122在国产 Java 认证框架中人气断层第一。
功能版图与技术栈:39 个官方插件覆盖 Spring Boot 2.x/3.x、WebFlux、Solon、jFinal 等全技术栈适配,plus 插件提供 OAuth2 服务端、SSO、临时令牌、同端互踢、二级认证、防 ReDoS/防暴力破解等增值模块;核心仅依赖 JDK8+(无强制第三方依赖),Redis 会话存储为可选插件;官方文档站 145 篇专题文档全覆盖——本期评测在本地 Docker 容器中以官方 demo-case 综合演示工程真实运行,117,832 行源码全量静态扫描。
版本与商业形态:本体 Apache-2.0 协议永久免费(官方文档明确承诺终身免费),代码级无任何 license 校验、激活码、试用期或用户数限制;商业形态为独立衍生产品——公开价格(来源 sa-max.cn 销售页与 sa-token.cc 官方文档,2026-11-18 抓取):Sa-Pro 单点登录商业版 ¥5,999 起、Sa-Max 统一认证综合版 ¥9,999 起,均为一次购买永久授权、全源码交付、不限域名与项目数;隐性成本极低(框架本身只需应用自有服务器 + 可选 Redis),无 SaaS 套餐、无实施绑定。收费确定性在同类项目中属最高档。
docker network create stnet && docker run -d --name satoken-redis --network stnet redis:7-alpine && docker run -d --name satoken-app --network stnet -p 8081:8081 -e SPRING_REDIS_HOST=satoken-redis crpi-bfp61hn0anlbem5v.cn-hangzhou.personal.cr.aliyuncs.com/sourceradar/sa-token:1.46.0-r001{ "code": 200, "msg": "ok", "data": { "satoken": "28a5255b-ea71-4894-a73d-911f223ff35c" } }
{ "code": 200, "data": true, "msg": "ok" }
{ "code": 200, "data": ["admin", "super-admin"], "msg": "ok" }
{ "code": 200, "msg": "ok" }
{ "code": 200, "data": false, "msg": "ok" }
{ "code": 401, "msg": "未能读取到有效 token", "data": null }
| 编号 | 等级 | 来源 | 风险说明 | 处置方式 | 状态 |
|---|---|---|---|---|---|
| VUL-01 | 严重 | CVE-2023-44794 | ≤1.36.0 构造 URL 提权漏洞(CVSS 9.8) | 升级至 1.37.0+ | ✅ v1.46.0 已修复 |
| VUL-02 | 高危 | CVE-2023-43961 | ≤1.36.0 Spring 动态控制器鉴权绕过(CVSS 8.8) | 升级至 1.36.0+ | ✅ v1.46.0 已修复 |
| CFG-01 | 中危 | 演示账号 | demo 演示账号 zhang/123456 公开明文 | 自部署后立即改密并移除 demo 工程登录接口 | ⚠️ 需处置 |
| CFG-02 | 中危 | 集成责任 | 框架级安全依赖集成方正确配置拦截路径,漏配即裸奔 | 上线前按官方「路由拦截统计」逐条核对 | ⚠️ 需处置 |
| NOTE-01 | 关注 | 实测发现 | 404 兜底/非请求上下文调 StpUtil 抛 SaTokenContext 异常(demo 兼容坑) | 升级后按官方迁移文档适配上下文模型 | ⚠️ 关注 |
核查口径:NVD/GitHub Advisory/OSCS 公开 CVE 库逐条核对(2026-11-18 抓取)+ 本地容器实测 + 默认配置检查(未运行商业化漏扫)。两个历史严重漏洞均在评测版本前修复;框架「安全但不兜底」的定位需集成方自查拦截配置。
| 检查项 | 结果 | 评定 |
|---|---|---|
| 模块分层 | core(304 文件/4.2 万行)+ 28 个 starter + 39 个官方插件 + BOM 统一版本管理,按技术栈与功能双维度拆分 | 优 |
| 超长方法 | 全量 1,019 个 Java 文件花括号深度扫描:超 100 行方法仅 3 个(0.3%),最长 168 行 | 优 |
| 代码规模 | 117,832 行 Java / 1,019 文件,体量适中、单文件职责单一 | 优 |
| 测试覆盖 | 644 个测试文件(与主代码文件比 0.63:1),测试密度在同类国产框架中罕见 | 优 |
| 依赖策略 | 核心零强制第三方依赖(纯 JDK8+),Redis/Redisson 等为可选插件——集成方按需引入 | 优 |
抽检口径:1,019 个主代码 Java 文件全量花括号深度扫描 + 目录规模统计(评分规则页 · 05 源码质量)。sa-token-doc 与 demo 工程未纳入主代码口径。
| 指标 | 数值 | 解读 |
|---|---|---|
| Gitee Star / Fork | ★ 49,570 / 4,572(GitHub 侧另有 ★19,122 / fork 2,914) | 国产框架人气第一梯队 |
| 最新版本 | v1.46.0(2026-08-19,新增 Apache Fory / Redisson 集成) | 持续发布 |
| 发布节奏 | 8 年持续迭代,小版本高频发布 + 插件生态持续扩编 | 节奏稳定 |
| 主仓状态 | 评测当日(2026-11-18)仍在推送代码 | 无断更风险 |
| 渠道生态 | 官方文档站(145 篇)+ QQ 交流群 + issue 双平台 + 商业衍生品 | 渠道齐全 |
采样口径:Gitee API v5 + GitHub API 仓库数据 + 本地克隆 git log(评分规则页 · 07 社区 / 08 维护)。issue 响应时效本期未采样,未计入加分。
# 从镜像 tar 加载(image/ 目录内 sa-token-1.46.0-r001.tar) docker load -i sa-token-1.46.0-r001.tar # 两条命令启动(Redis + 应用) docker network create stnet docker run -d --name satoken-redis --network stnet redis:7-alpine docker run -d --name satoken-app --network stnet -p 8081:8081 \ -e SPRING_REDIS_HOST=satoken-redis crpi-bfp61hn0anlbem5v.cn-hangzhou.personal.cr.aliyuncs.com/sourceradar/sa-token:1.46.0-r001 # 验证:登录成功即部署完成 curl "http://127.0.0.1:8081/acc/doLogin?name=zhang&pwd=123456"
启动耗时:应用容器就绪约 45 秒(JVM + Tomcat + Redis 连接),首次 load tar 约 30 秒。
重置环境:docker rm -f satoken-app satoken-redis && docker network rm stnet 后重跑即可,框架无持久化状态。
镜像可信吗:完全从官方仓库源码构建(Maven 3.9.9 install core/starter/redis-jackson/spring-el 四个模块 → 打包官方 demo-case → JRE 21 运行),未使用任何第三方预构建镜像;构建 Dockerfile 与 compose 随交付包开源。构建过程踩坑实录:①demo-case 官方 pom 未配 spring-boot-maven-plugin(按 IDE 运行设计),构建期需注入 repackage;②仓库 ${revision} 未扁平化 pom 从本地仓库解析报模型错误,需将 demo 挂入根 reactor 同体构建;③基础镜像源多家全挂,改用 Maven 官方二进制打入镜像。
复现环境:Windows 11 / Docker Desktop 29.1.3(WSL2)/ Maven 3.9.9 + JDK21 / autocannon 30 并发 × 12s × 3 组。
| 维度 | 权重 | 得分 | 加权 | 评分依据 |
|---|---|---|---|---|
| 功能 | 20% | 8.5 | 1.70 | 14 项接口实测全通;SSO/OAuth2 等宣称能力未逐一实测 |
| 代码 | 15% | 8.8 | 1.32 | 超百行方法仅 3 个;644 个测试文件、39 插件模块化 |
| 文档 | 10% | 9.0 | 0.90 | 官方文档站 145 篇专题全覆盖,示例即贴即用 |
| 收费模式 | 10% | 9.3 | 0.93 | Apache-2.0 本体零墙终身免费;衍生品明码标价 |
| 性能 | 10% | 7.8 | 0.78 | 读场景 2999 QPS / P90 123ms;doLogin 写 P99 1.17s(VM 口径) |
| 安全 | 10% | 8.2 | 0.82 | 2 个严重 CVE 均已修复;集成方需自查拦截配置 |
| 社区 | 10% | 9.2 | 0.92 | Gitee ★49,570 / GitHub ★19,122;issue 时效未采样 |
| 维护 | 10% | 9.0 | 0.90 | 评测当日仍在推送;8 年无断更 |
| 许可 | 5% | 9.5 | 0.475 | Apache-2.0:商用/闭源/SaaS 零限制 |
加权合计 8.745 → 8.7(四舍五入保留一位小数,即报告展示的总分)。