用途：Nextcloud 是自托管的云文件存储与协作平台，本资料聚焦其部署与运维，包括安装、occ 命令行管理、后台任务、文件扫描和应用管理。
进程与配置：它是 PHP Web 应用，没有单一守护进程，运行在 Web 服务器的 PHP-FPM 工作池中，不存在 nextcloud.service 可重启。CLI 工具为 occ，位于应用根目录（如 /var/www/nextcloud/occ），必须以 Web 服务器用户运行。Docker 下用 docker compose exec --user www-data nextcloud php occ <command>；裸机用 sudo -u www-data php /var/www/nextcloud/occ <command>。配置为 <nextcloud-root>/config/config.php（PHP 数组，非 INI）。数据目录由 config.php 的 datadirectory 指定，默认 <nextcloud-root>/data/。日志为 <data-dir>/nextcloud.log（JSON 行），也可查看 journalctl -u php-fpm 与 Web 服务器错误日志。推荐用 Docker Compose 安装，依赖 Web 服务器（nginx 或 Apache）、PHP-FPM、MariaDB/PostgreSQL 以及 Redis（多用户文件锁定必需）。Web 服务器用户为 www-data（Debian/Ubuntu）、apache（RHEL/Fedora）或容器内 www-data。
主要能力与常用命令：occ status 查看状态；occ update:check 检查升级；occ maintenance:mode --on/--off 开关维护模式；occ upgrade 升级；occ background:cron 手动运行后台任务；occ app:list/enable/disable/install 管理应用；occ user:list/add/resetpassword/delete 管理用户；occ files:scan username 或 --all 扫描文件；occ db:add-missing-indices、db:add-missing-columns、db:convert-filecache-bigint 维护数据库；occ cache:clear 清缓存；occ background:queue:status 与 background:job:execute 查看并执行后台任务；occ maintenance:repair 修复；occ config:system:set/get 读写配置；occ log:tail 查看日志。
期望状态与健康检查：维护模式关闭、后台任务为 cron 模式且每 5 分钟运行、管理面板无警告、Redis 已连接用于文件锁定、数据目录对 Web 服务器用户可写。可用 occ status 确认 installed: true、maintenance: false、needsDbUpgrade: false；用 occ background:queue:status 确认最近任务在 10 分钟内运行；用 curl -sI https://<hostname>/status.php 检查 JSON 中 installed:true。
常见故障与限制：数据目录权限错误需 chown -R www-data:www-data 并 chmod 750；OPcache 配置不当需调整 opcache.memory_consumption=128、opcache.revalidate_freq=0、opcache.save_comments=1；Redis 连接失败需检查服务、socket 路径与 php-redis 扩展；缺少 default_phone_region 或 maintenance_window_start 需用 occ config:system:set 设置；大版本升级必须逐级进行（如 27→28→29），每步运行 occ upgrade，不能跳版；多用户环境必须配置 Redis 文件锁定，否则并发写入可能损坏数据；后台任务默认 AJAX 模式不可靠，应改为系统 cron 或专用 cron 容器；occ 必须以 www-data 运行，用 root 运行会改变文件属主并破坏安装；大型实例升级可能耗时 10–60 分钟，升级前应开启维护模式且不可中断。裸机安装需匹配 PHP 版本与扩展，调试成本高，除非有特定理由否则优先 Docker Compose。