hoellen/nextcloud

hoellen/nextcloud

镜像概述和主要用途

hoellen/nextcloud是一个基于Alpine Linux的Nextcloud容器镜像，集成了nginx和PHP 7.3环境，旨在提供轻量、安全且功能完善的私有云存储解决方案。该镜像支持自动安装配置，确保数据与应用持久化，并兼容多种数据库和缓存系统，适合个人或小型团队部署私有云服务。

核心功能和特性

• 基于Alpine Linux构建，轻量高效
• 集成nginx和PHP 7.3环境（基于hoellen/nginx-php镜像）
• 支持通过环境变量实现自动安装配置
• 构建过程中验证包完整性（SHA512）和真实性（PGP）
• 数据和应用持久化存储
• 预安装并配置OPCache（opcode缓存）和APCu（本地缓存）
• 系统定时任务（cron）运行支持
• 兼容MySQL、PostgreSQL（需外部服务）和SQLite3数据库
• 支持Redis、FTP、SMB、LDAP、IMAP协议
• 包含GNU Libiconv库，解决部分应用的php iconv扩展错误
• 全程无root进程运行，增强安全性
• 提供丰富的环境变量配置选项

标签说明

• latest：最新稳定版本（22.0）
• 22.0：最新22.0.x稳定版本
• 21.0：最新21.0.x旧稳定版本
• 20.0：最新20.0.x已弃用版本
• 19.0：最新19.0.x版本（生命周期结束）
• 18.0：最新18.0.x版本（生命周期结束）
• 17.0：最新17.0.x版本（生命周期结束）
• 16.0：最新16.0.x版本（生命周期结束）
• 15.0：最新15.0.x版本（生命周期结束）
• 14.0：最新14.0.x版本（生命周期结束）
• 13.0：最新13.0.x版本（生命周期结束）
• 12.0：最新12.0.x版本（生命周期结束）
• 11.0：最新11.0.x版本（生命周期结束）
• daily：每日构建的最新开发代码版本

注：除daily标签外，其他标签每周构建一次。出于安全考虑，即使使用最新版本的Nextcloud，也应定期更新容器。

构建时变量

• NEXTCLOUD_VERSION：Nextcloud版本号
• 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）
• PHP_MAX_CHILDREN：PHP最大子进程数（默认：15）
• PHP_START_SERVERS：PHP启动时进程数（默认：2）
• PHP_MIN_SPARE_SERVERS：PHP最小空闲进程数（默认：1）
• PHP_MAX_SPARE_SERVERS：PHP最大空闲进程数（默认：6）
• CRON_PERIOD：定时任务执行间隔（默认：15m）
• CRON_MEMORY_LIMIT：定时任务PHP内存限制（默认：1024m）
• TZ：系统/日志时区（默认：Etc/UTC）
• ADMIN_USER：管理员账户用户名（默认：无，需通过Web配置）
• ADMIN_PASSWORD：管理员账户密码（默认：无，需通过Web配置）
• DOMAIN：设置时使用的域名（默认：localhost）
• DB_TYPE：数据库类型（sqlite3、mysql或pgsql，默认：sqlite3）
• DB_NAME：数据库名称（默认：无）
• DB_USER：数据库用户名（默认：无）
• DB_PASSWORD：数据库用户密码（默认：无）
• DB_HOST：数据库主机地址（默认：无）
• CHECK_PERMISSIONS：禁用/data文件夹权限检查（默认：1）

重要：管理员账户请使用强密码！

端口

• 8888：Nextcloud HTTP服务端口

数据卷

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

数据库配置

可使用主机或其他机器上的数据库实例，推荐使用外部数据库容器（如MariaDB）。以下是MariaDB配置示例，PostgreSQL也同样适用。

提示：可能需要根据硬件调整数据库设置以优化性能，参考Nextcloud文档。

部署步骤

拉取镜像并创建容器。以下示例中/docker为宿主机目录，可根据实际情况调整。请修改MYSQL_ROOT_PASSWORD和MYSQL_PASSWORD等敏感信息。

bash
# 拉取镜像
docker pull hoellen/nextcloud && docker pull mariadb

# 创建数据库容器
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

# 创建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 \
       hoellen/nextcloud

注：ADMIN_USER和ADMIN_PASSWORD为可选参数，若不提供，可通过Web界面配置管理员账户。

推荐使用Docker Compose

建议使用docker-compose管理容器。创建docker-compose.yml文件如下（根据实际需求调整）：

yaml
version: '2'

networks:
  default:
    driver: bridge

services:
  nextcloud:
    image: hoellen/nextcloud
    depends_on:
      - nextcloud-db           # 使用MySQL时依赖
      - 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
      - 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

  # Redis缓存配置
  redis:
    image: redis:alpine
    container_name: redis
    volumes:
      - /docker/nextcloud/redis:/data

部署命令：

bash
# 启动数据库并等待15秒
docker-compose up -d nextcloud-db
# 启动所有服务
docker-compose up -d
# 更新服务
docker-compose pull && docker-compose up -d

配置Redis缓存

Redis可用于分布式缓存和文件锁，配合APCu（本地缓存）提升性能。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,
   ),

管理命令（occ）使用

通过容器执行occ命令：

bash
docker exec -ti nextcloud occ 命令

反向代理配置

支持nginx、Haproxy、Caddy、h2o、Traefik等反向代理。容器已发送包括HSTS在内的HTTP头，无需重复配置。强烈建议（必须）通过HTTPS访问Nextcloud，可使用Let's Encrypt获取免费SSL证书。

配置建议

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

更新方法

拉取新版本镜像后，按部署步骤重新创建容器。由于使用外部数据卷，数据不会丢失，Nextcloud会自动处理数据库迁移。