自托管、点对点、加密的大文件传输工具。不依赖任何第三方网盘:你起一个 HTTPS 服务器, 朋友用浏览器打开链接直接下载。速度 = 你们双方带宽中较小者(IPv6 直连、国内互联,不绕国际出口, 无第三方限速)。传输完关掉即可。
- IPv6 没有 NAT,两台家宽设备都拿到公网地址后可以直接互连,不经过中转服务器
- 文件内容加密传输(HTTPS 自签名证书),即使走公网也不怕被中间人窥探
- 前提:双方都要有全球 IPv6 地址(
ipconfig里能看到2001:/240e:开头的地址,手机上用流量基本默认就有)
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"把本仓库以可编辑方式装进现有
.venv(含cryptography及 pytest / ruff / mypy 开发依赖)。 改代码即时生效,日常运行无需重装。之后双击启动.bat或直接跑python -m ipv6_transfer。
- 双击
启动.bat(第一次运行需生成自签名证书,约几秒) - 点「选择文件」或「选择文件夹」
- 可选:勾选「启用密码」并填一个密码
- 点「启动服务」→ 程序会生成若干条分享链接
- 分享链接会每条一行列出,并标注**「稳定地址(推荐)」/「临时地址(会变)」**,
点「复制这条」可分别复制——发给朋友用「稳定地址」那条;浏览器打开即可下载
- 发送单个文件时:朋友先看到「文件名 + 大小 + 开始下载」页面,点「开始下载」才开始下载
- 发送文件夹时:朋友看到文件列表,点文件名下载,或点「下载整个文件夹为 ZIP」
- 若提示「证书不受信任」→ 高级 → 继续访问(这是自签名证书,正常现象)
- 若设置了密码,浏览器会提示输入
- 传完点「停止服务」;也可设置「自动关闭(分钟)」到点自动停
.\.venv\Scripts\python.exe -m ipv6_transfer --headless --path "D:\电影\大文件.zip" --port 8000 --password "你的密码"| 防护 | 说明 |
|---|---|
| HTTPS 加密 | 自动生成自签名证书(cert/ 目录),TLS 1.2+,内容全程加密 |
| URL 令牌 | 每次启动随机生成 24 字节令牌拼在链接里,令牌不对一律返回 404,不暴露服务存在 |
| 可选密码 | HTTP Basic Auth,浏览器提示输入;恒时比较防时序攻击 |
| 防暴力破解 | 同一 IP 60 秒内失败 8 次即被限流 429 |
| 路径穿越防护 | 真实路径校验,..、编码绕过一律 403/404 |
| 目录页加固 | CSP + 文件名 HTML 转义,防 XSS |
| 断点续传 | 支持 HTTP Range(206),大文件中断可继续 |
| 自动关闭 | 可设定时自动停服,避免端口长时间暴露 |
| 仅限单文件 | 选文件时只暴露那一个文件,无法浏览同目录其它内容 |
朋友打不开链接? 按顺序排查:
- 双方都得有 IPv6(朋友先
ipconfig或访问 test-ipv6.com 确认) - Windows 防火墙:首次启动弹窗选「允许」;若没弹,手动放行对应端口
- 路由器 IPv6 入站:少数路由器默认拦截入站,去后台找「IPv6 防火墙/入站规则」放行
- 地址变了:家宽 IPv6 是动态的,断线重拨会变。重新看程序日志里的新链接,或
ipconfig对比 - 链接里有多个地址,选和
ipconfig里「IPv6 地址」一致的那条最稳(临时地址过几小时会轮换)
速度取决于什么? 直连后 = 发送方上行带宽 与 接收方下行带宽 中较小者。 国内家宽一般上行只有 20~50M,这是运营商的物理限制,任何工具都绕不过。
为什么有「证书不受信任」警告? 自签名证书没有 CA 签名,浏览器会警告。点「继续访问」即可, 内容依然是加密的。真正冒充证书颁发机构的人极难,安全性足够个人传输使用。
.\.venv\Scripts\python.exe -m pytest在 ::1 上跑 42 项用例(集成 + 单元),验证鉴权、下载、断点续传、zip 打包、穿越拦截、限流、配置与工具函数。
图形界面里用表格展示,每行一条请求、每个字段一列:
| 时间 | 身份 | 操作 | 状态 | 传输 | 耗时 | 速度 | 浏览器 |
|---|---|---|---|---|---|---|---|
| 14:23:05 | 240e:xxx | 开始下载「大文件.zip」 | 200 | 144.5 MB / 144.5 MB | 12.3s | 11.8 MB/s | Edge/122 |
| 14:23:40 | 用户「小明」(240e:xxx) | 打包下载文件夹「照片」 | 200 | 1.2 GB / 1.2 GB | 95s | 12.9 MB/s | Chrome/131 |
| 14:25:10 | 用户「小偷」(240e:xxx) | 密码错误 | 401 | — | — | — | — |
| 14:25:12 | 240e:xxx | 访问被限流(尝试过于频繁) | 429 | — | — | — | — |
- 颜色:成功(2xx)绿色、被拒/错误(4xx/5xx)红色、系统消息灰色
- 身份:启用了密码时显示「用户名(IP)」(用户名是访问者随便填的);没启用密码(无用户名)时只显示 IP
- 操作:开始下载 / 查看下载页 / 打包下载文件夹 / 浏览目录 / 密码错误 / 链接令牌错误 / 越权拦截 / 限流等
- 传输:已传 / 总大小;206 断点续传分片显示如
100 B / 293.0 KB - 中断:传输未完成即断开会标「(中断)」(206 分片不算中断)
- 浏览器:访问者 UA(截断 50 字符)
- 命令行模式则打印为单行文本
运行日志下方是独立的下载状态区块(勾选「下载状态」控制显示/隐藏),用表格 按「用户 + 文件」分行——多用户同时下载各自一行,每行实时显示进度、速度、状态 (下载中 / 完成 / 中断)。
「开始下载」以实际传输开始为准:朋友点「开始下载」按钮不算,真正开始传数据才算。
原始日志落盘:所有访问日志和系统消息会按天追加写入 logs/raw_YYYY-MM-DD.log,
包含时间、身份、操作、状态、传输统计、浏览器等完整字段,方便事后回溯。
GUI 启动时会显示日志文件路径。命令行可用 --log-dir 路径 指定目录、--no-log 关闭。
ipv6-transfer/
├── pyproject.toml # 打包与工具链配置(PEP 621,ruff/mypy/pytest 规则)
├── src/ipv6_transfer/ # 源码包(config/net/cert/log/server/core/cli/gui)
├── tests/ # pytest 测试(集成 + 单元)
├── 启动.bat # 双击启动
├── cert/ # 自动生成的自签名证书(可删除,会重新生成)
├── logs/ # 原始日志(按天:raw_YYYY-MM-DD.log)
└── error.log # 出错时生成(正常无此文件)