C

copyparty

SHA-256
44.8k stars·文件管理·已提供 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 消息只是无害的表面提示,不会导致进程退出。

来源 Issue #1507

标签

file-serverwebdavsftpftpsmbpythonresumable-uploadself-hosted

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤1:从GitHub Releases下载 copyparty-sfx.py

4

步骤2:在终端运行 python3 copyparty-sfx.py

5

步骤3:浏览器打开显示的地址即可使用

安装指引
  1. 步骤1:从GitHub Releases下载 copyparty-sfx.py
  2. 步骤2:在终端运行 python3 copyparty-sfx.py
  3. 步骤3:浏览器打开显示的地址即可使用
文件完整性

已提供 SHA-256 校验码,下载后可自行核对文件完整性

该校验码提取自 GitHub 官方 Release 页面

SHA256 校验码

c3b6a32123c8b3df782cf9a35c36bdb91213ad332f17e3144ec5c9f376560dd0

该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

删除下载的文件和配置文件即可,无系统残留。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议MIT
最后更新2026-10-15 07:45:11
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

1 FAQ

相似推荐