grandmaster/nextcloud-preview

Nextcloud 增强预览版 Docker 镜像

镜像概述

本镜像基于官方Nextcloud构建，集成了额外的预览提供者组件，扩展了可预览的文件类型范围。Nextcloud是一款开源的私有云存储解决方案，提供文件存储、共享、协作等核心功能，而本镜像通过增强预览能力，进一步提升了文件管理的直观性和用户体验。

核心功能与特性

基础功能

• 完整保留官方Nextcloud的全部核心功能，包括文件存储、用户管理、访问控制、文件共享、版本控制等
• 支持WebDAV、CalDAV、CardDAV等标准协议
• 可扩展的应用生态系统，支持安装第三方应用

增强特性

• 扩展预览支持：集成额外预览提供者，支持更多文件类型的预览，包括但不限于：
  • 视频文件：MP4、AVI、MKV、FLV等常见格式
  • 办公文档：DOCX、XLSX、PPTX等Office 2007+格式
  • 电子书：EPUB、MOBI格式
  • 矢量图形：SVG、AI、EPS格式
  • CAD文件：DXF、DWG（基础预览）
• 预配置优化：预览功能开箱即用，无需手动安装依赖或配置
• 性能优化：预览生成过程经过优化，减少服务器资源占用

使用场景

• 个人私有云：需要预览多种格式文件的个人用户，提升文件管理体验
• 团队协作平台：企业或团队用于文档共享与协作，支持快速预览各类办公文件
• 教育资源库：学校或培训机构存储教学资料，支持多种格式课件预览
• 创意工作流：设计团队共享设计文件，支持预览矢量图、CAD等专业格式
• 媒体管理系统：存储和预览各类媒体文件，无需额外打开专用软件

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name nextcloud-preview \
  -p 8080:80 \
  -v nextcloud_data:/var/www/html/data \
  -v nextcloud_config:/var/www/html/config \
  -v nextcloud_apps:/var/www/html/apps \
  -e NEXTCLOUD_ADMIN_USER=admin \
  -e NEXTCLOUD_ADMIN_PASSWORD=your_secure_password \
  --restart unless-stopped \
  docker.xuanyuan.run/nextcloud-with-preview-providers

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3'

services:
  nextcloud:
    image: docker.xuanyuan.run/nextcloud-with-preview-providers
    container_name: nextcloud-preview
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - NEXTCLOUD_ADMIN_USER=admin
      - NEXTCLOUD_ADMIN_PASSWORD=your_secure_password
      - NEXTCLOUD_TRUSTED_DOMAINS=localhost 192.168.1.100
    volumes:
      - nextcloud_data:/var/www/html/data
      - nextcloud_config:/var/www/html/config
      - nextcloud_apps:/var/www/html/apps
      - nextcloud_theme:/var/www/html/themes
    depends_on:
      - db
      - redis

  db:
    image: docker.xuanyuan.run/mariadb:10.6
    container_name: nextcloud-db
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=db_root_password
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_PASSWORD=db_user_password
    volumes:
      - db_data:/var/lib/mysql

  redis:
    image: docker.xuanyuan.run/redis:alpine
    container_name: nextcloud-redis
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  nextcloud_data:
  nextcloud_config:
  nextcloud_apps:
  nextcloud_theme:
  db_data:
  redis_data:

启动服务：

bash
docker-compose up -d

环境变量配置

预览功能配置

预览提供者配置文件位于容器内/var/www/html/config/config.php，可通过挂载配置卷进行自定义：

php
'preview_providers' => [
    'OC\Preview\PNG',
    'OC\Preview\JPEG',
    'OC\Preview\GIF',
    'OC\Preview\BMP',
    'OC\Preview\XBitmap',
    'OC\Preview\MP3',
    'OC\Preview\TXT',
    'OC\Preview\MarkDown',
    // 额外预览提供者
    'OC\Preview\Office',       // Office文档
    'OC\Preview\Video',        // 视频文件
    'OC\Preview\Epub',         // 电子书
    'OC\Preview\SVG',          // 矢量图形
    'OC\Preview\CAD',          // CAD文件
],

数据持久化

为确保数据安全，建议挂载以下卷：

• nextcloud_data：存储用户文件数据
• nextcloud_config：存储配置文件
• nextcloud_apps：存储已安装应用
• nextcloud_theme：存储自定义主题（如使用）

注意事项

• 首次启动时，镜像会自动安装并配置额外的预览依赖，可能需要较长时间
• 预览功能对服务器资源有一定要求，建议配置至少2GB内存
• 对于大型视频文件预览，可能需要调整preview_max_filesize参数
• 升级镜像前建议备份数据卷，以防配置冲突