故障排查

星火传输故障排查:登录失败、连不上接收端、续传失效与授权只读

要点速览

星火传输连不上接收端,九成是网络不可达、选错网卡或接收端防火墙没有放行 TCP 6054 端口;续传失效通常是源文件被修改、换了接收目录或删除了 .spark-partial 临时目录;授权突然只读或停用,先检查是否到期、长时间断网或系统时间被调回过去。

这篇面向在现场或机房使用星火传输时遇到异常的实施和运维人员,按"登录与授权""连接""传输过程"三类列出常见现象。每个问题第一句话给出最可能的原因和处理结论,后面是逐项排查步骤。前置条件:能打开星火传输程序,并能访问两端电脑。

登录与授权 #

登录页底部的状态灯是红色,登录不上 #

红灯表示程序访问不到官网的授权服务,请先恢复这台电脑访问官网的网络。

  1. 用浏览器打开官网,确认这台电脑可以正常上网。
  2. 如果电脑开启了代理软件或企业代理,确认代理没有拦截或错误转发对官网的访问。
  3. 检查程序设置页中的服务地址是否被改动过,被误改时恢复为默认值。
  4. 如果这台电脑所在网络本身就不允许访问外网,请改用离线激活,见 授权与激活指南。

验证码总是提示错误 #

每次登录都会生成新的验证码,题目是 20 以内的加减乘除,请填写计算结果而不是题目本身。

验证码看不清时刷新一张新的。连续多次登录失败可能触发频率限制,稍等几分钟再试。账号或密码不确定时,到官网找回密码。

登录后没有可激活的授权 #

单位名下没有星火传输的可用授权,或者账号还没有加入单位。

  1. 到官网「用户中心 → 我的单位」确认账号已创建或加入单位。
  2. 到 用户中心 → 我的授权 确认授权已出现,且所属单位与当前账号一致。
  3. 没有授权时,可以在程序中直接领取社区免费版或申请 14 天试用。

激活时提示设备数已满 #

这份授权的设备位已被占满,需要先解绑不再使用的设备。

在官网 用户中心 → 我的授权 中找到这份授权,解绑旧设备后,回到程序重新激活。

授权状态变成只读,无法发送和接收 #

只读通常由三种原因导致:授权已过宽限期、电脑长时间未联网导致无法续期,或系统时间被调回过去。

  1. 在程序授权页查看到期日和当前状态。已到期的,续费或购买后自动恢复。
  2. 电脑长时间断网的,恢复联网后等待程序自动心跳续期,或重新打开程序。
  3. 检查系统时间是否准确。时间被调回过去会被判定为时钟回拨,请把系统时间改回准确时间并联网同步。

只读期间正在运行的任务会停止,恢复后重新发送同一文件即可断点续传。

授权被停用,提示需要重新激活 #

授权被管理方停用或要求重新激活时,程序会清除本机激活信息。重新登录并激活即可;如果确认授权仍然有效却被停用,请通过 联系我们 反馈。

更换硬件或重装系统后授权失效 #

授权绑定本机硬件特征,更换主板、系统盘等主要硬件或重装系统后,程序会把它识别为新设备。

到官网 用户中心 → 我的授权 解绑原设备,再在这台电脑上重新激活。

离线激活导入授权文件失败 #

最常见的原因是授权文件与本机当前的挑战码不对应。

  1. 确认 .lic 文件是用这台电脑生成的挑战码签发的,不能用于其他电脑。
  2. 确认提交挑战码之后,没有在这台电脑上重新生成过挑战码。如果重新生成过,需要用新的挑战码重新签发。
  3. 确认签发时选择的是星火传输的授权,而不是其他产品。
  4. 拷贝过程中不要改动 .lic 文件内容,用文本方式传递时要完整复制。

离线激活后只能接收不能发送 #

这是离线授权的设计行为:服务端离线版为仅接收模式。

需要在隔离网内发送数据的场景,请通过 联系我们 说明需求。

免费版发送大文件时被拦截 #

社区免费版的单文件上限为 4 GB,超过时发送会被拦截并提示升级。

可以先申请 14 天试用,或购买正式版授权。注意:接收端也会校验单文件大小,两端都需要满足条件。

连接问题 #

发送端连不上接收端,一直无法开始传输 #

最常见的原因是两端网络不通、接收节点未启动、选错了网卡或接收端防火墙没有放行端口。

  1. 确认接收端「接收」页中接收节点处于运行状态。
  2. 核对发送端填写的地址与接收端显示的监听地址完全一致,包括端口。
  3. 接收端有多块网卡(例如同时连有线、无线和 VPN)时,确认选择的是发送端能访问到的那块网卡。
  4. 在发送端电脑上 ping 接收端 IP,确认网络可达;跨地域时确认 VPN 已连接。
  5. 在接收端 Windows 防火墙中放行接收端口(默认 TCP 6054)的入站连接;中间有硬件防火墙或安全网关时,请网络管理员放通该端口。
  6. 修改过端口的,确认两端使用的是同一个端口,且新端口没有被其他程序占用。

提示接收口令错误或被拒绝写入 #

发送端填写的口令与接收端当前的口令不一致。

以接收端「接收」页当前显示的口令为准重新填写。接收节点重新启动后,请再次核对口令。复制口令时注意不要带上多余的空格。

传输过程问题 #

重新发送后没有续传,从头开始传了 #

续传要求同一个文件、同一个接收节点、同一个接收目录,并且临时进度没有被删除。

  1. 确认源文件在两次发送之间没有被修改、覆盖或重新导出。文件内容变化后指纹不同,会被当作新文件。
  2. 确认接收端使用的是与上次相同的接收目录。
  3. 确认接收目录下的隐藏临时目录 .spark-partial 没有被删除或清理。

传输完成时提示复核失败,自动重新传输 #

接收端复核文件指纹与发送端不一致,程序已自动清空进度要求重传,这是保护数据完整的正常行为。

如果反复复核失败:确认传输期间源文件没有被其他程序写入;检查两端磁盘是否有坏道或空间不足;避免在传输过程中拔插移动硬盘。

传输速度明显低于网络带宽 #

速度受网络、磁盘和授权并发路数中最慢的一环限制。

  1. 在授权页查看当前套餐的并发上限,免费版并发较低。
  2. 检查两端磁盘:机械硬盘、USB 移动硬盘的读写速度通常低于万兆网络。
  3. 经过 VPN 隧道时存在加密开销,速度会低于内网直连。
  4. 同时运行的其他大流量程序会占用带宽。

接收目录里出现名为 .spark-partial 的隐藏文件夹 #

这是存放未完成传输数据的临时目录,传输完成并复核通过后,文件会从这里改名为正式文件。

有未完成任务时不要删除它,否则会丢失续传进度。确认不再需要续传时,可以在关闭接收节点后删除。

接收到的文件名后面多了 (1) #

接收目录里已有同名但内容不同的文件,程序为了不覆盖原文件,把新文件另存为「名称 (1)」。

请对比两个文件后自行决定保留哪一个。

仍未解决 #

请在 技术社区 发帖,附上程序版本、授权套餐、两端网络环境和现象描述;也可以通过 联系我们 获取支持。