Skip to content

tehnick/bosixnet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

81 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BOSixNet – Build Own IPv6 Network

Copyright: 2013-2019 Boris Pek <tehnick-8@yandex.ru>
License: MIT (Expat)

Homepage: https://github.com/tehnick/bosixnet

Deb packages:
  https://github.com/tehnick/bosixnet-debian
  https://launchpad.net/~tehnick/+archive/bosixnet

Description:
Project should be useful when you have to administer many computers
distributed through different networks and connected via NAT. In most of cases
you may just install miredo, gogoc or any other tunnel broker's software and
these computers will be available via IPv6 addresses. BOSixNet includes the
collection of tools for automatic updating the list of such hosts.

Project consist of two parts:
1) bosixnet-webui – FastCGI program which passively listens for incoming
   connections and generates list of hosts in your IPv6 network. This daemon
   prepares data which may be put directly into /etc/hosts.
2) bosixnet-daemon – shell script which periodically sends information about
   current IPv6 address to remote servers and updates local /etc/hosts file
   based on data received from these remote servers. It is expected that
   bosixnet-webui is launched on these remote servers, but it is not mandatory.

For building own IPv6 network you need to install miredo, gogoc or any other
tunnel broker software on all hosts where bosixnet-daemon will be launched.
Of course you do not need any of these programs if your Internet provider
gives you direct access to IPv6 network. Unfortunately this is too rare
situation now.

There are few possible solutions for remote server with bosixnet-webui:
1) Fixed IPv4 or IPv6 address. But if you have static IP you may use other
   solutions (like VPN) and this project is not very useful in such case.
2) Dynamic IPv4 address + fixed domain name. For example, you may use any DDNS
   provider.
3) Dynamic IPv6 address + fixed domain name. Some tunnel brokers give special
   domain names for their clients. For example, if you are registered on
   Freenet6 and use gogoc, you will have domain name like:
   <your-login>.broker.freenet6.net
4) etc.

bosixnet-webui is a tiny program with a very few dependencies. It may be easily
launched on embedded devices. And since this is a microservice then there are
no plans to make it more complicated in the future.

Important notes:
1) In almost all cases the speed of access via teredo is much better than via
   tunnel brokers. Also miredo is very easy in use.
2) If two computers are in the same LAN, direct connection via teredo is not
   possible between them. So for IPv6 connection at least one of them should
   use tunnel broker or native IPv6 address.

For information how to install and to use BOSixNet see file INSTALL.

Screenshots:
  https://tehnick.github.io/bosixnet/screenshots/00.png
  https://tehnick.github.io/bosixnet/screenshots/01.png

Some useful links:
  https://en.wikipedia.org/wiki/IPv6
  https://en.wikipedia.org/wiki/Miredo
  https://github.com/evi1c/gogoc