Skip to content

Releases

FST v1.2.0

Choose a tag to compare

@xuey490 xuey490 released this 09 Nov 15:43
3fff60c

FST-Go 是一个基于 libp2p 的局域网(可选跨网)点对点传输工具:设备之间直接建连、端到端加密,消息与文件中转不经过服务器。本版新增 Android 客户端,并修好了长期困扰移动端的局域网发现问题。

功能、技术栈、编译与排障的完整说明见 README_zh.md(另有 English / 日本語)。

下载

平台 文件 说明
Windows x64 fst-1.2.0-windows-amd64.zip 推荐:fst.exe + wintun.dll(TUN 代理需要后者)
Windows x64 fst-1.2.0-windows-amd64.exe 单文件,仅局域网功能可用,跨网 TUN 代理会因缺 wintun.dll 不可用
Android arm64 fst-1.2.0-android-arm64.apk debug 签名,可直接安装;上架商店需自备 release keystore
Debian / Ubuntu amd64 fst_1.2.0-1_amd64.deb 服务模式(fst serve + 浏览器界面),见下方说明

校验和(SHA-256):

3ff4486b16d19d7ef03f73448035c2d23eb2bbf3910b3d8c9804f33efc19f440  fst-1.2.0-android-arm64.apk
06ebebd72e1840a90e1cbf2fb18a461cbf1ec1879f14ee625372ad4b0578eb0a  fst-1.2.0-windows-amd64.exe
a3d8d5d0ca947901adc49daed84f3fcd3be1e1fa32c831b56be34ceb753275e8  fst-1.2.0-windows-amd64.zip
586f39f8c30eefc62363a9e3aa81c67cd8356d1f17f21fa1d6439c9ed06b2b24  fst_1.2.0-1_amd64.deb

安装

Windows

  1. 解压 zip 到任意目录(不要放在 %APPDATA%\FST)。
  2. 双击 fst.exe,首次启动会在 %APPDATA%\FST\ 生成身份与数据库。
  3. 局域网内另一台设备启动后,设备页会自动出现对方;点卡片即可聊天或发送文件。

换机器只需拷 fst.exe(要用 TUN 代理再带上 wintun.dll)。不要拷 %APPDATA%\FST\——identity.key 是设备身份,两台机器共用会 PeerID 冲突。

Android

  1. 传输 APK 到手机,允许「安装未知应用」后安装。
  2. 首次启动授权「通知」与「附近设备」;核心以本地库形式解压执行,App 会申请前台服务常驻。
  3. 与电脑连同一 Wi-Fi,两端互相出现在设备页即可互通。手机之间的直连不需要电脑参与。

Debian / Ubuntu(服务模式)

sudo dpkg -i fst_1.2.0-1_amd64.deb
fst serve                      # 终端会打印访问地址、访问令牌与数据目录
# 浏览器打开 http://127.0.0.1:9797 ,输入令牌即可使用完整界面

安装后应用菜单会生成「FST」入口(终端中启动服务模式)。

首次互通自检

  1. 两台设备在同一网段,路由器关闭「AP 隔离 / 客户端隔离」。
  2. 双方防火墙放行 TCP/UDP 8787 与 UDP 5353。
  3. 设备页互相可见 → 点卡片发一条消息验证;不可见时按 局域网发现与排障 逐层排查。

本版重点

局域网发现可用化

「手机发现不了电脑」「电脑看得见手机、手机看不见电脑」的根因有三个,逐个修掉:

  1. 服务类型不规范。 原来广播名是 fst.local.,而 Android 的 NsdManager 与 iOS 的 NWBrowser 只接受带下划线前缀的合法 DNS-SD 类型(_fst._tcp)。现在双注册:_fst._tcp 给移动端,旧裸标签 fst 留给已装机的老客户端。
  2. 手机把自己播成了 127.0.0.1。 Android 11+ 禁止应用 UID 使用 NETLINK_ROUTE,net.Interfaces() 必然失败,libp2p 展开监听地址后只剩回环地址。对端拿这个地址拨号会连到自己(peer id mismatch),症状是「已连接但发不出消息」。新增 AnnounceIP / SetAnnounceIP,把回环改写成真实局域网 IPv4,Wi-Fi 变化时热更新。
  3. 组播发到了虚拟网卡。 多网卡机器(WSL / Hyper-V / APIPA)上 zeroconf 会逐网卡 SetMulticastInterface,失败时报文可能从虚拟网卡出去,局域网里的手机永远收不到。现在只绑定真实局域网网卡。

另外新增 bridgePeer:把已连接对端的局域网地址代播到 mDNS,让不会应答组播查询的设备也能被其他客户端发现。

Android 客户端

首页为四宫格(设备 / 会话 / 传输 / 设置),设备页在线与离线分段、离线同名设备只保留最近一次,传输页按文件名 / 路径 / 设备名 / 状态搜索,设置页对齐桌面端可支持项(昵称、头像、并发数、限速、发送前校验、自动接收、受信设备、核心日志与重启)。

顺带修了一个隐蔽 bug:decodeAttach 返回 nil 让 JSON 输出 "attach":null,kotlinx.serialization 把它当类型错误抛出,导致手机端历史消息整段解码失败、界面永远显示「还没有消息」。

排障工具

cmd/ 下的几个小工具(仅 Windows 构建):

  • mdnsview / mdnssniff / mdnsfake / mdns6:把「广播没发出去 / 发错网卡 / 对端没应答 / 解析失败」四段分开验证
  • netdiag:逐块网卡真实 setsockopt 探测,区分「没有可路由 IPv4」「虚拟网卡」「策略禁止组播」
  • fstproxy:极简 TCP 转发,在开启无线客户端隔离的网络里由一台可达机器中转,Noise 握手仍在两端直接完成

关于 deb(重要)

这个 .deb 装的是服务模式,不是 GTK 窗口版。GTK4 + WebKitGTK 的窗口版必须用 CGO 在 Linux 主机上编译,本机没有可用的 Linux 工具链。仓库保留了对应配置(build/linux/nfpm/nfpm.yaml),在任意 Linux 主机执行 nfpm package -f build/linux/nfpm/nfpm.yaml -p deb 即可产出窗口版包。

兼容性

  • 协议 ID 仍是 /fst/msg/1.0.0,与 1.1.0 及旧移动端可互通;只有展示版本号升到 1.2.0。
  • 数据库、配置文件格式无变化,可直接覆盖安装;schema 迁移到 v7(messages.reply),旧库自动升级。
  • 桌面端数据目录仍是 %APPDATA%\FST(Windows)。

现状与限制

  • 三端可用但不完全对等:桌面端功能最全;Android 端没有 TUN/跨网络代理、群聊、文件夹发送、多设备消息同步(这些是端口裁剪,不是缺陷)。macOS 未验证。
  • 移动端未做真机回归:构建环境没有 Android 设备/模拟器,APK 只验证了「能编译、能签名、能被系统解包、核心能静态执行」,界面细节(尤其窄屏下的四宫格高度)需真机确认。
  • APK 为 debug 签名:可直接安装,上架应用商店需自备 release keystore。
  • 代理 IPv6 仍是实验能力,需真实双栈环境手工回归;不支持代理链。
  • 传输限速是全进程总量,不能按对端/方向单独设置;预哈希会多读一遍源文件。
  • 群聊只支持文本;历史只存本机,新成员看不到入群前消息。
  • 离线消息最多自动重试 20 次(退避封顶 10 分钟),之后转失败需手动重试。

验证情况

  • go build ./...、go vet 通过
  • 本机拉起真实守护进程做 IPC 冒烟:/settings 读→写→读一致;非法 base64 头像、未知 PeerID 的 trust/remove 均返回明确错误(而非静默成功)
  • gradle assembleDebug BUILD SUCCESSFUL,APK 内含 lib/arm64-v8a/libfstcored.so 与 classes.dex
  • deb 已解包校验:control 中 Version: 1.2.0-1、Architecture: amd64,载荷含 /usr/local/bin/fst、desktop 入口与图标
  • 未做真机回归:构建机没有连接 Android 设备,模拟器因 WHPX 未开启跑不起来。移动端界面只验证了编译与布局约束,四宫格在窄屏上的高度建议装上后确认

文档

v1.1.0

Choose a tag to compare

@xuey490 xuey490 released this 18 Oct 11:47

下载回来,解压到任意目录,双击fst.exe即可运行

v1.0.0

v1.0.0 Pre-release
Pre-release

Choose a tag to compare

@xuey490 xuey490 released this 17 Oct 02:03
4c77c45

已经打包好,在windows下解压,右键管理员运行,启动过程会有闪烁,只是命令行弹窗加载,无需理会