casdoor

环境要求

• 已安装 Docker（all-in-one 与 Docker Compose 方式均需要）
• 使用 Compose 方式需安装 Docker Compose 并已克隆仓库（含 docker-compose.yml）
• 本机 8000 端口未被占用
• Compose 方式首次启动需从源码构建 Go 后端与 React 前端，耗时数分钟

安装与启动步骤

1. 1选择安装方式

   README 给出四条路径，最快的是 all-in-one 单容器（含 SQLite 与演示数据），适合试用；Compose 方式为 Casdoor + MySQL 8，适合更接近生产的试用。

2. 2启动 all-in-one 容器

   一条命令即可跑起来，容器内自带 SQLite 与演示数据，最终访问 http://localhost:8000。数据存在容器内，容器删除即丢失，不适用于生产。

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

   复制

3. 3配置 MySQL 连接

   使用 Compose 方式前，先把 conf/app.conf 中的数据库设置改成与 db 服务一致；即使用 Compose 方式也填 localhost，启动时 Casdoor 会改写为 Docker 宿主地址。

4. 4启动 Compose 全套服务

   在仓库根目录执行，会从源码构建镜像并同时启动 Casdoor 与 MySQL；入口已带 --createDatabase=true，casdoor 数据库会自动创建。

   docker compose up

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:8000，能看到 Casdoor 的 Web 控制台登录页面即启动成功。

常见问题

注意事项

• 四条安装路径最终都指向 http://localhost:8000，可据此判断是否启动成功。
• all-in-one 镜像捆绑 SQLite 与演示数据，仅用于评估，生产环境请勿使用。
• 修改 conf/app.conf 的数据库配置必须在 docker compose up 之前完成，否则 Casdoor 会连不上数据库。
• 仓库地址与文档：https://github.com/casdoor/casdoor 、https://casdoor.ai/docs/overview 。