salmonstill/server

Fork 0

Files

T

salmonstill 6ef19d5be9 第一次初始化

2026-04-24 00:42:59 +08:00

5.3 KiB

Raw Permalink Blame History

Minecraft 基岩版 UDP 转发配置文档

架构

公网玩家 (UDP 19132)
    ↓
北京VPS (salmonstill.cn)
socat 监听 19132 → 转发到 10.0.0.2:19132
    ↓ WireGuard 隧道
旁路由 ImmortalWrt (192.168.1.199 / 10.0.0.2)
nftables 端口转发 + SNAT
    ↓
NAS (192.168.1.188:19132)
    ↓
Minecraft 基岩版 Docker 容器

设备信息

设备	IP	系统
北京VPS	`salmonstill.cn` / `49.232.242.90`	Ubuntu 22.04
旁路由	`192.168.1.199` / WG隧道: `10.0.0.2`	ImmortalWrt 24.10 (GL-MT2500)
NAS	`192.168.1.188`	绿联云 UGOS

第一部分：北京VPS 配置

WireGuard 配置 `/etc/wireguard/wg0.conf`

[Interface]
Address = 10.0.0.1/24
ListenPort = 51820
PrivateKey = <北京VPS私钥>
MTU = 1420

# 回包源地址转换（必须，否则公网玩家收不到回包）
PostUp = iptables -t nat -A POSTROUTING -s 10.0.0.0/24 -o eth0 -j MASQUERADE
PostDown = iptables -t nat -D POSTROUTING -s 10.0.0.0/24 -o eth0 -j MASQUERADE

[Peer]
# 旁路由
PublicKey = 9jPlaUhx2Dc+C5ZqJx6Iu8GtNMig3cFIoqfHg8PZbCA=
AllowedIPs = 10.0.0.2/32
PersistentKeepalive = 25

⚠️ 不使用 iptables DNAT 转发，改用 socat 处理 UDP 转发，避免 conntrack 连接跟踪问题导致回包丢失。

开启内核转发

echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf
sysctl -p

开放防火墙端口

ufw allow 51820/udp   # WireGuard
ufw allow 19132/udp   # Minecraft 基岩版

启动 WireGuard

systemctl enable wg-quick@wg0
systemctl start wg-quick@wg0

socat UDP 转发

socat 监听公网 19132 端口，收到包后转发给旁路由隧道 IP，并维护连接状态确保回包正确返回。

创建 systemd service：

nano /etc/systemd/system/mc-forward.service

[Unit]
Description=Minecraft UDP Forward
After=network.target

[Service]
ExecStart=/usr/bin/socat UDP4-LISTEN:19132,fork,reuseaddr UDP4:10.0.0.2:19132
Restart=always

[Install]
WantedBy=multi-user.target

启动并设置开机自启：

systemctl daemon-reload
systemctl enable mc-forward
systemctl start mc-forward

第二部分：旁路由 ImmortalWrt 配置

WireGuard 接口配置

路径：网络 → 接口 → 添加新接口

常规设置：

字段	值
接口名称	`WireGuard`
协议	`WireGuard VPN`
私钥	`<旁路由私钥>`
IP 地址	`10.0.0.2/24`
监听端口	不填

防火墙设置： 加入 wan 区域

Peers → 添加对端：

字段	值
公钥	`n159R7bNB+tW3Br0cok2zA27Pzg2WSPTI9uQ9odOFyU=`
端点主机	`salmonstill.cn`
端点端口	`51820`
允许的 IP	`0.0.0.0/0`
路由允许的 IP	✅ 勾选
持续 Keep-Alive	`25`

⚠️ 允许的 IP 必须设为 0.0.0.0/0，否则 WireGuard 会丢弃来自公网玩家 IP 的包。

端口转发配置

路径：网络 → 防火墙 → 端口转发 → 添加

字段	值
名称	`Minecraft-udp`
协议	`UDP`
源区域	`wan`
外部端口	`19132`
目标区域	`lan`
内部 IP 地址	`192.168.1.188`
内部端口	`19132`

SNAT 配置

路径：网络 → 防火墙 → NAT 规则 → 添加

字段	值
名称	`minecraft-snat`
地址族限制	`仅 IPv4`
协议	`UDP`
出站区域	`lan`
目标地址	`192.168.1.188`
目标端口	`19132`
操作	`SNAT - 重写为特定的源 IP 或端口`
重写 IP 地址	`192.168.1.199`

SNAT 的作用：将转发给 NAS 的包源 IP 改为旁路由 IP，确保 NAS 的回包发回给旁路由而不是直接走主路由，避免回包路径不对称。

第三部分：NAS Docker 配置

使用 network_mode: host 避免 Docker NAT 导致的 IP 映射问题。

services:
  bedrock:
    image: itzg/minecraft-bedrock-server:2026.2.1
    container_name: mc-bedrock
    network_mode: host
    stdin_open: true
    tty: true
    environment:
      EULA: "TRUE"
      VERSION: "1.26.14.1"
      TZ: "Asia/Shanghai"
      OPS: "2535472561115036"
    volumes:
      - /volume2/ProgramsV2/minecraft:/data
    restart: unless-stopped

第四部分：验证

检查 WireGuard 隧道

# 旁路由
wg show
# 正常应有 latest handshake 和双向 transfer

检查 socat 运行状态

systemctl status mc-forward

抓包验证完整链路

# VPS 上抓 wg0，确认双向流量
tcpdump -i wg0 udp port 19132 -n

# 旁路由抓 br-lan，确认转发到 NAS
tcpdump -i br-lan udp port 19132 -n

# NAS 上抓包，确认收到并回包
sudo tcpdump -i bridge0 udp port 19132 -n

故障排查

现象	排查方法
WireGuard 无握手	检查 VPS 防火墙 51820/udp 是否开放
socat 收不到包	检查 ufw 19132/udp 是否开放
旁路由收不到包	检查 WireGuard AllowedIPs 是否为 `0.0.0.0/0`
NAS 收不到包	检查端口转发内部端口是否填写正确
NAS 有回包但玩家连不上	检查 SNAT 规则是否生效，确认 NAS 用 host 网络模式
游戏内延迟不显示	检查 socat 是否正常运行，DNAT 规则是否已删除

扩展：新增其他 UDP 服务

VPS 新建一个 socat service，修改端口号
旁路由 LuCI 端口转发新增一条规则
ufw allow <新端口>/udp

5.3 KiB Raw Permalink Blame History Unescape Escape