Syncthing BEP 协议的 Rust 实现 — 零运行时依赖，单静态二进制，与官方 Go 守护进程线路兼容。
当前阶段：Alpha。核心协议完成，端到端同步验证通过，生产硬化进行中。
最新发布：v0.2.10-rc3 — Phase 0 完成 + 生产就绪修复 + 版本控制
| 亮点 | 说明 |
|---|---|
| 🔐 完整 BEP 协议 | prost 编解码, TLS + Hello + ClusterConfig + Index, LZ4 压缩 |
| 📁 端到端文件同步 | 块级拉取/推送, SHA-256 扫描, 双向同步 ~1 秒检测到推送 |
| 🔄 主动 Push | 本地文件变更立即推送到已连接对端 |
| 🗂️ 版本控制 | Simple (keep=N) + Staggered (4 时间窗口), .stversions/ 归档 |
| 🌐 多路径发现 | LAN UDP · 全球 HTTPS mTLS · STUN · UPnP · Relay v1 |
| 🖥️ 实时 TUI | 事件桥接实时同步状态, 配置热重载 |
| 🔄 Go 互操作 | 与 Go Syncthing v2.1.0 线路兼容 (跨版本已验证) |
| 组件 | 技术 |
|---|---|
| 协议 | BEP over TLS (prost + LZ4) |
| 网络 | Tokio + rustls + ParallelDialer |
| 发现 | UDP 广播 + HTTPS mTLS + STUN + UPnP + Relay v1 |
| 存储 | 元数据与块缓存抽象 |
| REST API | Axum (Go 版布局兼容) |
| TUI | 自定义事件桥接 |
syncthing-rust/
├── cmd/syncthing/ # CLI 入口 + TUI 主循环
├── crates/
│ ├── syncthing-core/ # 核心类型 (DeviceId, FileInfo, VersionVector)
│ │ # 信任边界：对下游 crate 只读
│ ├── bep-protocol/ # BEP 编解码 (prost) + 握手
│ ├── syncthing-net/ # TCP+TLS, ConnectionManager, 拨号, 发现, Relay
│ ├── syncthing-sync/ # Scanner, Puller, IndexHandler, 文件监控
│ ├── syncthing-fs/ # 文件系统抽象 (ignore, scanner, watcher)
│ ├── syncthing-api/ # REST API (Axum, Go 版布局兼容)
│ ├── syncthing-db/ # 元数据与块缓存
│ └── syncthing-versioner/# 文件版本控制 (Simple + Staggered)
├── docs/ # 设计文档, 计划, 报告
└── scripts/ # 健康检查, cloud-deploy, 压力测试
| 限制 | 影响 | 缓解 |
|---|---|---|
| 高延迟/不稳定网络 | 大文件批量传输可能因防火墙断开 | 自动重连 + keepalive；网络优化见 KNOWN_ISSUES §14 |
| 无 Symlink 同步 | 符号链接静默跳过 | v0.3.0 规划 |
| 无 Web GUI | 仅 TUI | — |
| 无 QUIC transport | 仅 TCP | 规划中 |
git clone https://github.com/juice094/syncthing-rust.git && cd syncthing-rust
cargo build --release
cargo run --release -- run --config-dir ~/.syncthing首次运行自动生成 Ed25519 TLS 证书。默认端口：BEP 22001, REST API 8385。
详见 CONTRIBUTING.md。
cargo test --all # 382 个测试
cargo check --all # 0 警告