Nextcloud 镜像文档

镜像概述和主要用途

本镜像基于 nextcloud:stable-fpm-alpine 构建，添加了自定义入口点脚本。主要用于通过环境变量自动化执行 Nextcloud 的 occ 命令，简化 Nextcloud 实例的配置与维护流程。Dockerfile 及构建脚本见：[***]

核心功能和特性

1. 自定义入口点脚本

启动时，系统会过滤环境变量中键以 php_occ_ 为前缀的变量，其值将作为 occ 命令参数执行，具体命令格式为：
php /var/www/html/occ ${value}

2. 优化的 PHP FPM 配置

调整了 PHP FPM 配置以支持更多子进程，提升并发处理能力，具体配置如下：

[www]
pm = dynamic
pm.max_children = 128
pm.start_servers = 8
pm.min_spare_servers = 8
pm.max_spare_servers = 16

核心功能和特性详情

• 基于官方稳定版：保留 nextcloud:stable-fpm-alpine 的基础功能，确保兼容性和稳定性。
• 自动化 occ 命令执行：通过环境变量定义启动时需执行的 occ 命令，无需手动操作。
• 性能优化：调整 PHP FPM 子进程参数，适应更高并发场景。

使用场景和适用范围

适用于需要在 Nextcloud 启动阶段自动执行 occ 命令的场景，例如：

• 初始化管理员设置（如邮箱配置）
• 数据库维护（添加缺失列、索引、主键）
• 文件系统清理（文件、远程存储共享清理）
• 应用更新（批量更新所有应用）
• 系统配置自定义（如设置共享文件夹路径）

适合需要自动化部署、配置或维护 Nextcloud 实例的用户或企业。

使用方法和配置说明

Docker Compose 示例

以下是 不完整 的 docker-compose.yml 文件，用于演示基本用法（实际部署需补充数据库、网络、卷挂载等配置）：

services:
  nextcloud_app:
    container_name: nextcloud_app
    image: p1st/nextcloud:stable-fpm-alpine
    environment:
      ### 启动时执行的 occ 命令 ###
      - php_occ_1=user:setting <admin_username> settings email <admin_email_address>  # 配置管理员邮箱
      - php_occ_2=db:add-missing-columns  # 添加缺失的数据库列
      - php_occ_3=db:add-missing-indices  # 添加缺失的数据库索引
      - php_occ_4=db:add-missing-primary-keys  # 添加缺失的数据库主键
      - php_occ_5=files:cleanup  # 清理文件系统
      - php_occ_6=sharing:cleanup-remote-storages  # 清理远程存储共享
      - php_occ_7=app:update --all  # 更新所有应用
      - php_occ_8=config:system:set --type=string --value '/shared' 'share_folder'  # 设置共享文件夹路径

环境变量配置说明

• 前缀规则：环境变量键需以 php_occ_ 为前缀，后跟数字（如 php_occ_1、php_occ_2），命令将按数字顺序执行。
• 值格式：变量值为完整的 occ 命令参数（无需包含 php /var/www/html/occ 前缀）。

PHP FPM 配置详情

镜像调整了 PHP FPM 的 www 池配置，具体参数如下（优化子进程管理，提升并发处理能力）：

[www]
pm = dynamic  # 动态进程管理模式
pm.max_children = 128  # 最大子进程数
pm.start_servers = 8  # 启动时的初始子进程数
pm.min_spare_servers = 8  # 最小空闲子进程数
pm.max_spare_servers = 16  # 最大空闲子进程数