惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Martin Fowler
Martin Fowler
A
About on SuperTechFans
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
aimingoo的专栏
aimingoo的专栏
T
The Blog of Author Tim Ferriss
IT之家
IT之家
罗磊的独立博客
博客园_首页
月光博客
月光博客
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
Last Week in AI
Last Week in AI
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
量子位
Hugging Face - Blog
Hugging Face - Blog
G
Google Developers Blog
博客园 - 叶小钗
H
Help Net Security
N
Netflix TechBlog - Medium
B
Blog
Engineering at Meta
Engineering at Meta
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
V
V2EX
Vercel News
Vercel News
博客园 - 三生石上(FineUI控件)

分享创造

[发 15 个码] 开发的 Mac 应用 分享 KCase 脑图测试用例生成平台(AI 辅助生成测试用例) 标签页囤积症自救:写了个插件 TabRack,主打快速检索、自动分类和 AI 摘要 [file-preview]一个比较全面的在线文件预览组件库-支持 react 和 vue 撸了个 iOS 小应用[极简水印相机],直接免费 做了一个 V2EX Skill 写了个 iOS 打码 App「遮鸭 Maskduck」,纯离线免费 35 岁前端,裁员失业后,我花 1 个月做了个 AI 生图网站 亲身经历猫咪急症,我做了一款猫狗疼痛检测工具,希望能救你家毛孩一命 如何用 AI 做比较酷炫的落地页? 求真!最近 AI 生图的能力强到可怕 开源一个查看 k8s 的菜单栏工具-kubebar Packpour:我做了个专门给 App Store Connect 填多语言元数据的小工具 面对 140 年一遇的超级厄尔尼诺,我做了个全球监测小站 做了一个自动翻译的 Hacker News 客户端 做了一个 AI 头像生成器,可以免费生成 2 次 [送码 50 个] 自己手搓了个高颜值的倒数日 App——拾光机,求 V 友们指点 一个将苹果健康 APP 数据导出的工具,然后把你的数据喂给 AI 分析 我做了一个叫「订阅斩」的 iOS App,专门对付那些悄悄扣钱的订阅 做了个草率的日麻互动漫画,听听反馈 喜欢自己洗车的朋友们,我用 ai 做了一款洗车小程序 -- 洗车志 感谢 V2EX 上各位 NAS🍆 和 Datahoarder 玩家的关注和真实反馈!作为个人开发者,能得到这么多硬核玩家们的讨论,我非常荣幸。 用 AI 开发熊孩子自律的小程序 用 OpenClaw 搭建个人运动助手 今天摸鱼给 NanaAI 也接入了 GPT-Image-2 [Video Companion]一个 chrome 插件,解决大多对视频操作的需求~欢迎使用提 bug AI 时代,做产品简单了,把产品推广出去却变的更难了~ bestskills.dev - Skills 精选和评测站点 免 ROOT 强力卸载安卓广告软件 一个 All In One 的运维工具,支持 SSH、数据库、Redis 管理
BoringTun 不做 manager,那我用 Rust 做一个: WG-FRIEND
enrolls · 2026-04-22 · via 分享创造

最近在折腾一个项目:WG-FRIEND

一句话介绍:

Semantic WireGuard/BoringTun lifecycle and client management helper

它的出发点其实很简单: 我这边最近比较常见的几个场景,是需要一台比较稳定的服务器做跨网络访问,需要远程回家,也需要把多台设备之间的 WireGuard 生命周期管理得更清楚一些。

但我一直觉得,现有这类方案里有个空档:

  • wg-quick 很好用,但更像“把接口拉起来”的工具
  • PiVPN 这类方案很适合快速起量,但整体还是偏 shell/script orchestration
  • BoringTun 很强,尤其是 Rust userspace WireGuard 这条路线很有价值,但它本身并不负责 manager / control plane

所以用 Rust 实现wg-friend 就此开始:将“拉起接口 / 管理服务 / 管理客户端 / 导入历史资产 / 做诊断”这些事情,从零散脚本提升成一个语义更明确的 control plane 。

目前这个项目主要做了几件事:

1. 把 WireGuard/BoringTun 的操作语义化

命令面我切成了四组:

  • server
  • client
  • service
  • doctor

我不太想继续沿用“全靠 shell 拼起来”的方式,而是想把常用动作收敛成更稳定的 CLI 语义。

2. 不再把客户端状态散落在各处

wg-friend 会把可完整物化的客户端,纳入 /etc/wg-friend 下面的 canonical state 。

也就是说,进入管理域的前提不是“这个客户端貌似存在过”,而是它必须足够完整,能产出:

  • 元数据
  • 标准导出配置
  • QR-ready payload

3. 给历史部署一条 import 路径

很多现有机器并不是从零开始的,已经有 /etc/wireguard、有过去导出的 client conf 、也可能混着 PiVPN 或手工维护的文件。

所以我做了 client import,去扫描本地已有客户端配置,校验完整性,推导公钥,对上 server peer set ,然后再写入 wg-friend 的 canonical state 。

我更希望这个项目能做的是:

让旧部署渐进迁移,而不是推倒重来。

4. 明确和 systemd / BoringTun 的职责边界

这里我比较明确的设计是:

  • systemd 去负责长期进程监督
  • wg-friend 去负责 preflight / configure / verify / cleanup
  • BoringTun 去负责 userspace WireGuard tunnel
  • wg-friend 不去碰协议实现,而是做 manager/control plane

协议实现、服务托管、运维语义,这三层最好不要混成一团。

5. Rust 实现,不做 TUI ,优先可维护性

这个项目是 Rust 写的。 我没有做 TUI ,而是更偏向:

  • 命令优先
  • 缺参时再 prompt
  • 输出尽量语义化
  • 诊断尽量可读
  • systemd 场景下行为尽量稳定

我想做的不是“一个很炫的界面”,而是一个真正能放到服务器上长期跑的 WireGuard/BoringTun helper 。


我现在对它的定位,大概就是:

BoringTun 不做 manager ,那这一层我来做。

如果你也有下面这些场景:

  • 需要一台稳定的服务器承载 WireGuard/BoringTun
  • 有远程回家需求
  • 有多客户端管理、导出、二维码分发需求
  • 机器上已经有历史 WireGuard 资产,不想推倒重来
  • 希望整个 lifecycle 比 wg-quick + shell 更清晰一些

欢迎看看,也欢迎直接拍砖。

目前还是比较早期,主要先把管理模型、状态模型和生命周期边界打清楚。