amd64/nextcloud

amd64

Nextcloud Docker镜像是社区志愿者维护的微服务镜像，适用于专家使用，提供安全的数据存储解决方案，支持从任何设备访问和共享文件、日历、联系人等数据，可通过环境变量自动配置，支持多种数据库和存储后端。

2 次收藏下载次数: 0状态：社区镜像维护者：amd64仓库类型：镜像最近更新：3 天前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这段话即可：

请先阅读并遵守：https://xuanyuan.cloud/agents.md

未读文档前不要生成 pull 命令或排错方案。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

Nextcloud Docker镜像文档

重要说明

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

快速参考

维护者：
https://github.com/nextcloud/docker
获取帮助：
https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

支持的标签及对应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

快速参考（续）

问题反馈地址：
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/, https://hub.docker.com/r/arm32v5/nextcloud/, https://hub.docker.com/r/arm32v6/nextcloud/, https://hub.docker.com/r/arm32v7/nextcloud/, https://hub.docker.com/r/arm64v8/nextcloud/, https://hub.docker.com/r/i386/nextcloud/, https://hub.docker.com/r/ppc64le/nextcloud/, https://hub.docker.com/r/riscv64/nextcloud/, https://hub.docker.com/r/s390x/nextcloud/
镜像 artifact 详情：
https://github.com/docker-library/repo-info/blob/master/repos/nextcloud（https://github.com/docker-library/repo-info/commits/master/repos/nextcloud）
（镜像元数据、传输大小等）
镜像更新：
https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fnextcloud
https://github.com/docker-library/official-images/blob/master/library/nextcloud（https://github.com/docker-library/official-images/commits/master/library/nextcloud）
本文档来源：
https://github.com/docker-library/docs/tree/master/nextcloud（https://github.com/docker-library/docs/commits/master/nextcloud）

什么是 Nextcloud？

Nextcloud 是一个安全的数据存储解决方案，允许您在自己的条件下从任何设备访问和共享文件、日历、联系人、邮件等数据。

https://nextcloud.com/

此 Docker 微服务镜像由 Nextcloud 社区开发和维护。Nextcloud GmbH 不为此 Docker 镜像提供支持。如果您需要专业支持，可以成为https://nextcloud.com/enterprise/或使用 https://github.com/nextcloud/all-in-one#nextcloud-all-in-one。

如何使用此镜像

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

apache 标签：包含完整的 Nextcloud 安装和 Apache Web 服务器，易于使用，可快速启动，是 latest 标签和未指定后缀的版本标签的默认选择。
fpm 标签：基于 https://hub.docker.com/_/php/ 镜像，运行 FastCGI 进程，需配合能将 HTTP 请求代理到 FastCGI 端口的 Web 服务器使用。

使用 apache 镜像

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

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

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

使用 fpm 镜像

fpm 镜像需配合 Web 服务器（如 https://docs.nextcloud.com/server/latest/admin_manual/installation/nginx.html）使用，该 Web 服务器需能将 HTTP 请求代理到容器的 FastCGI 端口（9000）。启动 fpm 容器命令如下：

console
$ docker run -d amd64/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 守护进程会将数据存储在 /var/lib/docker/volumes/... 目录下，即使容器崩溃、停止或删除，数据也会保留。

为便于升级和备份，建议使用命名 Docker 卷或挂载主机目录。需为数据库容器和 Nextcloud 分别配置卷：

Nextcloud：/var/www/html/ 目录（所有 Nextcloud 数据存放位置）

console
$ docker run -d \
-v nextcloud:/var/www/html \
amd64/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/ 的子目录）：

/var/www/html/custom_apps：已安装/修改的应用
/var/www/html/config：本地配置
/var/www/html/data：Nextcloud 实际数据
/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> \
amd64/nextcloud

自定义卷注意事项

在 /var/www/html 下挂载自定义卷时，需注意：

确保 https://github.com/nextcloud/docker/blob/master/upgrade.exclude 包含安装和升级期间需保留的文件和文件夹；或
将存储卷挂载到 /var/www/html 之外的位置。

注意：/var/www/html 目录中的数据在安装和升级期间可能会被覆盖/删除，除非在 https://github.com/nextcloud/docker/blob/master/upgrade.exclude 中列出。官方支持的额外卷已包含在内，自定义卷需自行添加。建议将自定义存储卷挂载到 /var/www/html 之外，并尽可能设为只读。

使用 Nextcloud 命令行界面

要使用 https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html（`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/MariaDB 数据库名称
MYSQL_USER：MySQL/MariaDB 数据库用户名
MYSQL_PASSWORD：MySQL/MariaDB 数据库用户密码
MYSQL_HOST：MySQL/MariaDB 数据库服务器主机名

PostgreSQL

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

除数据库配置外，若指定了完整的数据库环境变量，还可通过以下变量配置 Nextcloud 管理员用户（需同时设置）：

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

可通过以下变量设置数据目录（默认值为 /var/www/html/data）：

NEXTCLOUD_DATA_DIR：Nextcloud 存储用户文件的数据目录路径

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

NEXTCLOUD_TRUSTED_DOMAINS：可选，空格分隔的域名列表

安装和更新脚本仅在使用默认命令（apache-foreground 或 php-fpm）时触发。若使用自定义命令，需通过以下变量启用安装/更新：

NEXTCLOUD_UPDATE：默认 0，设为非 0 值启用

为确保容器更新后 htaccess 配置保持最新（尤其在多 swarm 节点环境中，配置不一致会导致服务器不可用）：

NEXTCLOUD_INIT_HTACCESS：默认未设置，设为 true 可在容器初始化后运行 occ maintenance:update:htaccess

如需使用 Redis，需在部署中创建单独的 https://hub.docker.com/_/redis/ 容器，并通过以下参数告知 Nextcloud：

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

建议使用 Redis 以防止文件锁定问题，详见示例。

要配置 Nextcloud 使用外部 SMTP 服务器，需提供以下连接详情：

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

至少需设置 SMTP_HOST、MAIL_FROM_ADDRESS 和 MAIL_DOMAIN。更多信息见 https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/email_configuration.html。

通过 hook 文件夹自动配置

提供 5 个 hook 文件夹，可在特定阶段执行脚本：

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

使用方法：将脚本添加到容器内 /docker-entrypoint-hooks.d 目录下的对应子文件夹，或通过卷挂载主机脚本：

yaml
services:
  app:
    image: docker.xuanyuan.run/amd64/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

注意：仅位于 hook 文件夹（非子目录）、以 .sh 结尾且可执行的脚本会被执行。

在反向代理后使用 apache 镜像并自动配置服务器主机和协议

默认情况下，apache 镜像会将来自 10.0.0.0/8、172.16.0.0/12 或 192.168.0.0/16 网段代理的请求的远程地址替换为 X-Real-IP。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 nextcloud 镜像标签

docker pull docker.xuanyuan.run/amd64/nextcloud:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull amd64/nextcloud:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

爱快 4.0 · iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

专属域名用法

专属域名 · 开启停用 · 多仓库

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

docker.sock / daemon

账号

失败是否计费

manifest · blob · 计费

申请开票（企业 / 个人）

开票 · 发票 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"