ppc64le/nextcloud

Nextcloud Docker镜像（ppc64le架构）

重要说明

⚠️⚠️⚠️ 此镜像由社区志愿者维护，专为专家级使用设计。如需快速轻松部署并支持全套Nextcloud Hub功能，请使用由Nextcloud GmbH维护的https://github.com/nextcloud/all-in-one#nextcloud-all-in-one%E3%80%82

快速参考

• 维护者：
  https://github.com/nextcloud/docker

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

• 提交问题：
  https://github.com/nextcloud/docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/nextcloud/%E3%80%81https://hub.docker.com/r/arm32v5/nextcloud/%E3%80%81https://hub.docker.com/r/arm32v6/nextcloud/%E3%80%81https://hub.docker.com/r/arm32v7/nextcloud/%E3%80%81https://hub.docker.com/r/arm64v8/nextcloud/%E3%80%81https://hub.docker.com/r/i386/nextcloud/%E3%80%81https://hub.docker.com/r/ppc64le/nextcloud/%E3%80%81https://hub.docker.com/r/riscv64/nextcloud/%E3%80%81https://hub.docker.com/r/s390x/nextcloud/

支持的标签及对应Dockerfile链接

• https://github.com/nextcloud/docker/blob/f5b7b40808604dd61411d0f7a775ac5ff29a974b/30/apache/Dockerfile
• https://github.com/nextcloud/docker/blob/f5b7b40808604dd61411d0f7a775ac5ff29a974b/30/fpm/Dockerfile
• https://github.com/nextcloud/docker/blob/f5b7b40808604dd61411d0f7a775ac5ff29a974b/30/fpm-alpine/Dockerfile
• https://github.com/nextcloud/docker/blob/f5b7b40808604dd61411d0f7a775ac5ff29a974b/31/apache/Dockerfile
• https://github.com/nextcloud/docker/blob/f5b7b40808604dd61411d0f7a775ac5ff29a974b/31/fpm/Dockerfile
• https://github.com/nextcloud/docker/blob/f5b7b40808604dd61411d0f7a775ac5ff29a974b/31/fpm-alpine/Dockerfile
• https://github.com/nextcloud/docker/blob/1f87830fd6f478c993248475979472aab1787a75/32/apache/Dockerfile
• https://github.com/nextcloud/docker/blob/1f87830fd6f478c993248475979472aab1787a75/32/fpm/Dockerfile
• https://github.com/nextcloud/docker/blob/1f87830fd6f478c993248475979472aab1787a75/32/fpm-alpine/Dockerfile

什么是Nextcloud？

Nextcloud是一个自托管的数据平台，可让您从任何设备访问和共享文件、日历、联系人、邮件等数据，完全由您掌控。

Nextcloud官网

此Docker微服务镜像由Nextcloud社区开发和维护，Nextcloud GmbH不为此Docker镜像提供支持。如需专业支持，可成为企业客户或使用https://github.com/nextcloud/all-in-one#nextcloud-all-in-one%E3%80%82

如何使用此镜像

该镜像设计用于微服务环境，提供两种版本：

• apache标签：包含完整Nextcloud安装和Apache Web服务器，易于使用，快速部署，是latest标签及未指定后缀版本标签的默认选择。
• fpm标签：基于https://hub.docker.com/_/php/%E9%95%9C%E5%83%8F%EF%BC%8C%E8%BF%90%E8%A1%8CFastCGI%E8%BF%9B%E7%A8%8B%EF%BC%8C%E9%9C%80%E9%85%8D%E5%90%88%E8%83%BD%E4%BB%A3%E7%90%86HTTP%E8%AF%B7%E6%B1%82%E8%87%B3FastCGI%E7%AB%AF%E5%8F%A3%E7%9A%84Web%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%BD%BF%E7%94%A8%E3%80%82

使用apache镜像

apache镜像包含Web服务器，暴露80端口。启动容器命令：

console
$ docker run -d -p 8080:80 ppc64le/nextcloud

启动后可通过http://localhost:8080/访问Nextcloud。

使用fpm镜像

fpm镜像需配合外部Web服务器（如Nginx）使用，暴露9000端口。启动容器命令：

console
$ docker run -d ppc64le/nextcloud:fpm

由于FastCGI进程无法处理静态文件（样式表、图片等），Web服务器需通过volumes-from选项访问这些文件（详见Docker Compose部分）。

使用外部数据库

默认情况下，容器使用SQLite存储数据，但Nextcloud设置向导（首次运行时出现）支持连接现有MySQL/MariaDB或PostgreSQL数据库。也可链接数据库容器（如--link my-mysql:mysql），设置时使用mysql作为数据库主机。

持久化数据

Nextcloud安装及数据库之外的数据（文件上传等）存储在未命名Docker卷/var/www/html中，即使容器崩溃、停止或删除，数据仍会保留。建议使用命名卷或主机目录挂载以方便升级和备份。

Nextcloud数据卷

• /var/www/html/：Nextcloud所有数据存储目录

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

数据库数据卷

• MySQL/MariaDB：/var/lib/mysql
• PostgreSQL：/var/lib/postgresql/data

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

额外卷

如需细粒度访问文件，可挂载以下额外卷：

• /var/www/html/custom_apps：已安装/修改的应用
• /var/www/html/config：本地配置
• /var/www/html/data：用户数据
• /var/www/html/themes/<YOUR_CUSTOM_THEME>：自定义主题

使用命名卷挂载所有这些目录的示例：

console
$ 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/<YOUR_CUSTOM_THEME> \
ppc64le/nextcloud

注意：/var/www/html目录下的数据在安装和升级时可能被覆盖/删除，除非在https://github.com/nextcloud/docker/blob/master/upgrade.exclude%E4%B8%AD%E5%88%97%E5%87%BA%E3%80%82%E5%AE%98%E6%96%B9%E6%94%AF%E6%8C%81%E7%9A%84%E9%A2%9D%E5%A4%96%E5%8D%B7%E5%B7%B2%E5%8C%85%E5%90%AB%E5%9C%A8%E5%86%85%EF%BC%8C%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8D%B7%E9%9C%80%E8%87%AA%E8%A1%8C%E6%B7%BB%E5%8A%A0%EF%BC%8C%E5%BB%BA%E8%AE%AE%E6%8C%82%E8%BD%BD%E5%88%B0%60/var/www/html%60%E4%B9%8B%E5%A4%96%E7%9A%84%E4%BD%8D%E7%BD%AE%E5%B9%B6%E8%AE%BE%E4%B8%BA%E5%8F%AA%E8%AF%BB%E3%80%82

使用Nextcloud命令行界面（occ）

执行occ命令：

console
$ docker exec --user www-data 容器ID php occ

Docker Compose环境：

console
$ docker compose exec --user www-data app php occ

通过环境变量自动配置

Nextcloud镜像支持通过环境变量自动配置，避免首次运行时的安装向导。需为所选数据库类型指定所有必要环境变量，支持SQLite、MySQL/MariaDB、PostgreSQL。

数据库配置

SQLite：

• SQLITE_DATABASE：SQLite数据库名称

MySQL/MariaDB：

• MYSQL_DATABASE：数据库名称
• MYSQL_USER：数据库用户名
• MYSQL_PASSWORD：数据库密码
• MYSQL_HOST：数据库主机名

PostgreSQL：

• POSTGRES_DB：数据库名称
• POSTGRES_USER：数据库用户名
• POSTGRES_PASSWORD：数据库密码
• POSTGRES_HOST：数据库主机名

管理员配置

指定管理员账户（需同时设置）：

• NEXTCLOUD_ADMIN_USER：管理员用户名
• NEXTCLOUD_ADMIN_PASSWORD：管理员密码

数据目录配置

• NEXTCLOUD_DATA_DIR：数据存储目录（默认：/var/www/html/data）

可信域名

• NEXTCLOUD_TRUSTED_DOMAINS：空格分隔的可信域名列表（默认未设置）

其他配置

• NEXTCLOUD_UPDATE：启用安装/更新（默认：0，仅在使用默认命令apache-foreground或php-fpm时触发）
• NEXTCLOUD_INIT_HTACCESS：设置为true以在容器初始化后执行occ maintenance:update:htaccess（默认未设置）
• REDIS_HOST：Redis容器名称（推荐用于防止文件锁定问题）
• REDIS_HOST_PORT：Redis端口（默认：6379）
• REDIS_HOST_PASSWORD：Redis密码（默认未设置）
• SMTP_HOST、SMTP_SECURE、SMTP_PORT等：SMTP服务器配置（用于邮件发送）
• PHP_MEMORY_LIMIT：PHP内存限制（默认：512M）
• PHP_UPLOAD_LIMIT：PHP上传限制（默认：512M）
• APACHE_BODY_LIMIT：Apache请求体大小限制（默认：1073741824 [1GiB]）

通过钩子文件夹自动配置

支持5种钩子，脚本需位于容器内/docker-entrypoint-hooks.d目录下对应子文件夹，以.sh结尾且可执行：

• pre-installation：Nextcloud安装/初始化前执行
• post-installation：Nextcloud安装/初始化后执行
• pre-upgrade：Nextcloud升级前执行
• post-upgrade：Nextcloud升级后执行
• before-starting：Nextcloud启动前执行

示例：通过卷挂载主机脚本

yaml
services:
  app:
    image: ppc64le/nextcloud:stable
    volumes:
      - ./app-hooks/pre-installation:/docker-entrypoint-hooks.d/pre-installation
      - ./app-hooks/post-installation:/docker-entrypoint-hooks.d/post-installation
      - ./app-hooks/pre-upgrade:/docker-entrypoint-hooks.d/pre-upgrade
      - ./app-hooks/post-upgrade:/docker-entrypoint-hooks.d/post-upgrade
      - ./app-hooks/before-starting:/docker-entrypoint-hooks.d/before-starting

在反向代理后使用apache镜像

默认情况下，apache镜像会将来自10.0.0.0/8、172.16.0.0/12或192.168.0.0/16网段代理的请求的远程地址替换为X-Real-IP。如需让Nextcloud从可信代理获取主机名、协议和客户端IP，需设置：

• APACHE_DISABLE_REWRITE_IP：设为1禁用IP重写
• TRUSTED_PROXIES：空格分隔的可信代理列表（支持IPv4 CIDR表示法）

也可通过以下环境变量设置固定覆盖参数：

• OVERWRITEHOST：代理主机名（可带端口）
• OVERWRITEPROTOCOL：代理协议（http或https）
• OVERWRITECLIURL：代理CLI URL（如https://mydnsname.example.com）
• OVERWRITEWEBROOT：代理绝对路径
• OVERWRITECONDADDR：基于远程地址覆盖值的正则表达式

使用Docker Compose运行

使用compose.yaml文件可快速搭建完整功能的Nextcloud环境，以下为基础示例。

基础版本（apache + MariaDB）

此配置使用apache镜像和MariaDB容器，卷用于持久化数据，无SSL加密，适用于代理后运行。运行前需设置MYSQL_ROOT_PASSWORD和MYSQL_PASSWORD的值。

yaml
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=设置_root密码
      - MYSQL_PASSWORD=设置_nextcloud数据库密码
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud

  app:
    image: ppc64le/nextcloud
    restart: always
    ports:
      - 8080:80
    links:
      - db
    volumes:
      - nextcloud:/var/www/html
    environment:
      - MYSQL_PASSWORD=设置_nextcloud数据库密码
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_HOST=db

启动命令：

console
$ docker compose up -d

启动后通过http://localhost:8080/访问Nextcloud。

快速参考（补充）

• 维护者：https://github.com/nextcloud/docker
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux、Stack Overflow
• 提交问题：https://github.com/nextcloud/docker/issues?q=
• 支持架构：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
• 镜像更新：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fnextcloud
• 描述来源：https://github.com/docker-library/docs/tree/master/nextcloud