benyanke/nextcloud

benyanke/nextcloud

从wonderfall/nextcloud分支而来

镜像概述和主要用途

本镜像为Nextcloud的Docker部署提供稳定支持，是wonderfall/nextcloud项目的分支版本（原项目已停止维护）。基于Alpine Linux构建，捆绑Nginx和PHP 7.1，支持通过环境变量自动安装，确保数据和应用持久化，适用于个人或小型团队搭建私有云存储服务。

核心功能和特性

• 基于Alpine Linux，轻量高效
• 捆绑Nginx和PHP 7.1（基于wonderfall/nginx-php镜像）
• 支持通过环境变量自动安装Nextcloud
• 构建过程中检查包完整性（SHA512）和真实性（PGP）
• 数据和应用持久化存储
• 预安装并配置OPCache（opcode缓存）和APCu（本地缓存）
• 系统定时任务（cron）运行
• 支持MySQL、PostgreSQL（需外部服务器）和sqlite3数据库
• 支持Redis、FTP、SMB、LDAP、IMAP服务
• 包含GNU Libiconv以支持php iconv扩展（避免部分应用错误）
• 无root进程运行，安全性高
• 提供丰富的环境变量配置（详见下文）

Docker标签

• latest：最新稳定版本（17）
• 17：最新17.0.x版本（稳定版）
• 16：最新16.0.x版本（Nextcloud稳定版，此容器镜像不再更新）
• 15：最新15.0.x版本（Nextcloud稳定版，此容器镜像不再更新）

出于安全考虑，即使使用最新版本的Nextcloud，也应定期更新容器，镜像会定期构建以保持底层依赖更新。

构建时变量

• NEXTCLOUD_VERSION：Nextcloud版本
• GNU_LIBICONV_VERSION：GNU Libiconv版本
• GPG_nextcloud：签名密钥指纹

环境变量

• UID：Nextcloud用户ID（默认：991）
• GID：Nextcloud组ID（默认：991）
• UPLOAD_MAX_SIZE：最大上传大小（默认：10G）
• APC_SHM_SIZE：APCu内存大小（默认：128M）
• OPCACHE_MEM_SIZE：OPCache内存大小（MB，默认：128）
• MEMORY_LIMIT：PHP内存限制（默认：512M）
• CRON_PERIOD：定时任务执行间隔（默认：15m）
• CRON_MEMORY_LIMIT：定时任务PHP内存限制（默认：1024m）
• TZ：系统/日志时区（默认：Etc/UTC）
• ADMIN_USER：管理员账户用户名（默认：无，需通过网页配置）
• ADMIN_PASSWORD：管理员账户密码（默认：无，需通过网页配置）
• DOMAIN：设置时使用的域名（默认：localhost）
• DB_TYPE：数据库类型（sqlite3、mysql或pgsql，默认：sqlite3）
• DB_NAME：数据库名称（默认：无）
• DB_USER：数据库用户名（默认：无）
• DB_PASSWORD：数据库用户密码（默认：无）
• DB_HOST：数据库主机（默认：无）
• PERMISSION_RESET：设为0禁用容器启动时的权限修复（适用于大型部署手动管理权限，默认：1）
• APP_AUTO_UPDATE：设为1启用容器重启时应用自动更新（默认：0）

请为管理员账户设置强密码！

端口

• 8888：Nextcloud HTTP端口

卷

• /data：Nextcloud数据存储
• /config：config.php配置文件位置
• /apps2：Nextcloud下载的应用存储
• /nextcloud/themes：Nextcloud主题存储
• /php/session：PHP会话文件存储

数据库

可使用主机或其他机器上的数据库实例，推荐使用外部数据库容器。建议使用MariaDB（可靠的数据库服务器），可通过Docker Hub的官方mariadb镜像创建数据库容器并链接到Nextcloud容器。也支持PostgreSQL。sqlite3仅推荐用于测试和极小实例，不建议生产环境使用。

使用场景和适用范围

适用于个人、家庭或小型团队搭建私有云存储服务，用于文件同步、共享和管理，支持多种客户端（Web、桌面、移动设备）访问，可集成第三方应用扩展功能。

详细使用方法和配置说明

基本部署（Docker命令）

拉取镜像并创建容器。/docker可替换为宿主机器上的任意路径。需修改MariaDB的MYSQL_ROOT_PASSWORD和MYSQL_PASSWORD值，也可调整Nextcloud的UID、GID及其他环境变量（见“环境变量”部分）。

bash
docker pull docker.xuanyuan.run/benyanke/nextcloud:10.0 && docker pull docker.xuanyuan.run/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 \
       docker.xuanyuan.run/mariadb:10
       
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 \
       docker.xuanyuan.run/benyanke/nextcloud:10.0

无需强制设置ADMIN_USER和ADMIN_PASSWORD，若不提供，可通过浏览器配置管理员账户。

部署完成后需使用反向代理通过互联网访问容器（详见下文“反向代理”部分）。通过环境变量配置后，无网页设置页面。

ARM架构设备

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

配置建议

在管理面板中，应将定时任务从AJAX cron切换为cron（系统定时任务）。

更新方法

拉取新版本镜像，按“基本部署”步骤重建容器。由于使用外部卷，数据不会丢失。若Nextcloud执行完整升级，应用可能被禁用，需重新启用（12.0.x及以上版本升级后应用会自动启用）。

Docker Compose配置

推荐使用https://docs.docker.com/compose/管理容器。创建`docker-compose.yml`文件（根据需求调整），执行`docker-compose up -d nextcloud-db等待数据库启动（约15秒），再执行docker-compose up -d启动所有服务。后续只需执行docker-compose up -d`即可。

Docker Compose示例文件

请勿直接复制粘贴，需根据实际需求调整！

yaml
version: '2'

networks:
  default:
    driver: bridge

services:
  nextcloud:
    image: docker.xuanyuan.run/benyanke/nextcloud
    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
      - APP_AUTO_UPDATE=1
    volumes:
      - /docker/nextcloud/data:/data
      - /docker/nextcloud/config:/config
      - /docker/nextcloud/apps:/apps2
      - /docker/nextcloud/themes:/nextcloud/themes

  # 使用MySQL时添加
  nextcloud-db:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/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: docker.xuanyuan.run/redis:alpine
    container_name: redis
    volumes:
      - /docker/nextcloud/redis:/data

更新命令：docker-compose pull && docker-compose up -d

Redis配置

Redis可用于分布式缓存和文件锁缓存，配合APCu（本地缓存）提升Nextcloud性能。PHP Redis扩展已预装，只需部署Redis服务器（可通过上述docker-compose配置），并在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服务器（上述docker-compose已提供示例）。安装Nextant应用后，在管理面板“附加设置”中，将“Solr Servlet地址”设为http://solr:8983/solr。

提示：如何使用occ命令

提供专用脚本，无需登录容器或设置权限，直接执行：docker exec -ti nextcloud occ 命令

反向代理

推荐使用HTTPS访问Nextcloud（强烈建议：必须通过加密连接访问），可使用nginx、Haproxy、Caddy、h2o、Traefik等反向代理。容器已发送包含HSTS的响应头，无需重复添加。Let's Encrypt提供免费SSL/TLS证书。

推荐使用https://github.com/xataz/docker-reverse-nginx，基于最新nginx和OpenSSL，通过https://github.com/xenolf/lego（Let's Encrypt客户端）实现SSL/TLS自动化，无需手动配置。

配置步骤

1. 为Nextcloud容器添加标签：

yaml
  nextcloud:
  ...
    labels:
      - reverse.frontend.domain=cloud.domain.tld
      - reverse.backend.port=8888
      - reverse.frontend.ssl=true
      - reverse.frontend.ssltype=ec384
      - reverse.frontend.hsts=false
      - reverse.frontend.headers=false

2. 在docker-compose中添加反向代理容器：

yaml
  reverse:
    image: docker.xuanyuan.run/xataz/reverse-nginx
    container_name: reverse
    ports:
      - "80:8080"
      - "443:8443"
    environment:
      - EMAIL=admin@domain.tld
    volumes:
      - /docker/reverse/ssl:/nginx/ssl
      - /var/run/docker.sock:/var/run/docker.sock
    depends_on:
      - nextcloud

完成后即可通过HTTPS访问Nextcloud。