ZFile Docker镜像文档

镜像概述和主要用途

ZFile是一款基于Java开发的轻量级文件存储服务，旨在提供简单、高效的文件管理与分享解决方案。该Docker镜像封装了ZFile应用及其运行环境，可快速部署至各类服务器环境，支持多种存储后端（如本地存储、对象存储等），适用于搭建个人文件库、团队协作空间或企业内部文件共享平台，提供直观的Web界面和完善的文件管理功能。

核心功能和特性

多存储后端支持

• 兼容本地文件系统、FTP/SFTP、阿里云OSS、腾讯云COS、AWS S3、MinIO等多种存储方式
• 支持同时管理多个存储源，统一界面操作不同存储后端文件

完善的文件管理功能

• 提供Web端文件上传、下载、新建文件夹、重命名、删除等基础操作
• 支持文件批量操作，提升管理效率
• 集成文件预览功能，支持图片、文档、音视频等多种格式在线预览

安全与权限控制

• 支持用户认证与权限管理，可配置不同用户对文件的访问权限
• 支持文件/文件夹级别的权限设置，保障数据安全
• 可选HTTPS加密传输，增强数据传输安全性

易用性与扩展性

• 简洁直观的Web管理界面，降低使用门槛
• 支持文件分享功能，生成临时访问链接
• 提供RESTful API，便于二次开发和系统集成
• 轻量化设计，资源占用低，运行稳定

使用场景和适用范围

个人用户

• 搭建个人文件存储中心，替代传统本地存储，实现跨设备访问
• 作为个人资源库，管理文档、照片、视频等媒体文件

团队/企业用户

• 团队内部文档协作与共享，提升协作效率
• 企业内部文件分发与管理，统一存储规范

特定场景

• 作为轻量级下载站，提供文件公开或私密下载服务
• 集成至现有系统，作为文件存储模块扩展功能

详细使用方法和配置说明

环境要求

• Docker Engine 19.03+
• 至少1GB内存，推荐2GB以上
• 存储空间根据实际存储需求配置

基础部署步骤

Docker Run 部署

bash
# 拉取镜像（若未指定tag，默认拉取latest）
docker pull zfile-dev/zfile

# 启动容器（映射端口8080，挂载数据卷至本地/path/to/zfile-data）
docker run -d \
  --name zfile \
  -p 8080:8080 \
  -v /path/to/zfile-data:/app/data \
  --restart=always \
  zfile-dev/zfile

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  zfile:
    image: zfile-dev/zfile
    container_name: zfile
    ports:
      - "8080:8080"  # 宿主机端口:容器端口，可根据需求修改
    volumes:
      - /path/to/zfile-data:/app/data  # 挂载数据卷，持久化配置和数据
    environment:
      - TZ=Asia/Shanghai  # 设置时区，可选
    restart: always  # 容器退出后自动重启

启动服务：

bash
docker-compose up -d

访问与初始化配置

1. 部署完成后，通过 [***] 访问ZFile服务
2. 首次访问将进入初始化配置向导，按提示完成存储源配置（选择存储类型、填写存储参数等）
3. 设置管理员账号密码，完成后即可登录管理界面

数据持久化说明

• 容器内/app/data目录存储应用配置、日志及本地存储文件（若使用本地存储），需通过数据卷挂载至宿主机，避免容器重启后数据丢失
• 建议定期备份宿主机挂载目录（/path/to/zfile-data），保障数据安全

配置参数说明

通过环境变量或配置文件（位于/app/data/conf/application.properties）可调整应用参数，常用配置项包括：

• server.port: 应用端口（默认8080，若修改需同步调整容器端口映射）
• spring.datasource.*: 数据库配置（默认使用H2嵌入式数据库，支持切换至MySQL等外部数据库）
• zfile.storage.*: 存储源相关配置（初始化后在管理界面配置更便捷）

***资源与文档

• 网站: []
• 详细部署文档:
  • Docker原生部署: [***]
  • 宝塔Docker应用商店部署: [***]
• 演示站: [***]
• Github仓库: [***]