vmflow-v0.4.0-开源L4端口转发-支持AI一句话配置转发规则-MCP写模式-使用教程

vmflow v0.4.0 发布，这是一款纯 Go 写的开源 L4 转发工具（MIT 协议），单二进制、TCP/UDP/tcp+udp 都支持，规则级限速、日/月流量配额、TUI 仪表盘、Telegram Bot 远程控制全都有。交流/反馈/蹲更新进 TG 群：https://t.me/VMPulse

本次 v0.4.0 最大亮点是 MCP 写模式：把 vmflow 接进 Claude、Codex 这类 AI 客户端后，直接说人话就能配置转发规则，不用再手写 config。

1、AI 一句话配置转发

vmflow 自带 stdio MCP 服务器（vmflow mcp），接进 AI 客户端后，跟 AI 说一句「帮我把本机 8080 转发到后端的 22 端口，限速 100Mbps」，AI 就会调用工具：读取当前配置 → 建规则 → 干跑校验 → 原子热加载，全程不用碰配置文件。

写模式默认关闭，需要显式开启（--write 或 VMFLOW_MCP_WRITE=1），安全设计不玩虚的：

默认只读：不开写模式就只有查询/诊断工具，摸不到配置
单规则操作：AI 一次只能增/删/改一条规则，幻觉最多影响一条，不会把整表覆盖掉
公网监听二次确认：监听非回环地址必须显式传 allow_non_loopback=true，AI 没法偷偷把端口开到公网
干跑校验：任何写操作都支持 dry_run，先过一遍 precheck（端口冲突、环路检测、目标解析）再落盘
并发保护：配置被别处改过会被拦截并提示重试，不会静默覆盖
令牌分级：写操作需要 admin 令牌，viewer 只能看

限速、配额这类参数直接写人话单位：100 Mbps、50GB，AI 传参不用换算字节。

2、转发本身的基本盘

协议：TCP、UDP、tcp+udp 三种模式，UDP 有界会话 + 队列 + 空闲回收
限速：规则级聚合带宽限制，支持上下行对称/不对称，人类可读单位（100 Mbps、12 MiB/s）
流量配额：日/月历法周期上传+下载合并计量，超量自动 block 到下个周期，配额状态持久化（v0.4.0 重构了持久化，写盘不再阻塞转发路径）
访问控制：IPv4/IPv6 源地址允许/拒绝列表，支持 CIDR
运维：配置热加载、precheck（环路检测、端口占用、目标解析）、Prometheus 指标、结构化日志
管理：TUI 仪表盘（vmflow tui）、CLI（vmflow ctl）、Telegram Bot 远程启停规则
平台：Linux / macOS / Windows，amd64 / arm64

3、安装

一行脚本，Linux/macOS 直接装：

curl -fsSL https://raw.githubusercontent.com/cloudapp3/vmflow/main/install.sh | bash

装完跑 vmflow init 进首次配置向导（选语言、建配置、装服务一条龙）。Windows 或手动安装见 GitHub Releases。

AI 接入也很简单，Claude Desktop 配置里加一段（Codex 同理）：

{
  "mcpServers": {
    "vmflow": {
      "command": "/usr/local/bin/vmflow",
      "args": ["mcp", "--write"],
      "env": {
        "VMFLOW_CONTROL_TOKEN": "你的admin令牌"
      }
    }
  }
}