零、Copyparty 深度介绍
1. 核心哲学：极简到离谱的部署
- 单文件即服务：整个服务器就是一个 Python 文件 (
copyparty-sfx.py) 或 Windows 下的.exe文件，没有任何依赖，下载即用。 - 开箱即用：无需配置数据库、无需安装复杂的依赖包，30秒内就能启动一个功能完整的文件服务器。
兼容性怪兽：
- Python 版本：从 Python 2.7 到最新的 Python 3.x 都能运行。
- 操作系统：Windows、Linux、macOS 是基本功，连 Windows 2000、Android（通过 Termux）、树莓派、甚至路由器都能跑。
- 浏览器：从现代的 Chrome、Firefox，到古董级的 IE4、PSP 内置浏览器，都能访问它的 Web 界面。
2. 核心功能：强得不像一个文件
Copyparty 最让人着迷的是它那些超越普通文件分享的“黑科技”：
| 功能类别 | 具体特性 | 体验与优势 |
|---|---|---|
| 🚀 传输黑科技 | 断点续传 (up2k 协议) | 上传大文件时，即使网络中断、浏览器崩溃甚至电脑重启，恢复后只需再次拖入同一个文件，它就能从中断处继续，而不是从头再来。 |
| 边传边下 (Race the Beam) | 上传者这边还在上传，接收方那边就可以开始下载了。上传进度即下载进度，非常适合团队紧急共享大文件。 | |
| 📺 媒体处理 | 强悍的媒体能力 | 自动为图片、视频和音频文件生成缩略图和波形图。内置的音乐播放器支持几乎所有常见格式（MP3、FLAC、AAC等），并支持实时转码，确保在任何浏览器上都能播放。 |
| 🔍 搜索与去重 | 全文搜索 | 不仅能搜文件名，还能直接搜索文件内容里的关键词，比如在一堆 PDF 或 Word 文档里找一句话，这功能通常只有专业的文档管理系统才有。 |
| 智能去重 | 当上传重复文件时，它不会傻傻地再存一份，而是指向已有的那份，帮你节省大量硬盘空间。 | |
| 🌐 多协议支持 | 不止是 Web | 除了通过浏览器访问，它还原生支持 WebDAV、FTP(S)、TFTP、SMB。这意味着你可以直接把共享文件夹映射为电脑的本地磁盘来用。 |
📦 一、安装
# 使用pip安装
pip install copyparty
# 如果需要增强功能（图片缩略图、音频元数据等），可以安装可选依赖
pip install copyparty[all] # 安装所有可选依赖
# 或者单独安装
pip install pillow # 图片缩略图支持
pip install mutagen # 音频元数据支持安装完成后，copyparty 命令就会添加到你的系统路径中。
🚀 二、启动服务
最简单启动
python -m copyparty这会在当前目录启动服务，默认端口 3923，任何人都可以浏览、下载和上传文件。
启动效果
$ python -m copyparty
Serving on http://0.0.0.0:3923
- Local: http://127.0.0.1:3923
- LAN: http://192.168.1.100:3923
- QR code: 扫描二维码用手机访问
Press Ctrl+C to stop常用启动参数
| 场景 | 命令 | 说明 |
|---|---|---|
| 局域网共享（读写） | copyparty -v .:rw | 当前目录允许上传和下载 |
| 自定义端口 | copyparty -p 8080 | 使用8080端口启动 |
| 指定共享目录 | copyparty -v D:\Share:rw | 共享指定目录 |
| 只读模式 | copyparty -v .:r | 只能下载，不能上传 |
| 带密码保护 | copyparty -a 用户名:密码 -v .:rw,用户名 | 需要登录才能访问 |
| 开启所有高级功能 | copyparty -e2dsa -e2ts | 启用搜索和音乐索引 |
🌐 三、访问界面
启动后，用浏览器访问：
- 本机访问：
http://localhost:3923 - 局域网访问：
http://你的IP:3923（如http://192.168.1.100:3923）
Web界面长什么样？
🔧 四、实际使用示例
示例1：快速共享当前目录（读写）
# 在要共享的目录下执行
cd C:\Users\vin\Desktop\share
python -m copyparty -v .:rw示例2：带密码的私人共享
# 创建用户，设置权限
python -m copyparty -a alice:123456 -v ./private:rw,alice
# 说明：-a 创建用户，-v 挂载目录，rw,alice 表示只有alice可读写示例3：音乐库服务器（带索引和播放）
python -m copyparty -e2dsa -e2ts -v D:\Music:/music:r
# 访问 http://localhost:3923/music 即可在线听歌示例4：临时接收文件（匿名上传，不暴露已有文件）
python -m copyparty -v ./incoming:dropbox:w,G:c,fk=4
# - dropbox 特殊模式：匿名上传，不上传不能浏览
# - w 允许上传
# - G 上传后生成访问密钥
# - fk=4 密钥长度4位🎯 五、常用命令速查表
| 命令 | 作用 |
|---|---|
copyparty | 默认启动（当前目录，端口3923） |
copyparty -p 8080 | 指定端口 |
copyparty -v D:\data:rw | 共享指定目录并允许读写 |
copyparty -a user:pass | 添加用户认证 |
copyparty --help | 查看所有参数 |
copyparty --version | 查看版本 |
评论 (0)