riscv64/nextcloud

Nextcloud Docker镜像文档

重要提示

⚠️⚠️⚠️ 此镜像由社区志愿者维护，专为专家用户设计。如需快速部署并支持完整的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

支持的标签及对应Dockerfile链接

• https://github.com/nextcloud/docker/blob/efa6ee645631d34047625a82dfddd083324628ef/32/apache/Dockerfile

• https://github.com/nextcloud/docker/blob/efa6ee645631d34047625a82dfddd083324628ef/32/fpm/Dockerfile

• https://github.com/nextcloud/docker/blob/efa6ee645631d34047625a82dfddd083324628ef/32/fpm-alpine/Dockerfile

• https://github.com/nextcloud/docker/blob/efa6ee645631d34047625a82dfddd083324628ef/33/apache/Dockerfile

• https://github.com/nextcloud/docker/blob/efa6ee645631d34047625a82dfddd083324628ef/33/fpm/Dockerfile

• https://github.com/nextcloud/docker/blob/efa6ee645631d34047625a82dfddd083324628ef/33/fpm-alpine/Dockerfile

快速参考（续）

• 问题反馈：
  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/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/nextcloud%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/nextcloud%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fnextcloud
  https://github.com/docker-library/official-images/blob/master/library/nextcloud%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/nextcloud%EF%BC%89

• 本文档来源：
  https://github.com/docker-library/docs/tree/master/nextcloud%EF%BC%88https://github.com/docker-library/docs/commits/master/nextcloud%EF%BC%89

什么是Nextcloud？

Nextcloud是一个安全的数据家园，可从任何设备访问和共享文件、日历、联系人、邮件等数据，完全由你掌控。

Nextcloud.com

此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%E5%A4%84%E7%90%86Nextcloud%E9%A1%B5%E9%9D%A2%E8%AF%B7%E6%B1%82%EF%BC%8C%E9%9C%80%E9%85%8D%E5%90%88%E8%83%BD%E5%B0%86HTTP%E8%AF%B7%E6%B1%82%E4%BB%A3%E7%90%86%E5%88%B0FastCGI%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 riscv64/nextcloud

此时可通过主机系统的 http://localhost:8080/ 访问Nextcloud。

使用fpm镜像

使用fpm镜像需额外Web服务器（如nginx）将HTTP请求代理到容器的FastCGI端口（9000）。通常建议通过Docker网络连接Web服务器容器（使用docker run --network <NAME> ...或compose.yaml文件），无需将fpm端口映射到主机。

console
$ docker run -d riscv64/nextcloud:fpm

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

使用外部数据库

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

持久化数据

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

Nextcloud卷

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

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

数据库卷

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

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

额外卷

如需细粒度访问文件，可挂载以下子目录作为卷：

• /var/www/html：主目录，升级必需
• /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> \
riscv64/nextcloud

自定义卷注意事项

在/var/www/html下挂载额外卷时，需注意：

• 确认https://github.com/nextcloud/docker/blob/master/upgrade.exclude%E5%8C%85%E5%90%AB%E5%AE%89%E8%A3%85%E5%92%8C%E5%8D%87%E7%BA%A7%E6%9C%9F%E9%97%B4%E9%9C%80%E4%BF%9D%E7%95%99%E7%9A%84%E6%96%87%E4%BB%B6/%E6%96%87%E4%BB%B6%E5%A4%B9%EF%BC%9B
• 或挂载到/var/www/html外部位置。

注意：/var/www/html内的数据在安装和升级时可能被覆盖/删除，除非列在https://github.com/nextcloud/docker/blob/master/upgrade.exclude%E4%B8%AD%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%9C%A8%E5%88%97%E8%A1%A8%E4%B8%AD%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%E3%80%82%E5%BB%BA%E8%AE%AE%E5%B0%86%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8D%B7%E6%8C%82%E8%BD%BD%E5%88%B0%60/var/www/html%60%E5%A4%96%E9%83%A8%EF%BC%8C%E4%B8%94%E5%B0%BD%E5%8F%AF%E8%83%BD%E8%AE%BE%E4%B8%BA%E5%8F%AA%E8%AF%BB%EF%BC%8C%E9%81%BF%E5%85%8D%E8%B0%83%E6%95%B4%E9%85%8D%E7%BD%AE%E3%80%82%E5%A6%82%E9%9C%80%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8D%B7%EF%BC%8C%E5%8F%AF%E6%9E%84%E5%BB%BA%E5%8C%85%E5%90%AB%E4%BF%AE%E6%94%B9%E5%90%8E%60/upgrade.exclude%60%E6%96%87%E4%BB%B6%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89%E9%95%9C%E5%83%8F%E3%80%82

使用Nextcloud命令行界面（occ）

使用Nextcloud命令行界面（occ命令）：

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

或使用docker compose：

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

通过环境变量自动配置

Nextcloud镜像支持通过环境变量自动配置，可预设置首次运行安装页面的所有选项。需为数据库类型指定所有必要环境变量，否则默认使用SQLite。仅使用一种数据库类型！

SQLite

• SQLITE_DATABASE：SQLite数据库名称

MySQL/MariaDB

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

PostgreSQL

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

作为通过环境变量传递敏感信息的替代方式，可在上述变量后添加_FILE，使初始化脚本从容器内文件加载值（详见下文Docker secrets部分）。

配置数据库后，可通过以下变量设置管理员账户（需同时设置）：

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

设置数据目录（默认/var/www/html/data）：

• NEXTCLOUD_DATA_DIR：数据存储目录

设置可信域名（空格分隔列表）：

• NEXTCLOUD_TRUSTED_DOMAINS：可选，默认未设置

仅当使用默认命令（apache-foreground或php-fpm）时触发安装/更新脚本。使用自定义命令时，需设置：

• NEXTCLOUD_UPDATE：默认0，设为非0值启用安装/更新

更新容器后确保htaccess文件最新：

• NEXTCLOUD_INIT_HTACCESS：默认未设置，设为true启用occ maintenance:update:htaccess

Redis配置

需单独部署https://hub.docker.com/_/redis/%E5%AE%B9%E5%99%A8%EF%BC%8C%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E5%8F%98%E9%87%8F%E9%85%8D%E7%BD%AE%EF%BC%9A

• REDIS_HOST：Redis容器名称（默认未设置）
• REDIS_HOST_PORT：Redis端口（默认6379，仅用于非标准端口外部Redis）
• REDIS_HOST_PASSWORD：Redis密码（默认未设置）

推荐使用Redis防止文件锁定问题。

SMTP配置

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

• SMTP_HOST：SMTP服务器主机名（默认未设置）
• SMTP_SECURE：连接安全类型（默认空，ssl或tls）
• SMTP_PORT：端口（默认465（SSL）或25（非安全），587可用于STARTTLS）
• SMTP_AUTHTYPE：认证方式（默认LOGIN，PLAIN表示无需认证）
• SMTP_NAME：认证用户名（默认空）
• SMTP_PASSWORD：认证密码（默认空）
• MAIL_FROM_ADDRESS：发件人本地部分（默认未设置）
• MAIL_DOMAIN：发件人域名（默认未设置）

至少需设置SMTP_HOST、MAIL_FROM_ADDRESS和MAIL_DOMAIN。更多配置参见Nextcloud文档。

S3兼容对象存储作为主存储

设置以下变量：

• OBJECTSTORE_S3_BUCKET：存储数据的桶名称
• OBJECTSTORE_S3_REGION：桶所在区域
• OBJECTSTORE_S3_HOST：对象存储服务器主机名
• OBJECTSTORE_S3_PORT：对象存储服务器端口
• OBJECTSTORE_S3_KEY：AWS风格访问密钥
• OBJECTSTORE_S3_SECRET：AWS风格密钥
• OBJECTSTORE_S3_STORAGE_CLASS：对象存储类别
• OBJECTSTORE_S3_SSL：是否使用SSL/TLS（默认true）
• OBJECTSTORE_S3_USEPATH_STYLE：是否使用路径风格（默认false，AWS S3无需设置）
• OBJECTSTORE_S3_LEGACYAUTH：是否使用 legacy 认证（默认false，AWS S3无需设置）
• OBJECTSTORE_S3_OBJECT_PREFIX：文件ID前缀（默认urn:oid:）
• OBJECTSTORE_S3_AUTOCREATE：是否自动创建桶（默认true）
• OBJECTSTORE_S3_SSE_C_KEY：服务器端加密（SSE-C）的Base64编码密钥（最大32字节，默认未设置）

更多信息参见Nextcloud文档。

OpenStack Swift对象存储作为主存储

设置以下变量：

• OBJECTSTORE_SWIFT_URL：Swift身份（Keystone）端点
• OBJECTSTORE_SWIFT_AUTOCREATE：是否自动创建容器（默认false）
• OBJECTSTORE_SWIFT_USER_NAME：Swift用户名
• OBJECTSTORE_SWIFT_USER_PASSWORD：Swift用户密码
• OBJECTSTORE_SWIFT_USER_DOMAIN：Swift用户域（默认Default）
• OBJECTSTORE_SWIFT_PROJECT_NAME：OpenStack项目名称
• OBJECTSTORE_SWIFT_PROJECT_DOMAIN：OpenStack项目域（默认Default）
• OBJECTSTORE_SWIFT_SERVICE_NAME：Swift服务名称（默认swift）
• OBJECTSTORE_SWIFT_REGION：Swift端点区域
• OBJECTSTORE_SWIFT_CONTAINER_NAME：存储数据的Swift容器（桶）

更多信息参见Nextcloud文档。

PHP配置

自定义PHP限制：

• PHP_MEMORY_LIMIT：脚本允许分配的最大内存（默认512M）
• PHP_UPLOAD_LIMIT：上传限制（post_max_size和upload_max_filesize，默认512M），大文件上传可能需调整其他限制，参见Nextcloud文档

Apache配置

自定义Apache最大文件上传限制：

• APACHE_BODY_LIMIT：客户端HTTP请求体总大小限制（字节，默认1073741824 [1GiB]，0表示无限制），参见Nextcloud文档

通过钩子文件夹自动配置

提供5个钩子：

• pre-installation：Nextcloud安装/初始化前执行
• `post