注意： 此镜像的描述超出了Docker Hub的25000字符限制，已被截断。完整描述可在[***] 这是nextcloud官方镜像的arm32v5架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“除amd64外的架构？”和官方镜像FAQ中的“Git中的镜像源已更改，现在该怎么办？”。

重要提示

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

快速参考

-** 维护者：**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

• 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

• 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

快速参考（续）

-** 问题反馈地址：[*]

-** 支持的架构：**(更多信息) amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

-** 镜像 artifact 详情：**repo-info 仓库的 repos/nextcloud/ 目录 (历史记录)（镜像元数据、传输大小等）

-** 镜像更新：**official-images 仓库的 library/nextcloud 标签、official-images 仓库的 library/nextcloud 文件 (历史记录)

-** 本描述的来源：**docs 仓库的 nextcloud/ 目录 (历史记录)

什么是 Nextcloud？

您所有数据的安全家园。从任何设备按您的方式访问和共享文件、日历、联系人、邮件等。

Nextcloud.com

此 Docker 微服务镜像是由 Nextcloud 社区开发和维护的。Nextcloud GmbH 不为此 Docker 镜像提供支持。如果您需要专业支持，可以成为企业客户或使用AIO。

如何使用此镜像

此镜像设计用于微服务环境。有两种版本的镜像可供选择。

apache 标签包含完整的 Nextcloud 安装，包括 Apache Web 服务器。它易于使用，能让您快速运行。这也是 latest 标签和未进一步指定的版本标签的默认选项。

第二个选项是 fpm 容器。它基于 php-fpm 镜像，运行一个 FastCGI 进程来提供 Nextcloud 页面。要使用此镜像，必须将其与任何可以将 HTTP 请求代理到容器的 FastCGI 端口的 Web 服务器结合使用。

使用 apache 镜像

apache 镜像包含 Web 服务器并暴露 80 端口。要启动容器，请输入：

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

现在您可以从主机系统通过 http://localhost:8080/ 访问 Nextcloud。

使用 fpm 镜像

要使用 fpm 镜像，您需要额外的 Web 服务器，例如 nginx，它可以将 HTTP 请求代理到容器的 FastCGI 端口。对于 fpm 连接，此容器暴露 9000 端口。在大多数情况下，您可能希望使用另一个容器或主机作为代理。如果使用主机，可以直接通过 9000 端口访问 Nextcloud 容器。如果使用另一个容器，请确保将它们添加到同一个 Docker 网络（通过 docker run --network <NAME> ... 或 compose.yaml 文件）。在这两种情况下，都不希望将 fpm 端口映射到主机。

$ docker run -d arm32v5/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 中。Docker 守护进程会将该数据存储在 Docker 目录 /var/lib/docker/volumes/... 内。这意味着即使容器崩溃、停止或删除，您的数据也会被保存。

升级和备份时应使用命名 Docker 卷或挂载的主机目录。要实现这一点，您需要一个用于数据库容器的卷和一个用于 Nextcloud 的卷。

Nextcloud：

• /var/www/html/ 文件夹，所有 Nextcloud 数据都存储在此处

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

数据库：

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

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

额外卷

如果您想精细访问各个文件，可以为数据、配置、主题和自定义应用挂载额外的卷。data、config 文件存储在 /var/www/html/ 内的相应子文件夹中。应用分为核心 apps（随 Nextcloud 一起提供，无需关心）和 custom_apps 文件夹。如果使用自定义主题，它将位于 themes 子文件夹中。

可挂载为卷的文件夹概述：

• /var/www/html 主文件夹，升级时需要
• /var/www/html/custom_apps 已安装/修改的应用
• /var/www/html/config 本地配置
• /var/www/html/data Nextcloud 的实际数据
• /var/www/html/themes/<YOUR_CUSTOM_THEME> 主题/品牌

如果要为所有这些使用命名卷，命令如下：

$ 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> \
arm32v5/nextcloud

自定义卷

如果在 /var/www/html 下挂载额外卷，应考虑：

• 确认 upgrade.exclude 包含安装和升级期间应保留的文件和文件夹；或
• 将存储卷挂载到 /var/www/html 之外的位置。

请注意，主文件夹 (/var/www/html) 内的数据在安装和升级期间会被覆盖/删除，除非在 upgrade.exclude 中列出。官方支持的额外卷已在该列表中，但自定义卷需要您自行添加。建议将自定义存储卷挂载到 /var/www/html 之外，如果可能设为只读，这样就无需进行此调整。但是，如果必须如此，您可以构建包含修改后的 /upgrade.exclude 文件的自定义镜像，以纳入您的自定义卷。

使用 Nextcloud 命令行界面

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

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

或对于 docker compose：

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

通过环境变量自动配置

Nextcloud 镜像支持通过环境变量自动配置。您可以在首次运行时预配置安装页面上询问的所有内容。要启用自动配置，请通过以下环境变量指定数据库连接。您必须为给定数据库指定所有环境变量，否则数据库环境变量默认为 SQLITE。** 仅使用一种数据库类型！**

SQLite：

• SQLITE_DATABASE 使用 SQLite 的数据库名称

MYSQL/MariaDB：

• MYSQL_DATABASE 使用 mysql/mariadb 的数据库名称。
• MYSQL_USER 使用 mysql/mariadb 的数据库用户名。
• MYSQL_PASSWORD 使用 mysql/mariadb 的数据库用户密码。
• MYSQL_HOST 使用 mysql/mariadb 的数据库服务器主机名。

PostgreSQL：

• POSTGRES_DB 使用 postgres 的数据库名称。
• POSTGRES_USER 使用 postgres 的数据库用户名。
• POSTGRES_PASSWORD 使用 postgres 的数据库用户密码。
• POSTGRES_HOST 使用 postgres 的数据库服务器主机名。

作为通过环境变量传递敏感信息的替代方法，可以在上述环境变量后附加 _FILE，使初始化脚本从容器中存在的文件加载这些变量的值。见下文Docker 密钥部分。

如果您设置了任何一组值（即 MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD、MYSQL_HOST 全部指定），首次运行时安装页面将不会询问这些内容。通过为数据库类型设置所有变量进行完整配置后，您还可以通过以下环境变量配置 Nextcloud 实例（仅当同时设置两者时有效）：

• NEXTCLOUD_ADMIN_USER Nextcloud 管理员用户名。
• NEXTCLOUD_ADMIN_PASSWORD Nextcloud 管理员用户密码。

如果需要，您可以设置数据目录，否则使用默认值。

• NEXTCLOUD_DATA_DIR（默认：/var/www/html/data）配置 Nextcloud 存储所有用户文件的数据目录。

也可以通过环境变量设置一个或多个受信任域。它们将在安装后添加到配置中。

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

仅当使用默认命令（apache-foreground 或 php-fpm）时，安装和更新脚本才会触发。如果使用自定义命令，必须通过以下环境变量启用安装/更新：

• NEXTCLOUD_UPDATE（默认：0）

您可能希望在每次容器更新后确保 htaccess 是最新的。特别是在多个 swarm 节点上，任何差异都会使服务器无法使用。

• NEXTCLOUD_INIT_HTACCESS（默认未设置）设为 true 以在容器初始化后运行 occ maintenance:update:htaccess。

如果要使用 Redis，必须在设置/Compose 文件中创建单独的 Redis 容器。要通知 Nextcloud 有关 Redis 容器的信息，请传入以下参数：

• REDIS_HOST（默认未设置）Redis 容器名称
• REDIS_HOST_PORT（默认：6379）Redis 的可选端口，仅用于运行在非标准端口的外部 Redis 服务器。
• REDIS_HOST_PASSWORD（默认未设置）Redis 密码

建议使用 Redis 以防止文件锁定问题。更多说明见示例。

要使用外部 SMTP 服务器，必须提供连接详细信息。要配置 Nextcloud 使用 SMTP，请添加：

• SMTP_HOST（默认未设置）：SMTP 服务器的主机名。
• SMTP_SECURE（默认空）：设为 ssl 使用 SSL，或 tls 使用 STARTTLS。
• SMTP_PORT（默认：SSL 为 465，非安全连接为 25）：SMTP 连接的可选端口。使用 587 作为 STARTTLS 的替代端口。
• SMTP_AUTHTYPE（默认：LOGIN）：认证方法。无需认证时使用 PLAIN。
• SMTP_NAME（默认空）：认证用户名。
• SMTP_PASSWORD（默认空）：认证密码。
• MAIL_FROM_ADDRESS（默认未设置）：Nextcloud 发送邮件的“发件人”字段的本地部分。
• MAIL_DOMAIN（默认未设置）：邮件的域名，不同于 Nextcloud 安装的域名。

至少必须设置 SMTP_HOST、