Windows 与 iPhone 文件互传指南:一个开源工具同时搞定传文件和剪贴板同步
Windows 与 iPhone 文件互传指南:一个开源工具同时搞定传文件和剪贴板同步
【免费下载链接】AirDropPlusEffortless file transfer and clipboard sync between Windows and iOS — powered by Python and Apple Shortcuts.项目地址: https://gitcode.com/gh_mirrors/ai/AirDropPlus
把 iPhone 里的照片传到 Windows 电脑,你通常要打开微信、忍受画质压缩,或者找一根已经失踪半年的数据线。AirDrop Plus 想改变这个场景:它让 Windows 和 iPhone 在同一局域网内直接互传文件、同步剪贴板,全程不经过任何第三方服务器。项目完全开源(MIT 协议),PC 端是一个轻量 Python 程序,iPhone 端配合一个苹果快捷指令即可使用。
一句话定位:它不是网盘,是你的"小区快递柜"
AirDrop Plus 和"传文件"工具的最大区别,在于数据不出局域网。
- 微信/QQ:文件先上传到腾讯服务器,再下载回来,大小受限、画质压缩。
- 网盘:上传 → 分享 → 下载,链路最长,还吃流量。
- AirDrop Plus:iPhone 通过 HTTP 请求直接把文件送到 Windows 上监听的本机服务,局域网内点对点完成。
换句话说,别人家的文件传输是"寄快递到外省再寄回来",AirDrop Plus 是"隔壁邻居敲门直接把文件递给你"。快,因为路径最短;安全,因为没有中间人。
从零到第一次传输:全程三步,十分钟内可复现
第一步:把程序跑起来
先拿到代码:
git clone https://gitcode.com/gh_mirrors/ai/AirDropPlus cd AirDropPlus pip install -r requirements.txt首次运行前复制一份配置模板(程序读取src/config/config.ini):
cp src/config/config.ini.example src/config/config.ini然后启动python src/AirDropPlus.py。第一次启动 Windows 防火墙会弹窗询问,选择"允许"。程序会缩到系统托盘,右键托盘图标即可打开设置页(其实是一个本地网页配置界面,运行在http://localhost:端口/settings)。
第二步:配置密钥、端口和保存路径
在设置页里确认三个参数,记住它们:
| 参数 | 默认值 | 作用 |
|---|---|---|
| key | 123456 | 访问密钥,两端必须一致 |
| port | 53843 | 通信端口,两端必须一致 |
| save_path | 空 | 收到的文件保存到哪个文件夹 |
想让 iPhone 通过主机名而不是 IP 找到电脑,可以在 Windows 里确认一下设备名称(设置 → 系统 → 关于),保持纯英文、不含中文即可。
第三步:装好快捷指令,两端对齐
在 iPhone 上安装 AirDrop Plus 配套的快捷指令(安装入口在项目文档docs/readme_zh.md里),然后把里面的三项改成和 PC 端一致:
- host:你的电脑名.local(如
PC-Office.local),不行就换成电脑的 IP - port:53843(默认)
- key:和 PC 端相同的密钥
改完立刻测试:在 iPhone 上选一张照片,分享菜单里点 AirDrop Plus,Windows 应弹出通知。这一步通了,后面全是享受。
读懂它:一个类比讲清全部原理
AirDrop Plus 的底层逻辑,一句话就能讲明白:
Windows 上运行着一个"小区快递站"(一个监听固定端口的 HTTP 服务),iPhone 上的快捷指令是"快递员",每次传输就是快递员按门牌号(host + port)、凭密码(key)把包裹送进快递站。
具体拆开看,其实只有两个环节:
- Windows 端:Flask 启动一个本地 HTTP 服务,监听
0.0.0.0上的指定端口。它提供几个极简接口:收文件(POST /file)、发文件(GET /file/<path>)、收剪贴板(POST /clipboard)、发剪贴板(GET /clipboard)。 - iPhone 端:快捷指令本质上是一个可交互的 HTTP 客户端,负责挑选文件、发起请求、把响应变成通知或剪贴板内容。
两端之间传的是普通 HTTP 数据,所以任何防火墙拦截、端口不通、主机名解析失败,都会直接表现为"快捷指令超时"——这也是后面避坑清单里最常出现的问题。
完整 API 文档在docs/api_zh.md,仓库api/目录下还附带了一套 Bruno 测试请求集合,想深入研究的开发者可以直接对着它调试。
把功能用出花样:四个真实使用方式
1. 批量传照片,不压缩画质
选照片 → 分享 → AirDrop Plus。原图直接落盘到你配置的保存路径,不经过任何压缩。iPhone 默认限制快捷指令一次传输的数据量,记得在"设置 → App → 快捷指令 → 高级 → 允许共享大量数据"里打开,否则一次传多张照片会报错。
2. 把 Windows 剪贴板"拉到"手机上
在 Windows 上复制一段代码、一个链接或一张截图,然后在 iPhone 上触发快捷指令选择 Receive,内容会直接进手机剪贴板。代码格式、图片清晰度原样保留,不用拍照识别、不用手动抄。
3. 反向操作:把手机内容"推"到 Windows 剪贴板
在 iPhone 上复制文字,触发快捷指令选 Send,Windows 端剪贴板立刻更新,通知栏直接看到内容。适合快速搬运验证码、会议链接这类小东西。
4. 加入控制中心,一键直达
把快捷指令加到 iOS 控制中心后,下拉就能呼出,省去反复打开"快捷指令" App 的步骤。传输这件小事被压缩成一个手势。
另外有个贴心细节:Windows 收到文件后的通知是交互式的,你可以在通知里直接"打开"、"在文件夹中定位"或"复制"文件,不用自己跑到保存目录里翻。
新手避坑速查:遇到问题先看这张表
| 症状 | 最可能的原因 | 直接给答案 |
|---|---|---|
| 快捷指令超时 | 两端不在同一局域网 | 确认 iPhone 和 PC 连同一个 WiFi,或一方连另一方的热点(热点传输不耗流量) |
| 快捷指令超时 | 端口不一致 | 检查 PC 设置页的 port 和快捷指令里的 port 是否相同(默认 53843) |
| hostname.local 连不上 | Bonjour 解析失败或主机名含中文 | 换电脑的 IP 直连;主机名保持纯英文、尽量避免- |
| 传输被拦 | 防火墙拦截端口 | 移除旧的 AirDropPlus 防火墙规则,重启程序并在弹窗中允许 |
| 一次传多张图报错 | 快捷指令"共享大量数据"未开启 | iPhone → 设置 → 快捷指令 → 高级 → 允许共享大量数据 |
| 启动后无通知但进程在跑 | Windows 版本过低,不支持交互通知 | 在设置页把通知样式切到"基本通知" |
| 端口被占用 | 其他程序占用了 53843 | 程序会自动换端口并弹通知,记得同步改快捷指令里的 port |
针对多网络环境的进阶技巧:快捷指令支持按 WiFi 名称维护一个"网络名 → PC IP"的映射表,家庭 WiFi、公司网络、手机热点各配一条,走到哪自动用对地址。
接下来你只需要做两件事
到这里,你既知道了它怎么用,也知道了它为什么好用。剩下的事情很简单:
- 现在就动手:克隆仓库、跑起来、装快捷指令,完成一次真实的文件传输。十分钟内你就能体会到"原来传文件可以不用等上传进度条"。
- 把它变成习惯:把快捷指令放进控制中心和分享菜单,给不同网络配好 IP 映射,然后把微信传文件的路径彻底忘掉。
更深入的 API 说明在docs/api_zh.md,配置模板样例在src/config/config.ini.example,源码结构清清爽爽地摆在src/下——Python 后端(src/server.py、src/clipboard.py)和快捷指令配合的全部逻辑都在里面,想改想学都有得看。
AirDrop Plus 是 MIT 协议的开源项目,代码透明可审计。传输这件事,本该这么简单。
【免费下载链接】AirDropPlusEffortless file transfer and clipboard sync between Windows and iOS — powered by Python and Apple Shortcuts.项目地址: https://gitcode.com/gh_mirrors/ai/AirDropPlus
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
