jamma/acl
jamma
自动构建
这是一个基于RBAC3+模型的通用鉴权系统，支持资源树结构与Redis存储，提供用户角色权限管理及鉴权接口，可通过Docker快速部署。
下载次数: 0状态：自动构建维护者：jamma仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
鉴权acl
镜像概述
通用鉴权系统，基于RBAC3+模型实现权限管理，支持资源树结构和Redis存储，提供灵活的用户角色权限配置与鉴权接口，可快速集成到各类系统中实现权限控制。
核心功能
- 基于RBAC3+模型（支持角色继承与资源继承）
- 资源树结构：资源权限可向下传递或通过
noRecursion限制传递 - Redis存储：配置数据持久化，支持动态加载更新
- 鉴权接口：提供
isAllowed（用户鉴权）和areAnyRolesAllowed（角色鉴权）接口 - 链路追踪：集成Jaeger实现服务链路监控
- 消息队列：支持jm-acl-mq模块与网关交互
部署说明
采用Docker部署，容器默认监听80端口，需配置Redis地址等环境变量：
bash# 替换localhost为实际Redis地址 docker run -d --name acl -e redis=redis://localhost jamma/acl
环境变量配置
jm-server
参考https://github.com/jm-root/server/tree/master/packages/jm-server
jm-acl
| 配置项 | 默认值 | 描述 |
|---|---|---|
| redis | - | 必填，Redis数据库URI |
| acl_key | "acl:" | Redis键前缀 |
| super_role | "root" | 超级角色ID |
| guest_role | "guest" | 游客角色ID |
| user_role | "user" | 登录用户角色ID |
| default_allow | false | 是否允许访问未登记的资源或权限 |
jm-acl-mq
| 配置项 | 默认值 | 描述 |
|---|---|---|
| gateway | "[***]" | Gateway服务器URI |
jm-server-jaeger
| 配置项 | 默认值 | 描述 |
|---|---|---|
| service_name | "acl" | 链路追踪服务名称 |
| jaeger | - | Jaeger服务器URI |
使用场景
1. ACL管理用户
ACL负责维护用户角色信息，通过用户ID鉴权：
bash# 保存用户角色 PUT /acl/user/users/{用户ID} {"roles": ["admin"]} # 鉴权示例 GET /acl/isAllowed?user=326482&resource=/sso&permissions=get
2. ACL不管理用户
用户角色由外部服务维护，通过角色列表鉴权：
bash# 鉴权示例 GET /acl/areAnyRolesAllowed?roles=admin&resource=/sso&permissions=get
3. 自定义角色
外部服务管理自定义角色，ACL负责角色权限配置：
bash# 查询角色拥有的资源权限 GET /acl/roles/{角色ID}/resources # 在ACL中创建自定义角色 PUT /acl/roles/{自定义角色ID} {"resources": {}}
实现原理
- 通过
load/save方法从Redis加载或保存RBAC配置 - 配置变化时自动调用
validateAclConfig检查合法性 - 资源变化时生成鉴权路由，实现
areAnyRolesAllowed/isAllowed接口 - 角色变化时基于
node-acl库动态生成实例
模块组成
- 核心模块：jm-acl（权限管理核心逻辑）
- 消息模块：jm-acl-mq（与网关交互）
- 主入口：main（服务启动入口）
关键流程图
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"