.
├── iptables-forward.sh      # 主入口
├── install.sh               # 创建 /usr/local/bin/iptables-forward 符号链接
├── lib/                     # 业务模块
├── tests/                   # 测试与 mock
└── plan_iptables_forward.md # 实施方案

运行要求

Debian 12/13
Bash 4+
root 或 sudo
iptables
ip6tables
iptables-persistent（提供 netfilter-persistent）

首次运行若缺依赖，脚本会列出缺失项并询问是否自动安装。

安装

直接运行

sudo ./iptables-forward.sh

安装到 PATH

sudo ./install.sh
sudo iptables-forward

默认会创建：

/usr/local/bin/iptables-forward -> /path/to/IPTables-Management/iptables-forward.sh

使用说明

交互模式

sudo ./iptables-forward.sh

主菜单提供：

查看所有转发规则
添加新的转发规则
删除现有转发规则
查看系统环境状态
立即保存到磁盘
退出

批处理模式

用于自动化测试或脚本调用：

sudo ./iptables-forward.sh --batch add <proto> <listen_port> <target_ip> <target_port> <ipver> [desc]
sudo ./iptables-forward.sh --batch delete <uuid>
sudo ./iptables-forward.sh --batch list
sudo ./iptables-forward.sh --batch save

参数说明：

proto: tcp / udp / both
ipver: 4 / 6 / both
target_ip:
- ipver=4 时传单个 IPv4
- ipver=6 时传单个 IPv6
- ipver=both 时传 IPv4,IPv6，例如 127.0.0.1,::1

示例：

sudo ./iptables-forward.sh --batch add tcp 8080 192.168.1.100 80 4 "web"
sudo ./iptables-forward.sh --batch add both 5353 127.0.0.1,::1 53 both "dns"

成功时标准输出会返回新规则 UUID。

存储与持久化

规则元数据默认保存在：

/var/lib/iptables-forward/rules.db

格式为一行一条：

uuid=a1b2c3d4|proto=tcp|lport=8080|tip=192.168.1.100|tport=80|ipver=4|desc=web|created=2026-04-17T10:00:00+0800

添加/删除规则时会自动调用：

netfilter-persistent save

以便把规则保存到：

/etc/iptables/rules.v4
/etc/iptables/rules.v6

测试

运行全部测试

tests/run_all.sh

跳过集成测试

tests/run_all.sh --skip-integration

测试覆盖：

tests/test_common.sh：输入校验
tests/test_storage.sh：规则存储
tests/test_env_check.sh：环境检查与修复
tests/test_rules_unit.sh：mock iptables 下的增删回滚
tests/test_integration.sh：真实 iptables 生命周期测试

tests/test_integration.sh 的执行策略：

root 环境下直接执行
非 root 但支持 unshare -Urn 时，会进入隔离网络命名空间执行
两者都不满足时会输出 SKIP

手工验收建议

建议按 plan_iptables_forward.md 再做以下实机验证：

在干净 Debian 12/13 上首次启动，确认自动安装流程可用。
准备一台实际后端服务主机，验证从第三方主机访问转发端口时流量确实命中目标服务。
重启系统后确认规则仍存在，且菜单中状态仍为健康。
删除规则后再次验证外部访问失败。

故障排查

1. 提示必须使用 root

脚本必须以 root 执行：

sudo ./iptables-forward.sh

2. 自动安装失败

可手动安装依赖后重试：

sudo apt-get update
sudo apt-get install -y iptables iptables-persistent

3. 持久化保存失败

确认以下命令可执行：

command -v netfilter-persistent
sudo netfilter-persistent save

4. 系统使用 nft 后端

Debian 12/13 默认常见为 iptables-nft。本项目不自动切换到 legacy 后端，而是依赖发行版默认配置。

5. 其它防火墙工具干扰

若系统启用了 ufw 或 firewalld，可能覆盖或影响转发规则。脚本会给出黄色警告，但不会自动关闭这些服务。

卸载

删除 PATH 链接

sudo ./install.sh --uninstall

删除脚本管理的规则与状态

sudo iptables-save | grep -v 'MGMT:' | sudo iptables-restore
sudo ip6tables-save | grep -v 'MGMT:' | sudo ip6tables-restore
sudo netfilter-persistent save
sudo rm -rf /var/lib/iptables-forward
sudo rm -f /etc/sysctl.d/99-iptables-forward.conf

可选：卸载持久化包

sudo apt-get remove --purge iptables-persistent

README.md Unescape Escape

IPTables-Management

目录结构