Nextcloud在宝塔面板安装失败主因是MySQL 8.0+默认认证插件不兼容，需改用5.7版本或切换为mysql_native_password；同时须调大Nginx与PHP上传限制、正确配置Redis、修复cron权限及执行用户。
宝塔面板里装 Nextcloud 为什么总卡在“数据库连接失败”
根本原因是宝塔默认的 MySQL 8.0+ 使用 caching_sha2_password 认证插件，而 Nextcloud 官方一键脚本（含宝塔应用商店里的“Nextcloud”插件）仍依赖旧版 mysql_native_password。不改就必然报错 Connection refused 或 Authentication plugin 'caching_sha2_password' cannot be loaded。
实操建议：
- 安装前先进宝塔 → 数据库 → 新建数据库时，手动把「MySQL 版本」选为
5.7（哪怕你服务器装的是 8.0，宝塔支持多版本共存） - 如果已用 8.0 创建了库，进终端执行：
ALTER USER 'nextcloud'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 别用宝塔「PHP 管理」里默认开启的
opcache.enable=1，Nextcloud 会因缓存冲突导致白屏，先关掉再装
Nextcloud 一键部署后上传大文件直接 500 或中断
不是 Nextcloud 的锅，是宝塔 Nginx 默认限制了请求体大小和超时时间，而 Nextcloud 大文件上传必须穿透这两层。
实操建议：
- 进宝塔 → 网站 → 你的 Nextcloud 域名 → 配置文件，在
server块里加三行： client_max_body_size 10G;fastcgi_read_timeout 3600;proxy_read_timeout 3600;- 同时检查 PHP 设置：宝塔 → PHP 设置 → 上传限制 → 把
upload_max_filesize和post_max_size都调到10G（注意单位是G，不是GB）
启用 Redis 缓存后登录变慢甚至 502
宝塔自带的 Redis 是单机默认配置，Nextcloud 要求它必须支持 php-redis 扩展且连接方式匹配，否则反而拖垮性能。
实操建议：
- 确认 PHP 已安装
redis扩展（宝塔 → PHP 设置 → 安装扩展 → 勾选redis） - Nextcloud 的
config/config.php里必须写成数组形式，不能只写 IP： 'memcache.distributed' => '\OC\Memcache\Redis','memcache.locking' => '\OC\Memcache\Redis','redis' => [ 'host' => '127.0.0.1', 'port' => 6379, 'timeout' => 0, ],- 别用 Unix socket（
/tmp/redis.sock），宝塔下容易权限错乱
升级 Nextcloud 后 cron.php 不执行或报错 “Access denied”
宝塔定时任务默认以 www 用户运行，但 Nextcloud 的 data/ 目录权限常被设为 root 或 www-data，导致 cron 无法写日志或锁文件。
实操建议：
- 进网站根目录，执行：
chown -R www:www nextcloud/（假设你的站点用户是www） - 宝塔定时任务命令必须完整带 PHP 路径和用户切换：
/www/server/php/80/bin/php -f /www/wwwroot/your-domain.com/cron.php - 频率别设太密——Nextcloud 官方建议至少
*/15 * * * *（每 15 分钟），设成* * * * *反而触发并发锁死
最常被忽略的是：宝塔「计划任务」里「执行用户」必须选 www，而不是默认的 root；否则即使路径对、权限对，cron 仍会因用户上下文不一致静默失败。
