
做站绕不开登录注册。自己写用户表,要处理密码存储、邮箱验证、找回密码;接第三方登录,又要一家一家研究协议细节;哪天想加双因素认证,又是一轮改造。这些活重复、琐碎,还容易出错。Casdoor 把这件事做成一个独立的开源身份认证平台,你的站点只管调接口,身份这块交给它。
项目在 github.com/casbin/casdoor,官网是 casdoor.org,采用 Apache-2.0 协议,目前在 GitHub 上有一万四千多颗星、近两千个 fork,主要用 Go 写成,仓库仍在活跃提交。它是一个有公开官方渠道的开源项目,文档、演示和更新记录都齐全,适合自己部署。
它到底解决什么
Casdoor 的定位是身份与访问管理加单点登录。认证协议上,它支持 OAuth 2.0、OIDC、SAML、CAS、LDAP、WebAuthn 和多因素认证,官方列出的身份提供商超过一百家,常见的社交账号和企业身份系统都在里面。你说的登录方式,多数不用自己接,配一下就能用。
最近它加了一个 Marketplace,应用、身份源和登录页主题都能一键安装,自托管的 IAM 也能像装插件一样扩展。它还内置了 MCP 服务,允许 AI 助手用自然语言管理用户和应用,走的是 Streamable HTTP,并针对智能体场景提供了 OAuth 2.1 和动态客户端注册。这部分是为 AI 应用准备的,普通站点可以暂时不用管,但说明它的演进方向是把身份层做成基础设施。
什么场景值得上
适合的场景:你有多个站点或应用要共用一套账号;你需要第三方登录又不想逐个研究协议;你要给后台加双因素认证和细粒度权限;你在做 SaaS,需要多租户和计费管理。
不适合的场景也要说清:一个只有一两个管理员的纯静态博客,上 Casdoor 属于杀鸡用牛刀;它不托管你的前端页面,登录页样式要自己去配主题或自己写。把它当基础设施,而不是当登录框美化工具,预期才不会对不上。
三步走通部署与接入
第一步,部署。官方推荐用 Docker Compose,一条命令把服务拉起来,默认带一个演示数据库,可以先跑起来看界面。正式用之前,要换成 PostgreSQL 或 MySQL,并把配置里的域名、端口和密钥改掉。单机起步 1 核 2G 够用,访问量上来再做水平扩展。
第二步,初始化。用默认管理员登录后先改密码,然后建组织,它是多租户的顶层单位,一个组织下面再建应用和用户。接着在身份源里添加你想用的登录方式,按官方指引填客户端编号和密钥,回调地址填你这边的地址。登录页主题可以在 Marketplace 里挑一个,省得从零写。
第三步,接入站点。Casdoor 提供多种语言的 SDK,也支持标准 OIDC,WordPress 可以找对应的 OIDC 插件对接。核心流程是:把用户导航到授权地址,登录成功后带着授权码跳回你的站点,你的站点用授权码换令牌,再解析出用户信息完成本地登录。接入时先确认回调地址完全一致,多数问题都出在末尾斜杠和协议头上。跑通一条最小链路之后,再逐个开启邮箱验证、找回密码和双因素认证。
三个容易踩的点
一是数据库别用默认的。演示库只适合试玩,正式环境不换库,重启一次数据就没了。
二是回调地址和跨域。前后端分离部署时,登录成功后跳回的前端地址、接口允许的跨域来源都要单独配,漏一个就卡在最后一步。
三是密钥管理。客户端密钥和服务端密钥不要写进前端代码,放服务端环境变量里。这类凭证一旦泄露,等于把登录入口交给了别人。
我的看法
自托管登录的取舍,本质是省下的开发时间和多出来的运维责任之间的一笔账。Casdoor 把注册、登录、第三方接入、双因素这些高频又繁琐的功能打包了,对多站点或需要统一账号的团队,这笔账算得过来;对单站小项目,维护一套独立认证服务反而更重。
判断的时机其实很清楚:当你开始为第二个站点重写登录逻辑的时候,就是考虑它的合适节点。真正的价值不在于它替你画了一个登录框,而在于把身份这件事从应用里剥离出来,变成一处配置、多处复用。
文章标题:给网站接一套自己的登录:Casdoor 自托管部署与接入拆解
文章链接:https://www.muooy.cn/16871.html
更新时间:2026年11月18日
1.本站大部分内容均收集于网络!若内容若侵犯到您的权益,请发送邮件至:305582964@qq.com,我们将第一时间处理!2.资源所需价格并非资源售卖价格,是收集、整理、编辑详情以及本站运营的适当补贴,并且本站不提供任何免费技术支持。
3.所有资源仅限于参考和学习,版权归原作者所有,更多请阅读用户协议和免责声明。
- 1一个二进制就能建站:Zola 静态生成器上手,三步跑通本地预览11月17日
- 2一个月攒到 1600 星的 Rust 原生任务管理器:Argus v0.5.0 上手拆解11月16日
- 3MiniMax 把 4K 生图开源了:十秒出图,但商用前先看清三条限制11月14日
- 4WordPress 官方新工具 Reprint:整站克隆到本地,改版不用再赌线上11月14日
- 5让 AI 像同事一样进群干活:开源自托管聊天工具 agentes.chat 拆解11月13日
- 6时之笛重制版能跑在PC上了:5000星开源重编译项目拆解11月10日
- 7命令行 Agent 后台自转:agent-autoloop 上手评测与部署11月6日
- 8一句话画出带官方Logo的架构图:stack-diagram上手11月5日
- 9文件分享不求网盘:8700星开源文件快递柜FileCodeBox自架指南11月4日
- 10不写一行代码:设计师用 AI 把个人网站从草图做到上线的全流程11月3日

