Skip to content

About

自托管、点对点、加密的大文件传输工具(IPv6 直连,浏览器下载)

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

IPv6 文件快传

自托管、点对点、加密的大文件传输工具。不依赖任何第三方网盘:你起一个 HTTPS 服务器, 朋友用浏览器打开链接直接下载。速度 = 你们双方带宽中较小者(IPv6 直连、国内互联,不绕国际出口, 无第三方限速)。传输完关掉即可。

为什么用 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。

快速开始(图形界面)

  1. 双击 启动.bat(第一次运行需生成自签名证书,约几秒)
  2. 点「选择文件」或「选择文件夹」
  3. 可选:勾选「启用密码」并填一个密码
  4. 点「启动服务」→ 程序会生成若干条分享链接
  5. 分享链接会每条一行列出,并标注**「稳定地址(推荐)」/「临时地址(会变)」**, 点「复制这条」可分别复制——发给朋友用「稳定地址」那条;浏览器打开即可下载
    • 发送单个文件时:朋友先看到「文件名 + 大小 + 开始下载」页面,点「开始下载」才开始下载
    • 发送文件夹时:朋友看到文件列表,点文件名下载,或点「下载整个文件夹为 ZIP」
    • 若提示「证书不受信任」→ 高级 → 继续访问(这是自签名证书,正常现象)
    • 若设置了密码,浏览器会提示输入
  6. 传完点「停止服务」;也可设置「自动关闭(分钟)」到点自动停

命令行模式(无界面)

.\.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),大文件中断可继续
自动关闭 可设定时自动停服,避免端口长时间暴露
仅限单文件 选文件时只暴露那一个文件,无法浏览同目录其它内容

常见问题

朋友打不开链接? 按顺序排查:

  1. 双方都得有 IPv6(朋友先 ipconfig 或访问 test-ipv6.com 确认)
  2. Windows 防火墙:首次启动弹窗选「允许」;若没弹,手动放行对应端口
  3. 路由器 IPv6 入站:少数路由器默认拦截入站,去后台找「IPv6 防火墙/入站规则」放行
  4. 地址变了:家宽 IPv6 是动态的,断线重拨会变。重新看程序日志里的新链接,或 ipconfig 对比
  5. 链接里有多个地址,选和 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               # 出错时生成(正常无此文件)

About

自托管、点对点、加密的大文件传输工具(IPv6 直连,浏览器下载)

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages