You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+13-11Lines changed: 13 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -1,23 +1,23 @@
1
1
# Firewall Blocklist
2
-
Firewall blocklist script for Netgear R7800 Router with Voxel firmware.
2
+
Firewall blocklist script for Netgear R7800 & R9000 Routers with Voxel firmware.
3
3
Should work with several other Netgear routers as well.
4
4
5
5
## Version
6
-
3.2.0
6
+
3.2.1
7
7
8
8
## Prerequisite
9
9
* You need to have Voxel's Firmware: https://www.voxel-firmware.com
10
-
* Although not mandatory for this script to work properly, it is recommanded to bave iprange installed (either on the internal flash `/usr/bin`, or through Entware[self compiled]). The install script will offer to install iprange on the internal flash. You can decide to install it separately or not at all. iprange allows great optimizations.
11
-
* If it is possible to install the script on the system partition, this is not recommanded and this installation requires to be on an external (USB) drive (the one on which you may have installed Entware).
10
+
* Although not mandatory for this script to work properly, it is recommanded to bave iprange installed (either on the internal flash `/usr/bin`, or through Entware). The install script will offer to install iprange on the internal flash (R7800 only for now, but Entware version works on R9000). You can decide to install it separately or not at all. iprange allows great optimizations and recommended.
11
+
* If it is possible to install the script on the system partition, this is not recommended and this installation requires to be on an external (USB) drive (the one on which you may have installed Entware).
12
12
* This script will be creating `firewall-start.sh` in `/opt/scripts`; that is a way to define custom iptables in Voxel's Firmwares. If you are already using your own `/opt/scripts/firewall-start.sh`, a line will be added to it to allow this script to work. The clean process will remove that line leaving the rest of `/opt/scripts/firewall-start.sh` in place.
13
13
14
14
## Install
15
15
* Connect to router's terminal with ssh or telnet
16
16
* Go to the attached drive (USB): `cd /mnt/optware/` (or change optware by the mountpoint of your drive)
17
-
* Copy and paste the following command: `wget -qO- https://github.com/bolemo/firewall-blocklist/archive/v3.2.0.tar.gz | tar xzf - --one-top-level=fbl --strip-components 1`
17
+
* Copy and paste the following command: `wget -qO- https://github.com/bolemo/firewall-blocklist/archive/v3.2.1.tar.gz | tar xzf - --one-top-level=fbl --strip-components 1`
18
18
* Make install script executable: `chmod +x fbl/install.sh`
19
19
* Run install script: `fbl/install.sh`
20
-
* Answer `y` if you want to install iprange
20
+
* Answer `y` if you want to install iprange (will only be asked on R7800)
21
21
* Check if installation went fine: `/opt/bolemo/scripts/firewall-blocklist info`
22
22
* Remove the install files and folder: `rm -r fbl` check then confirm each file to delete answering y
23
23
@@ -61,13 +61,15 @@ The file `/opt/bolemo/etc/firewall-blocklist.sources` contains the list of serve
61
61
62
62
You can find a lot of lists on internet. One great source are the lists from FireHOL: http://iplists.firehol.org/
63
63
64
+
### Custom blocklist
64
65
Since version 3.1, you can have your own custom blacklist of IPs or netsets (IPs with cidr netmask): just create a file named `firewall-blocklist.custom-bl.netset` in `/opt/bolemo/etc/` with your own list. Next tile you will perform a `firewall-blocklist update`, it will integrate your custom list to the master blocklist.
65
66
66
-
Since version 3.2, you can have your own custom whitelist of IPs or netsets (IPs with cidr netmask): just create a file named `firewall-blocklist.custom-wl.netset` in `/opt/bolemo/etc/` with your own list. Next tile you will perform a `firewall-blocklist update`, it will integrate your custom list to the master whitelist.
67
+
### Custom whitelist
68
+
Since version 3.2, you can have your own custom whitelist of IPs or netsets (IPs with cidr netmask): just create a file named `firewall-blocklist.custom-wl.netset` in `/opt/bolemo/etc/` with your own list. Next time you will perform a `firewall-blocklist update`, it will integrate your custom list to the master whitelist.
67
69
68
70
## Logging
69
71
### Enabling
70
-
To log activity of firewall-blocklist and see what is blocked, you can use the `-log=on` option with the parameter `restart`, `load_set` or `update` using this script.
72
+
To log activity of firewall-blocklist and see what is blocked, you can use the `-log=on` option with the parameter `restart`, `load_set` or `update` using this script (for example: `/opt/bolemo/scripts/firewall-blocklist restart -log=on`).
71
73
You can also use the following command: `nvram set log_firewall_blocklist=1`; the next time the firewall-blocklist will be restarted, logging will be active until next reboot of the router.
72
74
If you want logging to stay on after a reboot, after using the `-log=on` option or the command `nvram set log_firewall_blocklist=1` do `nvram commit`.
73
75
@@ -83,9 +85,9 @@ If you used `nvram commit` after enabling logging, then you need to use `nvram c
83
85
iprange is a great little utility dealing that is now part of the FireHOL project.
84
86
firewall-blocklist works fine without iprange installed, but it is recommanded to install it as it allows great optimizations.
85
87
86
-
The install script offers to install a version of it on the router (rootfs in /usr/bin). It has been kindly compiled by Voxel and does not require Entware or an external drive.
88
+
The install script offers to install a version of it on the router (rootfs in /usr/bin). It has been kindly compiled (R7800 only at this time) by Voxel and does not require Entware or an external drive.
87
89
You can also install it separately:
88
-
* directly from Voxel's website here: https://voxel-firmware.com/Downloads/iprange_1.0.4-1_ipq806x.ipk and install it using the command `/bin/opkg install iprange_1.0.4-1_ipq806x.ipk`.
89
-
* using Entware: `/opt/bin/opkg install iprange`.
90
+
*[R7800 only]directly from Voxel's website here: https://voxel-firmware.com/Downloads/iprange_1.0.4-1_ipq806x.ipk and install it using the command `/bin/opkg install iprange_1.0.4-1_ipq806x.ipk`.
91
+
* using Entware: `/opt/bin/opkg install iprange` (ok with R9000 and others).
90
92
91
93
The source is here: https://github.com/firehol/iprange
0 commit comments