<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Docker on Tech Philosopher</title><link>https://blog.bktus.com/tags/docker/</link><description>Recent content in Docker on Tech Philosopher</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 02 Jan 2026 23:20:27 +0100</lastBuildDate><atom:link href="https://blog.bktus.com/tags/docker/index.xml" rel="self" type="application/rss+xml"/><item><title>个人 VPS 自部署的长期主义：干净与安全</title><link>https://blog.bktus.com/archives/6upskf/</link><pubDate>Fri, 02 Jan 2026 23:20:27 +0100</pubDate><guid>https://blog.bktus.com/archives/6upskf/</guid><description>&lt;p>我开始认真折腾个人 self-host，大概已经有五六年了。严格意义上开始管理我自己的 VPS
的时间点，应该还可以往前追溯。最初的动机其实很简单：有些服务我每天都在用，比如密码管理器、音乐播放、笔记同步、个人网站、代码仓库等等。既然如此，为什么不干脆自己部署？这样一来数据在自己手里，也不用被各种平台订阅和涨价牵着走。&lt;/p></description><content:encoded><![CDATA[<p>我开始认真折腾个人 self-host，大概已经有五六年了。严格意义上开始管理我自己的 VPS
的时间点，应该还可以往前追溯。最初的动机其实很简单：有些服务我每天都在用，比如密码管理器、音乐播放、笔记同步、个人网站、代码仓库等等。既然如此，为什么不干脆自己部署？这样一来数据在自己手里，也不用被各种平台订阅和涨价牵着走。</p>
<p>这几年一路走下来，说实话，self-host 并不省心。我要维护系统、备份数据、关心安全、偶尔还要救火。但它给我的回报也很明确：</p>
<ul>
<li>数据完全掌控在自己手里</li>
<li>不再被订阅价格牵着走</li>
<li>对系统、网络和安全的理解明显更深</li>
</ul>
<p>现在我一台服务器跑着十几个服务，成本只是一台服务器的钱。在这两年取消了不少第三方平台的订阅后，算下来，整体成本可能反而更低。对我来说，这种“复杂但可控”的状态，反而比依赖一堆外部服务更安心。当然不这适合所有人，我感觉有：有一定技术背景的人、喜欢折腾的人以及愿意为稳定与掌控付出时间的人，这三者合一就适合这样。</p>
<p>到现在，我并不觉得自己成了什么“专家”，但有到现在两件事的感受越来越强烈：<strong>安全性<strong>以及</strong>服务器环境的整洁程度</strong>，这也是这篇文章的两个主线。这两个问题，几乎决定了你这台服务器上的各类服务能不能长期稳定地用下去。然后就是需要迁移的时候，比如换了一个更便宜或者更好的 VPS 供应商，这个时候的工作量（我自己就换了好几次，知道真的换不动了才稳定下来）。</p>
<h2 id="草莽阶段">草莽阶段</h2>
<p>最开始的时候，我的做法非常朴素。我会直接在宿主机上安装服务，然后安装 Nginx 或者
Apache2（httpd）。比如用 Nginx 做反向代理，Nginx 这类 Web 服务器 的好处是配置文件可以拆开，每个站点一份，用域名来区分各个服务而不是端口号，看起来井井有条。那时候我觉得这套方案挺优雅的。</p>
<p>但随着服务慢慢变多，问题开始一点点浮现。有的服务需要特定版本的依赖，我很难在同一个环境安装不同版本的各种依赖库或者数据库。而有的会在系统里留下各种临时文件；配置文件散落在 <code>/etc</code>、数据放在 <code>/srv</code>，日志又在 <code>/var</code>。一开始你还能记得“这是哪个服务的”，时间一长就完全混在一起了。</p>
<p>这期间，当我想删除一个不用的服务时，我已经不敢确定自己删得干不干净。特别是有的服务提供“一键安装脚本”，安装的时候一时畅快，等到了你想摆脱它的时候，你会发现当初的脚本不知道做了什么改动，如何复原都毫无头绪。你很难确认还有没有残留的配置、后台进程，甚至不知道删错东西会不会影响别的服务。这种不确定感，本身就是一个风险，对于强迫症来说，每每想起简直是如鲠在喉。</p>
<h2 id="容器化阶段">容器化阶段</h2>
<p>后来我把几乎所有服务都迁移到了 Docker 里。而且，到现在越来越倾向于将所有能用的到的服务或者工具软件容器化，再去部署。有些不提供标准的容器化部署方案的，但又很想用的服务，我会直接自己进行容器化包装，形成自己的容器化的解决方案。</p>
<p>真正改变体验的不是 Docker 本身，而是 <strong>Docker Compose</strong>。容器这东西，本质上就不应该被当成“长期维护对象”，它随时都可以被删掉、重建，你需要意识到这个。早期的时候，我觉得 Docker Compose 配置文件麻烦，为什么不用命令直接创建一个容器，然后让这个容器长期运行。后来等我要更新，或者这个服务依赖多个底层的其他容器的时候，问题就逐渐浮现出来。如果当初将对服务的部署写下来，写到一个配置文件中，然后每次就执行这个配置文件就能完美复现原先的部署，不需要自己额外配置什么 Bridge 网络，或者什么
hostname，亦或者是重启策略。这个节省了大量的时间和精力，并且配置的时候出错的可能性，也大大降低了。</p>
<p>到现在，我能够总结出：真正需要被长期维护的，只有三样东西：</p>
<ul>
<li>服务配置（包括版本，网络，存储等）</li>
<li>数据（主要是 Volumes 和其他映射的目录）</li>
<li>部署配置（Docker Compose 的各类 Yml 配置文件）</li>
</ul>
<p>不管是重装系统，还是换一台机器，只要这三者还在，这些服务就能在这个新的地方完美地克隆。而且，宿主机本身终于变得“干净”了。各个目录下不再到处是你几年之前装过、现在已经忘记用途的东西。所以，在这个阶段，我单独创建了一个 git 仓库来收集和管理所有我用到的服务的对应的 Docker Compose 配置文件，一年下来，我感觉这样是经得起各类场景的考验的。</p>
<h2 id="一个服务一个数据库">一个服务一个数据库</h2>
<p>这个是一个值得一提的点。很长一段时间里，我的所有服务共用一个数据库实例。这在逻辑上看起来非常合理：资源省、结构简单、管理集中。但真正长期维护下来，你会发现这其实是一个<strong>非常不友好的设计</strong>。</p>
<p>每多一个服务，就多一套用户、权限、密码；想迁移一个服务，就得小心翼翼地把数据库剥离出来；数据库版本一旦升级，所有服务都要跟着承担风险。对于不熟悉某个数据库的人来说，管理权限和用户是一件头疼的东西，你需要通过命令行或者什么数据库管理软件，仔细地区分和妥善保管各个服务的用户以及他们的密码。</p>
<p>后来我干脆反过来做了一件事：**每个服务，单独一个数据库实例。**也就是，每个
Docker Compose 中独立地会有一个数据库的 service。长期观察下来，对个人 self-host
来说，这并没有想象中那么“浪费”。一个数据库容器通常只占一两百兆内存，在一台 4c8g
的 VPS，甚至 2c4g， 或家用服务器上，是可以容忍的。</p>
<p>但换来的好处是非常实在的：服务之间彻底隔离，大大提高了安全性，然后后续也不用再为权限和兼容性焦头烂额。直接一件将所有数据和配置打包带走即可，每个数据库就只有这个对应服务的数据。</p>
<h2 id="最小暴露面原则">最小暴露面原则</h2>
<p>早期我几乎把所有服务都直接暴露在公网，用反向代理加登录验证来保护：</p>
<ul>
<li>一个 Nginx Proxy Manager</li>
<li>所有服务都有公网域名</li>
<li>靠应用层用户名/密码防护</li>
</ul>
<p>当时我也觉得：“所有服务都设置有用户名和密码，应该没问题吧？”，后来我慢慢才意识到，这就是自己骗自己。只要其中<strong>一个服务</strong>出现：暴力破解漏洞、认证绕过或者
RCE（远程代码执行），攻击者就可能拿到容器权限甚至宿主机权限。最初的是我遇到的情况是，我非容器部署的 gitlab 服务，在 gitlab 有次出现严重的远程执行漏洞后，我没有及时知道这件事。然后某一天，我发现服务器就被注入了木马，这还是 Cloud Provider 提醒我我才知道的。如果那个时候我的服务器上存着照片、视频、备份数据，后果会是灾难性的。</p>
<p>另外不同服务的安全成熟度差异巨大，技术栈五花八门；有些项目还很年轻，对安全的考虑远不成熟；我也不可能每天盯着各类安全公告。一旦其中某一个服务出现漏洞，或者这些服务用得框架或者依赖，比如最近的 React 技术栈相关的安全漏洞，那这个或者这些服务就可能在短时间内爆雷。如果这个时候容器化以及隔离做的不好，攻击者拿到的不一定只是那个服务，而很可能是整台机器。然后就是隐藏的木马脚本，或者挖矿脚本。</p>
<p>这也是我后来形成的一个核心原则：能不对公网开放的服务，就不要对公网开放。博客、静态页面这种，被攻击了损失也有限；但笔记、密码管理器、管理后台这种东西，一旦出事就是灾难。所以，需要好好评估自己现在对外暴露的服务。以我个人的经验来看，最能够让人放心的就是各类静态网站，或者只是通过参数生成页面没有数据库的。但是，很多服务我都想用，如何做到有些暴露有些不暴露？因此，我现在的实践是只对公网暴露真正需要的服务，比如静态博客、极少数公共服务。Git 仓库尽量不对外或只暴露只读静态视图（通过
gitweb 或者 cgit 暴露），而动态服务、管理后台、笔记、密码管理器等一律不直接暴露在公网。</p>
<h3 id="部署私有-vpn">部署私有 VPN</h3>
<p>在后来，我发现解决这个问题的关键，是 VPN。我在服务器上部署了一个私有的 VPN（比如
WireGuard），把所有私有服务全部放到<strong>只在内网可访问的网络里</strong>。只有当我连接
VPN，拿到一个虚拟内网 IP 后，然后以这个内网 IP 为起点，才能访问这些服务。整体思路是：</p>
<ul>
<li>VPN 提供一个虚拟私有网段（如 <code>10.8.x.x</code>）</li>
<li>Docker 内部服务使用另一个私有网段（如 <code>172.x.x.x</code>）</li>
<li>两个网段通过路由互通</li>
<li>公网无法直接访问这些服务</li>
</ul>
<p>这一步的意义在于：我不再需要为每个服务单独设计“防御方案”，因为它们根本就不在攻击面上。再配合一个只在内网工作的反向代理和 DNS，使用体验反而比公网还好：域名清晰、服务稳定，而且非常安心。</p>
<h3 id="内部反代与域名解析">内部反代与域名解析</h3>
<p>进一步优化体验，我在内网部署一个 内部 Nginx 容器（在 172.24.0.0/16 下），和对外提供服务的 Nginx 实例（比如 172.20.0.0/16）完全隔离开来。这个内部 Nginx 实例固定绑定到私有 IP（比如 172.24.0.2），只服务通过 VPN 网络连接进来的流量。</p>
<pre class="mermaid">
  flowchart LR
  %% Clients
  PUB[&#34;Public Internet User&#34;] --&gt;|&#34;HTTPS&#34;| PNGX[&#34;Public Nginx (*.example.com)&#34;]
  PNGX --&gt; PBLOG[&#34;Public Service (e.g., blog/static)&#34;]

  %% VPN access
  DEV[&#34;Your Device\n(WireGuard Client)&#34;] --&gt;|&#34;VPN Tunnel&#34;| WG[&#34;WireGuard Server (10.8.0.0/24)&#34;]

  %% Internal name + reverse proxy (VPN-only)
  WG --&gt;|&#34;DNS&#34;| DNS[&#34;Internal DNS (172.24.0.4)&#34;]
  WG --&gt;|&#34;HTTPS&#34;| INGX[&#34;Internal Nginx (172.24.0.2)&#34;]

  %% Private services
  subgraph DOCKER[&#34;Docker Private Networks&#34;]
    INGX --&gt; VAULT[&#34;Vaultwarden&#34;]
    INGX --&gt; NOTES[&#34;Notes / Joplin&#34;]
    INGX --&gt; GIT[&#34;Git Service&#34;]
  end
</pre>
<p>然后，再加一个强制的内部 DNS 服务，所有通过 VPN 进来的流量都只能够使用这个 DNS
提供的域名解析服务。实际的成熟的部署方案有很多，比如 AdguardHome 等，这还能够同时解决广告拦截、域名劫持问题。这个 DNS 服务除了解析通过的普通的网络流量外，还专门代理*.vpn.example.com 下的所有 DNS 解析，比如：</p>
<ul>
<li><code>git.vpn.example.com</code></li>
<li><code>notes.vpn.example.com</code></li>
<li><code>vault.vpn.example.com</code></li>
</ul>
<p>这些 DNS 都统一解析到内部的 Nginx 的监听的 IP，172.24.0.2。这样在 VPN 已连接的情况下，后续通过浏览器直接输入对应的域名，就能够直接访问对应的内部服务。所有流量都在内网完成。这个域名，最好是要在自己名下，然后在外部 DNS 管理中，*.vpn.example.com 设置为 NXDOMAIN 或者 VPS 的 IP 地址，来确保如果不小心没有通过 VPN 来访问内部服务，流量不会被意外转发到其他地方去。</p>
<h3 id="隔离数据库容器">隔离数据库容器</h3>
<p>数据库不应该和其他无关服务在同一个 Docker 网络里。为此我又做了一件事：让每个服务、数据库单独一个 isolated bridge，在这个 bridge 下只有这两个容器能互相通信且该
bridge 不连接外部网络。也就是说，一个服务即便被攻破，它能接触到的，也只有自己的数据库，而不是整台服务器上所有的数据库。比如这样：</p>
<pre tabindex="0"><code>services:
  db:
    image: postgres:16-alpine
    ...
    networks:
      - iso
    restart: unless-stopped

  joplin:
    image: git.stdv.de/saturneric/joplin:latest
    ...
    depends_on:
      - db
    networks:
      - iso
      - vpn
    restart: unless-stopped
networks:
  iso:
    internal: true
  vpn:
    external: true
</code></pre><p>可以看到，db 只在 iso 网络中和 joplin 一对一通信，这个网络阻止该在网络内直接访问外部网络（internal: true）。这样其他服务的被入侵后，一般无法通过网络的方式来访问到我的 joplin 的数据库。但这并不是“绝对安全”，前提始终是攻击者没有拿到宿主机权限。但在现实世界里，<strong>减少横向移动的可能性</strong>，本身就是非常重要的一层防护。</p>
<p>这样做其实也可以防止 hostname / database 名冲突，就是很多在同一个网络下的
database 公用同一个 hostname，那么很可能会导致有的时候某些服务访问错了数据库。</p>
<h2 id="防火墙策略">防火墙策略</h2>
<p>如果你使用的是 VPS，我的建议是：优先使用 Cloud Provider 提供的防火墙，而尽量减少宿主机防火墙规则。然后对于外部防火墙，尽可能地严格限制入方向的放行的端口，服务都通过域名和反代来访问。原因包括：双重防火墙极易混乱，你很容易忘记配置了哪一个，哪一个没有配置；然后，我也发现 Docker 端口映射有时会绕过本地防火墙，这个可能引起意外的内部服务端口暴露，很多时候自己并没有发现。然后，云防火墙能提前挡掉大规模扫描流量，这个也是将这个计算消耗转移到 Cloud Provider 身上。</p>
<p>一般来说云防火墙入方向只放行下面的这些端口：</p>
<ul>
<li>80 / 443</li>
<li>VPN 端口</li>
<li>SSH</li>
<li>其他你认为真的有必要开的端口</li>
</ul>
<p>其他端口即便在宿主机监听，只要云防火墙不放行，对外就是不可见的。你只能够通过 VPN
来访问到这些端口，这个就省心多了。</p>
<h2 id="ssh-安全">SSH 安全</h2>
<p>这个领域有很多其他的优秀的文章，我就一些很基础但非常重要的点，这些也是我现在一直在做的：</p>
<ul>
<li>禁止 root 用户 SSH 登录。如果需要使用到 root 用户，则使用普通用户 + sudo</li>
<li>普通用户的 SSH 用户名不要太容易猜测，比如 admin 什么的。</li>
<li>普通用户设置长随机口令（建议密码管理器生成），而平时默认用<strong>密钥登录</strong>。</li>
<li>可选：只允许普通用户使用密钥登录，禁用密码。（要小心密钥没有备份然后设备丢失的情况）</li>
</ul>
<p>很多人会建议更换 SSH 的端口号，有关于个人环境下是否更换 SSH 端口，下面是个人的观点：</p>
<ul>
<li>个人环境下安全收益有限</li>
<li>后续某些配置复杂度会上升</li>
<li>最终还是视个人习惯决定</li>
</ul>
<h2 id="后记">后记</h2>
<p>我现在其实上了 Dedicated Server，而不再是 VPS，也就是类似在机房租了一台看得见的物理服务器。因为我现在其实需要托管几十个容器（捋了一遍都是我要的）。这可能也是这个 Self-Host 确实已经成为了自己每天离不开的技术基础设施的一种体现，也是说明，我认为我每个月的投入更多的资金确实有其价值。</p>
<p>然后，需要指出的是，在某些地方，文章中提到的，通过私有 VPN 来一体化支持自己的内部服务流量和普通上网的流量，很难做到。比如在这些地方，服务器的上行带宽非常贵或者用的是流量计费。这个时候，我的建议是在自己家里的软路由中，提前进行分流，将对于
Self-Host 的流量先分离出来，然后正常的上网流量就走家庭带宽出去。</p>
<p>还有就是，如果你能做到有足够的服务器的上行带宽支撑私有 VPN，很多时候你可能并不想自己的 VPS 的 IP 来浏览网页，这无疑直接暴露了你的身份。更好的情况是，你将流量引入另一个 VPN Provider 的 VPN 服务器，然后再通过它提供的出口 IP 出来。对于这个问题，我有一个长期自用的成熟的解决方案，你可以参考我的我博客文章：<a href="https://blog.bktus.com/archives/ozzkto/">搭建个人链式
VPN 网络：高效隐私保护、设备无限制管理与远程访问</a>。</p>
]]></content:encoded></item><item><title>搭建个人链式VPN网络：高效隐私保护、设备无限制管理与远程访问</title><link>https://blog.bktus.com/archives/ozzkto/</link><pubDate>Mon, 02 Jun 2025 19:20:00 +0200</pubDate><guid>https://blog.bktus.com/archives/ozzkto/</guid><description>&lt;p>在某些场景中，我们可能需要搭建一个链式 VPN 结构，即先让内网设备连接到自建的
WireGuard 服务器（如个人 VPS），再通过该服务器将所有流量转发到另一个 VPN（公司、学校或商业 VPN 服务）后才进入互联网。搭建这种「VPN 套 VPN」的网络架构，有以下明显优势：&lt;/p></description><content:encoded><![CDATA[<p>在某些场景中，我们可能需要搭建一个链式 VPN 结构，即先让内网设备连接到自建的
WireGuard 服务器（如个人 VPS），再通过该服务器将所有流量转发到另一个 VPN（公司、学校或商业 VPN 服务）后才进入互联网。搭建这种「VPN 套 VPN」的网络架构，有以下明显优势：</p>
<ul>
<li>
<p>强大的隐私保护：内网设备的数据流量首先通过自己搭建的 WireGuard 加密隧道传输至个人 VPS，再由 VPS 二次通过商业或公司 VPN 进行转发，最终从该 VPN 的 IP 出口访问互联网。这种方式彻底避免了使用 VPS 自身 IP 地址直接访问目标网络，大大降低了个人 IP 被跟踪或泄露的风险。</p>
</li>
<li>
<p>集中化便捷管理：所有客户端设备统一连接到单个 WireGuard 服务，免去逐一配置每台设备的麻烦。更重要的是，它还能巧妙绕过一些商业 VPN 服务商设定的账号设备数量限制，一次付费，所有设备共享。</p>
</li>
<li>
<p>灵活便捷，轻松切换：由于商业或公司 VPN 配置仅在自建 WireGuard 服务器端修改一次即可生效，下游客户端（手机、电脑等）无需单独调整。这使得更换或重新配置上游 VPN
时更加迅速和便捷，大大提高日常维护的效率。</p>
</li>
<li>
<p>打造专属虚拟局域网，实现跨设备互通：一旦所有设备连接到自建的 WireGuard VPN 服务器后，将自动获得统一的 VPN 虚拟局域网 IP 地址（例如：10.8.0.0/16）。处于该网络中的设备能够直接互相通信，无需额外设置。</p>
</li>
</ul>
<p>这种便捷性意味着无论你身处何处，都能轻松实现：</p>
<ul>
<li>远程 SSH 登录：随时访问家中或办公室的服务器。</li>
<li>私有 NAS 媒体访问：在外轻松访问家中 NAS 存储的媒体文件。</li>
<li>远程办公：随时随地安全访问公司内部网络资源。</li>
</ul>
<h2 id="方案">方案</h2>
<p>经过本人的探索和实践，我逐步摸索出了自己的一套链式 VPN 方案。总体来看，我的方案完全基于 Docker 部署，所用到的核心组件有：</p>
<ol>
<li><strong>gluetun</strong>：一个 Docker 镜像，内置 OpenVPN/ WireGuard 客户端，可连接到各大
VPN 服务提供商。本例中我们通过配置在 Docker 网络中提供 VPN 网关功能。</li>
<li><strong>wg-easy</strong>：一个简化的 WireGuard Docker 镜像，内置 Web 界面，便于创建/管理
WireGuard 配置文件。下游设备通过 WireGuard 客户端连接到该服务，所有流量将被转发到 gluetun 容器，由 gluetun 再发给上游 VPN。</li>
</ol>
<p>该方案的优势在于完全容器化部署，避免污染服务器/VPS 的环境。然后就是比较稳定，个人日常使用未发现明显延迟、卡顿、断流问题，而且性能良好（在个人家用带宽下测试）。另外，该方案现在能够支持 IPv6，即使设备身处 IPv4 的网络环境，也能通过链路实现对
IPv6 资源的代理访问。</p>
<p>在网络拓扑上，整个系统仅需要一个 Docker 网桥（bridge）：</p>
<ul>
<li><strong>vpn</strong>：用于 gluetun 与 wg-easy 之间的“VPN 网络”， gluetun 在其中作为网关，wg-easy 发出的流量都将进入该网络并通过 gluetun 转发到上游 VPN。</li>
</ul>
<pre class="mermaid">
  flowchart TD
 subgraph s1[&#34;Your Devices&#34;]
        n1[&#34;Phone&#34;]
        E[&#34;PC&#34;]
        D[&#34;Laptop&#34;]
  end
 subgraph s2[&#34;Your Server (VPS)&#34;]
        n2[&#34;WG-Easy (WireGuard Server)&#34;]
        F[&#34;Gluetun (VPN Client)&#34;]
  end
    n1 -- WireGuard Tunnel --&gt; n2
    n2 --&gt; F
    E -- &#34;WireGuard Tunnel&#34; --&gt; n2
    D -- &#34;WireGuard Tunnel&#34; --&gt; n2
    F -- VPN Tunnel --&gt; B[&#34;VPN Provider&#34;]
    B --&gt; n3[&#34;Internet&#34;]
    n1@{ shape: rect}
    B@{ shape: rect}
    n3@{ shape: rect}
</pre>
<p>其中，wg-easy 监听 UDP 51820，客户端（自己的手机电脑）连接后，wg-easy （在容器中）会将流量通过 Docker 网络 vpn 发往 gluetun 容器，gluetun 再使用
WireGuard/OpenVPN 连接上游 VPN。所有下游流量最终从 gluetun 的 tun0 接口出去，达到链式 VPN 的效果。</p>
<hr>
<p>对于想跳过下面的详细设置步骤、直接使用完整集成方案的用户，可以参考我在 GitHub 上的仓库：</p>
<p>👉<strong><a href="https://github.com/saturneric/wg-easy-gluetun">https://github.com/saturneric/wg-easy-gluetun</a></strong></p>
<h2 id="环境与前置条件">环境与前置条件</h2>
<ul>
<li>一台支持 Docker 与 Docker Compose 的 Linux 服务器/VPS（内核支持 WireGuard 和
iptables/NFT）。建议内核版本 ≥ 5.10。</li>
<li>已安装 Docker 和 Docker Compose v2+。</li>
<li>拥有一个支持 OpenVPN/WireGuard 的商业 VPN 服务商账号。</li>
<li>确保宿主机允许 CAP_NET_ADMIN 与 SYS_MODULE 权限，能加载 WireGuard 内核模块（可通过 lsmod | grep wireguard 验证）。</li>
</ul>
<h2 id="创建自定义网络"><strong>创建自定义网络</strong></h2>
<p>在正式部署前，先在宿主机上创建网桥</p>
<pre tabindex="0"><code>docker network create \
  --driver bridge \
  --subnet 172.31.0.0/16 \
  --subnet fd01:beee:beee::/48 \
  vpn
</code></pre><p>说明：如果已有网络与子网冲突，请根据实际情况调整子网段。本示例假设 Docker 网桥支持 IPv6（用于示例 IPv6 转发）。若不使用 IPv6，可省略相关配置或将
disable_ipv6=1。</p>
<h2 id="docker-compose-配置详解">Docker Compose 配置详解</h2>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">version</span>: <span style="color:#e6db74">&#34;3&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">services</span>:
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">gluetun</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">image</span>: <span style="color:#ae81ff">qmcgaw/gluetun</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">cap_add</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">NET_ADMIN</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">SYS_MODULE</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">devices</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">/dev/net/tun:/dev/net/tun</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">environment</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">VPN_SERVICE_PROVIDER=${VPN_SERVICE_PROVIDER}</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">VPN_TYPE=${VPN_TYPE}</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">WIREGUARD_PRIVATE_KEY=${WIREGUARD_PRIVATE_KEY}</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">WIREGUARD_PRESHARED_KEY=${WIREGUARD_PRESHARED_KEY}</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">WIREGUARD_ADDRESSES=${WIREGUARD_ADDRESSES}</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">SERVER_REGIONS=${SERVER_REGIONS}</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">configs</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#f92672">source</span>: <span style="color:#ae81ff">post-rules.txt</span>
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">target</span>: <span style="color:#ae81ff">/iptables/post-rules.txt</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">volumes</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">/lib/modules:/lib/modules:ro</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">/data/gluetun-ws:/gluetun</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">sysctls</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv4.ip_forward=1</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv4.conf.all.src_valid_mark=1</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv6.conf.all.disable_ipv6=0</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv6.conf.all.forwarding=1</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv6.conf.default.forwarding=1</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">networks</span>:
</span></span><span style="display:flex;"><span>      <span style="color:#f92672">vpn</span>:
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">ipv4_address</span>: <span style="color:#ae81ff">172.31.0.4</span>
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">ipv6_address</span>: <span style="color:#e6db74">&#34;fd01:beee:beee::4&#34;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">restart</span>: <span style="color:#ae81ff">unless-stopped</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">wg-easy</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">image</span>: <span style="color:#ae81ff">ghcr.io/wg-easy/wg-easy:15</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">ports</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#e6db74">&#34;51820:51820/udp&#34;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">networks</span>:
</span></span><span style="display:flex;"><span>      <span style="color:#f92672">vpn</span>:
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">ipv4_address</span>: <span style="color:#ae81ff">172.31.0.8</span>
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">ipv6_address</span>: <span style="color:#e6db74">&#34;fd01:beee:beee::8&#34;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">cap_add</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">NET_ADMIN</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">SYS_MODULE</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">sysctls</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv4.ip_forward=1</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv4.conf.all.src_valid_mark=1</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv6.conf.all.disable_ipv6=0</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv6.conf.all.forwarding=1</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">net.ipv6.conf.default.forwarding=1</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">volumes</span>:
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">/lib/modules:/lib/modules:ro</span>
</span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">/data/wg-easy:/etc/wireguard</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">restart</span>: <span style="color:#ae81ff">unless-stopped</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">networks</span>:
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">vpn</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">external</span>: <span style="color:#66d9ef">true</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">configs</span>:
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">post-rules.txt</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">content</span>: |<span style="color:#e6db74">
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      iptables -A FORWARD -i eth0 -o tun0 -j ACCEPT
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      iptables -A FORWARD -i tun0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      iptables -t nat -A POSTROUTING -o tun0 -j MASQUERADE
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      ip6tables -I INPUT -p icmpv6 -j ACCEPT
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      ip6tables -I OUTPUT -p icmpv6 -j ACCEPT
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      ip6tables -A FORWARD -i eth0 -o tun0 -j ACCEPT
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      ip6tables -A FORWARD -i tun0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">      ip6tables -t nat -A POSTROUTING -o tun0 -j MASQUERADE</span>
</span></span></code></pre></div><p>接下来，逐项拆解说明：</p>
<ul>
<li><code>image: qmcgaw/gluetun</code>：Lightweight swiss-army-knife-like VPN client to
multiple VPN service providers，能够使用在容器环境提供 VPN 服务，给其他有需要的容器提供 VPN 连接。官方维护的 gluetun 镜像，支持多种 VPN 协议与服务商。</li>
<li><code>cap_add: [NET_ADMIN, SYS_MODULE]</code>：需要 NET_ADMIN、SYS_MODULE 权限，以及开启
IP 转发等设置（wg-easy 与 gluetun 一致），赋予容器网络管理与加载内核模块的权限，以便创建 TUN 设备及配置路由，且保证 WireGuard 隧道与路由功能正常。</li>
<li><code>devices: [&quot;/dev/net/tun:/dev/net/tun&quot;]</code>：挂载宿主机的 TUN 设备到容器，使
gluetun 能创建虚拟网卡。</li>
<li><code>image: ghcr.io/wg-easy/wg-easy:15</code>：wg-easy 的官方镜像（版本号可根据需要调整）。</li>
<li><code>&quot;51820:51820/udp&quot;</code>：将宿主机 UDP 51820 端口映射到容器，以便下游设备通过宿主机或直接通过 Docker 网络来连接 WireGuard。如果你需要对外暴露 WG-Easy 的 Web 管理界面，那你需要额外加入<code>&quot;51821:51821/tcp&quot;</code>。</li>
</ul>
<p>环境变量中的具体参数可参考 <a href="https://github.com/qdm12/gluetun-wiki/tree/main">gluetun 官方文档</a>。</p>
<p>需要注意的是上面提到的这两个配置，用于固定容器在 Docker 网桥中的 IP 地址，后续配置 WG-Easy 的路由表和防火墙规则的时候会频繁引用。如果需要替换，那么需要注意修改后续配置中的相应值。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">networks</span>:
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">vpn</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">ipv4_address</span>: <span style="color:#ae81ff">172.31.0.4</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">ipv6_address</span>: <span style="color:#e6db74">&#34;fd01:beee:beee::4&#34;</span>
</span></span></code></pre></div><div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">networks</span>:
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">vpn</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">ipv4_address</span>: <span style="color:#ae81ff">172.31.0.8</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">ipv6_address</span>: <span style="color:#e6db74">&#34;fd01:beee:beee::8&#34;</span>
</span></span></code></pre></div><p>gluetun 额外启动脚本<code>post-rules.txt</code>加入的防火墙规则的解释如下：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span><span style="color:#75715e"># 1. IPv4 转发规则 （允许 eth0 &lt;-&gt; tun0 双向转发）</span>
</span></span><span style="display:flex;"><span>iptables -A FORWARD -i eth0 -o tun0 -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -A FORWARD -i tun0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 2. IPv4 NAT 伪装（所有走 tun0 的包都做 SNAT）</span>
</span></span><span style="display:flex;"><span>iptables -t nat -A POSTROUTING -o tun0 -j MASQUERADE
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 3. IPv6 ICMP 放行（保证 Neighbor Discovery Protocol 等协议正常）</span>
</span></span><span style="display:flex;"><span>ip6tables -I INPUT -p icmpv6 -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -I OUTPUT -p icmpv6 -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 4. IPv6 转发规则 （允许 eth0 &lt;-&gt; tun0 双向转发）</span>
</span></span><span style="display:flex;"><span>ip6tables -A FORWARD -i eth0 -o tun0 -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -A FORWARD -i tun0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 5. IPv6 NAT 伪装（所有走 tun0 的 IPv6 包都做 SNAT）</span>
</span></span><span style="display:flex;"><span>ip6tables -t nat -A POSTROUTING -o tun0 -j MASQUERADE
</span></span></code></pre></div><p>通过以上规则，下游（来自 wg-easy 的流量）在 gluetun 容器内部可以顺利地被转发到
tun0 接口，进入上游 VPN 通道；上游返回的数据包同样能回到 Docker 网络，并最终到达
wg-easy 再返回客户端。这就实现了一个 VPN 网关的功能。</p>
<h2 id="wg-easy-post-up-脚本说明">WG-Easy &ldquo;Post Up&rdquo; 脚本说明</h2>
<p>除了 gluetun 的网络规则，还需在 wg-easy 里设置“Post Up”和“Post Down”脚本，用于在
WireGuard 隧道建立后动态添加路由与 ip rule，让下游客户端的流量都走 gluetun。本例针对 wg-easy v15 版本，因为在 v15 版本后 wg-easy 才支持 IPv6。如果想知道 v14 版本的配置，可以看我在<a href="https://github.com/qdm12/gluetun/discussions/1192#discussioncomment-12689316">GitHub 发布的帖子</a>。</p>
<p><img alt="image-20250602184632727" loading="lazy" src="https://img.bktus.com/One7gB5U.webp"></p>
<p>在目前 v15.0.0 版本的实际的操作中，<strong>需要把我给出的示例转换为单行（用分号分隔每一条命令）填写到截图所示的输入框中</strong>。或者，你可以把脚本写成文件，添加到 wg-easy
中的目录中，然后引用。然后点击<code>Save</code>，耐心等待 wg-easy 弹出配置成功的提示框。必要时，可以在配置后重启 wg-easy 容器。</p>
<h3 id="配置示例">配置示例</h3>
<p>以下为完整示例以及解释（注意需在 wg-easy 的 WEB 管理页面配置）:</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span><span style="color:#75715e"># WG-Easy Post Up 脚本（示例）</span>
</span></span><span style="display:flex;"><span>VPN<span style="color:#f92672">=</span><span style="color:#66d9ef">$(</span>ifconfig | grep -B1 172.31.0.8 | grep -o <span style="color:#e6db74">&#34;^\w*&#34;</span><span style="color:#66d9ef">)</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 先默认拒绝所有转发流量</span>
</span></span><span style="display:flex;"><span>iptables -P FORWARD DROP
</span></span><span style="display:flex;"><span>ip6tables -P FORWARD DROP
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 开放 WireGuard UDP 端口（{{port}} 会被替换为 WireGuard 端口号，一般为 51820）</span>
</span></span><span style="display:flex;"><span>iptables -A INPUT -p udp -m udp --dport <span style="color:#f92672">{{</span>port<span style="color:#f92672">}}</span> -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -A INPUT -p udp -m udp --dport <span style="color:#f92672">{{</span>port<span style="color:#f92672">}}</span> -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 允许本地与 WireGuard 隧道之间的转发</span>
</span></span><span style="display:flex;"><span>iptables -A FORWARD -i wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -A FORWARD -o wg0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -A FORWARD -s <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> -d <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> -i wg0 -o wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ip6tables -A FORWARD -i wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -A FORWARD -o wg0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -A FORWARD -s <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> -d <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> -i wg0 -o wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 配置 IPv4 路由表（表 200 用作下游流量专用表）</span>
</span></span><span style="display:flex;"><span>iptables -t nat -A POSTROUTING -s <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> -o $VPN -j MASQUERADE
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 添加 ip rule，让源自 {{ipv4Cidr}} 的流量走表 200</span>
</span></span><span style="display:flex;"><span>ip rule add from <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip route add default via 172.31.0.4 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip route add 172.31.0.0/16 via 172.31.0.1 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip route add <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> dev wg0 table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 配置 IPv6 路由表（同理，使用表 200）</span>
</span></span><span style="display:flex;"><span>ip -6 rule add from <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route add default via fd01:beee:beee::4 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route add fd01:beee:beee::/48 via fd01:beee:beee::1 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route add <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> dev wg0 table <span style="color:#ae81ff">200</span>
</span></span></code></pre></div><p>下面三个变量是 wg-easy 的模板变量，会由 wg-easy 自动填充，但用户要确保参数有效：</p>
<ul>
<li><code>{{port}}</code>：WireGuard 监听的端口，一般与 Docker 映射的端口（51820）一致。</li>
<li><code>{{ipv4Cidr}}</code>：下游客户端网段，比如 <code>10.8.0.0/24</code>。由 wg-easy 分配给 Peer。</li>
<li><code>{{ipv6Cidr}}</code>：下游客户端的 IPv6 段，比如 <code>fdcc:ad94:bacf:61a4::cafe::/64</code>。</li>
</ul>
<p>这里提供用于 PostDown 的脚本（简单将<code>-A</code>替换为<code>-D</code>，<code>add</code>变成<code>del</code>）：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>VPN<span style="color:#f92672">=</span><span style="color:#66d9ef">$(</span>ifconfig | grep -B1 172.31.0.8 | grep -o <span style="color:#e6db74">&#34;^\w*&#34;</span><span style="color:#66d9ef">)</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>iptables -P FORWARD DROP
</span></span><span style="display:flex;"><span>ip6tables -P FORWARD DROP
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>iptables -D INPUT -p udp -m udp --dport <span style="color:#f92672">{{</span>port<span style="color:#f92672">}}</span> -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -D INPUT -p udp -m udp --dport <span style="color:#f92672">{{</span>port<span style="color:#f92672">}}</span> -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>iptables -D FORWARD -i wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -D FORWARD -o wg0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -D FORWARD -s <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> -d <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> -i wg0 -o wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ip6tables -D FORWARD -i wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -D FORWARD -o wg0 -m state --state RELATED,ESTABLISHED -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -D FORWARD -s <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> -d <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> -i wg0 -o wg0 -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>iptables -t nat -D POSTROUTING -s <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> -o $VPN -j MASQUERADE
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ip rule del from <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip route del default via 172.31.0.4 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip route del 172.31.0.0/16 via 172.31.0.1 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip route del <span style="color:#f92672">{{</span>ipv4Cidr<span style="color:#f92672">}}</span> dev wg0 table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ip -6 rule del from <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route del default via fd01:beee:beee::4 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route del fd01:beee:beee::/48 via fd01:beee:beee::1 dev $VPN table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route del <span style="color:#f92672">{{</span>ipv6Cidr<span style="color:#f92672">}}</span> dev wg0 table <span style="color:#ae81ff">200</span>
</span></span></code></pre></div><h3 id="使用多张-docker-网桥">使用多张 Docker 网桥</h3>
<p>在我的环境中，wg-easy 会连接到多张 Docker 网桥，也就是除了 vpn 之外，还有其他服务专用的网桥。如果你需要为 wg-easy 再接入新的桥接网络，建议保留上面配置中 $VPN
变量而不是直接 wg-easy 提供的 {{device}}模板变量。因为通过 $VPN 变量可以自动绑定对应网段对应的网卡，确保路由和防火墙规则只作用在指定的接口上，而不会误伤其他网络服务。对于第二个 Docker 网桥，你可以在 PostUp 中添加如下命令：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>VPN_IF<span style="color:#f92672">=</span><span style="color:#66d9ef">$(</span>ifconfig | grep -B1 172.31.0.8 | grep -o <span style="color:#e6db74">&#34;^\w*&#34;</span><span style="color:#66d9ef">)</span>
</span></span></code></pre></div><p>需要注意将<code>172.31.0.8</code>替换为 对应 Docker 网桥上的 wg-easy 容器的 IP，这个需要你固定 wg-easy 在该 Docker 网桥中的 IP。或者，你可以调整一下这个正则匹配，让 grep
筛选网段而非 IP 地址。这样，<code>$VPN_IF</code> 将解析为对应的网段正在使用的网络接口。然后，请同时更新路由表和防火墙规则，保证 各个服务网络之间的流量隔离与正常转发：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>iptables -t nat -A POSTROUTING -s &lt;NETWORK_CIDR&gt; -o &lt;NETWORK_INTERFACE&gt; -j MASQUERADE
</span></span><span style="display:flex;"><span>ip6tables -t nat -A POSTROUTING -s &lt;NETWORK_CIDR&gt; -o &lt;NETWORK_INTERFACE&gt; -j MASQUERADE  <span style="color:#75715e"># 如果此桥有 IPv6</span>
</span></span><span style="display:flex;"><span>ip route add &lt;NETWORK_CIDR&gt; via &lt;NETWORK_GATEWAY&gt; dev &lt;NETWORK_INTERFACE&gt; table <span style="color:#ae81ff">200</span>
</span></span><span style="display:flex;"><span>ip -6 route add &lt;NETWORK_CIDR&gt; via &lt;NETWORK_GATEWAY&gt; dev &lt;NETWORK_INTERFACE&gt; table <span style="color:#ae81ff">200</span>  <span style="color:#75715e"># 如果此桥有 IPv6</span>
</span></span></code></pre></div><p>对于需要给多个容器提供 VPN 服务的但又不希望直接给 wg-easy 添加多个 Docker 网桥的读者。这里提供一种更精细可控的做法：将那些需要走 VPN 的其他服务分别绑定到独立的
WireGuard 客户端容器（如 linuxserver/wireguard 或类似 Gluetun 的镜像）中，然后通过 wg-easy（或类似管理界面）为每个服务创建单独的 WireGuard 账户。最后将对应的配置导入到 服务对应的 WireGuard 客户端容器中。这样做的好处在于：</p>
<ul>
<li>每个服务拥有独立的 WireGuard 配置文件，流量隔离更彻底；</li>
<li>可以在 wg-easy 中更直观地监控、限制单个服务的网络访问；</li>
<li>不再需要编写诸如 <code>iptables -A FORWARD -i eth+ -o tun0</code> 这类对某个网络接口一概放行的规则，而是仅对特定容器进行信任授权。</li>
</ul>
<p>这种方式能够为每个容器提供更细粒度的权限控制，例如实时流量监控、随时撤销某个服务的 VPN 权限等等。不过，如果运行多个 WireGuard 客户端容器会带来额外的 CPU 和内存消耗。</p>
<h2 id="部署">部署</h2>
<h3 id="创建并加载环境变量">创建并加载环境变量</h3>
<p>在与 docker-compose.yml 同目录下，创建一个 .env 文件，写入（参考前面给出的
gluetun 文档）：</p>
<pre tabindex="0"><code>VPN_SERVICE_PROVIDER=XXX
VPN_TYPE=XXXX
WIREGUARD_PRIVATE_KEY=YOUR_PRIVATE_KEY
WIREGUARD_PRESHARED_KEY=YOUR_PSK
WIREGUARD_ADDRESSES=XXX
SERVER_REGIONS=XXX
</code></pre><h3 id="确认-docker-网络存在">确认 Docker 网络存在</h3>
<p>如前文所述，确保 名为 vpn 的自定义网络已创建。</p>
<h3 id="启动容器">启动容器</h3>
<p>执行下面的命令，观察 wg-easy 与 gluetun-ws 容器启动日志，确认 WireGuard 客户端与服务端都正常建立。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>$ docker-compose up -d
</span></span></code></pre></div><h3 id="添加-wireguard-客户端">添加 WireGuard 客户端</h3>
<ul>
<li>通过浏览器访问 <code>http://&lt;WG-Easy容器IP&gt;:51821</code>（取决于 wg-easy 配置），进入
wg-easy 的 Web 界面。或者你可以在 Docker Compose 中加入对于 51821 端口的 TCP
映射，然后用 <code>http://&lt;本机IP&gt;:51821</code> 访问 Web 管理界面。或者用 Nginx 进行反向代理也行。</li>
<li>在 Admin Panel 的 Hooks 栏，填写上面给出的的 Post Up 和 Post Down 配置，并保存。<strong>这一步特别关键。</strong></li>
<li>创建一个新的 Peer（填写 Peer 名称），wg-easy 会自动生成对应的配置文件，带有
AllowedIPs = 0.0.0.0/0, ::/0，并下载 .conf 文件。</li>
<li>在本地设备（Windows/Mac/Linux/手机）上导入该配置，启动 WireGuard，进行测试。</li>
</ul>
<h3 id="验证-vpn2vpn-通道">验证 VPN2VPN 通道</h3>
<ul>
<li>在客户端连上 WireGuard 后，打开 <a href="https://ipleak.net">https://ipleak.net</a> 或 <a href="https://ifconfig.co">https://ifconfig.co</a>，查看出口 IP。</li>
<li>若显示的是上游商业 VPN 的 IP，则说明链式 VPN 通道正常。</li>
<li>可在 gluetun 容器中执行 curl ifconfig.co，应该能看到商业 VPN 给的公网 IP；在
wg-easy 容器中执行同样操作，也能看到相同的出口 IP（走上游 VPN）。</li>
</ul>
<h3 id="检查流量路由">检查流量路由</h3>
<ul>
<li>在 wg-easy 容器中，可执行 ip rule show / ip route show table 200，确认路由表
200 已生效，默认路由指向 172.31.0.4（gluetun）。</li>
<li>在 gluetun 容器中，执行 iptables -t nat -L -nv，可看到对应的 MASQUERADE 规则。</li>
<li>如需排查，可在两容器内分别使用 tcpdump -i 对应接口进行抓包，确认流量状态。</li>
</ul>
<h2 id="注意事项">注意事项</h2>
<h3 id="dns-泄露">DNS 泄露</h3>
<p>本例如果不做额外的 DNS 安全措施，就存在 DNS 泄露的风险：当容器或客户端直接使用宿主机或公共 DNS 时，DNS 查询可能绕过 VPN 通道而直连上游，暴露真实 IP 和访问的网站记录；其实 gluetun 在自己内部会创建一个 DNS 服务器，然后强制所有的 DNS 流量走这个服务，来避免使用本地 DNS 造成 DNS 泄露。但 gluetun 默认只在容器内部监听 DNS 访问，外部容器或主机无法访问。这也让 wg-easy 无法直接使用 gluetun 内部的 DNS 服务，所以我们不能简单把 wg-easy 中的 DNS 流量直接转发到 gluetun。</p>
<p>为了避免这些问题，通常需要部署一个独立的 DNS 服务（如 AdGuard Home 或
Pi-hole），并将所有 DNS 查询都通过该服务处理，通过 VPN 出口进行上游解析，这样既能保证 DNS 查询也走 VPN，又能实现广告拦截和恶意域名过滤。</p>
<h4 id="部署-adguard-home-或类似的-dns-服务">部署 AdGuard Home 或类似的 DNS 服务</h4>
<p>我们可以在同一个 Docker 网络（例如 vpn 网络）中运行一个独立的 AdGuard Home 容器。AdGuard Home 会同时监听 UDP/TCP 53 端口，并且具有更强的拦截广告、恶意域名过滤等功能。举例来说，你可以在 docker-compose.yml 中加入类似以下服务（仅示范）：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">adguard</span>:
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">image</span>: <span style="color:#ae81ff">adguard/adguardhome</span>
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">restart</span>: <span style="color:#ae81ff">unless-stopped</span>
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">networks</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">vpn</span>:
</span></span><span style="display:flex;"><span>      <span style="color:#f92672">ipv4_address</span>: <span style="color:#ae81ff">172.31.0.16</span>
</span></span><span style="display:flex;"><span>      <span style="color:#f92672">ipv6_address</span>: <span style="color:#e6db74">&#34;fd01:beee:beee::16&#34;</span>
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">ports</span>:
</span></span><span style="display:flex;"><span>    - <span style="color:#e6db74">&#34;53:53/udp&#34;</span>
</span></span><span style="display:flex;"><span>    - <span style="color:#e6db74">&#34;53:53/tcp&#34;</span>
</span></span><span style="display:flex;"><span>    - <span style="color:#e6db74">&#34;3000:3000/tcp&#34;</span> <span style="color:#75715e"># Web 界面端口</span>
</span></span><span style="display:flex;"><span>  <span style="color:#f92672">volumes</span>:
</span></span><span style="display:flex;"><span>    - <span style="color:#ae81ff">/data/adguard/workdir:/opt/adguardhome/work</span>
</span></span><span style="display:flex;"><span>    - <span style="color:#ae81ff">/data/adguard/conf:/opt/adguardhome/conf</span>
</span></span></code></pre></div><p>这样，AdGuard Home 会暴露在宿主机的 53 端口，同时在 Docker vpn 网络内分配一个
IP（比如 172.31.0.5）。后续我们就能够从 wg-easy、客户机甚至其他容器直接访问这个
AdGuard 容器。你也可以选择不暴露 53 端口，仅仅通过 vpn 这个网桥提供 DNS 服务。</p>
<p>访问 AdGuard 的 Web 界面（通常在 <code>http://&lt;Host-IP&gt;:3000</code>），确认上游 DNS 设置正确，广告拦截等策略正常。然后你需要进行测试，最好在 WG-Easy 容器中执行<code>nslookup hostname 172.31.0.16</code>，测试 wg-easy 到 AdGuard Home 的 DNS 链路是否是通的。</p>
<h4 id="修改-dns-配置">修改 DNS 配置</h4>
<p>在 Adgaurd 部署、配置并测试成功后，我们需要调整在 wg-easy 生成的客户端 DNS 配置，因为 wg-easy 默认会把 DNS 服务器设置为<code>1.1.1.1</code>与<code>2606:4700:4700::111</code>。这一步需要在 wg-easy 的 Admin Panel 把 DNS 改为 AdGuard 容器的 IP：<code>172.31.0.16</code>与<code>fd01:beee:beee::16</code>。</p>
<p><img alt="image-20250603173359127" loading="lazy" src="https://img.bktus.com/pinDVKdk.webp"></p>
<p>需要注意：已经添加的设备的 DNS 配置并不会跟随 Admin Panel 中的 DNS 配置自动进行修改，需要你手动更新设备中 WireGuard 里的 DNS 配置，或者在 WG-Easy 中对这个设备单独进行调整然后在重新下载并应用配置文件到设备。</p>
<p>最后，为了严格限制 WG-Easy 对外的 DNS 访问，杜绝 DNS 泄露。我们可以在 PostUp
Hook 脚本中补充如下指令：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span><span style="color:#75715e"># 允许向 adgaurd 的 DNS 端口发包</span>
</span></span><span style="display:flex;"><span>iptables -A OUTPUT -o $VPN -d 172.31.0.16 -p udp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -A OUTPUT -o $VPN -d 172.31.0.16 -p tcp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -A OUTPUT -o $VPN -d fd01:beee:beee::16 -p udp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -A OUTPUT -o $VPN -d fd01:beee:beee::16 -p tcp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># 拒绝其它网络栈的 DNS 查询，避免漏出到宿主机</span>
</span></span><span style="display:flex;"><span>iptables -A OUTPUT -p tcp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span><span style="display:flex;"><span>iptables -A OUTPUT -p udp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span><span style="display:flex;"><span>ip6tables -A OUTPUT -p tcp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span><span style="display:flex;"><span>ip6tables -A OUTPUT -p udp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span></code></pre></div><p>其对应的 PostDown 脚本如下：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>iptables -D OUTPUT -o $VPN -d 172.31.0.16 -p udp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>iptables -D OUTPUT -o $VPN -d 172.31.0.16 -p tcp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -D OUTPUT -o $VPN -d fd01:beee:beee::16 -p udp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>ip6tables -D OUTPUT -o $VPN -d fd01:beee:beee::16 -p tcp --dport <span style="color:#ae81ff">53</span> -j ACCEPT
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>iptables -D OUTPUT -p tcp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span><span style="display:flex;"><span>iptables -D OUTPUT -p udp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span><span style="display:flex;"><span>ip6tables -D OUTPUT -p tcp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span><span style="display:flex;"><span>ip6tables -D OUTPUT -p udp --dport <span style="color:#ae81ff">53</span> -j REJECT
</span></span></code></pre></div><h3 id="ipv6-支持">IPv6 支持</h3>
<ul>
<li>如不使用 IPv6，可在 docker-compose.yml 中将 ipv6_address、ip6tables 规则等相关配置移除，并在创建网络时不启用 IPv6。</li>
<li>如果使用 IPv6，需要确保宿主机与 VPN 服务商支持 IPv6 隧道。</li>
</ul>
<h3 id="性能与资源">性能与资源</h3>
<p>WireGuard 本身对 CPU 要求较高，特别在满速传输时，需要较好的硬件支持。</p>
<h3 id="multi-hop多跳">Multi-Hop（多跳）</h3>
<p>本架构即为双跳（下游 → wg-easy → gluetun → 上游 VPN → 互联网）。如果想再进一步配置多跳，可在上游 VPN 选择不同区域，或再叠加一个 VPN 容器。但需注意性能下降与维护复杂度上升。</p>
<h3 id="防火墙与安全">防火墙与安全</h3>
<p>本例中，wg-easy 容器默认仅开放 UDP 51820 端口，如需在公网访问，请在宿主机防火墙
（iptables/nftables）开放对应端口，同时只允许可信 IP 访问，以减少暴露面。</p>
<h3 id="postdown-脚本">PostDown 脚本</h3>
<p>为避免卸载后遗留规则，务必为 wg-easy 的 PostDown 添加相应的 iptables -D、ip rule
del、ip route del 等操作。否则重启时可能产生重复路由或冲突。</p>
<h2 id="网络排查示例">网络排查示例</h2>
<p>当发现客户端无法访问 LAN 或 Internet 时，我在这里提供一些常用步骤快速定位问题的方案。这个方案也是我平时常用的。我相信通过这种由粗到细的思路，就能有效找出大多数网络连接故障的根源。</p>
<p>下面给出测试方案的具体的步骤，但这里仅仅展示在 IPv4 下的排查指令，对于 IPv6，读者可以很容易通过对指令进行微调来排查。</p>
<h3 id="分阶段-ping-测试本地">分阶段 Ping 测试（本地）</h3>
<ul>
<li><code>ping 10.8.0.1</code>：确认 VPN 隧道是否建立。</li>
<li><code>ping 172.31.0.8</code>：检查客户端是否能到达 wg-easy 容器（Docker 桥接网络）。</li>
<li><code>ping 172.31.0.4</code>：验证桥接网络到 gluetun 容器的连通性。</li>
<li><code>ping 8.8.8.8</code>：测试 gluetun 是否能正常访问外网。</li>
</ul>
<p>如果某步失败，就有针对性地检查对应的路由或防火墙规则。</p>
<h3 id="dns-解析验证本地">DNS 解析验证（本地）</h3>
<p>通过上面的测试后，说明 IP 层面链路没有问题，接下来我们就继续排查 DNS 的问题。</p>
<ul>
<li><code>nslookup example.com</code> ：通过 默认 DNS 服务器 。</li>
<li><code>nslookup example.com 172.31.0.16</code> ：通过 adgaurd 。</li>
<li><code>nslookup example.com 8.8.8.8</code> ：测试公共 DNS 是否可用。</li>
</ul>
<p>若无法得到正确响应，说明 DNS 请求没有到达预期的服务器。</p>
<h3 id="进入容器内部排查">进入容器内部排查</h3>
<p>如果 DNS 也没有问题，那可能是一些更深层次的路由表或者防火墙规则的冲突问题。我们可以分别进入 wg-easy 或者 gluetun 容器进行调试：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>docker exec -it &lt;container-name/id-of-wg-easy&gt; /bin/bash
</span></span><span style="display:flex;"><span>docker exec -it &lt;container-name/id-of-gluetun&gt; /bin/sh
</span></span></code></pre></div><p>在对应容器内执行：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>ip rule show             <span style="color:#75715e"># 查看路由规则是否正确</span>
</span></span><span style="display:flex;"><span>ip route show table <span style="color:#ae81ff">200</span>  <span style="color:#75715e"># 验证路由表 200</span>
</span></span><span style="display:flex;"><span>ping -c <span style="color:#ae81ff">2</span> 8.8.8.8        <span style="color:#75715e"># 测试容器出网</span>
</span></span><span style="display:flex;"><span>ping -c <span style="color:#ae81ff">2</span> example.com    <span style="color:#75715e"># 测试容器内 DNS</span>
</span></span><span style="display:flex;"><span>iptables-saves           <span style="color:#75715e"># 检查防火墙规则</span>
</span></span><span style="display:flex;"><span>ip route                 <span style="color:#75715e"># 验证默认路由表</span>
</span></span></code></pre></div><h3 id="更高阶方法tcpdump路由表与防火墙检查">更高阶方法：tcpdump、路由表与防火墙检查</h3>
<p>如果上述简单手段仍无法定位，那就说明存在一些更深的路由表或者防火墙配置冲突问题，
这个时候可使用 <code>tcpdump -i &lt;接口&gt;</code> 捕获数据包，观察 DNS（UDP/TCP 53）或其他流量是否到达容器或被丢弃。然后，请仔细检查宿主机和容器内的路由表（ip rule show、ip
route show）是否存在重叠或冲突项；确认 ip rule 的优先级和表表项是否生效。再次审视 iptables/ip6tables 规则，尤其是 FORWARD、OUTPUT、nat 表，确认是否有误拒绝或重复的规则导致流量被拦截。</p>
<h3 id="更新造成的问题">更新造成的问题</h3>
<p>需要注意，你遇到的问题也很有可能是某一个容器的镜像更新后造成的问题，这个时候需要检查是否最近有自动更新，然后尝试通过版本降级该解决。此时如果遇到的问题消失，那么接下来，在问题最终解决之前，可以先固定旧的镜像版本确保服务可用。</p>
]]></content:encoded></item><item><title>搭建一个免费开源好用的Docker面板 Portainer</title><link>https://blog.bktus.com/archives/qzi6jo/</link><pubDate>Wed, 23 Nov 2022 20:47:20 +0800</pubDate><guid>https://blog.bktus.com/archives/qzi6jo/</guid><description>&lt;p>Portainer 是一个好用的 Docker 容器控制面板。它的代码仓库在&lt;a href="https://github.com/portainer/portainer">这里&lt;/a>。它支持单节点和集群部署。&lt;/p>
&lt;p>&lt;img loading="lazy" src="https://img.bktus.com/9fTiNfHY.webp">&lt;/p>
&lt;p>在此之前，我已经将个人服务器完全容器化了。如果能够可视化操作、监控各种容器，对于日常的运维帮助很大，感觉一切尽在掌握。 可以看看搭建好后的效果，界面还是很美观的。&lt;/p></description><content:encoded><![CDATA[<p>Portainer 是一个好用的 Docker 容器控制面板。它的代码仓库在<a href="https://github.com/portainer/portainer">这里</a>。它支持单节点和集群部署。</p>
<p><img loading="lazy" src="https://img.bktus.com/9fTiNfHY.webp"></p>
<p>在此之前，我已经将个人服务器完全容器化了。如果能够可视化操作、监控各种容器，对于日常的运维帮助很大，感觉一切尽在掌握。 可以看看搭建好后的效果，界面还是很美观的。</p>
<p><img loading="lazy" src="https://img.bktus.com/IFxfLgEQ.webp"></p>
<p>可以快速拉取镜像</p>
<p><img loading="lazy" src="https://img.bktus.com/ayIZFLg7.webp"></p>
<p>可以可视化发布容器，并灵活设置环境变量、网络、重启策略等等参数。</p>
<p><img loading="lazy" src="https://img.bktus.com/wUudLYc0.webp"></p>
<p>可以在镜像更新的时候，快速用新镜像更新容器。</p>
<p><img loading="lazy" src="https://img.bktus.com/KPLjXDDl.webp"></p>
<p>还可以快速进入接入容器命令行，查看容器日志。</p>
<p><img loading="lazy" src="https://img.bktus.com/qrAtBO4O.webp"></p>
<p>可以说，我日常需要的功能都有，感觉很完善了。</p>
<h2 id="搭建">搭建</h2>
<p>那么对于单点服务器来说，该如何搭建呢，首先你要确认你的服务器目前有安装 Docker。可以输入<code>docker -v</code>来看看当前环境中是否存在 docker。 如果不存在，需要安装
docker，你可以在 Google 找找教程。对于 AWS 的 EC2，可以输入<code>sudo yum install docker -y</code>来安装。 确认安装好 Docker 后。确认一下 Docker 是否启动。然后看看
/var/run 路径下是否有 docker.sock 文件。 然后，确认 8000 端口和 9443 端口都没有被占用，因为 Portainer 后续要用到这两个端口。</p>
<h3 id="将应用数据存储在-docker-volume">将应用数据存储在 Docker Volume</h3>
<p>如果你想将 Portainer 产生的应用数据存在 Docker Volume 中，你可以直接执行下面的命令。后续部署完成后，Portainer 所使用的 Docker Volume 也可以在 Portainer 看到并管理。如果 8000 端口被占用了，可以将<code>-p 8000:8000</code>改成其他端口，类似<code>-p 12345:8000</code>。9443 端口也是类似。 如果你想指定容器名为其他，可以修改&ndash;name 参数，
比如说<code>--name myportainer</code>。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>% docker volume create portainer<span style="color:#ae81ff">\_</span>data
</span></span><span style="display:flex;"><span>% docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart<span style="color:#f92672">=</span>always -v /var/run/docker.sock:/var/run/docker.sock -v portainer<span style="color:#ae81ff">\_</span>data:/data portainer/portainer-ce:latest
</span></span></code></pre></div><h3 id="将应用数据映射到宿主机的其他地方">将应用数据映射到宿主机的其他地方</h3>
<p>你可以在/data 下建立目录 portainer，所以说，最终的路径是/data/portainer。我最终选择了这种方式，因为我单独购买了 AWS 的数据盘来存储我的服务器的应用数据。所以我倾向于将应用数据都存在数据盘中。 其他参数设置和上面的部分一致。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>% docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart<span style="color:#f92672">=</span>always -v /var/run/docker.sock:/var/run/docker.sock -v /data/portainer:/data portainer/portainer-ce:latest
</span></span></code></pre></div><h3 id="确认部署状态">确认部署状态</h3>
<p>然后执行<code>docker ps</code>来确认 Portainer 是否正常启动。可以参考我的截图中的红框中的信息。</p>
<p><img loading="lazy" src="https://img.bktus.com/rWI6KsIK.webp"></p>
<p>如果你等待几分钟，看到 Status 为 Up xxx minutes 的话，说明 Portainer 容器已经成功启动了。 然后，你可以访问 https://localhost:9443 来访问面板，并设置管理员密码。</p>
]]></content:encoded></item></channel></rss>