在Windows 11上部署青龙面板的注意事项
项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong 青龙面板(Qinglong)是一款基于Node.js开发的定时任务管理工具，广泛应用于自动化脚本执行场景。本文将详细介绍在Windows 11操作系统上通过Docker部署青龙面板时可能遇到的问题及解决方案。
环境准备
在Windows 11上部署青龙面板前，需要确保已安装以下组件：
- Docker Desktop for Windows
- Windows Terminal或PowerShell
- 系统内存建议至少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
关键参数解析
- 路径映射：Windows系统需要使用
$(pwd -W)来获取当前目录的Windows风格路径，确保Docker能正确识别 - 端口映射：5700端口是青龙面板的默认访问端口
- 环境变量：QlPort指定了容器内部使用的端口号
- 重启策略：unless-stopped确保容器在Docker服务重启后自动恢复
注意事项
- 避免在命令中包含
-e QlBaseUrl="/"参数，这可能导致路由问题 - Windows路径需要使用正斜杠(/)而非反斜杠()
- 首次启动可能需要较长时间等待容器初始化完成
- 确保5700端口未被其他应用程序占用
验证部署
成功部署后，可以通过以下方式验证：
- 访问http://localhost:5700应显示青龙面板登录页面
- 使用
docker ps命令查看容器运行状态 - 检查日志确认无报错信息：
docker logs qinglong
通过遵循上述指导，用户可以在Windows 11系统上顺利完成青龙面板的Docker部署，避免常见的配置错误。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
