ZFile：全能型在线网盘程序，让你的对象存储（OSS/S3/OneDrive）瞬间变身精美网盘！

如果你手手里有阿里云 OSS、腾讯云 COS、华为云 OBS，或者拥有大容量的 OneDrive、Google Drive，你一定苦恼过：这些存储虽然强大，但官方后台的预览和分享界面实在太难用了。

ZFile 是一款基于 Java 开发的开源网盘目录展示程序。它不直接存储文件，而是作为一个极其精美的“前端外壳”，将你的各种底层存储聚合在一起，提供类似于百度网盘、阿里云盘的在线浏览、搜索、预览及下载体验。

🛠️ 为什么它是“神器”？

• 聚合管理：一个界面管理所有云存储。
• 在线预览：无需下载，直接在线看视频（支持字幕）、听音乐、看 PDF、甚至在线编辑代码。
• 直链分发：为文件生成永久直链，非常适合作为图床或静态资源分发站。
• 极速搜索：支持全局搜索，找文件不再是大海捞针。

---

✨ 核心功能亮点

• 🌈 颜值爆表：基于 Vue3 + Element Plus，支持自定义主题色、公告栏、文档说明。
• 📦 多存储支持：
  • 本地存储：服务器硬盘。
  • 对象存储：S3 协议、阿里云 OSS、腾讯云 COS、华为云 OBS、七牛云 KODO 等。
  • 云盘支持：OneDrive（支持世纪互联）、Google Drive。
  • 其他：FTP、SFTP、WebDAV。
• 🎬 强大的预览引擎：
  • 视频：支持多线路、弹幕、倍速播放。
  • 文档：支持 Office 在线预览（需配置）、Markdown 渲染、文本编辑。
• 🛡️ 安全防护：支持特定文件夹加锁（密码访问），支持 IP 黑白名单。

---

🏗️ 准备工作

在部署 ZFile 之前，请确保你的服务器满足以下前置需求：

需求项目	建议配置	备注
操作系统	Linux (推荐) / Windows / macOS	推荐 Ubuntu 22.04+
Java 环境	JDK 1.8 / 11	如果使用 Docker 则无需手动安装
数据库	H2 (内置) / MySQL	小规模使用默认 H2 即可
内存占用	512MB 以上	Java 程序启动约占用 200MB+

---

🚀 全方案部署教程

方案一：Docker 部署（保姆级推荐 ⭐️）

这是最简单、最干净的安装方式，适合绝大多数用户。

# 1. 创建映射目录
mkdir -p /opt/zfile/db /opt/zfile/logs /opt/zfile/config

# 2. 启动容器
docker run -d \
  --name zfile \
  -p 8080:8080 \
  -v /opt/zfile/db:/root/.zfile-v4/db \
  -v /opt/zfile/logs:/root/.zfile-v4/logs \
  -v /opt/zfile/config:/root/.zfile-v4/config \
  --restart always \
  zfile/zfile:latest

方案二：Docker Compose 部署（稳定维护）

适合需要配合 Nginx 反代或其他容器一起管理的用户。

1. 创建 docker-compose.yml：

version: '3.3'
services:
    zfile:
        container_name: zfile
        image: zfile/zfile:latest
        restart: always
        ports:
            - '8080:8080'
        volumes:
            - './db:/root/.zfile-v4/db'
            - './logs:/root/.zfile-v4/logs'
            - './config:/root/.zfile-v4/config'

2. 运行指令：docker-compose up -d

方案三：Linux 一键脚本（传统部署）

如果你不想使用 Docker，可以使用官方提供的一键脚本：

# 下载并安装（适用于 Centos/Debian/Ubuntu）
curl -sSO https://zfile.vip/install.sh && bash install.sh

---

⚙️ 初始配置指南

1. 初始化：浏览器访问 http://服务器IP:8080，首次进入会跳转到安装向导。
2. 设置管理员：配置你的管理员账号和密码。
3. 添加存储源：
   • 进入后台 -> 存储源设置 -> 新增。
   • 选择你的存储类型（如“本地存储”或“阿里云 OSS”）。
   • 填写 AccessKey、SecretKey 等必要信息。
4. 预览设置：在后台“显示设置”中可以开启视频预览、音频预览等增强功能。

---

📝 总结评价

✅ 优点

• 跨平台适配：Java 编写，Windows 和 Linux 都能跑。
• 功能极其成熟：预览功能是目前同类开源项目中做得最精细的。
• 搜索性能强：即使文件成千上万，搜索依然丝滑。

❌ 缺点

• 资源占用：相比 Python 或 Go 编写的工具（如 FileCodeBox），Java 的内存开销略大。

---

🔗 项目官方资源

类型	地址
GitHub 仓库	zfile-dev/zfile
官方文档	https://docs.zfile.vip/
演示 Demo	https://demo.zfile.vip/