
ZFile
Self-hosted web file manager that puts many storage backends (S3, OneDrive, FTP and more) behind one browsable
- Stars
- 10.9k
- Forks
- 2k
- Licence
- MIT
- Language
- Java
- Last update
- 4 days ago
- Type
- App
What it is
ZFile is a web-based cloud drive program for individuals and small teams. It connects to several existing storage services, such as S3, OneDrive, Google Drive, and local or FTP storage, and lets you browse, preview, and share files from one place. You run it on your own server, and it is available in Chinese-language documentation.
- Browse files from S3, OneDrive, or a local folder through one web interface
- Preview images, video, audio, PDFs, Office files, and 3D OBJ files in the browser
- Generate a direct link or a short link with an expiry time to share a file
- Create separate user accounts and assign each user a storage source or directory
Great for
- Individuals or small teams who already have files spread across several cloud storage services
- People who want to share direct download links or short links with expiring validity
- Users who want to give different people access to specific storage sources or folders
- Anyone deploying with Docker or Docker Compose on AMD64 or ARM64 servers
Not ideal for
- People who want a hosted service with no server to maintain, since the README describes self-hosting
- Users who need the rate-limited download and file-type restriction features, which the README marks as donor-edition only
- Teams needing a large enterprise deployment, since the README describes it as aimed at individuals and small teams
How to get it
- 1
See the README
You'll need: Docker or Docker Compose (for container deployment, per README)
Download the one-click install script
curl -fsSL https://docs.zfile.vip/install.sh -o install.shMake the script executable
chmod +x install.shRun the install script
./install.sh - 2
Run it
- Run the one-click install script from the README.
- Open the admin backend and log in.
- Add a storage source, such as local storage or S3.
- Create a user and assign them a storage source or directory.
- Open the file browser and try previewing a file or generating a link.
- 3
Get the most out of it
- Use the admin backend to connect several storage sources so they appear in one file list.
- Assign storage sources or directories per user rather than sharing one account.
- Generate short links with an expiry time when sharing files outside your team.
- Use keyboard shortcuts such as Ctrl+A and Shift+click for faster multi-file selection.
- Check the official install and changelog docs at docs.zfile.vip for deployment options beyond the script.
Downloads
Strengths
- Supports many storage backends, including S3, OneDrive, SharePoint, Google Drive, and FTP/SFTP
- Built-in online preview for many common file types, with a responsive layout for phones and tablets
- Multi-user support with per-user storage or directory assignment
Trade-offs
- Some features (download rate limiting, per-user file-type restrictions) are listed as donor-edition only
- Documentation and README are primarily in Chinese, which may slow setup for non-Chinese readers
- Self-hosting means you must secure and maintain the server yourself
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| zfile (this) | 10.9k | App | intermediate | 4 days ago | Individuals or small teams who already have files spread across several cloud storage services |
| litemall | 20.4k | App | intermediate | 3 months ago | Java developers who want a full example of a Spring Boot shop backend |
| ruoyi-vue-pro | 40.2k | Framework | advanced | 5 days ago | Java developers building an internal admin or back-office system |
| gogs | 47.9k | App | intermediate | 6 days ago | Small teams that want a private Git server on their own hardware |
| PicGo | 27.5k | App | beginner | 17 days ago | Bloggers and note-takers who paste screenshots into Markdown editors |
| dashy | 26.9k | App | beginner | 6 days ago | People running a homelab or home server who want one page for all their services |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.