copyparty
SHA-256用任意浏览器将任何设备变成文件服务器,支持断点续传。
一个小巧的Python工具,让你的电脑/手机秒变文件服务器。
核心功能
- 支持HTTP/WebDAV/SFTP/FTP/TFTP/SMB六种协议
- 任意浏览器上传下载,支持断点续传
- 支持Android应用和iPhone快捷指令
- 内建文件管理、搜索、缩略图、媒体播放器
- 生成分享链接、RSS订阅、OPDS电子书
避坑指南
- •SFTP性能较慢(约700MB/s);SMB服务器不安全,不建议用于WAN;默认无加密,如需HTTPS需自行配置反向代理。
适用场景
- 家庭内网文件共享
- 临时文件传输(无需安装客户端)
- 服务器文件管理(多协议访问)
详细介绍
copyparty是一个轻量级、多协议文件服务器,只要有Python环境(2或3)就能在任意设备上运行。支持HTTP、WebDAV、SFTP、FTP、TFTP和SMB六种协议;你可以在树莓派、旧电脑或云服务器上共享文件。核心功能包括:网页断点续传、内置文件管理器、缩略图预览、媒体播放器、全文搜索、zip/tar打包下载、RSS订阅、OPDS电子书阅读、Android客户端和iOS快捷指令。配置极简——只需运行一个Python脚本。此外还支持上传去重、事件钩子和按文件夹权限管理。
常见问题与排障 (1)
故障排除当 copyparty 静默退出且没有任何 traceback 时,我该如何找出是哪个信号杀死了它?
在 strace 下运行 copyparty 以捕获信号传递,包括 SIGKILL 等无法捕获的信号:
strace -Tttyyvfesignal -o /home/yourname/strace.strace python3 copyparty-sfx.py -c your.conf
将配置路径/参数替换为你平时使用的 copyparty 命令。进程消失后,检查日志:
tail -n 100 /home/yourname/strace.strace
grep -E 'SIG(KILL|TERM|INT|HUP|QUIT)' /home/yourname/strace.strace | tail -n 50
最后一条信号记录显示了终止信号,并可能包含发送方的 PID。Python 无法记录 SIGKILL,因此没有任何回溯信息的静默退出属于预期现象。
如果整个 Raspberry Pi 发生重启,或者没有记录到任何终止信号,请先排查外部原因:使用功率足够的官方 PSU、外接供电的 USB 驱动器/集线器,并更换可疑的 USB 线缆。意外重启后,使用以下命令查看上一次启动的内核日志:
journalctl -b -1 -k --no-pager | tail -n 100
vcgencmd get_throttled
仅在关闭时出现的 ProgrammingError: Recursive use of cursors not allowed 消息只是无害的表面提示,不会导致进程退出。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
步骤1:从GitHub Releases下载 copyparty-sfx.py
步骤2:在终端运行 python3 copyparty-sfx.py
步骤3:浏览器打开显示的地址即可使用
- 步骤1:从GitHub Releases下载 copyparty-sfx.py
- 步骤2:在终端运行 python3 copyparty-sfx.py
- 步骤3:浏览器打开显示的地址即可使用
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
c3b6a32123c8b3df782cf9a35c36bdb91213ad332f17e3144ec5c9f376560dd0该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除下载的文件和配置文件即可,无系统残留。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
1 FAQ