在Windows 11上部署青龙面板的注意事项

青龙面板(Qinglong)是一款基于Node.js开发的定时任务管理工具，广泛应用于自动化脚本执行场景。本文将详细介绍在Windows 11操作系统上通过Docker部署青龙面板时可能遇到的问题及解决方案。

环境准备

在Windows 11上部署青龙面板前，需要确保已安装以下组件：

1. Docker Desktop for Windows
2. Windows Terminal或PowerShell
3. 系统内存建议至少8GB

常见部署问题

许多用户在Windows 11上使用Docker部署青龙面板时会遇到访问5700端口显示Nginx默认页面而非青龙面板首页的情况。这通常是由于路径映射或环境变量配置不当导致的。

正确的部署命令

经过验证，在Windows 11上正确部署青龙面板的命令如下：

docker run -dit \
  -v "/$(pwd -W)/ql/data:/ql/data" \
  -p 5700:5700 \
  -e QlPort="5700" \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

关键参数解析

1. 路径映射：Windows系统需要使用$(pwd -W)来获取当前目录的Windows风格路径，确保Docker能正确识别
2. 端口映射：5700端口是青龙面板的默认访问端口
3. 环境变量：QlPort指定了容器内部使用的端口号
4. 重启策略：unless-stopped确保容器在Docker服务重启后自动恢复

注意事项

1. 避免在命令中包含-e QlBaseUrl="/"参数，这可能导致路由问题
2. Windows路径需要使用正斜杠(/)而非反斜杠()
3. 首次启动可能需要较长时间等待容器初始化完成
4. 确保5700端口未被其他应用程序占用

验证部署

成功部署后，可以通过以下方式验证：

1. 访问http://localhost:5700应显示青龙面板登录页面
2. 使用docker ps命令查看容器运行状态
3. 检查日志确认无报错信息：docker logs qinglong

通过遵循上述指导，用户可以在Windows 11系统上顺利完成青龙面板的Docker部署，避免常见的配置错误。