必须确认三件事：docker命令可执行、/var/lib/docker磁盘空间≥20gb、当前用户对/usr/bin/docker有执行权限；centos 7/8和ubuntu 20.04+兼容，低版本因缺systemd支持无法启动dockerd。
宝塔里装Docker插件前必须确认的三件事
宝塔面板本身不自带Docker，得先装插件，但不是装了就能用。很多人卡在第一步，是因为忽略了系统兼容性和权限基础。
必须确认：docker 命令能直接执行、/var/lib/docker 所在磁盘空间充足（建议 ≥20GB）、当前用户对 /usr/bin/docker 有执行权限。CentOS 7/8 和 Ubuntu 20.04+ 没问题，但 CentOS 6 或 Debian 10 以下版本会缺 systemd 支持，dockerd 启不来。
- 运行
docker --version看是否返回版本号，否则重装 Docker 引擎（别用宝塔内置的“Docker管理器”插件，它只是个壳） -
df -h /var/lib/docker查剩余空间，Nextcloud 容器跑起来后日志、临时文件、镜像层叠加容易吃掉 5–10GB - 如果提示
permission denied，加sudo usermod -aG docker www（宝塔默认用www用户操作网站），然后newgrp docker刷新组权限
nextcloud 镜像选哪个？别直接 pull latest
官方 nextcloud:latest 实际指向的是 Apache + PHP 8.2 的镜像，但宝塔默认走 Nginx，两者共存会抢 80 端口，且 PHP 扩展加载路径不一致，极易导致 Class 'Redis' not found 或 OPcache not enabled 错误。
推荐明确指定镜像标签：
- 要省事：用
nextcloud:25-fpm（FPM 模式，不带 Web 服务器，交给宝塔 Nginx 反代） - 要稳定：用
nextcloud:24-fpm（LTS 版本，PHP 8.1，扩展兼容性更好） - 别碰
linuxserver/nextcloud这类第三方镜像——它默认把数据卷挂到/config和/data，和宝塔习惯的路径逻辑冲突，后期迁移极难
拉取命令：docker pull nextcloud:25-fpm
挂载目录怎么配才不踩坑？重点看 data 和 config
Nextcloud 对目录权限极其敏感，尤其 data 目录必须由 www-data（容器内用户）和宝塔的 www 用户（宿主机）同时可写。硬链接或符号链接在这里基本失效，必须用真实目录 + 正确 UID/GID。
-
/www/wwwroot/nextcloud/html：挂载容器的/var/www/html，放 Nextcloud 程序文件，权限设为755，属主www:www -
/www/wwwroot/nextcloud/data：挂载容器的/var/www/html/data，这是用户上传文件的实际落盘位置，必须设为770，属主www:www，且容器启动时加参数--user 33:33（33 是www-data的 UID/GID） -
/www/wwwroot/nextcloud/config：挂载容器的/var/www/html/config，存config.php，权限750即可，属主同上
典型 docker run 命令片段：docker run -d --name nc-app --user 33:33 -v /www/wwwroot/nextcloud/html:/var/www/html -v /www/wwwroot/nextcloud/data:/var/www/html/data -v /www/wwwroot/nextcloud/config:/var/www/html/config nextcloud:25-fpm
宝塔 Nginx 反代配置的关键字段不能少
容器只开 9000 端口（PHP-FPM），所有 HTTP 请求必须经宝塔 Nginx 转发过去。漏掉任一字段，就会出现白屏、AJAX 失败或登录后跳转 /login 循环。
在宝塔网站设置 → 反向代理 → 添加，目标 URL 填：http://127.0.0.1:9000，但必须手动补全以下配置（在“配置文件”里编辑）：
- 加
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，否则 PHP 找不到入口文件 - 加
fastcgi_param HTTPS on;（即使没开 SSL，Nextcloud 也依赖此判断协议类型，否则分享链接变http://） - 加
client_max_body_size 16G;（匹配容器内php.ini的upload_max_filesize） - 删掉默认的
location ~ \.php$块，改用宝塔自动生成的 FPM 模块配置，避免重复解析
改完重启 Nginx，再进容器执行 ls -l /var/www/html/data，确认 UID/GID 是 33，否则立刻停容器，chown -R 33:33 /www/wwwroot/nextcloud/data。
最常被忽略的是 data 目录的 UID 同步和 Nginx 的 HTTPS on 参数——前者导致上传失败且无报错，后者让整个信任域失效，连管理员后台都进不去。
