bird-lg/README.mkd

117 lines
3.0 KiB
Markdown
Raw Permalink Normal View History

2012-03-28 15:18:01 +02:00
BIRD-LG
=======
Overview
--------
2013-08-20 09:58:40 +02:00
This is a looking glass for the Internet Routing Daemon "Bird".
2012-03-28 15:18:01 +02:00
2013-08-20 09:58:40 +02:00
Software is split in two parts:
- lgproxy.py:
2013-08-20 09:58:40 +02:00
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.
2012-03-28 15:18:01 +02:00
- lg.py:
2013-08-20 09:58:40 +02:00
This is the frontend, a web based UI that request informations to all lgproxy.py nodes.
2013-08-20 09:58:40 +02:00
The domain and the list of all bird nodes can be done.
2012-03-28 15:18:01 +02:00
2013-08-20 09:58:40 +02:00
```
2012-03-28 15:18:01 +02:00
***************
+--> * lgproxy.py *
2012-03-28 15:18:01 +02:00
| ***************
|
******** ******************* | ***************
* USER * ----> * webserver/lg.py *--+--> * lgproxy.py *
2012-03-28 15:18:01 +02:00
******** ******************* | ***************
|
| ***************
+--> * lgproxy.py *
2012-03-28 15:18:01 +02:00
***************
2013-08-20 09:58:40 +02:00
```
2012-03-28 15:18:01 +02:00
Installation
------------
The web service (lg.py) depends on:
2012-03-28 15:18:01 +02:00
- python-flask >= 0.8
- python-dnspython
2012-07-21 17:37:11 +02:00
- python-pydot
2017-10-30 13:33:39 +01:00
- graphviz
- whois
The proxy running on routers (lgproxy.py) depends on:
- python-flask >= 0.8
2017-10-30 13:33:39 +01:00
- 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.
2012-03-28 15:18:01 +02:00
License
-------
2012-03-28 15:18:01 +02:00
2013-08-20 09:58:40 +02:00
Source code is under GPL 3.0, powered by Flask, jQuery and Bootstrap.
2012-03-28 15:18:01 +02:00
2013-08-20 09:58:40 +02:00
Copyright © 2012 Mehdi Abaakouk <sileht@sileht.net>
2017-08-04 14:56:59 +02:00
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/
2017-08-04 15:02:14 +02:00
* http://lg.arn-fai.net
2018-05-25 21:17:03 +02:00
* https://lg.grenode.net/
2017-08-04 14:56:59 +02:00
* 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/
2017-08-04 14:56:59 +02:00
* 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/
2018-05-25 21:17:03 +02:00
* https://lg.franceix.net/
* https://lg.fullsave.net/
2018-06-26 10:58:14 +02:00
* http://lg.catnix.net/
2018-09-06 14:54:21 +02:00
* https://lg.worldstream.nl/
* https://lg.angolacables.co.ao/