安装与环境准备

它解决什么问题

Muer 以「一个 Starter 依赖 + 宿主提供少量 SPI」的方式嵌入现有 Spring Boot 应用，不需要额外部署一套独立 IAM 服务。

依赖坐标

业务应用通常只需要下面这一个聚合 Starter：

<dependency>
    <groupId>cloud.muer</groupId>
    <artifactId>muer-spring-boot-starter</artifactId>
    <version>0.1.0-SNAPSHOT</version>
</dependency>

三种使用情景

当前 0.1.0 是 Release Candidate（0.1.0-SNAPSHOT），尚未发布到 Maven Central。按你的环境选择获取方式：

情景	怎么做
0.1.0 RC（本机开发）	本地 `mvn install`，见下方「本地安装」
企业内部使用	把构建产物上传到 Nexus / Artifactory，团队成员从内部仓库拉取
未来 Maven Central 发布后	直接在上面的 `pom.xml` 里加依赖即可（当前不可用）

当前重点讲前两种。

0.1.0 RC 本地安装

从源码把框架安装到本机 Maven 仓库：

git clone https://github.com/wbh123/Muer-IAM-Framework.git
cd Muer-IAM-Framework
mvn clean install -DskipTests

这会安装到：

~/.m2/repository/cloud/muer/muer-spring-boot-starter/0.1.0-SNAPSHOT/

正式 0.1.0 发布 Maven Central 后，这一步会被删除。

企业内部仓库

发布到内部 Nexus / Artifactory 后，开发者无需 clone 源码，只需在 pom.xml 声明坐标，并配置镜像仓库为内部地址即可。

运行前置条件

Java 21；
Spring Boot 4；
MySQL 8.x（发布验证基线为 MySQL 8.4）；
Redis 7。

上面的 MySQL / Redis 是 Muer 0.1.0 默认 Starter 实现运行所需的持久化 Repository 与默认 Token/Session 快速状态存储。若宿主替换了对应的公共 SPI 实现，其基础设施要求由宿主实现自行决定。

MySQL 和 Redis 可以是：

本机安装；
内网已有服务；
云托管服务；
Docker / Kubernetes 中的服务。

Docker 不是前置条件。 IAM 只关心宿主应用能否通过标准 Spring Boot 配置连接这些基础设施。

宿主必须提供的 SPI

Starter 不会替你持有用户与业务资源。根据你使用的能力注册对应 Spring Bean：

Bean	必需？	作用
`IdentityAuthenticator`	登录时必需	校验宿主凭据并投影 `IamPrincipal`
`PermissionDefinitionProvider`	推荐	用代码注册业务权限（`document:read` 等）
`ResourceHierarchyProvider`	用 Scope 时需要	判断业务资源是否位于 Scope 内
`MvcResourceDescriptorResolver`	MVC Scope 时需要	把 `@RequirePermission` 请求映射成 `ResourceDescriptor`

示例实现：

最小接入模式

不要以为四个 Bean 一个都不能少。 它们是分层可选的：

只要登录
  IdentityAuthenticator

登录 + 业务权限
  + PermissionDefinitionProvider

资源级权限（Scope / @RequirePermission）
  + ResourceHierarchyProvider
  + MvcResourceDescriptorResolver

完整治理
  + Admin Console
  + Audit
  + Observability

想从最小链路起步，先只接 IdentityAuthenticator，跑通「添加 Starter → 登录 → /iam/auth/me」，再按需往上加。

不需要做什么

普通接入者不需要：

运行 IAM 仓库的完整 Testcontainers 套件；
使用 Docker 复刻项目 CI 环境；
直接依赖 IAM 的 MyBatis Mapper / Repository 实现；
为 Redis 预创建 Key；
默认手工创建 IAM 数据表。

如果 muer.schema.enabled=true，Starter 会自动执行 IAM Flyway migration。

下一步

想最快跑通一个真实接口：阅读15 分钟快速开始（可直接对照 examples/quickstart）；
想不用 Docker 手动部署：阅读手动部署；
查看完整参数：阅读基础配置与配置参考。