jricks92/nextcloud

Nextcloud 镜像文档

镜像概述

本镜像为 wonderfall/nextcloud 的分支版本，因原作者停止支持而由个人维护。基于Alpine Linux构建，集成nginx和PHP 7.1，添加了HTTP/2支持，用于提供安全的个人数据存储与同步服务。注意：此镜像为个人使用目的创建，非官方版本，支持不规律，欢迎通过GitHub提交PR或issue（Docker Hub评论可能无法查看）。

核心功能与特性

• 轻量基础：基于Alpine Linux，体积小且资源占用低
• 完整集成：捆绑nginx和PHP 7.1（基于wonderfall/nginx-php镜像）
• 自动部署：通过环境变量实现自动安装配置
• 安全可靠：构建过程中验证包完整性（SHA512）和真实性（PGP）
• 数据持久化：支持数据、应用、配置文件的持久化存储
• 性能优化：预配置OPCache（代码缓存）和APCu（本地缓存）
• 任务调度：系统cron任务自动运行
• 数据库兼容：支持MySQL、PostgreSQL（需外部服务）和sqlite3
• 扩展支持：集成Redis、FTP、SMB、LDAP、IMAP支持
• 编码优化：包含GNU Libiconv，解决部分应用的php iconv扩展错误
• 安全设计：无root进程运行，提升容器安全性
• 灵活配置：丰富的环境变量支持自定义部署（详见下文）

标签说明

• 12.0：最新12.0.x版本（稳定版），对应Nextcloud 12.0.4

除daily标签外，其他标签每周构建一次。为保障安全，即使使用最新版本，也建议定期更新容器。

构建时变量

环境变量

管理员密码请务必设置为强密码！

端口与卷

端口

• 8888：HTTP服务端口

卷

数据库配置

可使用主机、外部服务器或容器化数据库。推荐使用MariaDB容器，示例如下：

bash
docker run -d --name db_nextcloud \
  -v /docker/nextcloud/db:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=supersecretpassword \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud \
  -e MYSQL_PASSWORD=supersecretpassword \
  mariadb:10

部署示例

Docker Run 命令

bash
# 拉取镜像
docker pull wonderfall/nextcloud:12.0 && docker pull mariadb:10

# 创建数据库容器
docker run -d --name db_nextcloud \
  -v /docker/nextcloud/db:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=supersecretpassword \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud \
  -e MYSQL_PASSWORD=supersecretpassword \
  mariadb:10

# 创建Nextcloud容器
docker run -d --name nextcloud \
  --link db_nextcloud:db_nextcloud \
  -v /docker/nextcloud/data:/data \
  -v /docker/nextcloud/config:/config \
  -v /docker/nextcloud/apps:/apps2 \
  -v /docker/nextcloud/themes:/nextcloud/themes \
  -e UID=1000 -e GID=1000 \
  -e UPLOAD_MAX_SIZE=10G \
  -e APC_SHM_SIZE=128M \
  -e OPCACHE_MEM_SIZE=128 \
  -e CRON_PERIOD=15m \
  -e TZ=Etc/UTC \
  -e ADMIN_USER=mrrobot \
  -e ADMIN_PASSWORD=supercomplicatedpassword \
  -e DOMAIN=cloud.example.com \
  -e DB_TYPE=mysql \
  -e DB_NAME=nextcloud \
  -e DB_USER=nextcloud \
  -e DB_PASSWORD=supersecretpassword \
  -e DB_HOST=db_nextcloud \
  wonderfall/nextcloud:12.0

若未设置ADMIN_USER和ADMIN_PASSWORD，可通过浏览器完成管理员账户配置。

Docker Compose 配置

推荐使用docker-compose管理容器，以下为示例配置（根据需求调整）：

yaml
version: '2'

networks:
  default:
    driver: bridge

services:
  nextcloud:
    image: wonderfall/nextcloud:12.0
    depends_on:
      - nextcloud-db  # 使用MySQL时依赖
      # - solr         # 使用Nextant时依赖
      # - redis        # 使用Redis时依赖
    environment:
      - UID=1000
      - GID=1000
      - UPLOAD_MAX_SIZE=10G
      - APC_SHM_SIZE=128M
      - OPCACHE_MEM_SIZE=128
      - CRON_PERIOD=15m
      - TZ=Europe/Berlin
      - ADMIN_USER=admin            # 不设置则通过浏览器配置
      - ADMIN_PASSWORD=admin        # 不设置则通过浏览器配置
      - DOMAIN=localhost
      - DB_TYPE=mysql
      - DB_NAME=nextcloud
      - DB_USER=nextcloud
      - DB_PASSWORD=supersecretpassword
      - DB_HOST=nextcloud-db
    volumes:
      - /docker/nextcloud/data:/data
      - /docker/nextcloud/config:/config
      - /docker/nextcloud/apps:/apps2
      - /docker/nextcloud/themes:/nextcloud/themes

  # MySQL数据库服务
  nextcloud-db:
    image: mariadb:10
    volumes:
      - /docker/nextcloud/db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=supersecretpassword
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_PASSWORD=supersecretpassword
  
  # Nextant搜索服务（可选）
  # solr:
  #   image: solr:6-alpine
  #   container_name: solr
  #   volumes:
  #     - /docker/nextcloud/solr:/opt/solr/server/solr/mycores
  #   entrypoint:
  #     - docker-entrypoint.sh
  #     - solr-precreate
  #     - nextant

  # Redis缓存服务（可选）
  # redis:
  #   image: redis:alpine
  #   container_name: redis
  #   volumes:
  #     - /docker/nextcloud/redis:/data

部署步骤：

1. 保存为docker-compose.yml
2. 启动数据库：docker-compose up -d nextcloud-db（等待15秒数据库初始化）
3. 启动所有服务：docker-compose up -d
4. 更新时：docker-compose pull && docker-compose up -d

高级配置

ARM设备支持

需基于Alpine-ARM镜像（如orax/alpine-armhf:edge）自行构建。

Cron任务配置

在管理员面板中，建议将任务调度方式从AJAX cron切换为cron（系统cron）。

Redis缓存配置

已内置PHP Redis扩展，部署Redis容器后，在config.php中添加：

php
'memcache.distributed' => '\OC\Memcache\Redis',
'memcache.locking' => '\OC\Memcache\Redis',
'memcache.local' => '\OC\Memcache\APCu',
'redis' => array(
  'host' => 'redis',
  'port' => 6379,
),

Nextant搜索配置

部署Solr容器后，安装Nextant应用，在管理员面板的“附加设置”中设置Solr地址为http://solr:8983/solr。

OCC命令使用

通过以下命令执行Nextcloud控制台命令：

bash
docker exec -ti nextcloud occ 命令

反向代理设置

强烈建议通过HTTPS访问Nextcloud，推荐使用wonderfall/reverse镜像（基于nginx，支持Let's Encrypt自动证书）。

配置示例（Docker Compose）

在Nextcloud服务中添加标签：

yaml
nextcloud:
  ...
  labels:
    - reverse.frontend.domain=cloud.domain.tld  # 域名
    - reverse.backend.port=8888                 # 后端端口
    - reverse.frontend.ssl=true                 # 启用SSL
    - reverse.frontend.ssltype=ec384            # SSL类型
    - reverse.frontend.hsts=false               # HSTS配置
    - reverse.frontend.headers=false            # 头信息配置

添加反向代理服务：

yaml
reverse:
  image: wonderfall/reverse
  container_name: reverse
  ports:
    - "80:8080"
    - "443:8443"
  environment:
    - EMAIL=admin@domain.tld  # Let's Encrypt邮箱
  volumes:
    - /docker/reverse/ssl:/nginx/ssl
    - /var/run/docker.sock:/var/run/docker.sock
  depends_on:
    - nextcloud

更新方法

拉取新版本镜像后，按部署步骤重新创建容器。外部卷确保数据不会丢失。若Nextcloud执行全量升级，应用可能被禁用（12.0.x版本后升级会自动启用应用）。