阿坤玩存储

不只是存储

首页nas关于

wireguard ipv6 docker配置 带管理面板，支持双栈访问

2025-07-26

wg-easy 是一个由社区开发者 WeeJeWel 创建的开源项目，它将强大的 WireGuard VPN 服务与一个简洁直观的 Web 可视化界面集成在一起，通过 Docker 容器部署，让自建 VPN 变得异常简单。

🧩 主要特点

  • 快速部署：基于 Docker，只需几行命令即可启动服务，免去繁琐配置。

  • 网页管理界面：无需命令行操作，通过浏览器即可完成用户添加、删除、配置导出、查看连接状态等功能。

  • 一键生成客户端配置：支持生成配置文件及二维码，移动设备扫码即可连接。

  • 流量与连接监控：实时查看每个客户端的连接状态与上传/下载流量。

docker compose

version: "3"

services:
  wg-easy:
    image: weejewel/wg-easy
    container_name: wg-easy
    restart: unless-stopped

    environment:
      - WG_HOST=YOUR_SERVER_IP            # 替换为你的服务器公网 IP 或域名
      - PASSWORD=YOUR_ADMIN_PASSWORD      # 设置 Web UI 管理密码
      - WG_DEFAULT_DNS=223.5.5.5, 8.8.8.8 # 客户端DNS地址
    ports:
      - "51820:51820/udp"  # WireGuard VPN
      - "51821:51821/tcp"  # 管理界面

    volumes:
      - ./config:/etc/wireguard

    cap_add:
      - NET_ADMIN
      - SYS_MODULE

    sysctls:
      net.ipv4.ip_forward: "1"
      net.ipv4.conf.all.src_valid_mark: "1"      
      net.ipv6.conf.all.disable_ipv6: "0"
      net.ipv6.conf.all.forwarding: "1"
      net.ipv6.conf.default.forwarding: "1"

docker run

docker run -d \
  --name wg-easy \
  --restart unless-stopped \
  -e WG_HOST=YOUR_SERVER_IP \
  -e PASSWORD=YOUR_ADMIN_PASSWORD \
  -e WG_DEFAULT_DNS="223.5.5.5, 8.8.8.8" \
  -p 51820:51820/udp \
  -p 51821:51821/tcp \
  -v "$(pwd)/config:/etc/wireguard" \
  --cap-add NET_ADMIN \
  --cap-add SYS_MODULE \
  --sysctl net.ipv4.ip_forward=1 \
  --sysctl net.ipv4.conf.all.src_valid_mark=1 \
  --sysctl net.ipv6.conf.all.disable_ipv6=0 \
  --sysctl net.ipv6.conf.all.forwarding=1 \
  --sysctl net.ipv6.conf.default.forwarding=1 \
  weejewel/wg-easy

说明：

  • -e WG_HOST=YOUR_SERVER_IP ：将 YOUR_SERVER_IP 替换成你服务器的公网 IP 或者域名，例如 wg.xxxxxx.com 或 1.1.1.1。

  • -e PASSWORD=YOUR_ADMIN_PASSWORD ：设置 Web UI 登录密码，换成你自己想用的密码。

  • -e WG_DEFAULT_DNS="223.5.5.5, 8.8.8.8" ：客户端默认 DNS，可以根据需要改成其他。

  • -v "$(pwd)/config:/etc/wireguard" ：配置文件持久化，当前目录下的 config 文件夹会映射到容器内 /etc/wireguard，请确保你有这个文件夹，或先创建。

  • --cap-add 和 --sysctl 参数是必须的，保证容器能正确运行 WireGuard。

如果觉得上面这个升级提示看着不爽、自己会配置 https 的朋友可以继续往下看👀

该配置文件来自 WeeJeWel 最新的开源项目 wg-easy/wg-easy

wg-easy/wg-easy 简介

wg-easy 是一个开源项目，基于 WireGuard 打造的 可视化 VPN 管理面板，通过 Docker 部署即可轻松搭建属于自己的 VPN 服务。

  • ✅ 一键部署 WireGuard + Web 管理界面

  • ✅ 网页操作，支持添加/删除用户、二维码导出、连接状态查看

  • ✅ 支持 IPv6、Prometheus、客户端过期等高级功能

  • ✅ 面向新手，有引导界面进行配置

  • ✅多语言界面：包含简体中文，界面友好，适合国内用户使用。

GitHub 地址：👉 https://github.com/wg-easy/wg-easy

yaml 配置文件(该配置文件正常情况不用修改任何参数)

services:
  wg-easy:
    image: ghcr.io/wg-easy/wg-easy:15
    container_name: wg-easy
    volumes:
      - ./config:/etc/wireguard
      - /lib/modules:/lib/modules:ro
    ports:
      - "51820:51820/udp"
      - "51821:51821/tcp"
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    sysctls:
      - net.ipv4.ip_forward=1
      - net.ipv4.conf.all.src_valid_mark=1
      - net.ipv6.conf.all.disable_ipv6=0
      - net.ipv6.conf.all.forwarding=1
      - net.ipv6.conf.default.forwarding=1

docker run

docker run -d \
  --name wg-easy \
  --restart unless-stopped \
  -p 51820:51820/udp \
  -p 51821:51821/tcp \
  -v "$(pwd)/config:/etc/wireguard" \
  -v /lib/modules:/lib/modules:ro \
  --cap-add NET_ADMIN \
  --cap-add SYS_MODULE \
  --sysctl net.ipv4.ip_forward=1 \
  --sysctl net.ipv4.conf.all.src_valid_mark=1 \
  --sysctl net.ipv6.conf.all.disable_ipv6=0 \
  --sysctl net.ipv6.conf.all.forwarding=1 \
  --sysctl net.ipv6.conf.default.forwarding=1 \
  ghcr.io/wg-easy/wg-easy:15

引导界面：

管理界面

客户端管理界面

全平台客户端官网下载链接：https://www.wireguard.com/install/