manlongdan/library_nextcloud

manlongdan

Nextcloud Docker镜像是由社区志愿者维护的微服务镜像，提供安全的数据存储与管理平台，支持文件、日历、联系人等数据的访问与共享，适用于专家级用户自行部署和配置。

下载次数: 0状态：社区镜像维护者：manlongdan仓库类型：镜像最近更新：2 个月前

让 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 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/50bf6dc8f95729b95d6313edff8fb***ce/30/apache/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/30/fpm/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/30/fpm-alpine/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/31/apache/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/31/fpm/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/31/fpm-alpine/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/32/apache/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/32/fpm/Dockerfile
https://github.com/nextcloud/docker/blob/50bf6dc8f95729b95d6313edff8fb***ce/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/
镜像制品详情：
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？

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

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进程来提供Nextcloud页面。使用此镜像时，必须与能将HTTP请求代理到容器FastCGI端口的任何Web服务器结合使用。

使用apache镜像

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

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

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

使用fpm镜像

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

console
$ docker run -d nextcloud:fpm

由于FastCGI进程无法提供静态文件（样式表、图像等），Web服务器需要访问这些文件。这可以通过volumes-from选项实现。你可以在Docker Compose部分找到更多信息。

使用外部数据库

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

持久化数据

Nextcloud安装和所有数据库之外的数据（文件上传等）存储在https://docs.docker.com/storage/volumes/`/var/www/html`中。Docker守护进程会将该数据存储在Docker目录`/var/lib/docker/volumes/...`中。这意味着即使容器崩溃、停止或删除，你的数据也会保存。

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

Nextcloud：

/var/www/html/文件夹，所有Nextcloud数据存放于此

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

数据库：

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

console
$ 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> 主题/品牌

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

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> \
nextcloud

自定义卷

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

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

请注意，除非在https://github.com/nextcloud/docker/blob/master/upgrade.exclude中列出，否则主文件夹（`/var/www/html`）内的数据在安装和升级期间会被覆盖/删除。官方支持的额外卷已在该列表中，但自定义卷需要你自行添加。建议将自定义存储卷挂载到`/var/www/html`之外的位置，并尽可能设为只读，以避免此调整。如果必须在`/var/www/html`下挂载，你可以构建包含修改后的`/upgrade.exclude`文件的自定义镜像，以纳入你的自定义卷。

使用Nextcloud命令行界面

要使用https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html（即`occ`命令）：

console
$ docker exec --user www-data 容器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的数据库服务器主机名

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

如果设置了任何一组值（即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文件中创建单独的https://hub.docker.com/_/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连接的可选端口，STARTTLS可使用587
SMTP_AUTHTYPE（默认：LOGIN）认证方法，无需认证时使用PLAIN
SMTP_NAME（默认空）认证用户名
SMTP_PASSWORD（默认空）认证密码
MAIL_FROM_ADDRESS（默认未设置）Nextcloud发送邮件中“发件人”字段的本地部分
MAIL_DOMAIN（默认未设置）邮件使用的域名（不同于Nextcloud安装的域名）

应用配置至少需要设置SMTP_HOST、MAIL_FROM_ADDRESS和MAIL_DOMAIN。

有关配置SMTP的其他值，请查看https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/email_configuration.html。

要使用外部S3兼容对象存储作为主存储，设置以下变量：

OBJECTSTORE_S3_BUCKET Nextcloud存储数据的存储桶名称
OBJECTSTORE_S3_REGION S3存储桶所在的区域
OBJECTSTORE_S3_HOST 对象存储服务器的主机名
OBJECTSTORE_S3_PORT 对象存储服务器的端口
`

镜像拉取方式

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

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

docker pull docker.xuanyuan.run/manlongdan/library_nextcloud:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull manlongdan/library_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访问体验非常流畅，大镜像也能快速完成下载。"