标签： 网盘程序

如果你手手里有阿里云 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/

在互联网高度发达的今天，分享一个文件依然充满槽点：网盘限速、社交软件扫描隐私、跨平台登录账号繁琐。

FileCodeBox (文件快递柜) 是一款基于 FastAPI 框架开发的开源轻量级文件分享系统。它的设计灵感直接来源于现实生活中的快递柜模式：

存件人：上传文件/文本，系统自动生成一个唯一的“取件码”。 取件人：无需注册，输入 5 位取件码，瞬间完成提取。

这不仅仅是一个文件上传工具，它更像是一个跨设备的数据中转站。无论是代码片段、安装包还是私密文档，它都能以最优雅的方式在你的电脑、手机、服务器之间流转。

---

✨ 核心功能亮点

• 🚀 极简交互：五位数取件码，跨设备传输只需几秒钟。
• 🎨 高颜值 UI：基于 Vue3 + Naive UI 打造，支持暗黑模式，响应式适配手机端。
• 🔒 隐私保护：支持设置过期时间、下载次数限制，甚至可以给文件加锁。
• 📂 多端存储：默认本地存储，同时完美对接 S3、阿里云 OSS、腾讯云 COS 等对象存储。
• 🛠️ 后台管理：自带强大的管理面板，支持文件管理、系统设置及公告发布。
• ⚡ 高性能：基于 FastAPI 异步框架，占用极低，哪怕是 1核512M 的小鸡也能流畅运行。

---

🛠️ 部署前准备

在开始安装之前，请确保你的服务器环境满足以下要求：

需求项目	最低配置 / 要求	推荐配置
操作系统	Linux (Ubuntu/CentOS/Debian)	Docker 环境 (任意 OS)
内存	256 MB	512 MB+
磁盘	视存储需求而定	建议 10GB 以上
依赖环境	Docker & Docker Compose	Docker 20.10+

---

🚀 全方案部署教程

方案一：Docker 一键部署（推荐 ⭐️）

这是最简单、最不容易出错的方式，适合大部分用户。

docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

一键更新命令

docker pull lanol/filecodebox:beta && docker stop filecodebox && docker rm filecodebox && docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

方案二：Docker Compose 部署（进阶推荐）

如果你需要配合 Nginx Proxy Manager 等工具使用，Docker Compose 更加优雅。

1. 在目录下创建 docker-compose.yml：

version: '3'
services:
  filecodebox:
    image: vastsa/filecodebox:latest
    container_name: filecodebox
    restart: always
    ports:
      - "12345:12345"
    volumes:
      - ./data:/app/data

2. 执行启动命令：

docker-compose up -d

方案三：源码手动部署（适合二次开发）

如果你希望在 Python 环境下直接运行：

# 克隆仓库
git clone https://github.com/vastsa/filecodebox.git
cd filecodebox

# 安装依赖
pip install -r requirements.txt

# 启动服务
python3 main.py

---

⚙️ 初始配置说明

1. 访问地址：部署完成后，访问 http://你的服务器IP:12345。
2. 管理后台：点击页面上的“管理”或直接访问 /admin。
3. 默认密码：初始管理密码通常为 FileCodeBox2023 (请务必在第一时间进入后台修改密码)。
4. 反向代理：建议使用 Nginx 进行反向代理并开启 HTTPS，确保传输安全。

---

📝 总结与评价

✅ 优点

1. 轻量化：镜像极小，启动速度极快。
2. 零门槛：取件人不需要任何学习成本，输入 5 位数字即可。
3. 扩展性强：支持各种云存储，不用担心服务器硬盘被撑爆。

❌ 缺点

1. 安全性平衡：取件码机制虽然方便，但如果不设置复杂的后缀或管理权限，容易被暴力破解取件码（建议在后台设置取件码位数及有效期）。

💡 适用建议

• 个人/家庭：作为跨设备的“剪贴板”和文件转运站。
• 小微企业/团队：局域网内分发软件安装包、技术文档。
• 开发者：作为临时静态资源的托管方案。

---

🔗 项目相关资源

资源类型	地址
GitHub 仓库	vastsa/FileCodeBox
官方文档	https://fcb-docs.aiuo.net/
Demo	https://share.lanol.cn/#/

---

希望这篇教程能帮你搭建起属于自己的私有“快递柜”！如果你在部署过程中遇到任何问题，欢迎在下方留言讨论。

你是否也面临这样的困扰：阿里云盘存电影、OneDrive 存文档、百度网盘存资料，每次找东西都要切好几个 App？

OpenList 就是为了终结这种混乱而生的。它通过标准化的接口，将各种云存储、本地存储挂载到一个统一的、极简的网页界面中。不仅支持在线预览，还能直接作为视频流源，配合 PotPlayer 瞬间变身个人私有影院。

---

🌟 OpenList 核心功能：网盘界的“大一统”

OpenList 之所以能在众多列表程序中脱颖而出，靠的是这几项核心硬实力：

• ☁️ 多存储深度支持：完美挂载 阿里云盘、天翼云盘、OneDrive、Google Drive、WebDAV、本地存储 等。
• 🎬 在线流媒体播放：内置高性能视频播放器，支持字幕加载，云端高清大片无需下载，在线即看。
• 🚀 极速文件管理：支持跨盘文件操作，极速搜索，且目录树加载优化到了毫秒级。
• 🔗 直链提取：一键生成文件直链，方便分享或配合 Aria2 等工具进行高速下载。
• 🛡️ 权限细分：支持为不同的目录设置访问密码，保护你的私密资源。

---

🛠️ 准备工作：前置环境需求

• 服务器：境内外 VPS 均可，建议配置 1GB 内存以上。
• 域名（可选）：建议配置域名并开启 HTTPS，以便实现 WebDAV 稳定挂载。
• 环境：推荐使用 Docker 部署，省去配置各种运行库的麻烦。

---

🚀 部署步骤：三步搭建你的云端资源库

1️⃣ 方案一：Docker Compose 一键部署（推荐 🐳）

这是目前最稳定、且方便后续升级的方案。

# docker-compose.yml
services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    restart: always
    ports:
      - "5244:5244"   # 默认映射端口
    volumes:
      - ./data:/app/data  # 挂载配置数据，防止重启后丢失
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai

启动指令：

docker-compose up -d

访问 http://服务器IP:5244 即可进入管理后台。

---

2️⃣ 方案二：手动挂载存储（实战操作）

进入后台后，核心步骤如下：

1. 添加存储：点击“存储” -> “添加”，选择你要挂载的网盘类型（如阿里云盘）。
2. 获取 Token：根据页面提示，通过扫码或授权获取 Token 填入。
3. 设置路径：指定挂载到 OpenList 的哪个文件夹下。
4. 保存即看：刷新首页，你的云端文件已经整齐地躺在那儿了。

---

📝 总结评价

✅ 优点：

• 多合一管理：一个页面看遍所有网盘，效率神器。
• 预览强大：文档、代码、图片、视频几乎全格式支持在线预览。
• 国产优化：对国内主流网盘的支持非常到位，更新迭代迅速。

❌ 缺点：

• Token 时效性：受限于网盘平台的 API，部分网盘需要定期更新授权。
• 流量开销：如果作为中转下载，会消耗服务器流量（建议开启“重定向”模式以节省流量）。

---

🔗 项目地址与信息汇总

项目信息	内容 / 链接
GitHub 仓库	OpenListTeam/OpenList
官方文档	OpenList 使用指南
核心技术栈	Vue.js + Golang / Node
开源协议	AGPL-3.0

---

小编点评：如果你还在为手机里装了 5 个网盘 App 而烦恼，或者想让电视盒子直接播放网盘里的 4K 原盘，OpenList 绝对是你服务器里必装的“第一生产力工具”。

蓝眼云盘 (Tank) 是一款主打“极简主义”的开源私有云存储系统，采用 Go 语言后端与 React 前端架构，仅以约 10MB 的精小体积实现了跨平台支持与强大的文件管理能力。它支持 SQLite 开箱即用，集成 URL 抓取、图床处理及共享空间等高级功能，是追求极致性能与简单部署的开发者首选。

---

核心特色亮点

特性维度	亮点描述
轻量跨平台	运行包仅 10MB 左右；完美支持 Win、Linux、macOS。
部署零门槛	支持 Docker 与 SQLite，无需配置复杂数据库，真正开箱即用。
全能上传	支持拖拽、URL 远程抓取、剪贴板粘贴及文件夹直接上传。
协作管理	拥有共享空间功能，支持多用户协同管理，适合小团队。
开发者友好	提供完整的 API 接口，可直接作为网站的第三方后端存储。
多媒体处理	自定义预览接口，支持图片实时裁剪/缩放缓存，秒变专业图床。

🚀 蓝眼云盘 (Tank) 多平台安装部署指南

蓝眼云盘支持多种部署方式，无论你是个人桌面用户还是服务器运维人员，都能找到合适的安装方案。

📌 前置要求

• 数据库： 准备 MySQL 5.7+ 数据库（推荐），需使用 UTF-8 (utf8mb4) 编码以支持中文文件名。
• 轻量选择： 亦支持 SQLite（开箱即用，无需安装数据库）。

---

🐧 Linux 部署

1. 基本步骤

1. 在 MySQL 中创建一个名为 tank 的数据库。
2. 下载并解压最新版安装包。
3. 进入根目录，执行：./tank
4. 访问 http://服务器IP:6010 进入安装引导。

2. 进阶：使用 Systemd 守护进程（推荐）

若需开机自启并方便管理，建议创建服务文件：

1. 创建并编辑文件：vim /etc/systemd/system/tank.service
2. 写入以下内容（注意修改 ExecStart 为你的实际路径）：

[Unit]
Description=EyeblueTank
Documentation=https://tank-doc.eyeblue.cn
Wants=network.target
After=network.target

[Service]
Type=simple
# 若使用非root用户，请指定 User=你的用户名
DynamicUser=yes
# 确保路径指向 tank 可执行文件
ExecStart=/data/program/tank/tank
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

3. 管理命令：

systemctl daemon-reload      # 重载配置
systemctl enable tank        # 设置开机启动
systemctl start tank         # 启动服务
systemctl status tank        # 查看运行状态

---

🐳 Docker 部署（最快捷）

使用 Docker 部署可以一键解决环境依赖问题。

第一步：启动 MySQL 容器

docker run --name dockermysql \
  -p 13306:3306 \
  -e MYSQL_ROOT_PASSWORD=your_password \
  -e MYSQL_DATABASE=tank \
  -e TZ=Asia/Shanghai \
  -d mysql:5.7 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci

第二步：启动蓝眼云盘容器

# 请将 x.x.x 替换为最新版本号
docker run --name tank \
  -p 6010:6010 \
  --link dockermysql:mysql \
  -v ~/data/dockermatter:/data/build/matter \
  -d eyeblue/tank:x.x.x

• 安装配置提示： 在 Web 引导页，MySQL 地址填写 mysql，端口填写 3306。

---

🪟 Windows & 🍎 macOS 部署

1. 快速启动

1. 准备： 安装并运行 MySQL（或稍后引导页选 SQLite）。
2. 运行：
   • Windows： 下载解压后，双击运行 tank.exe。
   • macOS： 下载解压后，在终端执行 ./tank。
3. 访问： 浏览器打开 http://127.0.0.1:6010 完成初始化。

2. 后台运行 (适用于 Linux/macOS)

如果你不希望一直开着终端窗口，可以使用内置脚本：

• 启动： ./startup.sh
• 停止： ./shutdown.sh

---

💡 安装小贴士

• 防火墙： 记得在云服务器后台（如阿里云、腾讯云）安全组中开启 6010 端口。
• 反向代理： 生产环境建议使用 Nginx 进行反向代理，并配置 SSL 开启 HTTPS。

---

项目核心亮点

• 极速体验： Go 语言带来的高性能，响应速度极快。
• 图床功能： 支持像 PicGo 一样作为图床使用，支持直接复制 Markdown 链接。
• 预览支持： 内置常见文档和多媒体文件的在线预览能力。
• 完全掌控： 所有数据存储在自己的服务器，安全隐私有保障。

项目地址	项目文档
Eyeblue Cloud Storage	介绍 | 蓝眼云盘

如果你有一台 1M 带宽的“小水管”服务器，却想搭建一个下载速度突破 100MB/s 的私有云盘，ZPan 是你唯一的选择。

不同于传统网盘程序，ZPan 并不“存储”你的文件。它本质上是一个 URL 签名服务器 + 可视化的文件浏览器。

---

🔥 核心逻辑：它是如何做到不限速的？

传统的网盘（如 Nextcloud）是**“中转站”**模式，你的文件需要经过服务器中转才能到达客户端。

• 传统模式速度上限 = 你的服务器出口带宽。

ZPan 采用的是“直连”模式：

1. 当你点击下载时，客户端向 ZPan 发起请求。
2. ZPan 服务器验证你的权限，并生成一个带有签名的临时下载 URL。
3. 客户端直接使用这个 URL 从 S3 存储（阿里云 OSS、腾讯云 COS 等）下载文件。

• ZPan 模式速度上限 = 你的本地网络带宽 + 云存储的下行带宽。

这意味着，即便你的服务器带宽只有 1M，你依然可以享受满速下载，因为它完全不占用服务器的流量！

---

✨ ZPan 特色一览

• 完全不受服务器带宽限制：上传下载均走云存储直连。
• 全协议支持：支持所有兼容 S3 协议的云存储（OSS, COS, OBS, MinIO 等）。
• 伪文件系统：支持文件夹管理、文件分享（未登录亦可访问）。
• 多媒体增强：内置文档预览、音视频播放。
• 多用户体系：支持多用户存储空间控制及多语言切换。
• 极简部署：Go 语言原生开发，单文件运行，部署成本极低。

---

⚖️ 竞品分析：为什么选 ZPan 而不是其他？

在发布文章时，这一段对比能帮助你的读者做出最终决定：

产品	核心区别	为什么不选它？
NextCloud	基于本地文件系统	诞生早，设计陈旧。即使挂载云存储，流量依然要过服务器中转，速度受限。
Cloudreve	功能大而全	同样支持直传，但功能过于复杂。ZPan 更加克制、专注，适合追求极致简洁的用户。
Z-File	在线目录程序	定位于个人文件库或工具站。不支持多账户管理，不适合作为云盘使用。
蓝眼云盘	传统网盘	不支持对象存储直连，仅适合本地存储。

---

🛠️ 快速安装指南（Docker 方式）

ZPan 提供了极简的部署方式，推荐使用 Docker：

docker run -d \
  --name zpan \
  -p 8222:8222 \
  -v /your/path/data:/etc/zpan \
  --restart unless-stopped \
  saltbo/zpan:latest

• 访问端口：http://服务器IP:8222
• 初始化：第一个注册的用户即为管理员。

---

🎯 总结：谁最适合 ZPan？

• 成本敏感型用户：手里有低配 VPS（水管小），但有大量 S3 存储额度。
• 极简主义者：不需要 Nextcloud 那种笨重的办公套件，只想安安静静传个文件。
• 开发者：需要一个能管理 S3 存储桶且带权限控制的可视化前端。

项目地址	项目文档
Zpan一个基于云存储的网盘系统	Zpan