OpenList 安装问题告警与解决方案
发布日期：2026-05-17
影响范围：部分 CentOS 9 + Docker 环境的 1Panel 服务器
问题描述
在 1Panel 应用商店安装 OpenList v4.2.1 时，出现以下错误导致安装失败：
failed to extract layer ... failed to mount overlay ... invalid argument
该错误源于 Docker 存储驱动 overlay2 在部分虚拟化/文件系统上不兼容。
已完成的临时对策

将 Docker 存储驱动切换为 vfs（兼容性更好）。
清理旧驱动数据并重启 Docker。
在 1Panel 中重新勾选“External access”确保外网可访问。

自助解决步骤
1) 切换 Docker 存储驱动为 vfs
systemctl stop docker
echo '{"storage-driver":"vfs"}' > /etc/docker/daemon.json
rm -rf /var/lib/docker
systemctl start docker
2) 在 1Panel 应用商店重装 OpenList 并勾选 External access
3) 手动安装备选命令见原公告
详情请查看完整公告文件。