AIGC标识 Casdoor 开源版 Marketplace 实操:安装应用、身份源与登录页主题

Casdoor 这两个月在控制台里加了 Marketplace,应用接入、身份源和登录页主题可以在实例里一键安装。这篇按步骤走一遍,顺便说明安装和卸载的语义。

1. 启动一个本地实例

docker run -p 8000:8000 casbin/casdoor-all-in-one

打开 http://localhost:8000 ,用 admin / 123 登录。这是带示例数据的 SQLite 实例,只适合试用,不要用于生产。

2. 打开 Marketplace

登录后,控制台侧栏有 Marketplace 入口。页面读取 Casdoor 商店的目录,海外是 marketplace.casdoor.com,国内镜像 marketplace.casdoor.cn。实例默认读 jsDelivr 上的只读目录,国内网络连不上会自动回退到 .cn;内网环境可以把 marketplaceUrl 配置成内部镜像。

目录目前 42 个条目:10 个应用接入、6 个身份源模板、24 套登录页主题、2 个 action。

3. 安装一个应用模板:Grafana

在 Marketplace 里找到 Grafana,点安装。会弹出一个表单,只需要填 Grafana 的地址,例如 http://localhost:3000 。确认后,Casdoor 会:

  • 创建一个名为 Grafana 的 application;
  • 填好回调地址,例如 http://localhost:3000/login/generic_oauth ;
  • 配好 scope 和登录方式;
  • 在详情页给出 Grafana 那边 grafana.ini 要填的内容。

安装包在下载后会按商店索引里的 sha256 校验。应用模板是声明式的 JSON,安装过程不会往磁盘写文件。

4. 安装一个身份源模板:Keycloak

身份源模板是反方向:把 Keycloak 当成 Casdoor 的登录来源。安装时填 Keycloak 的地址、client ID 和 client secret,Casdoor 生成对应的 provider。装完可以在应用的登录方式里勾选这个身份源。

除了 Keycloak,目录里还有 Zitadel、Authentik、Authelia、自建 GitLab 和超星学习通。超星学习通只在中文界面显示。

5. 安装登录页主题

主题有 24 套,Brutal、Terminal、Retro、Pixel、Nord、Dracula、Catppuccin、Solarized 等。每套主题在安装前都可以点预览,预览会直接在登录页上套用主题,但不会写入应用设置。

选定后点安装,主题字段会写进当前应用的登录页设置。想换回去,在 Marketplace 的已安装列表里卸载主题,原来的设置会被还原。

如果只想看看效果,可以打开 demo.casdoor.com 的登录页,它会轮播主题;访客可以临时切换,URL 上带 ?theme=<id> 就固定某个主题。

6. Action 和其他改动

Marketplace 里唯一会执行代码的是 action,跑在 WebAssembly 沙箱里,不能访问数据库和文件系统,HTTP 请求只能发往 manifest 中声明的域名,单次调用最多 60 秒。目前上架的是 Revolut 支付和 Vonage 短信。

这次更新还顺手改了几处:应用没配邮件源时使用全局默认邮件 provider;application 支持从表格批量导入并保留 client ID/secret;注册审核;webhook 按端点分队列;Microsoft 365 邮件源和 ALTCHA 验证码;MCP / Agent 的 token 链路补了 DPoP、resource 参数和 RFC 7523 客户端断言。

7. 卸载与升级

卸载应用或身份源模板时,Casdoor 会删除这次安装生成的对象;主题会恢复安装前的值。integration 表里记录了版本、变量和生成的对象,后续升级会按新版本的模板重新应用。

商店现在只有 42 个条目,大部分是项目团队维护的。应用模板、身份源模板和主题都接受社区贡献,仓库是 https://github.com/casdoor/casdoor-integrations ,一个条目通常只需要几个 JSON 文件和说明文档。

仓库:https://github.com/casdoor/casdoor
文档:https://casdoor.ai

posted @ 2026-11-17 00:20  Casbin开源社区  阅读(6)  评论(0)    收藏  举报