Magic Wormhole：两台电脑传文件，一个口令就行

Magic Wormhole 在 GitHub 上已经拿到 22,645 Star。

这个项目只做一件事：让两台电脑之间直接传文件，不需要上传到云端，不需要配置服务器，也不需要注册账号。发送端生成一串人类可读的口令，接收端输入同样的口令，连接就建立起来了。

1、 这玩意儿是干嘛的

wormhole 是一个命令行工具，也是一套 Python 库。发送方运行 wormhole send，工具会生成一串像 7-guitarist-revenge 这样的口令。接收方在另一台电脑上运行 wormhole receive，输入同样的口令，文件就开始点对点传输。

口令使用语音区分度高的词表生成，短且好念。接收端支持 tab 补全，通常只需要敲几个字符就能自动补全剩下的单词。口令是单次使用的，传完就作废，不需要记住。

支持任意大小的文件和目录，也支持短文本片段。

2、 安全机制

两端先通过一台信箱服务器交换加密密钥，密钥协商完成后文件本身走点对点传输。使用的 SPAKE2 协议保证即使有人在监听握手过程，也无法推算出最终密钥。传输过程是端到端加密的，中间服务器只能看到密文，看不到文件内容。

3、 安装使用

兼容 Python 3.10 及以上版本。很多操作系统的包管理器里已经收录了这个工具，也可以通过 pip 直接安装：

pip install magic-wormhole

发送文件：

wormhole send filename.txt

接收文件：

wormhole receive 7-guitarist-revenge

4、 适合什么场景

• 公司内网限制多、U 盘被禁用，需要把文件传给同事
• 不想把敏感文件上传到任何云盘或中转站
• 临时换电脑，需要快速把配置文件或代码片段搬过去
• 跨平台传输，Linux、macOS、Windows 都能跑

5、 生态和扩展

项目用 MIT 许可证开源。核心逻辑拆成了独立的 Python 库，可以集成到其他应用里。信箱服务器和中继服务器的源码也在单独仓库中维护，有私有化部署需求的人可以自建完整环境。

集成到其他应用里。信箱服务器和中继服务器的源码也在单独仓库中维护，有私有化部署需求的人可以自建完整环境。