避坑指南：在Windows 11上用Docker Compose一键部署Casdoor（含MySQL和持久化配置）

Windows 11容器化部署Casdoor全攻略：告别环境配置噩梦

"明明按照文档一步步操作，为什么我的Casdoor就是跑不起来？"这可能是许多Windows开发者初次接触开源身份认证系统时的共同困惑。传统部署方式需要手动配置Go、Node.js、Yarn、MySQL等一系列环境，光是处理版本兼容性和依赖冲突就足以让人崩溃。本文将带你用Docker Compose彻底解决这些问题，只需一个命令就能在Windows 11上启动完整的Casdoor服务栈。

1. 为什么选择容器化部署Casdoor？

去年团队接了一个需要集成多平台登录的中型项目，当我按照官方文档在Windows上部署Casdoor开发环境时，先后遭遇了：

• Go版本不兼容导致编译失败
• Node.js与Yarn的版本冲突
• MySQL连接字符串配置错误
• 端口被占用导致服务无法启动

整整两天时间都浪费在环境调试上。直到尝试了Docker方案，才发现原来部署可以如此简单——所有依赖环境都被封装在容器里，完全隔离于主机系统。这种环境一致性正是Windows开发者最需要的。

容器化部署Casdoor的核心优势：

• 依赖隔离：每个服务运行在独立容器中，互不干扰
• 一键启停：docker-compose up/down命令管理全生命周期
• 快速迁移：相同的配置可在任何支持Docker的机器上运行
• 资源可控：精确限制CPU/内存使用量

提示：即使你从未使用过Docker，按照本指南操作也能在30分钟内完成部署。确保已安装Docker Desktop for Windows并启用WSL2后端。

2. 准备工作：Windows专属配置要点

在Windows 11上使用Docker需要特别注意以下几个关键点：

2.1 系统要求检查

• Windows 11 21H2或更高版本
• 已启用Hyper-V和WSL2（可通过PowerShell验证）

# 检查Hyper-V状态 dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart # 检查WSL2状态 wsl --list --verbose

2.2 磁盘权限配置

Windows的NTFS文件系统与Linux容器存在权限差异，建议：

1. 在Docker Desktop设置中启用"Use the WSL 2 based engine"
2. 将项目文件存放在WSL2子系统可访问的路径（如\\wsl$\挂载点）
3. 避免使用包含中文或空格的路径

2.3 端口冲突排查

Casdoor默认使用以下端口：

• 7001：前端访问端口
• 3306：MySQL数据库端口

使用以下命令检查端口占用情况：

netstat -ano | findstr "7001" tasklist | findstr "<PID>"

3. 编写docker-compose.yml全栈配置

下面是我们精心调优的Compose文件，已包含MySQL数据持久化和健康检查：

version: '3.8' services: casdoor: image: casbin/casdoor-all-in-one container_name: casdoor_app environment: - RUN_IN_DOCKER=true - DRIVER_NAME=mysql - DATA_SOURCE_NAME=db_user:db_password@tcp(mysql:3306)/casdoor volumes: - ./casdoor_data:/var/lib/casdoor ports: - "7001:8000" depends_on: mysql: condition: service_healthy restart: unless-stopped networks: - casdoor_net mysql: image: mysql:8.0 container_name: casdoor_mysql environment: MYSQL_ROOT_PASSWORD: root_password MYSQL_DATABASE: casdoor MYSQL_USER: db_user MYSQL_PASSWORD: db_password volumes: - mysql_data:/var/lib/mysql ports: - "3306:3306" healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] timeout: 20s retries: 10 restart: unless-stopped networks: - casdoor_net volumes: mysql_data: casdoor_data: networks: casdoor_net: driver: bridge

关键配置解析：

4. 部署实操与验证

4.1 启动全栈服务

1. 将上述YAML保存为docker-compose.yml
2. 在文件所在目录打开终端执行：

docker-compose up -d

首次运行会下载约800MB的镜像，视网络情况需要5-15分钟。启动完成后可以通过以下命令观察日志：

docker-compose logs -f

4.2 验证服务状态

检查各容器是否正常运行：

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

预期输出应包含两个状态为"Up"的容器：

NAMES STATUS PORTS casdoor_app Up 5 minutes 0.0.0.0:7001->8000/tcp casdoor_mysql Up 5 minutes 0.0.0.0:3306->3306/tcp

4.3 访问Casdoor面板

打开浏览器访问http://localhost:7001，使用默认凭证登录：

• 用户名：admin
• 密码：123

成功登录后应立即修改管理员密码，并在"系统设置"中完成以下关键配置：

1. 修改默认组织名称
2. 配置邮件/SMS提供商
3. 添加OAuth应用客户端ID和密钥

5. 生产环境进阶配置

5.1 数据备份策略

建议配置定期备份MySQL数据和Casdoor上传文件：

# 备份MySQL数据 docker exec casdoor_mysql sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > backup.sql # 备份上传文件 Compress-Archive -Path .\casdoor_data -DestinationPath .\casdoor_backup.zip

5.2 性能调优参数

在高并发场景下，可调整Compose文件中的资源限制：

services: casdoor: deploy: resources: limits: cpus: '2' memory: 2G environment: - GOMAXPROCS=2

5.3 HTTPS配置

使用Nginx反向代理配置SSL证书：

server { listen 443 ssl; server_name sso.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://casdoor_app:8000; proxy_set_header Host $host; } }

6. 与传统部署方案对比

我们在相同硬件配置的Windows 11机器上进行了性能测试：

实际使用中发现，容器化方案特别适合以下场景：

• 团队协作开发时保持环境统一
• 需要频繁切换不同版本进行测试
• 在本地模拟生产环境架构