Repository navigation
Releases
FST v1.2.0
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
- 解压 zip 到任意目录(不要放在
%APPDATA%\FST)。 - 双击
fst.exe,首次启动会在%APPDATA%\FST\生成身份与数据库。 - 局域网内另一台设备启动后,设备页会自动出现对方;点卡片即可聊天或发送文件。
换机器只需拷 fst.exe(要用 TUN 代理再带上 wintun.dll)。不要拷 %APPDATA%\FST\——identity.key 是设备身份,两台机器共用会 PeerID 冲突。
Android
- 传输 APK 到手机,允许「安装未知应用」后安装。
- 首次启动授权「通知」与「附近设备」;核心以本地库形式解压执行,App 会申请前台服务常驻。
- 与电脑连同一 Wi-Fi,两端互相出现在设备页即可互通。手机之间的直连不需要电脑参与。
Debian / Ubuntu(服务模式)
sudo dpkg -i fst_1.2.0-1_amd64.deb
fst serve # 终端会打印访问地址、访问令牌与数据目录
# 浏览器打开 http://127.0.0.1:9797 ,输入令牌即可使用完整界面安装后应用菜单会生成「FST」入口(终端中启动服务模式)。
首次互通自检
- 两台设备在同一网段,路由器关闭「AP 隔离 / 客户端隔离」。
- 双方防火墙放行 TCP/UDP 8787 与 UDP 5353。
- 设备页互相可见 → 点卡片发一条消息验证;不可见时按 局域网发现与排障 逐层排查。
本版重点
局域网发现可用化
「手机发现不了电脑」「电脑看得见手机、手机看不见电脑」的根因有三个,逐个修掉:
- 服务类型不规范。 原来广播名是
fst.local.,而 Android 的NsdManager与 iOS 的NWBrowser只接受带下划线前缀的合法 DNS-SD 类型(_fst._tcp)。现在双注册:_fst._tcp给移动端,旧裸标签fst留给已装机的老客户端。 - 手机把自己播成了 127.0.0.1。 Android 11+ 禁止应用 UID 使用
NETLINK_ROUTE,net.Interfaces()必然失败,libp2p 展开监听地址后只剩回环地址。对端拿这个地址拨号会连到自己(peer id mismatch),症状是「已连接但发不出消息」。新增AnnounceIP/SetAnnounceIP,把回环改写成真实局域网 IPv4,Wi-Fi 变化时热更新。 - 组播发到了虚拟网卡。 多网卡机器(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 assembleDebugBUILD 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 未开启跑不起来。移动端界面只验证了编译与布局约束,四宫格在窄屏上的高度建议装上后确认
文档
- README_zh.md — 详细版:功能、架构、协议、编译、打包、中继部署、局域网排障、本地调试、现状与限制
- README.md / README_ja.md — 英文 / 日文精简版
- phone/README.md — 移动端界面结构、IPC 接口与构建步骤
- docs/局域网发现排查报告.md — mDNS / 网卡 / 防火墙 / AP 隔离的完整排查路径
- docs/移动端技术选型评估.md — 移动端复用 Go 核心的取舍