本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

lsiodev/nextcloud

LinuxServer.io提供的Nextcloud容器，让您随时随地访问所有文件，支持文件同步与共享，具备定期应用更新、用户权限映射（PUID/PGID）、多架构支持等特性，适合个人或企业搭建私有云存储服务。

0 次下载activelsiodev镜像

linuxserver/nextcloud

Nextcloud让您随时随地访问所有文件。您的照片和文档在哪里？使用Nextcloud，您可以选择自己的服务器（家庭、数据中心或服务提供商），文件将存储在那里。Nextcloud在该服务器上运行，保护您的数据，并允许您通过桌面或移动设备访问。通过Nextcloud，您还可以访问、同步和共享办公室FTP驱动器、Dropbox或家庭NAS上的现有数据。

支持的架构

我们利用Docker清单实现多平台支持。只需拉取lscr.io/linuxserver/nextcloud:latest即可获取适合您架构的正确镜像，也可通过标签拉取特定架构镜像。

支持的架构：

架构	可用	标签
x86-64	✅	amd64-<version tag>
arm64	✅	arm64v8-<version tag>
armhf	❌

版本标签

此镜像提供多种版本标签，使用时请注意区分：

标签	可用	描述
latest	✅	Nextcloud稳定版本
develop	✅	Nextcloud测试版（仅预发布版本）

应用设置

通过https://<您的IP>:443访问Web界面，更多信息请查看Nextcloud官方文档。

更新Nextcloud

更新Nextcloud需拉取新镜像并重新创建容器。仅支持逐个主版本升级（例如从14到16需先升级到15）。所有数据存储在/config和/data卷中，不会丢失。启动脚本会检查卷中版本与容器版本，发现不匹配时自动启动升级流程。

协作编辑

Nextcloud内置的协作编辑包（Collabora/CODE和OnlyOffice）仅在x86_64系统且使用glibc时兼容，因此与本镜像不兼容。需为其创建单独容器，并通过相应连接器插件在Nextcloud中配置。若已（自动）安装这些内置包，可能导致不稳定，建议移除。

自定义应用目录

如果使用自定义应用目录，需将自定义文件夹挂载到Web服务器可访问路径。推荐通过卷挂载实现，例如：

volumes:
  - /path/to/your_custom_apps_folder:/app/www/public/your_custom_apps_folder

之后，在config.php中按官方文档设置"path" => OC::$SERVERROOT . "/your_custom_apps_folder",。

严格反向代理

本镜像默认使用自签名证书，因此协议为https。若使用验证证书的反向代理，需禁用对容器的证书检查。

使用方法

以下提供docker-compose和docker cli两种使用方式帮助您创建容器。

docker-compose（推荐，查看更多信息）

---
version: "2.1"
services:
  nextcloud:
    image: lscr.io/linuxserver/nextcloud:latest
    container_name: nextcloud
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/appdata:/config
      - /path/to/data:/data
    ports:
      - 443:443
    restart: unless-stopped

docker cli（查看更多信息）

docker run -d \
  --name=nextcloud \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 443:443 \
  -v /path/to/appdata:/config \
  -v /path/to/data:/data \
  --restart unless-stopped \
  lscr.io/linuxserver/nextcloud:latest

参数说明

容器通过运行时参数配置，格式为<外部>:<内部>。例如-p 8080:80表示将容器内80端口映射到主机8080端口。

参数	功能
`-p 443`	Web界面访问端口
`-e PUID=1000`	用户ID（详见下方说明）
`-e PGID=1000`	组ID（详见下方说明）
`-e TZ=Etc/UTC`	时区设置，参考时区列表
`-v /config`	Nextcloud配置文件存储路径
`-v /data`	个人数据存储路径

来自文件的环境变量（Docker secrets）

可通过特殊前缀FILE__从文件设置环境变量，例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

这会将MYVAR环境变量的值设置为/run/secrets/mysecretvariable文件的内容。

应用运行的Umask设置

所有镜像支持通过可选参数-e UMASK=022覆盖服务的默认umask设置。注意umask是权限减法而非加法，使用前请参考相关说明。

用户/组标识符

使用卷（-v参数）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机卷目录归属于指定用户，权限问题将解决。

使用id your_user命令获取您的PUID和PGID：

id your_user

示例输出：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

Docker Mods Docker Universal Mods

我们发布了多种Docker Mods以扩展容器功能。上述动态徽章链接可查看此镜像及通用Mods。

支持信息

容器运行时进入shell：

docker exec -it nextcloud /bin/bash

实时监控容器日志：

docker logs -f nextcloud

查看容器版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' nextcloud

查看镜像版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/nextcloud:latest

更新说明

多数镜像为静态版本，需更新镜像并重建容器以更新应用（Nextcloud、Plex等除外）。不建议在容器内更新应用。更新容器方法如下：

通过Docker Compose

更新镜像：

所有镜像：

docker-compose pull

单个镜像：

docker-compose pull nextcloud

更新容器：

所有容器：

docker-compose up -d

单个容器：

docker-compose up -d nextcloud

清理旧镜像：
```
docker image prune
```

通过Docker Run

更新镜像：

docker pull lscr.io/linuxserver/nextcloud:latest

停止运行中的容器：

docker stop nextcloud

删除容器：

docker rm nextcloud

使用相同参数重新创建容器（卷映射正确的情况下，/config文件夹及设置将保留）
清理旧镜像：
```
docker image prune
```

通过Watchtower自动更新（仅在忘记原始参数时使用）

拉取最新镜像并使用相同环境变量重启容器：

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once nextcloud

清理旧镜像：docker image prune

警告：不推荐使用Watchtower自动更新容器，建议使用Docker Compose进行管理。

镜像更新通知 - Diun（Docker镜像更新通知器）

提示：推荐使用Diun接收更新通知，不建议使用自动更新容器的工具。

本地构建

如需本地修改镜像进行开发或自定义：

git clone [***]
cd docker-nextcloud
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/nextcloud:latest .

可使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体：

docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后，使用-f Dockerfile.aarch64指定ARM架构的Dockerfile。

版本历史

02.01.24: - 现有用户应更新：site-confs/default.conf - 清理默认站点配置。
22.12.23: - 站点默认配置更新，包含js和mjs的mime.types，并更新位置以包含更多文件类型。
28.10.23: - 初始化期间禁用使用occ进行Web升级。
31.08.23: - 重新添加updatenotification应用，允许用户接收应用更新通知（也会通知NextCloud更新，但不支持通过Web UI更新NextCloud）。
14.08.23: - 添加develop分支。
25.06.23: - 将Nextcloud安装移至容器内，移除CLI更新器。查看变更公告。
21.06.23: - 现有用户应更新/config/nginx/site-confs/default.conf - 修复real ip设置的安全问题。
25.05.23: - 基于Alpine 3.18重建，弃用armhf架构。
13.04.23: - 将ssl.conf包含移至default.conf。
21.03.23: - 添加php81-sysvsem作为v26的新依赖，将默认X-Robots-Tag更新为noindex, nofollow。
02.03.23: - 初始化期间设置crontabs权限。
20.01.23: - 基于Alpine 3.17和php8.1重建。
10.10.22: - 基于Alpine 3.15和php8重建，重构nginx配置（查看变更公告）。
30.09.22: - 禁用output_buffering，参考nextcloud文档。
21.05.22: - 更新版本检查端点。
28.04.22: - 增加OPCache interned strings缓冲设置至16。
14.04.22: - Nginx默认站点配置更新以支持v23（现有用户应删除/config/nginx/site-confs/default.conf并重启容器），修复LDAP连接。
11.09.21: - 基于Alpine 3.14重建。
21.03.21: - 发布php8测试标签。
25.02.21: - Nginx默认站点配置更新以支持v21（现有用户应删除/config/nginx/site-confs/default.conf并重启容器）。
21.01.21: - 修复php iconv（曾导致邮件插件故障），启动时尝试移除损坏的CODE Server应用。
20.01.21: - 增加php fcgi超时以防止504网关超时错误（现有用户应删除/config/nginx/site-confs/default.conf并重启容器）。
16.01.21: - 基于Alpine 3.13重建，32位ARM用户参考此文章。
12.08.20: - 各种默认站点配置更新，包括添加webfinger支持（现有用户应删除/config/nginx/site-confs/default.conf并重启容器）。
03.06.20: - 基于Alpine 3.12重建。
03.06.20: - 添加php7-bcmath和php7-fileinfo。
31.05.20: - 添加occ和updater.phar的别名。
31.03.20: - 允许用户自定义crontab，修复logrotate。
17.01.20: - 更新php.ini默认值和站点配置，包括可选的HSTS指令（现有用户应删除/config/nginx/site-confs/default.conf并重启容器）。
19.12.19: - 基于Alpine 3.11重建。
18.11.19: - Nginx默认站点配置更新以支持v17（现有用户应删除/config/nginx/site-confs/default.conf并重启容器）。
28.10.19: - 将 cron 任务改为每5分钟运行一次。
24.10.19: - Nginx默认站点配置更新以修复CVE-2019-11043（现有用户应删除/config/nginx/site-confs/default.conf并重启容器）。
14.07.19: - 构建时下载nextcloud。
28.06.19: - 基于Alpine 3.10重建。
23.03.19: - 切换到新基础镜像，使用arm32v7标签。
27.02.19: - 更新基础nginx配置以同步v15需求。
22.02.19: - 基于Alpine 3.9重建。
28.01.19: - 添加流水线逻辑和多架构支持。
25.01.19: - 添加php7-phar以支持occ升级。
05.09.18: - 基于Alpine 3.8重建。
11.06.18: - 初始安装使用latest而非特定版本。
26.04.18: - 默认安装版本更新至13.0.1。
06.02.18: - 默认安装版本更新至13.0.0。
26.01.18: - 基于Alpine 3.7重建，默认安装版本更新至12.0.5。
12.12.17: - 默认安装版本更新至12.0.4，修复续行符。