WireGuard Peer 端点动态解析服务 - 自动检测并更新 WireGuard Peer 的端点 IP 地址。
- DDNS 域名解析：支持监控使用 DDNS 的 WireGuard Peer，当域名 IP 变化时自动更新
- Lucky STUN 隧道支持：支持从 Lucky 获取 STUN 隧道信息，自动更新 Peer 端点
- DNS-over-HTTPS：支持使用 DoH 进行域名解析，保护 DNS 查询隐私
- 间隔检查：可配置检查间隔，持续监控 Peer 端点变化
- 测试模式：提供
--test/-t参数用于测试 DNS 解析和 API 连接
- .NET 10.0 Runtime
- WireGuard 已安装（
wg.exe位于C:\Program Files\WireGuard\wg.exe）
配置文件为 appsettings.json，主要配置项如下：
"WireGuard": {
"WgExePath": "C:\\Program Files\\WireGuard\\wg.exe",
"CheckIntervalSeconds": 60,
"DnsResolveMode": "DoH",
"DoHServerUrls": [
"https://223.5.5.5/dns-query",
"https://doh.pub/dns-query",
"https://120.53.53.53/dns-query"
]
}
| 配置项 | 说明 | 默认值 |
|---|---|---|
WgExePath | wg.exe 可执行文件路径 | C:\Program Files\WireGuard\wg.exe |
CheckIntervalSeconds | 检查间隔（秒） | 60 |
DnsResolveMode | DNS 解析模式：System 或 DoH | DoH |
DoHServerUrls | DoH 服务器地址列表 | 阿里、腾讯、腾讯 DNSPod |
"DdnsPeers": [
{
"PublicKey": "Peer公钥",
"Domain": "ddns域名",
"Port": WireGuard端口
}
]
"LuckyPeers": [
{
"PublicKey": "Peer公钥",
"LuckyBaseUrl": "Lucky服务地址",
"OpenToken": "Lucky的OpenToken",
"TunnelName": "STUN隧道名称"
}
]
dotnet build -c Release
dotnet run
测试 DNS 解析和 Lucky API 连接：
dotnet run -- --test
# 或
dotnet run -- -t
使用 Windows Service Wrapper 或 NSSM 将程序安装为后台服务运行。
- 服务启动后每
CheckIntervalSeconds秒执行一次检查 - 获取当前 WireGuard 所有接口的 Peer 信息
- 对每个配置的 DDNS Peer，解析其域名并与上次结果比较
- 对每个配置的 Lucky Peer，从 Lucky API 获取隧道信息并与上次结果比较
- 当 IP 地址发生变化时，执行
wg set <interface> peer <publicKey> endpoint <ip:port>更新端点
src/
├── Program.cs # 程序入口
├── Workers/
│ └── Worker.cs # 后台工作服务
├── Services/
│ ├── WireGuardService.cs # WireGuard 命令执行
│ ├── DdnsResolver.cs # DDNS 域名解析
│ ├── LuckyClient.cs # Lucky API 客户端
│ └── ServiceTester.cs # 服务测试器
├── Models/
│ └── Config.cs # 配置模型
└── appsettings.json # 配置文件
- DnsClientX - DNS-over-HTTPS 客户端
- Microsoft.Extensions.Hosting - .NET 通用主机
- Microsoft.Extensions.Http - HTTP 客户端工厂
About
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
