Nextcloud Docker 镜像文档

重要提示

⚠️⚠️⚠️ 本镜像是由社区志愿者维护的，专为专家使用设计。如需快速部署并支持完整的 Nextcloud Hub 功能，请使用由 Nextcloud GmbH 维护的 Nextcloud All-in-One Docker 容器。

镜像概述

Nextcloud 是一个安全的个人数据存储解决方案，允许用户从任何设备访问和共享文件、日历、联系人、邮件等数据，数据完全由用户自主掌控。本 Docker 镜像是由 Nextcloud 社区开发和维护的微服务版本，旨在提供灵活的部署选项，适用于熟悉 Docker 和微服务架构的专家用户。

• 维护方：Nextcloud 社区
• 适用人群：熟悉 Docker 容器化部署、需要自定义微服务架构的技术专家
• 注意：不推荐用于快速部署场景（推荐使用官方 All-in-One 方案）

核心功能与特性

架构与标签支持

• 多架构支持：包括 amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
• 镜像类型：
  • apache：包含完整 Nextcloud 及 Apache Web 服务器，易于使用
  • fpm：基于 PHP-FPM，需配合外部 Web 服务器（如 Nginx）
  • fpm-alpine：基于 Alpine Linux 的轻量级 PHP-FPM 版本

核心功能

• 外部数据库支持：默认使用 SQLite，可配置 MySQL/MariaDB、PostgreSQL 外部数据库
• 持久化存储：通过 Docker 卷或主机目录挂载，确保数据（配置、文件上传等）持久化
• 环境变量自动配置：支持通过环境变量预配置数据库、管理员账户、Trusted Domains、Redis、SMTP 等
• 钩子脚本：提供 pre-installation、post-installation、pre-upgrade、post-upgrade、before-starting 五个钩子点，支持自定义初始化逻辑
• 反向代理兼容：支持通过环境变量配置反向代理（如 Trusted Proxies、协议/主机覆盖）
• 性能优化：支持 Redis 缓存以避免文件锁定问题，可自定义 PHP 内存限制、上传限制等参数

使用场景

• 自托管数据存储：适合需要完全掌控数据隐私的个人或小型团队，用于存储文件、日历、联系人等
• 微服务架构部署：适用于熟悉 Docker 生态的专家，需手动配置 Web 服务器、数据库等组件
• 定制化需求：需要自定义存储路径、集成外部服务（如 SMTP、对象存储）或优化性能的场景
• 不适用场景：快速部署（推荐 Nextcloud All-in-One）、对 Docker 不熟悉的用户

支持的标签及 Dockerfile 链接

快速参考

• 维护方：Nextcloud 社区
• 获取帮助：Docker 社区 Slack、Server Fault、Unix & Linux、Stack Overflow
• 提交 issue：[***]
• 架构支持：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
• 镜像元数据：repo-info 仓库

使用方法

基础使用：Apache 镜像

Apache 镜像包含 Web 服务器，可直接运行并暴露端口访问：

docker run -d -p 8080:80 arm64v8/nextcloud

访问 http://localhost:8080 即可进入 Nextcloud 初始化页面（默认使用 SQLite 数据库）。

基础使用：FPM 镜像

FPM 镜像需配合外部 Web 服务器（如 Nginx），仅暴露 FastCGI 端口（9000），不建议映射到主机：

docker run -d arm64v8/nextcloud:fpm

注意：FPM 无法处理静态文件（样式表、图片等），需 Web 服务器通过 volumes-from 或共享卷访问 /var/www/html 目录。

使用外部数据库

默认使用 SQLite，推荐生产环境使用 MySQL/MariaDB 或 PostgreSQL。可通过环境变量自动配置，或在初始化页面手动输入数据库信息。

示例：链接 MariaDB 容器

# 启动 MariaDB 容器
docker run -d \
  --name nextcloud-db \
  -v db:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=rootpass \
  -e MYSQL_PASSWORD=dbpass \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud \
  mariadb:10.6

# 启动 Nextcloud，链接数据库
docker run -d \
  --name nextcloud \
  -p 8080:80 \
  --link nextcloud-db:mysql \
  -e MYSQL_HOST=mysql \
  -e MYSQL_USER=nextcloud \
  -e MYSQL_PASSWORD=dbpass \
  -e MYSQL_DATABASE=nextcloud \
  -v nextcloud:/var/www/html \
  arm64v8/nextcloud

持久化数据

Nextcloud 数据（配置、文件上传等）存储在 /var/www/html，推荐使用命名卷或主机目录挂载以持久化数据：

核心数据卷

示例：挂载命名卷

docker run -d \
  -v nextcloud:/var/www/html \          # 主目录
  -v nextcloud-apps:/var/www/html/custom_apps \  # 自定义应用
  -v nextcloud-config:/var/www/html/config \    # 配置
  -v nextcloud-data:/var/www/html/data \        # 用户数据
  arm64v8/nextcloud

使用 Nextcloud 命令行工具（occ）

通过 docker exec 执行 occ 命令（需指定 www-data 用户）：

# 示例：列出用户
docker exec --user www-data <容器ID> php occ user:list

# Docker Compose 示例
docker compose exec --user www-data app php occ user:list

配置说明

环境变量自动配置

支持通过环境变量预配置 Nextcloud，无需手动初始化。

数据库配置

管理员与基础配置

Redis 配置（推荐）

用于缓存和避免文件锁定，需单独部署 Redis 容器：

SMTP 配置

用于邮件发送（通知、密码重置等）：

PHP 与 Apache 参数

钩子脚本

支持在关键阶段执行自定义脚本，脚本需放置在 /docker-entrypoint-hooks.d/<HOOK> 目录，需为 .sh 后缀且可执行。

示例：挂载钩子脚本（Docker Compose）

services:
  app:
    image: arm64v8/nextcloud:stable
    volumes:
      - ./hooks/pre-installation:/docker-entrypoint-hooks.d/pre-installation
      - ./hooks/post-upgrade:/docker-entrypoint-hooks.d/post-upgrade

反向代理配置

在反向代理后部署时，需配置 Nextcloud 信任代理并正确识别客户端 IP、协议和主机：

示例：Nginx 反向代理后配置

docker run -d \
  -p 8080:80 \
  -e TRUSTED_PROXIES=192.168.1.100 \  # 代理服务器 IP
  -e OVERWRITEPROTOCOL=https \         # 代理使用 HTTPS
  -e OVERWRITEHOST=cloud.example.com \ # 代理域名
  arm64v8/nextcloud

Docker Compose 部署示例

基础版：Apache + MariaDB

volumes:
  nextcloud:
  db:

services:
  db:
    image: mariadb:10.6
    restart: always
    command: --transaction-isolation=READ-COMMITTED --log-bin=binlog --binlog-format=ROW
    volumes:
      - db:/var/lib/mysql
    environment:
      -