Skip to content

Repository files navigation

LAN 文件传输

LAN Transfer Python Zero Dependency MIT License Cross Platform Web UI Local First Privacy First

局域网 AirDrop —— 打开浏览器,拖拽文件,搞定,还能聊天。

一个用 Python 写的局域网文件传输工具。在电脑上启动一个轻量 HTTP 服务,局域网内任何设备用浏览器打开 http://IP:8765 就能上传/下载文件,还能实时聊天

  • 直连满速 — 瓶颈只有你的路由器/网卡速率
  • 零限制 — 文件大小、类型、数量,通通没限制
  • 跨平台接收 — 发文件的是 Windows,接收端可以是任何有浏览器的设备
  • 现代 Web UI — 拖拽上传、实时进度、二维码分享、粘贴即上传
  • 实时聊天 — 局域网内所有设备可以实时文字聊天(新增 v0.2.0)
  • 磁盘空间检查 — 上传前检查可用空间,空间不足自动拒绝(新增 v0.2.0)
  • 自定义共享目录 — GUI 版本支持浏览选择任意文件夹(新增 v0.2.0)
  • 零依赖 — 只用到 Python 标准库,不需要 pip install 任何东西

快速开始

# 命令行版本
python lan_transfer.py

# 或 GUI 版本(双击启动,推荐)
python lan_transfer_gui.py

# 或打包好的 EXE
LAN文件传输.exe

启动后,在同一局域网的任意设备浏览器中输入显示的网址(如 http://192.168.1.179:8765),即可开始传输。

截图 · Screenshots

Web 界面 · Web UI

Web UI - 深色主题,文件管理 + 实时聊天

拖拽上传、文件管理、实时聊天——深色主题,零门槛操作 · Drag & drop, file management, real-time chat — dark theme, zero learning curve

GUI 桌面程序 · GUI Desktop App

GUI - 目录浏览、空间显示、一键启停

自定义共享目录、磁盘空间实时显示、一键启动/停止 · Custom share directory, real-time disk space, one-click start/stop

打包为 EXE

pip install pyinstaller
pyinstaller --onefile --windowed lan_transfer_gui.py
# EXE 输出在 dist/ 目录

特性

功能 说明
拖拽上传 网页拖拽文件即可上传,支持批量
粘贴上传 截图后 Ctrl+V 直接贴到网页上传
实时进度 上传进度条 + 实时速度显示
二维码 生成二维码,手机扫码直接打开
文件管理 在线预览/下载/删除共享文件
图片预览 图片文件自动生成缩略图
跨平台 服务端 Windows,接收端 Mac/Linux/手机均可
实时聊天 [NEW] 局域网内设备实时文字聊天,支持昵称
磁盘检查 [NEW] 上传前自动检测磁盘空间,不足时拒绝上传
目录浏览 [NEW] GUI 版本支持浏览和选择任意共享文件夹
大文件支持 [NEW] 超时时间延长至 1 小时,支持超大文件传输

更新日志

v0.2.0 (2026-07-07)

新增功能:

  • 实时聊天系统 — 所有接入同一服务的设备可以实时文字聊天
    • 支持自定义昵称
    • 消息自动刷新(每 3 秒)
    • 保留最近 200 条消息
    • 显示发送时间和 IP
  • 磁盘空间检查 — 上传文件前自动检查目标磁盘剩余空间
    • 空间不足时拒绝上传并提示
    • GUI 界面实时显示可用空间
  • 自定义共享目录 — GUI 版本新增"浏览"按钮
    • 可以选择任意本地文件夹作为共享目录
    • 选择后自动更新可用空间显示
  • 超时优化 — 服务器超时从 60 秒延长至 3600 秒
    • 请求超时从 120 秒延长至 7200 秒
    • 支持超大文件(几十 GB)的稳定传输

技术改进:

  • 新增 GET /api/chatPOST /api/chat 接口
  • 线程安全的聊天消息存储
  • Windows kernel32 API 获取磁盘空间
  • GUI 目录选择使用 tkinter filedialog

v0.1.0 (2026-07-03)

  • 初始版本
  • 基础文件上传/下载/删除
  • 拖拽上传、粘贴上传
  • 二维码分享
  • 图片预览
  • GUI 和命令行双版本

技术架构

  • 后端: Python http.server + socketserver.ThreadingMixIn
  • 前端: 内联 SPA(HTML + CSS + JS,无外部依赖)
  • 传输: HTTP 流式上传/下载,1MB 分块
  • 聊天: REST API + 3 秒轮询,内存存储
  • 打包: PyInstaller → 单文件 EXE(约 11MB)

许可证

MIT License


📡 关于作者

AICDragon 公众号

🐉 AICDragon — AI 工具实战派

专注 AI Agent 自动化 · 本地大模型 · 开源踩坑实录

每周一篇 AI 实战,全平台同名搜「AICDragon

About

Zero-dependency LAN file transfer tool. Open browser, drag files, done. Pure Python, MIT licensed

Topics

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages