Copyparty: A versatile file server application

By /

It supports accelerated recoverable uploads, deduplication, WebDAV, FTP, TFTP, zeroconf, media indexer, thumbnail generation, and more, integrates multiple protocols and services, and supports cross-platform use without any dependencies.

1. Project Overview

  • Repository name: copyparty, maintained by user hovudstraum (GitHub username 9001).
  • Brief description: “Portable file server with accelerated resumable uploads, dedup, WebDAV, FTP, TFTP, zeroconf, media indexer, thumbnails++ all in one file, no deps”
  • License: MIT license.
  • Supported platforms are wide: Windows, Linux, MacOS, Android (Termux), etc.

2. Core functional highlights

This project is relatively “comprehensive” and covers many common/uncommon file service needs. Key features include:

  • File Server Mode: When started, turn a machine into an upload/download center.
  • Multi-protocol support: HTTP/HTTPS, WebDAV, FTP, TFTP, SMB/CIFS (although the latter mentions “not recommended for WAN”), etc.
  • Powerful upload function: Support dragging and dropping files/folders to the browser for upload. Support for “resumable uploads” and “race the beam”.
  • Download/browse is also optimized: folders can be packaged as zip/tar downloads, with their own media player, image thumbnails, text previews, search, etc.
  • Media index and thumbnail generation: You can generate thumbnail views for music, pictures, videos, and other files. Tools such as FFmpeg and Pillow are supported as optional dependencies.
  • Flexible configuration: supports multiple volumes, account permissions, shared links (filekeys/dirkeys), countdown self-deletion, access rules, etc.

3. Applicable scenarios

According to its functions, CopyParty is more suitable for the following scenarios:

  • Home/Small NAS Sharing: You have a NAS or machine at home and want to quickly launch a browser to upload and download services, but you don’t want to install a complicated system.
  • Temporary/portable file services: For example, if you take your computer on a business trip or want to upload/download it on your local LAN or through a reverse tunnel (such as Cloudflare Tunnel). The README mentions “make it accessible over the internet… use cloudflared tunnel”.
  • Multi-protocol requirements: If you want to access not only through the web but also with multi-protocol access such as FTP, WebDAV, TFTP, etc.
  • Media Material Management: If you have a large number of audio/video/image files and want to have thumbnails, previews, indexes, playback, then it offers these features.

4. Features and Benefits

  • Few dependencies: Although there are optional features (such as FFmpeg, Pillow), it basically only needs Python to run. The README emphasizes “server only needs Python (2 or 3), all dependencies optional”.
  • Easy to start: “Just run copyparty-sfx.py — that’s it!”.
  • Broad browser/platform support: The goal is “every browser should at least be able to browse, download, upload files” plus cross-platform.
  • “Complete”: While not every feature may be extremely professional, it provides a “do all the things” idea. The README says “inverse linux philosophy – do all the things, and do an okay job”.
  • Activity/Community: This repository already has more stars (33.5k) and forks (1.3k) showing a certain community attention.

5. Considerations/Restrictions

  • While there are many features, it also means that there may be some edge features that are not as good as specialized tools. For example, the README itself reminds that “some of the alternatives might be a better fit for you”.
  • Media abbreviation, transcoding, and other functions require additional dependencies (e.g., FFmpeg, Pillow). If you run in a resource-constrained environment, you may not perform well.
  • Security configuration needs attention: Because the default drag-and-drop upload, read/write permissions may be open, if deployed in an Internet-accessible environment, you need to do a good job of permissions, https, reverse proxy settings, etc.
  • SMB/CIFS modules are supported, but the README says “unsafe, slow, not recommended for wan” indicates that it may not be optimal in this regard.
  • Uploading/downloading very large files or a large number of concurrent files may be limited by hardware, network, databases (such as indexes), etc. The README mentions “no filesize limit! even on Cloudflare” but it really depends on your environment.

6. Summarize in one sentence

Copyparty is a file server solution with a single file/few dependencies and rich features, suitable for those who want to quickly build a fully functional upload/download/sharing environment. If you only need basic document services, there may be a lighter solution; If you need multi-protocol, browser experience + media preview, and fast deployment, it is a good choice.

Github：https://github.com/9001/copyparty
Tubing:

Scroll to Top