首页
/ 【限时免费】 【Sa-Token】开源下载和安装教程

【限时免费】 【Sa-Token】开源下载和安装教程

2026-02-04 04:16:18作者:丁柯新Fawn

1、项目介绍

Sa-Token 是一个轻量级 Java 权限认证框架,核心功能包括:

  • 登录认证、权限认证、单点登录
  • OAuth2.0、微服务鉴权
  • 分布式会话管理
  • 支持 SpringBoot/Solon/JFinal 等框架
  • 提供简洁的API(如StpUtil.login()实现登录)

2、项目下载位置

官方推荐通过Maven直接引入依赖:

<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>1.44.0</version>
</dependency>

源码仓库地址:

  • Gitee: dromara/sa-token
  • GitHub: dromara/sa-token

3、环境配置

基础要求

  • JDK 8+
  • Maven 3.0+
  • Spring Boot 2.x/3.x

配置示例(SpringBoot)

application.yml中添加基础配置:

sa-token:
    token-name: satoken    # Token名称
    timeout: 2592000      # Token有效期(秒)
    is-share: true        # 是否允许同一账号多端登录

4、安装方式

方式一:SpringBoot项目集成

  1. 在pom.xml中添加依赖
  2. 创建配置类:
@Configuration
public class SaTokenConfig {
    @Bean
    public SaTokenConfigure saTokenConfigure() {
        return new SaTokenConfigure();
    }
}

方式二:快速启动示例项目

克隆官方demo:

git clone https://gitee.com/dromara/sa-token.git
cd sa-token/sa-token-demo
mvn spring-boot:run

5、常用处理脚本

登录鉴权脚本示例

// 登录
@PostMapping("/login")
public String login(String username, String password) {
    if("admin".equals(username) && "123456".equals(password)) {
        StpUtil.login(10001);  // 参数为账号id
        return "登录成功";
    }
    return "登录失败";
}

// 权限校验
@SaCheckPermission("user.add")
@PostMapping("/user/add")
public String addUser() {
    return "用户添加成功";
}

路由拦截配置

@Configuration
public class SaTokenInterceptor implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new SaInterceptor())
            .addPathPatterns("/**")
            .excludePathPatterns("/login");
    }
}

提示:更多功能如SSO集成、JWT扩展等可参考官方文档的详细示例

登录后查看全文
热门项目推荐
相关项目推荐