电脑和手机之间通过 WiFi 局域网互传文件,无需数据线,无需安装 App。
- 新增 Token 身份验证,扫码自动获取访问令牌,防止未授权访问
- 新增文件类型安全过滤,拦截可执行文件上传(.exe .bat .sh 等)
- 新增设备连接数限制(最多 20 台)和 WebSocket 心跳检测
- 输入消毒处理(XSS / 路径遍历防护)
- 默认端口从 3000 改为 6009
适合开发者或有 Node.js 环境的用户。
- 打开终端,进入项目目录
cd "你的项目路径"
- 安装依赖(首次使用)
npm install
cd web && npm install && cd ..
- 构建前端(首次使用或修改前端后)
cd web && npx vite build && cd ..
- 启动服务器
node server/index.js
或者直接双击 start.bat,它会自动完成以上步骤。
适合任何 Windows 用户,无需安装任何软件。
- 将
release\FileTransfer文件夹压缩成 zip 发给对方 - 对方解压到任意目录
- 双击
FileTransfer.bat即可启动
- 电脑启动后,终端会显示二维码和访问地址(如 http://192.168.1.xxx:6009)
- 手机连接与电脑同一个 WiFi
- 手机扫码 或 手动在浏览器输入地址
- 打开即可使用
| 功能 | 说明 |
|---|---|
| 文件传输 | 支持拖拽上传、多文件、最大 5GB |
| 剪贴板同步 | 文字和链接在设备间实时同步 |
| 文件管理 | 浏览、下载、删除、批量操作 |
| 传输历史 | 查看所有上传/下载记录 |
| 设备信息 | 实时显示已连接的设备和系统信息 |
| 二维码 | 电脑端显示二维码,手机扫码直接连接 |
如果修改了代码,重新打包:
node build-release.js
打包结果在 release\FileTransfer\,压缩成 zip 即可分享。
Q: 手机无法连接? A: 确保手机和电脑连接同一个 WiFi。如果仍然不行,可能需要放行 Windows 防火墙端口 6009(以管理员身份运行):
netsh advfirewall firewall add rule name="File Transfer" dir=in action=allow protocol=tcp localport=6009
Q: 如何修改端口?
A: 启动时设置环境变量:set PORT=8080 && node server/index.js
Q: 文件存在哪里?
A: 上传的文件保存在 uploads\ 目录,数据库在 data\transfer.db。
Q: 如何停止服务器?
A: 在终端按 Ctrl + C。