Docker 部署 Casdoor 指南

Casdoor 是一个开源的身份和访问管理（IAM）平台，功能强大且灵活。使用 Docker 部署 Casdoor，能够避免复杂的环境配置，快速完成平台搭建。以下是详细的部署步骤。

一、准备工作

  1. 安装 Docker：确保服务器上已安装 Docker。如果尚未安装，可根据服务器的操作系统类型，参考Docker 官方文档进行安装。

  2. 拉取镜像：在终端中执行以下命令，拉取 Casdoor 官方镜像。Casdoor 提供了两个镜像，一个包含前端和后端，另一个仅包含后端，你可以根据需求选择。

  • 拉取包含前端和后端的镜像：
  1. docker pull casdoor/casdoor:latest
  • 拉取仅包含后端的镜像：
  1. docker pull casdoor/casdoor-backend:latest

二、配置文件

  1. 创建配置目录：在服务器上创建一个用于存放 Casdoor 配置文件的目录，例如：
  1. mkdir -p /casdoor/config
  1. 获取配置文件：从 Casdoor 的 GitHub 仓库中获取配置文件app.conf，并将其放入上述创建的目录中。
  1. wget https://raw.githubusercontent.com/casdoor/casdoor/main/conf/app.conf -O /casdoor/config/app.conf
  1. 配置数据库：编辑app.conf文件，配置数据库连接信息。Casdoor 支持多种数据库，以下以 MySQL 为例进行说明。

  • 确保已安装并运行 MySQL 数据库，并创建一个名为casdoor的数据库。

  • 在app.conf文件中，找到数据库相关配置项，修改为正确的数据库连接信息：

  1. driverName = mysqldataSourceName = root:123456@tcp(localhost:3306)/casdoor?charset=utf8mb4&parseTime=True&loc=LocaldbName = casdoor
  • 其中，root是数据库用户名，123456是密码，localhost是数据库主机地址，3306是端口号，casdoor是数据库名称。请根据实际情况进行修改。

三、启动 Casdoor 容器

  1. 使用包含前端和后端的镜像启动：执行以下命令启动 Casdoor 容器，将容器内的端口映射到服务器的端口（这里将容器的 8000 端口映射到服务器的 8000 端口），并挂载配置文件目录。
  1. docker run -d --name casdoor -p 8000:8000 -v /casdoor/config:/casdoor/conf casdoor/casdoor:latest
  1. 使用仅包含后端的镜像启动：如果选择仅后端镜像，还需要启动前端容器。
  • 首先启动后端容器：
  1. docker run -d --name casdoor-backend -p 7001:7001 -v /casdoor/config:/casdoor/conf casdoor/casdoor-backend:latest
  • 然后启动前端容器，将前端容器连接到后端容器：
  1. docker run -d --name casdoor-frontend -p 8000:8000 --link casdoor-backend:casdoor-backend casdoor/casdoor-frontend:latest

四、访问 Casdoor

在浏览器中输入服务器的 IP 地址和映射的端口号（例如http://服务器IP:8000），即可访问 Casdoor。使用默认的全局管理员账户built - in/admin和密码admin123登录 Casdoor 管理界面，开始配置和使用 Casdoor 平台。

五、常见问题及解决方法

  1. 数据库连接失败：检查app.conf文件中的数据库配置信息是否正确，确保数据库服务正常运行，并且数据库用户具有足够的权限。

  2. 端口冲突：如果启动容器时提示端口冲突，可修改映射的端口号，例如将-p 8000:8000改为-p 8080:8000，将容器的 8000 端口映射到服务器的 8080 端口。

通过以上步骤，你可以快速、便捷地使用 Docker 部署 Casdoor。如果在部署过程中遇到其他问题，可以参考 Casdoor 官方文档或在相关技术社区寻求帮助。以上内容涵盖了 Docker 部署 Casdoor 的核心步骤与关键要点。若你在部署中遇到具体问题，或想了解更多进阶配置，欢迎随时和我交流。