碎碎念

最近有点空，想着一口气把 issue 全清了。不知不觉过了 412 天，慢慢收获 1.2k star 。有兴趣的可以去仓库翻翻，README 介绍详细，场景原理都画了图。有问题欢迎提 issue 。

🧭仓库地址： https://github.com/zywe03/realm-xwPF

更新速览 20260902

网络转发脚本 xwPF.sh

• 转发协议能选纯 TCP / 纯 UDP / 双栈，状态栏标 [纯 TCP] [纯 UDP]


• systemd 和 OpenRC 双端都加了服务异常自动重启，带熔断，不会崩了之后疯狂刷屏

端口流量狗 port-traffic-dog.sh

• 新增整机流量监控，开机默认就开着，靠 /proc/net/dev 自安装起累计，重启或网卡重建自动校准


• 端口 / 端口组能设截止日期，到期自动阻断，延期或填 0 取消就自动恢复


• 多端口、端口段能组一起共享同一套统计 / 配额 / 限速


• 通知支持每分钟 / 小时 / 天推送，Webhook （企业微信 / 飞书 / 钉钉）和 Telegram 可填 API Host 中转 api.telegram.org

脚本介绍

网络转发脚本：xwPF.sh

同步 realm 最新版全部功能，终端 TUI 数字界面，点点点轻松管理网络转发。

• 多发行版：Debian/Ubuntu 、Alpine 、CentOS/RHEL 都认，自动识别包管理器和 init 系统（ systemd / OpenRC ）


• 服务自愈：双端服务异常自动重启，内置熔断防刷屏


• 转发协议选择：每条规则可选纯 TCP / 纯 UDP / 双栈（ both 默认）；纯 UDP 自动降级 standard 并跳过 ws/tls ；状态标签显示 [纯 TCP] [纯 UDP]，both 不显


• 搭建隧道：双端 realm 架构支持 TLS 、ws 、wss


• 负载均衡：轮询、IP 哈希，可配权重


• 故障转移：用系统工具做自动故障检测，保持轻量


• 规则备注：给规则加备注，不用额外记


• 端口流量狗：统计端口和整机流量，控制限速 / 限流，可设通知（见下面独立介绍）


• 直观配置 MPTCP：界面清晰展示 MPTCP 端点


• 网络链路测试：测延迟、带宽、稳定性、大包路由（基于 hping3 & iperf3 & nexttrace & bgp.tools ）


• 一键导出 / 导入：打包全部文件迁移，备注等信息完全带走；导入识别压缩包还原；还能批量识别导入自己写的 realm 规则配置


• 完整卸载：分阶段清理，"轻轻的我走了，正如我轻轻的来"

一键安装：

wget -qO- https://raw.githubusercontent.com/zywe03/realm-xwPF/main/xwPF.sh | sudo bash -s install

端口流量狗：port-traffic-dog.sh

独立脚本，能单独装，快捷指令 dog，不依赖主脚本。轻量级 Linux 端口流量监控管理工具，支持端口级和整机流量统计、速率限制、流量配额控制。

适用场景：中转、Web 服务器、代理、游戏服务器这类没自带流量管理的程序，给它挂上监控和控制； VPS 流量计费场景下防超额、降成本。

流量监控

• 持久化，异常关机重启无感保持数据


• 基于 nftables 的端口级精确统计，实时累计


• 整机流量默认开启，基于网卡计数器每分钟增量算，不新增防火墙规则，重启 / 网卡重建自动校准，自安装起累计（安装前历史流量不计）


• 支持单向（出站）和双向（入站 + 出站）


• 监控项语法：三种分隔符组合，- 表端口段（100-200），, 表同组共享（443,80 共享一套统计 / 配额 / 限速 / 重置），; 表独立项（443;80 各自独立）。能混：443,5000-5100;22222。同端口不能跨项重复，区间重叠直接拒

流量控制

• 基于 tc 的端口速率限制（ Kbps/Mbps/Gbps ），动态算 burst 应对突发又不过度放宽


• 整机限速和端口限速同时开自动取最小值


• 基于 nftables quota 的月度配额（ MB/GB/TB ），可自定义每月 1~31 日重置，超限自动阻断，手动能恢复


• 端口 / 端口组截止日期（YYYY-MM-DD），到期内核 drop ，延期或 0 取消自恢复


• 整机配额告警：和端口同路径设，超限只标签 + 推送预警，不阻断整机流量（防误杀 SSH ）

通知系统

• Telegram 和 Webhook 模块各自独立，禁一个不影响另一个


• Telegram 机器人推送，可填 API Host 中转 api.telegram.org


• Webhook 支持企业微信 / 飞书 / 钉钉群机器人


• 状态汇报间隔 1 分钟~24 小时随便设

数据与端口管理

• 一键导出 / 导入，完整迁移配置和数据


• 保留流量重置历史，日志自动轮转


• 多用户场景给端口加备注，方便区分

一键安装：

wget -O port-traffic-dog.sh https://raw.githubusercontent.com/zywe03/realm-xwPF/main/port-traffic-dog.sh && chmod +x port-traffic-dog.sh && ./port-traffic-dog.sh

网络受限用加速源即可