linuxserver/nextcloud

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

支持的架构

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

支持的架构：

版本标签

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

应用设置

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

更新Nextcloud

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

协作编辑

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

自定义应用目录

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

yaml
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（推荐，查看更多信息）

yaml
---
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（查看更多信息）

bash
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端口。

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

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

bash
-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：

bash
id your_user

示例输出：

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

Docker Mods

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

支持信息

• 容器运行时进入shell：

  bash
  docker exec -it nextcloud /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f nextcloud
  

• 查看容器版本号：

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

• 查看镜像版本号：

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

更新说明

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

通过Docker Compose

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull nextcloud
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d nextcloud
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/nextcloud:latest
  

• 停止运行中的容器：

  bash
  docker stop nextcloud
  

• 删除容器：

  bash
  docker rm nextcloud
  

• 使用相同参数重新创建容器（卷映射正确的情况下，/config文件夹及设置将保留）

• 清理旧镜像：

  bash
  docker image prune
  

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

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

  bash
  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接收更新通知，不建议使用自动更新容器的工具。

本地构建

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

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

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

bash
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-***（现有用户应删除/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，修复续行符。