Win10 Docker部署青龙面板：从零到一的保姆级避坑指南

1. 为什么要在Win10上用Docker跑青龙面板青龙面板是一款开源的定时任务管理工具特别适合用来管理各种签到脚本。我最早是在树莓派上接触它的后来发现用Docker部署简直不要太方便。在Win10上部署最大的好处就是不用折腾虚拟机也不用装双系统对新手特别友好。记得我第一次尝试时照着网上的教程操作结果卡在WSL2配置这一步整整两天。后来才发现是因为没开BIOS里的虚拟化支持。这种坑踩多了就特别想写一份真正适合小白的教程。下面我会把每个步骤都拆解得特别细连右键菜单怎么点都会截图说明。2. 部署前的准备工作2.1 检查系统版本和硬件支持首先右键点击此电脑选择属性确认你的Win10版本是1903或更高。我见过有人用1809版本死活装不上WSL2升级系统后秒解决。同时按CtrlShiftEsc打开任务管理器在性能标签页查看虚拟化是否已启用。如果显示禁用需要重启进BIOS开启。不同主板的设置位置不一样常见的有Intel平台叫Intel Virtualization TechnologyAMD平台叫SVM Mode 开启后保存退出重新进入系统验证。2.2 安装WSL2和Docker Desktop在微软商店搜索Windows Subsystem for Linux安装默认的Ubuntu发行版。然后以管理员身份运行PowerShell输入wsl --set-default-version 2接着去Docker官网下载Docker Desktop安装包。安装时一定要勾选Use WSL 2 instead of Hyper-V这个选项不然会出现各种兼容性问题。安装完成后在系统托盘右键Docker图标选择Settings确保Resources WSL Integration里勾选了Ubuntu。注意如果安装后启动报错可能是没关闭杀毒软件。特别是某数字卫士经常拦截Docker服务。3. 青龙面板的Docker部署实战3.1 拉取镜像和创建容器打开命令提示符不是PowerShell运行以下命令拉取最新镜像docker pull whyour/qinglong:latest这个镜像是青龙面板的官方维护版本我对比过几个衍生版本这个最稳定。创建容器时要注意端口和目录映射docker run -dit \ -v /qinglong/config:/ql/config \ -v /qinglong/scripts:/ql/scripts \ -v /qinglong/log:/ql/log \ -p 5700:5700 \ --name qinglong \ --hostname qinglong \ --restart always \ whyour/qinglong:latest这里有个新手容易踩的坑Win10下的路径要写成/qinglong而不是C:\qinglong因为实际挂载的是WSL子系统里的路径。3.2 初始化配置在浏览器访问http://localhost:5700首次打开会进入安装向导。重点说几个关键设置账号密码建议不要用默认的admin/admin通知设置可以跳过后续再加依赖安装一定要勾选Python3和Node.js初始化完成后建议立即去配置文件里修改时区为Asia/Shanghai否则定时任务会按UTC时间执行。4. 常见问题排查指南4.1 端口冲突问题如果5700端口被占用比如我之前装过Jellyfin可以改用其他端口。修改docker run命令的-p参数比如-p 5701:5700然后通过http://localhost:5701访问。查看端口占用情况的命令netstat -ano | findstr 57004.2 挂载目录权限问题有时候会发现脚本无法写入挂载目录这是因为WSL2的权限机制。解决方法是在Ubuntu子系统中手动创建目录并赋权sudo mkdir -p /qinglong/{config,scripts,log} sudo chmod -R 777 /qinglong4.3 容器自动停止这种情况我遇到过两次一次是因为内存不足WSL2默认只分配50%内存需要在.wslconfig文件中调整[wsl2] memory4GB swap2GB另一次是因为Windows休眠导致WSL崩溃建议关闭快速启动功能控制面板 电源选项 选择电源按钮的功能 更改当前不可用的设置 取消勾选启用快速启动。5. 进阶使用技巧5.1 多容器管理如果需要同时运行多个青龙实例比如区分工作和个人用途可以用docker-compose来管理。创建一个docker-compose.yml文件version: 3 services: qinglong_work: image: whyour/qinglong:latest container_name: qinglong_work ports: - 5700:5700 volumes: - /qinglong/work/config:/ql/config - /qinglong/work/scripts:/ql/scripts restart: always qinglong_personal: image: whyour/qinglong:latest container_name: qinglong_personal ports: - 5701:5700 volumes: - /qinglong/personal/config:/ql/config - /qinglong/personal/scripts:/ql/scripts restart: always然后运行docker-compose up -d即可同时启动两个实例。5.2 备份与恢复最稳妥的备份方式是直接打包WSL发行版wsl --export Ubuntu qinglong_backup.tar恢复时用wsl --import Ubuntu_new C:\wsl\Ubuntu_new qinglong_backup.tar如果只是需要备份青龙配置可以直接复制/qinglong/config目录下的文件。我习惯用这个命令打包tar -czvf qinglong_config_backup.tar.gz -C /qinglong/config .6. 日常维护建议青龙面板跑久了容易积累日志文件建议设置定期清理。最简单的方法是在面板里添加一个定时任务每周执行ql rmlog 7这个命令会删除7天前的日志。对于Docker本身建议每月执行一次系统清理docker system prune -f监控容器资源占用也很重要我常用这个命令查看状态docker stats --format table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}遇到面板卡顿的情况可以先尝试重启容器docker restart qinglong如果还是不行可能是数据库文件损坏需要进入容器修复docker exec -it qinglong bash cd /ql/config sqlite3 data.db .recover | sqlite3 data.db.fixed mv data.db.fixed data.db