zhaojun1998/zfile-pro Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

zfile Docker镜像是基于zfile在线文件列表程序的容器化部署方案，旨在简化部署流程，帮助用户快速搭建支持多存储后端的文件管理系统。该程序支持本地存储、阿里云OSS、腾讯云COS、七牛云、AWS S3等多种存储源，提供直观的Web界面，满足个人或企业对文件存储、管理、分享的需求。

核心功能与特性

• 多存储后端支持：兼容本地存储、阿里云OSS、腾讯云COS、七牛云、华为云OBS、AWS S3等主流对象存储服务，支持同时管理多个存储源。
• 直观Web界面：采用响应式设计，支持深色/浅色模式切换，界面简洁美观，操作流程符合用户习惯。
• 完善权限控制：支持基于路径的权限管理，可设置公开访问、密码保护、用户角色权限等多种访问策略。
• 丰富文件操作：支持文件上传、下载、删除、重命名、移动、复制、新建目录等基础操作，支持大文件分片上传。
• 高级功能集成：提供文件搜索、目录加密、图片预览、视频播放（支持MP4等主流格式）、文档在线预览（PDF、Office等）。
• 性能与安全优化：支持文件缓存机制提升访问速度，集成HTTPS、IP访问限制、登录认证等安全防护功能。

使用场景

• 个人文件管理：搭建个人云盘，统一管理本地硬盘与云端存储文件，替代传统FTP或本地文件共享。
• 企业文件共享：企业内部部门文件协作、跨团队资源共享，通过权限控制确保数据安全。
• 开发者资源站：分享开发工具、SDK、文档等资源，支持按分类展示和关键词搜索。
• 服务器文件管理：通过Web界面远程管理服务器文件，无需SSH登录，提升操作便捷性。
• 存储服务展示：为对象存储（如OSS、COS）提供可视化前端，方便展示和分享存储内容。

使用方法

Docker快速部署

通过以下命令一键启动zfile容器：

bash
docker run -d \
  --name zfile \
  -p 8080:8080 \
  -v /宿主机/data目录:/app/data \
  -v /宿主机/conf目录:/app/conf \
  --restart always \
  zfile-dev/zfile:latest

参数说明：

• -p 8080:8080：将容器8080端口映射到宿主机8080端口（可根据需求修改宿主机端口）。
• -v /宿主机/data目录:/app/data：挂载数据目录，存储数据库文件、日志及临时数据（需替换为实际路径）。
• -v /宿主机/conf目录:/app/conf：挂载配置目录，持久化应用配置文件（需替换为实际路径）。
• --restart always：设置容器开机自启。

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  zfile:
    image: zfile-dev/zfile:latest
    container_name: zfile
    ports:
      - "8080:8080"  # 端口映射，左侧为宿主机端口
    volumes:
      - ./zfile-data:/app/data  # 数据目录持久化（当前目录下zfile-data文件夹）
      - ./zfile-conf:/app/conf  # 配置目录持久化（当前目录下zfile-conf文件夹）
    restart: always  # 容器重启策略

执行以下命令启动服务：

bash
docker-compose up -d

配置说明

环境变量配置

通过环境变量自定义服务参数（在docker run中添加-e 变量名=值或在docker-compose.yml的environment中配置）：

初始化配置流程

1. 容器启动后，访问[***]进入初始化引导界面。
2. 完成管理员账号设置（用户名、密码）。
3. 添加存储源：选择存储类型（如本地存储/阿里云OSS），配置存储路径、访问密钥等参数。
4. 设置存储源访问路径（如/oss），配置权限策略（公开/密码保护/角色权限）。
5. 保存配置后即可通过Web界面管理文件。

数据持久化说明

为避免容器重启后配置和数据丢失，需确保以下目录已挂载到宿主机：

• /app/data：存储H2数据库文件（默认）、日志文件、上传临时文件。
• /app/conf：存储应用配置文件（如application.yml、存储源配置等）。

参考资源

• 官方部署文档：[***]
• 官方网站：[***]
• 演示站：[***]
• 源码仓库：[***]