这一页是 PendingNet 在 GitHub 上的项目说明(README)。下面收起来的那一节,是给想自己下载源码跑起来的人看的;只想了解这个项目是什么,跳过它就行。
PendingNet
和 VPS 搭配使用的 Sing-box 部署方案 配套 Mac/iOS 客户端
苹果生态用 VPS 搭自建节点的一整套解决方案部署脚本 + Mac/iOS 客户端(iCloud 同步)+ 流量统计(分应用、域名统计)
协议:默认 TCP 走 Xray Reality,UDP 走 Hysteria2
快速开始
- macOS —— Releases
- iPhone / iPad —— TestFlight
仓库结构
cmd/pendingnet-server/ VPS 端:安装、部署、接管、配对、状态
cmd/sbtally/ 本机统计的命令行
internal/pnserver/ 服务端核心:状态、HTTP API、Release 下载校验、systemd
internal/pairing/ .pdn 的生成与严格校验
internal/source/ Clash API 的 WebSocket 连接流订阅
internal/core/ 流量累加、SQLite 存储、查询
internal/daemon/ 统计守护进程 + 本地 HTTP/SSE 接口
internal/sbconfig/ sing-box 配置的导入与生成
app/SBTallyCore/ Swift 共享层(模型、配置生成、Keychain、控制协议)+ 全部 Swift 测试
app/SBTally/ macOS app
app/PendingNetHelper/ macOS 特权助手(root,按代码签名校验 XPC 调用方)
app/PendingNetIOS/ iOS app
app/PacketTunnel/ iOS Packet Tunnel Extension(内嵌 libbox)
scripts/ 构建、签名、公证、发布、App Store Connect 查询
deploy/ vps-install.sh(VPS 一键部署)+ 本机 launchd 部署脚本(早期的自用统计服务)
技术栈:Go 1.26(modernc.org/sqlite 纯 Go 实现,不用 cgo;github.com/coder/websocket)·
Swift 6 / SwiftUI · NetworkExtension · sing-box libbox · XcodeGen · Sparkle 2 · systemd · Xray-core · Hysteria2
许可
第三方运行时 / 库:sing-box · Xray-core · Hysteria2 · Sparkle 2 · modernc.org/sqlite 等,各遵其原协议。
这一页搬自 syncmeta/PendingNet 的 README,搬运日期 2026-08-24。 这是一次性拷贝:GitHub 上的 README 以后改了,这一页不会跟着变。 原文在 https://github.com/syncmeta/PendingNet/blob/main/README.md。