iv-org/smart-ipv6-rotator
1
0
Fork 0
mirror of https://github.com/iv-org/smart-ipv6-rotator.git synced 2024-11-27 00:00:30 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
IPv6 rotator for specific subnets - unblock restrictions on IPv6 enabled websites (Google by default but customizable for others)
7 Commits 1 Branch 0 Tags 134 KiB
Python 99%
Dockerfile 1%
1d0101a286
Go to file
Emilien Devos 1d0101a286 fix variable assignment
2023-10-14 18:47:09 +02:00
.gitignore first working version 2023-10-14 18:04:21 +02:00
config.py.example init progression 2023-10-12 00:23:32 +02:00
README.md improve doc + timeout for checking ipv6 2023-10-14 18:44:28 +02:00
smart-ipv6-rotator.py fix variable assignment 2023-10-14 18:47:09 +02:00

README.md

Requirements

  • IPv6 on your server
  • Invidious works in IPv6
  • Install these two python packages:
    • pyroute2
    • requests

How to setup (very simple tutorial for the moment)

  1. Git clone the repository somewhere
  2. Copy the file config.py.example to config.py.
  3. Change the ipv6_subnet to your IPv6 subnet. If you do not know it, you can use a tool like http://www.gestioip.net/cgi-bin/subnet_calculator.cgi
  4. Run once the script using sudo python smart-ipv6-rotator.py run
  5. If everything went well then configure a cron for periodically rotate your IPv6 range. Once per day is enough for YouTube servers.

How to clean the configuration done by the script

sudo python smart-ipv6-rotator.py clean

Only works if the script did not crash.

Why does this need root privileges?

You can only modify the network configuration of your server using root privileges.
The attack surface of this script is very limited as it is not running in the background, it's a one shot script.

How does this script work?

  1. First it check that you have IPv6 connectivity.
  2. It automatically find the default IPv6 gateway and automatically generate a random IPv6 address from the IPv6 subnet that you configured.
  3. It adds the random IPv6 address to the network interface.
  4. It configures route for only using that new random IPv6 address for the specific IPv6 subnets (Google ipv6 ranges by default). This way you current ipv6 network configuration is untouched.

TODO

  • Allow to configure your IPv6 subnets yourself. (Could be used for other projects)
  • Better handle in case of errors in configuring IPv6 routes. Rollback the changes automatically
  • Argument for testing if the setup will work without permanently do any modification.
  • Allow to specify a specific network interface + ipv6 gateway instead of automatically discovering it.
  • Arg for spit out the IPv6 subnet of the current default ipv6 address instead of saying to use gestioip.net tool.