重要提示

⚠️⚠️⚠️ 此镜像由社区志愿者维护，专为专家级使用设计。如需快速部署并支持完整Nextcloud Hub功能，请使用Nextcloud GmbH维护的Nextcloud All-in-One容器。

快速参考

• 维护者：
  Nextcloud社区

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应Dockerfile链接

• 30.0.16-apache, 30.0-apache, 30-apache, 30.0.16, 30.0, 30
• 30.0.16-fpm, 30.0-fpm, 30-fpm
• 30.0.16-fpm-alpine, 30.0-fpm-alpine, 30-fpm-alpine
• 31.0.9-apache, 31.0-apache, 31-apache, stable-apache, production-apache, 31.0.9, 31.0, 31, stable, production
• 31.0.9-fpm, 31.0-fpm, 31-fpm, stable-fpm, production-fpm
• 31.0.9-fpm-alpine, 31.0-fpm-alpine, 31-fpm-alpine, stable-fpm-alpine, production-fpm-alpine
• 32.0.0-apache, 32.0-apache, 32-apache, apache, 32.0.0, 32.0, 32, latest
• 32.0.0-fpm, 32.0-fpm, 32-fpm, fpm
• 32.0.0-fpm-alpine, 32.0-fpm-alpine, 32-fpm-alpine, fpm-alpine

镜像概述

Nextcloud是一个安全的数据存储与共享平台，支持从任何设备访问和管理文件、日历、联系人、邮件等数据。本Docker镜像为社区维护的微服务版本，适用于专家级部署，提供灵活的配置选项，但Nextcloud GmbH不提供官方支持。该镜像针对s390x架构构建，是官方Nextcloud镜像的特定架构版本。

核心功能与特性

• 多版本支持：提供apache（含Web服务器）和fpm（FastCGI进程）两种镜像版本，满足不同部署需求。
• 外部数据库集成：支持MySQL/MariaDB、PostgreSQL等外部数据库，替代默认SQLite。
• 持久化存储：通过Docker卷实现数据持久化，包括应用文件、配置、用户数据等。
• 环境变量自动配置：支持通过环境变量预配置数据库连接、管理员账户、Redis缓存、SMTP邮件服务等。
• 钩子机制：提供pre-installation、post-upgrade等钩子文件夹，支持部署前后自定义脚本执行。
• 反向代理兼容：支持通过环境变量配置反向代理信任、主机名及协议覆盖。

使用场景与适用范围

适用于需要自定义微服务架构的专家用户，用于构建安全可控的数据管理平台。不推荐新手使用，建议需要完整功能支持和简易部署的用户选择Nextcloud官方All-in-One容器。

使用方法与配置说明

基础镜像选择

apache镜像

包含完整Nextcloud及Apache Web服务器，暴露80端口，适合快速启动：

$ docker run -d -p 8080:80 s390x/nextcloud

访问http://localhost:8080即可进入Nextcloud初始化页面。

fpm镜像

基于php-fpm，需配合外部Web服务器（如Nginx）反向代理至9000端口：

$ docker run -d s390x/nextcloud:fpm

注意：fpm镜像无法直接提供静态文件服务，需Web服务器通过卷挂载访问/var/www/html目录。

持久化数据配置

Nextcloud数据默认存储于/var/www/html匿名卷，建议使用命名卷或主机目录挂载以确保数据持久化：

Nextcloud数据卷

$ docker run -d \
  -v nextcloud:/var/www/html \
  s390x/nextcloud

数据库数据卷（以MariaDB为例）

$ docker run -d \
  -v db:/var/lib/mysql \
  mariadb:10.6

细分数据卷

支持挂载细分目录以实现精细化管理：

$ docker run -d \
  -v nextcloud:/var/www/html \           # 主目录（升级必需）
  -v apps:/var/www/html/custom_apps \    # 自定义应用
  -v config:/var/www/html/config \       # 配置文件
  -v data:/var/www/html/data \           # 用户数据
  -v theme:/var/www/html/themes/mytheme \ # 自定义主题
  s390x/nextcloud

外部数据库配置

默认使用SQLite，推荐通过环境变量或初始化向导配置外部数据库：

环境变量自动配置（MySQL/MariaDB）

$ docker run -d \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud \
  -e MYSQL_PASSWORD=dbpass \
  -e MYSQL_HOST=db \
  --link db:db \
  s390x/nextcloud

支持的数据库环境变量

• SQLite：SQLITE_DATABASE（数据库名）
• MySQL/MariaDB：MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD、MYSQL_HOST
• PostgreSQL：POSTGRES_DB、POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_HOST

Nextcloud命令行工具（occ）

通过容器执行occ命令管理Nextcloud（需指定www-data用户）：

$ docker exec --user www-data CONTAINER_ID php occ

示例：列出用户

$ docker exec --user www-data CONTAINER_ID php occ user:list

环境变量自动配置

管理员账户

预配置管理员账户（需同时设置）：

$ docker run -d \
  -e NEXTCLOUD_ADMIN_USER=admin \
  -e NEXTCLOUD_ADMIN_PASSWORD=adminpass \
  s390x/nextcloud

数据目录

自定义数据存储路径：

$ docker run -d \
  -e NEXTCLOUD_DATA_DIR=/var/www/html/mydata \
  -v data:/var/www/html/mydata \
  s390x/nextcloud

可信域名

设置允许访问的域名列表：

$ docker run -d \
  -e NEXTCLOUD_TRUSTED_DOMAINS="example.com localhost 192.168.1.1" \
  s390x/nextcloud

Redis缓存配置

启用Redis以解决文件锁定问题：

$ docker run -d \
  -e REDIS_HOST=redis \
  -e REDIS_HOST_PASSWORD=redispass \
  --link redis:redis \
  s390x/nextcloud

SMTP邮件服务

配置外部SMTP服务器发送邮件：

$ docker run -d \
  -e SMTP_HOST=smtp.example.com \
  -e SMTP_SECURE=tls \
  -e SMTP_PORT=587 \
  -e SMTP_NAME=*** \
  -e SMTP_PASSWORD=smtppass \
  -e MAIL_FROM_ADDRESS=user \
  -e MAIL_DOMAIN=example.com \
  s390x/nextcloud

钩子文件夹使用

通过挂载钩子目录执行自定义脚本，支持以下钩子：

• pre-installation：安装前
• post-installation：安装后
• pre-upgrade：升级前
• post-upgrade：升级后
• before-starting：启动前

示例：挂载主机脚本目录至钩子文件夹

services:
  app:
    image: s390x/nextcloud:stable
    volumes:
      - ./hooks/pre-installation:/docker-entrypoint-hooks.d/pre-installation
      - ./hooks/post-upgrade:/docker-entrypoint-hooks.d/post-upgrade

要求：脚本需位于钩子目录根级，以.sh结尾且可执行。

反向代理配置

通过环境变量配置反向代理信任及协议覆盖：

信任代理IP

$ docker run -d \
  -e APACHE_DISABLE_REWRITE_IP=1 \
  -e TRUSTED_PROXIES="192.168.1.0/24 172.17.0.1" \
  s390x/nextcloud

覆盖主机名及协议

$ docker run -d \
  -e OVERWRITEHOST=cloud.example.com:443 \
  -e OVERWRITEPROTOCOL=https \
  s390x/nextcloud

Docker Compose示例

apache+MariaDB基础配置

volumes:
  nextcloud:
  db:

services:
  db:
    image: mariadb:10.6
    restart: always
    command: --transaction-isolation=READ-COMMITTED --log-bin=binlog --binlog-format=ROW
    volumes:
      - db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass  # 替换为安全密码
      - MYSQL_PASSWORD=dbpass         # 替换为安全密码
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud

  app:
    image: s390x/nextcloud
    restart: always
    ports:
      - 8080:80
    links:
      - db
    volumes:
      - nextcloud:/var/www/html
    environment:
      - MYSQL_PASSWORD=dbpass
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_HOST=db

启动服务：

$ docker compose up -d

访问http://localhost:8080完成初始化。

问题反馈与支持

• ** issue提交**：Nextcloud Docker GitHub
• 社区帮助：Docker Community Slack、Server Fault、Stack Overflow