MCPcopy Index your code
hub / github.com/zfile-dev/zfile

github.com/zfile-dev/zfile @4.5.0

repository ↗ · DeepWiki ↗ · release 4.5.0 ↗ · Ask this repo → · + Follow
1,572 symbols 5,479 edges 415 files 767 documented · 49% updated 50d ago4.5.0 · 2025-11-12★ 10,78458 open issues
README
<a href="https://zfile.vip" target="_blank" rel="noopener noreferrer">
    <img style="margin: auto; width: 100px; display: block" src="https://github.com/zfile-dev/zfile/raw/4.5.0/img/logo-zfile.png" alt="ZFile" />
</a>

ZFile 是一个适用于个人或小团队的在线网盘程序,可以将多种存储类型统一管理,再也不用登录各种网站管理文件,现在你只需要在 ZFile 中畅快使用!

<img alt="last commit"      src="https://shields.io/github/last-commit/zfile-dev/zfile.svg?style=flat-square"/>
<img alt="downloads"        src="https://shields.io/github/downloads/zfile-dev/zfile/total?style=flat-square"/>
<img alt="release version"  src="https://shields.io/github/v/release/zfile-dev/zfile?style=flat-square"/>
<img alt="commit activity"  src="https://shields.io/github/commit-activity/y/zfile-dev/zfile?style=flat-square"/>
<img alt="open issues"      src="https://shields.io/github/issues/zfile-dev/zfile?style=flat-square"/>
<img alt="closed issues"    src="https://shields.io/github/issues-closed-raw/zfile-dev/zfile?style=flat-square"/>
<img alt="forks"            src="https://shields.io/github/forks/zfile-dev/zfile?style=flat-square"/>
<img alt="stars"            src="https://shields.io/github/stars/zfile-dev/zfile?style=flat-square"/>
<img alt="watchers"         src="https://shields.io/github/watchers/zfile-dev/zfile?style=flat-square"/>
<img alt="gitcode"          src="https://gitcode.com/zfile-dev/zfile/star/badge.svg"/>



<span>
    <a href="https://zfile.vip">官网</a>
    <span> | </span>
    <a href="https://docs.zfile.vip">文档</a>
    <span> | </span>
    <a href="https://demo.zfile.vip">预览地址</a>
</span>

系统特色

  • Docker、Docker Compose 支持(amd64, arm64)。
  • 支持对文件生成直链、短链(可设过期时间)。
  • 响应式设计,支持手机、平板、电脑等多种设备访问。
  • 支持多用户功能,可分配给指定用户指定存储源或目录。
  • 支持在线浏览图片、播放音视频,文本文件、Office、Obj(3d)等文件类型。
  • 支持对接 S3、OneDrive、SharePoint、Google Drive、多吉云、又拍云、本地存储、FTP、SFTP 等存储源。
  • 支持常用快捷键,Ctrl + A 全选,Ctrl + 左键 多选,Shift + 左键 范围选择,Esc 取消全选等。
  • 支持限速下载(捐赠版)
  • 支持限制指定用户可查看、上传的文件类型(捐赠版)

快速开始

一键脚本安装:

curl -sSL https://docs.zfile.vip/install.sh -o install.sh && chmod +x install.sh && ./install.sh

更多安装方式请参考 安装文档

功能预览

文件列表

文件列表

画廊模式

图片预览

视频预览

视频预览

文本预览

文本预览

音频预览

音频预览

PDF 预览

PDF 预览

Office 预览

Office 预览

3d 文件预览

3d 文件预览

生成直链

生成直链

页面设置

页面设置

后台设置-登录

后台设置-登录

后台设置-存储源列表

后台设置-存储源列表

后台设置-添加存储源(本地存储)

后台设置-添加存储源(本地存储)

后台设置-用户管理

后台设置-存储源权限控制

后台设置-显示设置

后台设置-显示设置

支持作者

如果本项目对你有帮助,请作者喝杯咖啡吧。

赞助我

Star History

Star History Chart

Sponsors

NodeSupport 赞助了该项目

Extension points exported contracts — how you extend this code

RefreshTokenService (Interface)
需要刷新 Token 服务的存储源 @author zhaojun [8 implementers]
src/main/java/im/zhaojun/zfile/module/storage/service/base/RefreshTokenService.java
PasswordConfigMapper (Interface)
存储源密码配置表 Mapper 接口 @author zhaojun [4 implementers]
src/main/java/im/zhaojun/zfile/module/password/mapper/PasswordConfigMapper.java
ReadmeConfigMapper (Interface)
存储源文档配置表 Mapper 接口 @author zhaojun [4 implementers]
src/main/java/im/zhaojun/zfile/module/readme/mapper/ReadmeConfigMapper.java
LoginVerifyService (Interface)
(no doc) [8 implementers]
src/main/java/im/zhaojun/zfile/module/user/service/login/verify/LoginVerifyService.java
BaseFileService (Interface)
基础文件服务接口,定义了了一些通用方法定义 @author zhaojun [4 implementers]
src/main/java/im/zhaojun/zfile/module/storage/service/base/BaseFileService.java

Core symbols most depended-on inside this repo

concat
called by 157
src/main/java/im/zhaojun/zfile/core/util/StringUtils.java
getCurrentUserBasePath
called by 108
src/main/java/im/zhaojun/zfile/module/storage/service/base/AbstractBaseFileService.java
getName
called by 101
src/main/java/im/zhaojun/zfile/core/util/FileUtils.java
put
called by 90
src/main/java/im/zhaojun/zfile/module/link/cache/LinkRateLimiterCache.java
isEmpty
called by 85
src/main/java/im/zhaojun/zfile/core/util/ArrayUtils.java
equals
called by 72
src/main/java/im/zhaojun/zfile/module/storage/model/dto/ZFileCORSRule.java
getSuccessData
called by 72
src/main/java/im/zhaojun/zfile/core/util/AjaxJson.java
isNotEmpty
called by 68
src/main/java/im/zhaojun/zfile/core/util/ArrayUtils.java

Shape

Method 1,141
Class 383
Interface 29
Enum 19

Languages

Java100%

Modules by API surface

src/main/java/im/zhaojun/zfile/module/storage/service/base/AbstractMicrosoftDriveService.java35 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/impl/GoogleDriveServiceImpl.java33 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/impl/Open115ServiceImpl.java30 symbols
src/main/java/im/zhaojun/zfile/core/util/matcher/impl/IpRuleMatcher.java29 symbols
src/main/java/im/zhaojun/zfile/module/share/service/ShareLinkService.java28 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/impl/UpYunServiceImpl.java24 symbols
src/main/java/im/zhaojun/zfile/core/exception/GlobalExceptionHandler.java24 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/impl/LocalServiceImpl.java23 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/base/AbstractS3BaseFileService.java23 symbols
src/main/java/im/zhaojun/zfile/core/util/CharSequenceUtil.java23 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/impl/WebdavServiceImpl.java22 symbols
src/main/java/im/zhaojun/zfile/module/storage/service/impl/SftpServiceImpl.java22 symbols

Dependencies from manifests, versioned

cn.dev33:sa-token-spring-boot3-starter1.38.0 · 1×
cn.hutool:hutool-all5.8.31 · 1×
com.alibaba.fastjson2:fastjson22.0.29 · 1×
com.alibaba:dns-cache-manipulator1.8.2 · 1×
com.baomidou:mybatis-plus-spring-boot3-starter3.5.6 · 1×
com.github.lookfirst:sardine5.12 · 1×
com.github.mwiede:jsch0.2.20 · 1×
com.github.oshi:oshi-core6.6.3 · 1×
com.github.xiaoymin:knife4j-openapi3-jakarta-spring-boot-starter4.5.0 · 1×
com.google.guava:guava33.3.0-jre · 1×
com.mysql:mysql-connector-j
com.qiniu:qiniu-java-sdk7.12.1 · 1×

Datastores touched

(mysql)Database · 1 repos
zfileDatabase · 1 repos

For agents

$ claude mcp add zfile \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact