dromara /Sa-Token

✨ 开源、免费、一站式 Java 权限认证框架,让鉴权变得简单、优雅!—— 登录认证、权限认证、分布式 Session 会话、微服务网关鉴权、SSO 单点登录、OAuth2.0 统一认证、jwt 集成、API Key 秘钥授权、API 参数签名

★ 19,113⑂ 2,913👁 153⑃ 197● 781▤ 40
JavaApache-2.0Created 2020-02-03sa-token.com
More from this author
Download: Sa-Token v1.46.0 发布 🚀,新增 Apache Fory 集成、独立 Redisson 集成Sa-Token-1.46.0 ↓1.46.02026-08-19
-1
Daily
+6
Weekly
+28
Monthly
19,113
stars
2,913
forks
153
watchers
197
prs
781
issues
40
releases

README

简体中文 | 繁體中文 | English | 日本語 | 한국어 | Русский


	

Sa-Token v1.46.0
✨ 开源、免费、一站式 java 权限认证框架,让鉴权变得简单、优雅! 

	
	
	
	
	
	 --
	 --
	
	

学习测试请拉取 master 分支,dev 是在开发分支 (在根目录执行 git checkout master) --

	在线文档:https://sa-token.com
	 | 
	需求提交



---

 📝 前言:

回望 2020 年初,我为 Sa-Token 提交第一行代码之际,彼时市面上 Java 缺少的不仅是一个简洁好用的鉴权框架,更是一整套清晰、自洽的权限架构设计思想。

因此,这几年间我将大量时间倾注在 Sa-Token 的文档编写,几乎每一章节、每一句话、每一个字都经过反复修改、精细打磨,以求做到最清晰、干练、易懂的表述。用心阅读文档,你学习到的将不止是 Sa-Token 框架本身,更是绝大多数场景下权限认证设计的最佳实践。


 🛠️ Sa-Token 介绍

Sa-Token 是一个轻量级 Java 权限认证框架,目前拥有五大核心模块:登录认证、权限认证、单点登录、OAuth2.0、微服务鉴权。

你还在手搓以下功能?Stop,让 Sa-Token 来!

!sa-token-jss

要在 SpringBoot 项目中使用 Sa-Token,你只需要在 pom.xml 中引入依赖:

 xml


	cn.dev33
	sa-token-spring-boot-starter
	1.46.0



除了支持 SpringBoot2、Sa-Token 还为 SpringBoot3/4、Solon、JFinal 等常见 Web 框架提供集成包,做到真正的开箱即用。



简单示例展示:(点击展开 / 折叠)

Sa-Token 旨在以简单、优雅的方式完成系统的权限认证部分,以登录认证为例,你只需要:

 java
// 会话登录,参数填登录人的账号id 
StpUtil.login(10001);


无需实现任何接口,无需创建任何配置文件,只需要这一句静态代码的调用,便可以完成会话登录认证。

如果一个接口需要登录后才能访问,我们只需调用以下代码:

 java
// 校验当前客户端是否已经登录,如果未登录则抛出 NotLoginException 异常
StpUtil.checkLogin();


在 Sa-Token 中,大多数功能都可以一行代码解决:

踢人下线:

 java
// 将账号id为 10077 的会话踢下线 
StpUtil.kickout(10077);


权限认证:

 java
// 注解鉴权:只有具备 user:add 权限的会话才可以进入方法
@SaCheckPermission("user:add")
public String insert(SysUser user) {
    // ... 
    return "用户增加";
}


路由拦截鉴权:

 java
// 根据路由划分模块,不同模块不同鉴权 
registry.addInterceptor(new SaInterceptor(handler - {
	SaRouter.match("/user/", r - StpUtil.checkPermission("user"));
	SaRouter.match("/admin/", r - StpUtil.checkPermission("admin"));
	SaRouter.match("/goods/", r - StpUtil.checkPermission("goods"));
	SaRouter.match("/orders/", r - StpUtil.checkPermission("orders"));
	SaRouter.match("/notice/", r - StpUtil.checkPermission("notice"));
	// 更多模块... 
})).addPathPatterns("/");


如果您曾经使用过 Shiro、SpringSecurity,在切换到 Sa-Token 后,您将体会到质的飞跃。







 核心模块一览:(点击展开 / 折叠) 

- 登录认证 —— 单端登录、多端登录、同端互斥登录、七天内免登录。
- 权限认证 —— 权限认证、角色认证、会话二级认证。
- 踢人下线 —— 根据账号id踢人下线、根据Token值踢人下线。
- 注解式鉴权 —— 优雅的将鉴权与业务代码分离。
- 路由拦截式鉴权 —— 根据路由拦截鉴权,可适配 restful 模式。
- Session会话 —— 全端共享Session,单端独享Session,自定义Session,方便的存取值。
- 持久层扩展 —— 可集成 Redis,重启数据不丢失。
- 前后台分离 —— APP、小程序等不支持 Cookie 的终端也可以轻松鉴权。
- Token风格定制 —— 内置六种 Token 风格,还可:自定义 Token 生成策略。
- 记住我模式 —— 适配 [记住我] 模式,重启浏览器免验证。
- 二级认证 —— 在已登录的基础上再次认证,保证安全性。 
- 模拟他人账号 —— 实时操作任意用户状态数据。
- 临时身份切换 —— 将会话身份临时切换为其它账号。
- 同端互斥登录 —— 像QQ一样手机电脑同时在线,但是两个手机上互斥登录。
- 账号封禁 —— 登录封禁、按照业务分类封禁、按照处罚阶梯封禁。
- 密码加密 —— 提供基础加密算法,可快速 MD5、SHA1、SHA256、AES 加密。
- 会话查询 —— 提供方便灵活的会话查询接口。
- Http Basic认证 —— 一行代码接入 Http Basic、Digest 认证。
- 全局侦听器 —— 在用户登陆、注销、被踢下线等关键性操作时进行一些AOP操作。
- 全局过滤器 —— 方便的处理跨域,全局设置安全响应头等操作。
- 多账号体系认证 —— 一个系统多套账号分开鉴权(比如商城的 User 表和 Admin 表)
- 单点登录 —— 内置三种单点登录模式:同域、跨域、同Redis、跨Redis、前后端分离等架构都可以搞定。
- 单点注销 —— 任意子系统内发起注销,即可全端下线。
- OAuth2.0认证 —— 轻松搭建 OAuth2.0 服务,支持openid模式 。
- 分布式会话 —— 提供共享数据中心分布式会话方案。
- 微服务网关鉴权 —— 适配Gateway、ShenYu、Zuul等常见网关的路由拦截认证。
- RPC调用鉴权 —— 网关转发鉴权,RPC调用鉴权,让服务调用不再裸奔
- 临时Token认证 —— 解决短时间的 Token 授权问题。
- 独立Redis —— 将权限缓存与业务缓存分离。
- Quick快速登录认证 —— 为项目零代码注入一个登录页面。
- 标签方言 —— 提供 Thymelea

Top issues

Latest release

Sa-Token v1.46.0 发布 🚀,新增 Apache Fory 集成、独立 Redisson 集成 v1.46.0 2026-08-19
- core:
	- 新增:侦听器新增注销前钩子 doBeforeLogout / doBeforeKickout / doBeforeReplaced。 [重要]
	- 新增:StpInterface.isDisabled 补充 loginType 参数。  [不向下兼容]
	- 新增:新增 allowLoginIdColon 配置,默认禁止 loginId 包含冒号。  [不向下兼容]
	- 修复:Jackson DefaultTyping 多态反序列化 RCE,新增 SaJsonStrategy 全局类型白名单。  [重要]  [漏洞修复]
	- 新增:getSaTokenConfig 策略支持自定义配置来源,方便从数据库中读取配置。
	- 新增:新增 SaRequest / SaResponse / SaStorage 创建策略。  fix: 841
	- 新增:Session 新增 getList / getSet / getMap 类型安全集合读取。
	- 修改:随机字符串/数字改用 CSPRNG(SecureRandom)生成。
	- 修复:isLastingCookie 为 null 时 getCookieTimeout 不再 NPE。
	- 修复:isUrl 支持 IPv6 方括号地址并拒绝裸 IPv6。
	- 修复:JSON 反序列化容错优

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON