Python开发的文件传输工具 copyparty，通过浏览器即可完成文件浏览、上传、下载、在线播放等操作

copyparty是一款轻量级文件服务器工具，只需Python环境（支持Python 2和3）就能运行，所有依赖均为可选，能把几乎任何设备变成文件服务器，支持通过网页浏览器进行可断点续传的上传和下载操作。

支持多种协议，包括http、webdav、ftp、tftp、smb/cifs，支持安卓应用和iPhone快捷指令，方便移动设备使用。

最简单的方式是运行copyparty-sfx.py，一步到位。

可以通过以下方式安装使用：

• PyPI：python3 -m pip install --user -U copyparty

• 对于无法安装Python的情况，可使用copyparty.exe

• Arch Linux：直接通过包管理器安装

• NixOS：通过nix安装

• 安卓设备：在termux中安装

• 若使用uv，可运行uv tool run copyparty

• 系统出现问题时，可尝试pyz版本

• 还能制作成可启动的U盘或光盘

• 如需隔离运行，可使用prisonparty创建小型chroot环境，或用bubbleparty借助bubblewrap包装，也支持docker

启用缩略图（图片/音频/视频）、媒体索引和音频转码功能，需安装一些推荐依赖，不同系统安装命令不同：

• Alpine：apk add py3-pillow ffmpeg

• Debian：apt install --no-install-recommends python3-pil ffmpeg

• Fedora：rpmfusion + dnf install python3-pillow ffmpeg --allowerasing

• FreeBSD：pkg install py39-sqlite3 py39-pillow ffmpeg

• MacOS：port install py-Pillow ffmpeg 或 brew install pillow ffmpeg

• Windows：python -m pip install --user -U Pillow（需手动安装python和ffmpeg，不建议使用winget或Microsoft Store，可能导致$PATH出问题）

copyparty.exe已包含Pillow，仅需ffmpeg处理媒体标签和视频缩略图。

无参数运行copyparty（比如在Windows上双击），会允许所有人对当前文件夹进行读写操作，也可设置账户和卷来限制访问。

一些推荐选项：

• -e2dsa：启用通用文件索引

• -e2ts：启用音频元数据索引（需要FFprobe或Mutagen）

• -v /mnt/music:/music:r:rw,foo -a foo:bar：将/mnt/music以/music共享，任何人可读取，用户foo可读写，密码为bar

• 若要仅让foo用户读取，其他人无法访问，可将:r:rw,foo替换为:r,foo

在家使用

想让copyparty能通过互联网访问，可启动cloudflare快速隧道，用cloudflared tunnel --url http://127.0.0.1:3923启动隧道，隧道启动后会显示一个URL，通过该URL可让他人访问你的文件或向你上传文件。

若有域名，可搭建永久的cloudflare隧道，避免使用随机生成的URL。

由于用户会通过cloudflare连接，运行copyparty时需加上--xff-hdr cf-connecting-ip，以正确检测客户端IP。

在服务器上使用

服务器上使用copyparty，可考虑以下工具：

• contrib/systemd/copyparty.service：将copyparty作为systemd服务运行（内有指南）

• contrib/systemd/prisonparty.service：在chroot中运行，提高安全性

• contrib/openrc/copyparty：在Alpine/Gentoo上运行

• contrib/rc/copyparty：在FreeBSD上运行

• nixos模块：在NixOS主机上运行

• contrib/nginx/copyparty.conf：在nginx后反向代理，获得更好的https支持

需开放所需端口，完整示例如下：（69:tftp，1900:ssdp，3921:ftp，3923:http/https，3945:smb，3969:tftp，3990:ftps，5353:mdns，12000:passive-ftp）

firewall-cmd --permanent --add-port={80,443,3921,3923,3945,3990}/tcp  # --zone=libvirt
firewall-cmd --permanent --add-port=12000-12099/tcp  # --zone=libvirt
firewall-cmd --permanent --add-port={69,1900,3969,5353}/udp  # --zone=libvirt
firewall-cmd --reload