深入Casdoor源码GoBeego后端、React前端与XORM数据层架构完整拆解指南【免费下载链接】casdoorAn open-source Agent-first Identity and Access Management (IAM) /LLM MCP agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD项目地址: https://gitcode.com/gh_mirrors/ca/casdoorCasdoor 是一款开源的Agent 优先Agent-first身份与访问管理IAM平台同时充当 LLM 的 MCP/Agent 网关与认证服务器支持 OAuth、OIDC、SAML、CAS、LDAP、SCIM、WebAuthn、TOTP、MFA、Face ID 等主流认证协议。这篇文章带你拆解它「Go Beego 后端 React 前端 XORM 数据层」的三层架构帮助你快速看懂一个生产级 IAM 系统的源码组织方式。一、一张图看懂 Casdoor 架构分层Casdoor 是一个单体但高度模块化的项目后端用Go Beego提供 REST API前端用React TypeScript构建 Web 管理界面数据层统一通过XORM ORM操作多种数据库。整体分层如下分层技术栈核心目录职责路由层Beego Routerrouters/API 注册、全局过滤器CORS/超时/鉴权控制层Beego Controllerscontrollers/请求解析、参数校验、调用业务层业务/数据层XORM Engineobject/全部领域模型 数据库访问 后台任务协议扩展层Go 标准库ldap/、radius/、scim/内置 LDAP/RADIUS/SCIM 等协议服务前端层React 18 Viteweb/用户界面、OAuth 登录页、管理后台Agent 网关层MCP Go SDKmcpself/、service/为 AI Agent 提供 MCP 协议接入依赖方面go.mod 中可以看到三大核心依赖beego/v2Web 框架、xorm-io/xormORM、casbin/casbin权限引擎以及modelcontextprotocol/go-sdkMCP 协议支持——这正是它区别于传统 IAM 系统的关键。二、GoBeego 后端从入口看启动流程1. 入口文件 main.go一个服务能做什么打开 main.go约 150 行代码就勾勒出整个服务的启动流程routers.InitAPI() // 注册所有 API 路由 object.InitFlag() // 解析启动参数与配置文件 object.InitAdapter() // 初始化数据库连接 object.CreateTables() // 自动建表/同步表结构 // ... go ldap.StartLdapServer() // 内嵌 LDAP 服务 go radius.StartRadiusServer() // 内嵌 RADIUS 服务 web.Run(fmt.Sprintf(:%v, port))可以看到 Casdoor 用goroutine 并行启动多个协议服务主 HTTP 服务、LDAP 服务、RADIUS 认证服务、Webhook 投递 worker 等同时运行一个二进制文件就覆盖了多个身份认证协议场景。2. Beego 过滤器链横切逻辑的集中管理main.go 中注册了一条完整的过滤器链所有请求都会依次经过web.InsertFilter(*, web.BeforeRouter, routers.AutoSigninFilter) web.InsertFilter(*, web.BeforeRouter, routers.CorsFilter) web.InsertFilter(*, web.BeforeRouter, routers.TimeoutFilter) web.InsertFilter(*, web.BeforeRouter, routers.ApiFilter) web.InsertFilter(*, web.BeforeRouter, routers.PrometheusFilter)每个过滤器都是一个独立文件位于 routers/ 目录职责单一、可独立测试auto_signin_filter.go根据 Cookie 自动登录cors_filter.go跨域处理timeout_filter.go请求超时控制authz_filter.go基于 Casbin 的 API 级鉴权field_validation_filter.go字段级参数校验 这种过滤器链设计是 Beego 项目的常见最佳实践把安全、限流、监控等横切逻辑与业务路由彻底解耦。3. 路由注册约定大于配置所有 API 在 routers/router.go 中集中注册路由命名遵循清晰的get-/add-/update-/delete-前缀约定web.Router(/api/get-user, controllers.ApiController{}, GET:GetUser) web.Router(/api/add-user, controllers.ApiController{}, POST:AddUser) web.Router(/api/login/oauth/access_token, controllers.ApiController{}, POST:GetOAuthToken) web.Router(/.well-known/openid-configuration, controllers.RootController{}, GET:GetOidcDiscovery)注意两类控制器的分工ApiController处理所有/api/*业务接口RootController处理协议级端点OIDC 发现文档、JWKS、CAS 票据校验、SCIM 等。MCP 协议入口也在这里注册router.goweb.Router(/api/mcp, mcpself.McpController{}, POST:HandleMcp)三、XORM 数据层一个 Ormer 打通五种数据库1. Ormer 封装连接管理 自动建库Casdoor 没有把 XORM Engine 直接散落各处而是在 object/ormer.go 中封装了一个全局单例Ormertype Ormer struct { driverName string dataSourceName string dbName string Db *sql.DB Engine *xorm.Engine }InitAdapter()根据 conf/app.conf 中的driverName创建连接支持MySQL、PostgreSQL、SQL Server、SQLite通过 blank import 四种数据库驱动见 ormer.go并能自动创建数据库和 schema。所有业务代码统一通过ormer.Engine访问数据切换数据库只需改一行配置。2. 启动即同步表结构object/ormer.go 的createTable()方法用Sync2()逐个同步 40 余个领域模型到数据库——表不存在则创建字段有变化则自动迁移。这意味着Casdoor 部署时无需手动执行 SQL 脚本这也是它开箱即用体验的核心原因之一。同步的模型覆盖了 IAM 的全部概念User、Organization、Application、Token、Session、Permission、Role、Enforcer、Syncer、Agent、Server、Site……每个模型对应object/目录下同名文件目录即文档。3. 模型定义标签即 Schema以用户模型 object/user.go 为例XORM 用结构体标签同时描述数据库列和 JSON 字段type User struct { Owner string xorm:varchar(100) notnull pk json:owner Name string xorm:varchar(255) notnull pk json:name CreatedTime string xorm:varchar(100) index json:createdTime Password string xorm:varchar(150) json:password ... }Owner Name组成联合主键体现了 Casdoor 的多租户设计每个资源都归属于某个 Organization组织。json标签让同一结构体既能落库、又能直接作为 API 返回体省去了 DTO 转换层。四、React 前端从 Vue 时代迁移到现代技术栈前端代码位于 web/ 目录旧版 Vue 代码保留在 web-old/ 供对照从 web/package.json 可见一套相当现代的技术选型类别选型说明构建工具Vite 5秒级启动的构建/开发服务器框架React 18 TypeScript类型安全的前端代码路由react-router-dom管理端与登录页路由UI 组件Radix UI Tailwind CSS无障碍组件 原子化样式国际化i18next11 种语言见 web/src/locales/E2E 测试Cypress用例见 web/cypress/e2e/前端如何与后端对话前端没有直接散落fetch调用而是在 web/src/backend/ 下为每类资源封装了一个 Backend 模块例如 UserBackend.ts、ApplicationBackend.ts、TokenBackend.ts与后端object/目录的模型一一对应。页面层则按 CRUD 模式组织在 web/src/pages/约 100 个页面文件每种资源都有XxxListPage和XxxEditPage配合通用的 web/src/components/crud/ 组件复用表格、搜索、编辑逻辑。而登录页、OAuth 授权页等面向终端用户的界面位于 web/src/components/auth/。构建产物由 web/mv.js 移动后Beego 通过静态路径直接托管前端实现一个服务交付前后端的部署模式。五、亮点速览Agent 网关与内置协议服务作为新一代 IAMCasdoor 有两块值得单独拆解1️⃣ MCP/Agent 网关mcpself/ 目录实现了自托管的 MCP 服务端应用、用户、权限、认证四类工具结合 service/ 中的代理转发逻辑让 AI Agent 能通过 MCP 协议安全地调用 Casdoor 的 APIAgent 会话还接入了 OpenTelemetryobject/openclaw_session_graph.go实现会话链路追踪。2️⃣ 内置协议服务器除了 HTTPCasdoor 还在进程内启动了 ldap/LDAP 服务端、radius/RADIUS 认证、scim/SCIM 用户同步服务——企业里常见的身份源协议它都能直接扮演服务器角色而不仅仅是客户端。六、新手源码阅读路线建议顺序main.go150 行——建立全局认知启动了哪些服务和过滤器routers/router.go——通过路由表浏览 Casdoor 的全部能力面object/ormer.go——理解数据访问入口与多数据库适配object/user.go——精读一个核心模型理解多租户与标签映射controllers/auth.go idp/——跟踪一次 OAuth 登录的完整链路30 第三方身份提供商都在这里web/src/backend/UserBackend.ts——回到前端看 API 是如何封装的七、总结Casdoor 的架构可以浓缩为一句话Beego 负责路由与过滤器、object 包负责领域模型与 XORM 数据访问、React 负责交互、MCP 服务负责 Agent 接入。它没有过度拆分微服务而是用清晰的目录边界 单一全局 Ormer 约定式路由换来极低的部署与认知成本——这正是它既能当传统 SSO 服务器、又能当 AI Agent 认证网关的根本原因。掌握这种分层方式后你不仅读懂了 Casdoor也获得了解析绝大多数「Go 后端 React 前端 ORM」项目的通用方法论。【免费下载链接】casdoorAn open-source Agent-first Identity and Access Management (IAM) /LLM MCP agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD项目地址: https://gitcode.com/gh_mirrors/ca/casdoor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考