星火传输收发与断点续传操作指南：接收节点、发送任务、网络与性能

这篇面向已经完成安装和激活、需要在项目中长期使用星火传输的实施和运维人员。读完后，你能正确设置接收节点和发送任务，理解断点续传与完整性复核的规则，并按网络条件规划部署。前置条件：已按 快速入门 完成一次传输，且两端授权均处于有效状态。

程序结构：一个程序，两种角色 #

星火传输把发送端和接收端合在同一个桌面程序里，主界面上分为「发送」和「接收」两个页面，另有授权和设置页面。

• 一台电脑可以只发、只收，也可以同时运行发送任务和接收节点。
• 两台电脑可以互为收发：A 向 B 发送的同时，B 也可以向 A 发送。
• 不需要额外部署任何服务器，数据只在两台电脑之间直连流动。

接收端：启动接收节点 #

入口：主界面「接收」页。

接收节点参数 #

启动后，页面显示监听地址（IP:端口）和接收口令，把两者一起交给发送方。

接收端的安全机制 #

• 接收口令校验：没有口令或口令不正确的请求一律拒绝写入，比对方式不会因口令内容不同而泄露时间差。
• 文件名消毒：发送方传来的文件名会被清洗，不允许借助 ..、绝对路径等手段把数据写到接收目录以外。
• 同名不覆盖：接收目录里已有同名文件时，绝不覆盖已有文件（具体规则见下文）。

防火墙放行 #

接收端需要在 Windows 防火墙中放行接收端口（默认 TCP 6054）的入站连接。只需在接收端放行，发送端无需开放端口。如果中间还有硬件防火墙或安全网关，同样需要放行从发送端到接收端该端口的访问。

发送端：发起传输任务 #

入口：主界面「发送」页。

1. 把文件拖入发送列表，可添加多个文件，多个文件会并发流式传输。
2. 填写接收端的监听地址和接收口令。
3. 开始发送后，程序先计算文件特征指纹，再分片发送。
4. 传输过程中可以看到实时速度曲线、已传 / 总量和剩余时间。

分片与并发 #

断点续传：断了也不用重来 #

接收端为每个文件维护一张分片位图，记录每个 8 MB 分片是否已经到达，并实时写入磁盘。因此断点续传在以下情况下都有效：

• 网络中断后恢复；
• 发送端或接收端程序被关闭后重新打开；
• 任一端电脑关机或重启。

续传方法：恢复后，在发送端把同一个文件重新发送到同一个接收节点、同一个接收目录。接收端比对指纹和分片位图，告诉发送端缺哪些分片，发送端只补传缺失的部分。

需要注意的规则：

• 未完成的数据保存在接收目录下的隐藏临时目录 .spark-partial 中。删除这个目录等于放弃所有未完成任务的进度。
• 如果源文件在两次发送之间被修改，指纹会不同，程序会把它当作新文件从头传输。
• 在 NTFS 分区上，接收端会把未完成的文件标记为稀疏文件，乱序到达的分片可以直接写入，不会因为补零而卡顿。

完整性复核 #

1. 发送前，程序在数秒内计算文件特征指纹（BLAKE3 算法；100 MB 及以下的文件全量计算，更大的文件对首、中、尾采样并结合文件长度计算）。
2. 接收端全部分片到齐后，按同一算法复核。
3. 复核一致，文件从临时目录改名为正式文件；复核不一致，自动清空该文件的进度，要求重新传输。

因此，接收目录里出现的正式文件都是已通过复核的文件，不需要再人工比对文件大小。

秒传与同名文件处理 #

网络部署建议 #

星火传输是点对点直连工具，发送端必须能直接访问到接收端的监听地址。它不经过任何中转服务器，因此在两端网络不可达时不会"绕路"传输。

性能影响因素 #

• 网络带宽：内网环境下，TB 级文件可以跑满千兆到万兆带宽。VPN 隧道的加密开销会降低实际速率。
• 磁盘速度：机械硬盘或 USB 移动硬盘的读写速度往往低于万兆网络，此时磁盘是瓶颈。
• 并发路数：受授权套餐限制，免费版并发较低；高带宽环境建议使用试用版或团队版、永久版等高并发套餐。

相关文档 #

• 授权与激活指南
• 故障排查
• 常见问题