https://blog.ohtly.com/tags/netbird/ Recent content in Netbird on OHTLY Blog Hugo zh-cn Thu, 18 Jun 2026 21:41:45 +0800 https://blog.ohtly.com/posts/2026-06-18-netbird-selfhosted/ Thu, 18 Jun 2026 21:41:45 +0800 https://blog.ohtly.com/posts/2026-06-18-netbird-selfhosted/ <h2 id="概述"> 概述 <a class="heading-link" href="#%e6%a6%82%e8%bf%b0"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>用 NetBird 自建控制平面，替换现有的 WireGuard VPN 手动组网。控制平面部署在云服务器上，所有节点通过 P2P WireGuard 隧道互联。</p> <h2 id="步骤"> 步骤 <a class="heading-link" href="#%e6%ad%a5%e9%aa%a4"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <h3 id="1-traefik-v2--v3-升级"> 1. Traefik v2 → v3 升级 <a class="heading-link" href="#1-traefik-v2--v3-%e5%8d%87%e7%ba%a7"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h3> <p>现有 Traefik 版本是 v2.10.7，先升级到 v3.7.5 为后续路由做准备。</p> <p>兼容性分析：</p> <ul> <li>文件配置文件（File provider）的 YAML 语法完全兼容，无需改动</li> <li><code>--serversTransport.insecureSkipVerify</code> CLI 参数名不变</li> <li><code>ipwhitelist</code> 中间件重命名为 <code>ipAllowList</code>，在 v3 中需要手动迁移</li> <li>升级时需要加 <code>--core.defaultrulesyntax=v2</code> 保持路由语法兼容，确认稳定后移除</li> </ul> <p>升级步骤：只需改 Docker Compose 的 image tag，重启即可。</p> <h3 id="2-netbird-控制平面部署"> 2. NetBird 控制平面部署 <a class="heading-link" href="#2-netbird-%e6%8e%a7%e5%88%b6%e5%b9%b3%e9%9d%a2%e9%83%a8%e7%bd%b2"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h3> <p>控制平面用 Docker Compose 部署，使用 NetBird v0.65+ 的<strong>合并容器架构</strong>，不再需要分开的 management/signal/relay/coturn 四个容器。</p>