plugowski/iptables

用于管理iptables条目的类。

1.0 2016-02-11 18:50 UTC

This package is not auto-updated.

Last update: 2024-09-14 19:14:42 UTC


README

iptable 库允许您通过PHP快速轻松地解析和操作iptables记录。其主要功能是解析原始iptables转储并构建完整的对象树,包含链和规则。它几乎将iptables提供的大部分功能都移动了过来。

并非所有补丁都已实现 - 对于我的目的来说没有必要这样做 - 但对于大多数用例来说应该足够。

安装

安装iptables的最简单方法是使用composer。

composer require plugowski/iptables

当然,您也可以下载该存储库并将所有类从src加载到您的项目中(别忘了加载所有必需的文件)。

用法

解析原始iptables转储,构建与iptables中的五个默认表之一相关联的链树。

use plugowski\iptables\IptablesService;
use plugowski\iptables\Table\Table;
use plugowski\iptables\Table\TableFactory;

$iptables = new IptablesService();
$table = (new TableFactory())->build(Table::TABLE_MANGLE);
$table->setRaw(shell_exec('iptables -nL --line-numbers -t ' . Table::TABLE_MANGLE));

$result = $iptables->parseIptablesChains($table);

上述代码的结果应该是包含Chain集合的Table对象。

$chains = $iptables->getChainsList();

连接

每个Table都有一个Chains,每个Chain都有一个Rules,其中包含描述所有选定选项的属性。使用iptables类,您可以简单地找到指定的链并获取其中所有规则列表。

示例

您可以直接在测试中查看一些示例。但为了快速查看,我也将其放在这里。

让我们获取iptables设置,我们想编辑第一条记录 - 设置源为127.0.0.1

Chain INPUT (policy DROP) 
num  target     prot opt source               destination
1    ACCEPT     all  --  0.0.0.0/0            0.0.0.0/0
2    DROP       all  --  0.0.0.0/0            0.0.0.0/0           state INVALID
3    ACCEPT     all  --  0.0.0.0/0            0.0.0.0/0           state RELATED,ESTABLISHED
4    DROP       tcp  --  0.0.0.0/0            0.0.0.0/0           tcp dpt:22 state NEW
5    ACCEPT     tcp  --  0.0.0.0/0            0.0.0.0/0           MAC 00:00:00:00:11:22

我假设我们已经在$result变量下解析了表格,所以这样做是最简单的方法

$newRule = new Rule('ACCEPT', 'tcp', '127.0.0.1');
$cmd = $result->getChainByName('INPUT')->replaceRule($newRule, 1);

对象中的第一条规则已被更改,并且在结果中我们得到了$cmd中的命令

iptables -R INPUT 1 -t mangle  --proto tcp --source 127.0.0.1 --jump ACCEPT

命令

命令类允许您生成用于管理iptables的纯shell命令(仅返回字符串,不执行!)。

// To create shell comand like that:
// iptables -A INPUT -t mangle --match mac --mac-source 11:22:33:aa:bb:cc --jump RETURN

$command = new Command(Table::TABLE_MANGLE);
$cmd = $command->setMatch('mac', ['source' => '11:22:33:aa:bb:cc'])
        ->setJump('RETURN')
        ->append('INPUT');

请确保您首先设置了所有选项(如setMatch()setProtocol()等),然后调用操作方法,因为这些方法返回字符串,因此无法进行链式调用。