mirror of https://github.com/sileht/bird-lg.git
117 lines
3.0 KiB
Markdown
117 lines
3.0 KiB
Markdown
BIRD-LG
|
|
=======
|
|
|
|
Overview
|
|
--------
|
|
|
|
This is a looking glass for the Internet Routing Daemon "Bird".
|
|
|
|
Software is split in two parts:
|
|
|
|
- lgproxy.py:
|
|
|
|
It must be installed and started on all bird nodes. It act as a proxy to make traceroute and bird query on the node.
|
|
Access restriction to this web service can be done in file "lgproxy.cfg". Two access restriction methods can be configured:
|
|
based on source IP address or based on a shared secret. Both methods can be used at the same time.
|
|
|
|
- lg.py:
|
|
|
|
This is the frontend, a web based UI that request informations to all lgproxy.py nodes.
|
|
The domain and the list of all bird nodes can be done.
|
|
|
|
|
|
```
|
|
|
|
|
|
***************
|
|
+--> * lgproxy.py *
|
|
| ***************
|
|
|
|
|
******** ******************* | ***************
|
|
* USER * ----> * webserver/lg.py *--+--> * lgproxy.py *
|
|
******** ******************* | ***************
|
|
|
|
|
| ***************
|
|
+--> * lgproxy.py *
|
|
***************
|
|
```
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
The web service (lg.py) depends on:
|
|
|
|
- python-flask >= 0.8
|
|
- python-dnspython
|
|
- python-pydot
|
|
- graphviz
|
|
- whois
|
|
|
|
The proxy running on routers (lgproxy.py) depends on:
|
|
|
|
- python-flask >= 0.8
|
|
- traceroute
|
|
- ping
|
|
|
|
Each service can be embedded in any webserver by following regular python-flask configuration.
|
|
It is also possible to run the services directly with python for developping / testing:
|
|
|
|
python2 lg.py
|
|
python2 lgproxy.py
|
|
|
|
Systemd unit files are provided in the `init/` subdirectory.
|
|
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
On your routers, copy `lgproxy.cfg.example` to `lgproxy.cfg` and edit the values.
|
|
|
|
On the web host, copy `lg.cfg.example` to `lg.cfg` and edit the values.
|
|
|
|
|
|
License
|
|
-------
|
|
|
|
Source code is under GPL 3.0, powered by Flask, jQuery and Bootstrap.
|
|
|
|
Copyright © 2012 Mehdi Abaakouk <sileht@sileht.net>
|
|
|
|
Happy users
|
|
-----------
|
|
|
|
* https://lg.ovh.net/
|
|
* http://lg.beta.as6453.net/
|
|
* https://lg.hamburg.freifunk.net/start
|
|
* http://lg.ring.nlnog.net/
|
|
* https://lg.tetaneutral.net/
|
|
* https://lg.gitoyen.net/
|
|
* http://lg.as5580.net/
|
|
* https://lg.ldn-fai.net/
|
|
* http://lg.arn-fai.net
|
|
* https://lg.grenode.net/
|
|
* http://lg.dataix.ru/
|
|
* https://lg.blix.com/
|
|
* https://lg.man-da.de/
|
|
* http://route-server.belwue.net/
|
|
* https://lg.exn.uk/
|
|
* https://meerblick.io/
|
|
* https://lg.as49697.net/
|
|
* http://lg.netnation.com/
|
|
* http://lg.edxnetwork.eu/
|
|
* https://lg.hivane.net/
|
|
* https://atw.hu/looking-glass
|
|
* http://lg.sibir-ix.ru/
|
|
* http://lg.interlan.ro/
|
|
* http://lg.as35266.net/
|
|
* https://lg.atw.co.hu/
|
|
* http://lg.as60362.net/
|
|
* http://lg.stuttgart-ix.de/
|
|
* http://www.bet3000.tv/
|
|
* https://lg.franceix.net/
|
|
* https://lg.fullsave.net/
|
|
* http://lg.catnix.net/
|
|
* https://lg.worldstream.nl/
|
|
* https://lg.angolacables.co.ao/
|