Skip to content

PendingNet 0.3.31

Choose a tag to compare

@syncmeta syncmeta released this 24 Aug 02:04
· 23 commits to main since this release

自建代理的一套自用客户端。你需要一台自己的 VPS——这个仓库不托管任何服务端,下载了 app 也连不上任何现成节点。

这一版的重点:VPS 那头变成一条命令

在一台全新的 Debian VPS 上以 root 执行:

curl -fsSL https://raw.githubusercontent.com/syncmeta/PendingNet/main/deploy/vps-install.sh | sudo bash

脚本自己探公网 IP、下载并校验服务端二进制(下不到就现场装 Go 编译)、装好并启动服务,最后在屏幕上打印一条 pendingnet:// 配对链接。在装了 PendingNet 的 Mac / iPhone 上点一下那条链接就完成导入,链接被聊天软件吞掉时也可以整条复制、粘进 App 连接页的「粘贴链接导入」框。

再要一条链接就跑 sudo pendingnet-server pair create。凭据规则没变:默认十分钟过期、只能用一次、一台设备一份——它等同于密码,别往公开地方贴

脚本不会替你改防火墙,跑完会把需要放行的三个入口(443/tcp、443/udp、7443/tcp)列出来,你自己在云厂商安全组里开。第二次在同一台机器上跑只补一条新链接,不动在跑的服务;要重做部署得显式加 --force-provision(已配对的客户端会立刻失效)。

其他改动

  • 配对文件多了一种形态:一条 pendingnet:// 链接。macOS 和 iOS 都注册了这个 scheme,点一下直接唤起配对。原来的 .pdn 文件一个字没删(pair create --format json --out xx.pdn)。
  • provision 加了 --force,允许重做自己装过的机器;中途失败会把停掉的服务原样拉回来。
  • 发布产物新增 Linux 服务端二进制(amd64 / arm64)和 SHA256SUMS,一键脚本据此秒装。

系统要求和硬性前提

  • macOS 14 或更高。安装包经 Developer ID 签名并通过 Apple 公证。
  • 装完要去「系统设置 → 通用 → 登录项与扩展」把 PendingNet 的后台项目打开——不打开,TUN 和系统代理两种模式都用不了
  • 要连上必须有一台自己的 VPS,按上面那条命令装好 pendingnet-server 并生成一条配对链接。

已知边界

arm64 的服务端二进制只是交叉编译出来了,从没在真的 arm64 机器上跑过。一键脚本在容器里跑通了全套场景,但公网入站(云厂商安全组这类)只能在真机上验。iOS 版不能从这里分发,只能走 App Store / TestFlight。