|
|
|
|
pyseeder
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
Reseed data managment tools for I2P
|
|
|
|
|
|
|
|
|
|
* Generate reseed signing keypair
|
|
|
|
|
* Make reseed data files (su3)
|
|
|
|
|
* Download su3 files from official servers for mirroring
|
|
|
|
|
* Upload reseed data to different places (with plugins)
|
|
|
|
|
* Run HTTPS reseed server
|
|
|
|
|
|
|
|
|
|
Reseed transports are implemented so that users can bootstrap their I2P nodes
|
|
|
|
|
without needing to connect to "official" I2P reseeds. This makes I2P more
|
|
|
|
|
invisible for firewalls.
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
$ pip3 install https://github.com/PurpleI2P/pyseeder/zipball/master
|
|
|
|
|
|
|
|
|
|
[Detailed installation instructions](INSTALL.md)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Usage
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
$ pyseeder --help
|
|
|
|
|
$ pyseeder keygen --help
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Generating keypair
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$ pyseeder keygen --cert data/user_at_mail.i2p.crt --private-key data/priv_key.pem --signer-id user@mail.i2p
|
|
|
|
|
|
|
|
|
|
This will generate certificate (user\_at\_mail.i2p.crt) and private RSA key
|
|
|
|
|
(priv\_key.pem) in data folder. E-mail is used as certificate identifier.
|
|
|
|
|
|
|
|
|
|
Script will prompt for private key password.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Generating reseed data
|
|
|
|
|
----------------------
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$ YOUR_PASSWORD="Pa55w0rd"
|
|
|
|
|
$ echo $YOUR_PASSWORD | pyseeder reseed --netdb /path/to/netDb --private-key data/priv_key.pem --outfile output/i2pseeds.su3 --signer-id user@mail.i2p
|
|
|
|
|
|
|
|
|
|
This will generate file i2pseeds.su3 in output folder, using user@mail.i2p as
|
|
|
|
|
certificate identifier.
|
|
|
|
|
|
|
|
|
|
Note: you'll have to enter your private key password to stdin, the above
|
|
|
|
|
is one of the ways to do it (for cron and scripts).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Download su3 file from official servers
|
|
|
|
|
---------------------------------------
|
|
|
|
|
|
|
|
|
|
$ pyseeder transport.pull --urls https://reseed.i2p-projekt.de/ https://reseed.i2p.vzaws.com:8443/ --outfile output/i2pseeds.su3
|
|
|
|
|
|
|
|
|
|
Note: --urls parameter is optional, defaults are "official" I2P reseeds.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Upload su3 file with pluggable transports
|
|
|
|
|
-----------------------------------------
|
|
|
|
|
|
|
|
|
|
$ pyseeder transport.push --config transports.ini --file output/i2pseeds.su3
|
|
|
|
|
|
|
|
|
|
All parameters are optional. Copy file transports.ini.example to
|
|
|
|
|
transports.ini. Edit your settings in this new file.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Run HTTPS reseed server
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
$ pyseeder serve --port 8443 --host 127.0.0.1 --private-key data/priv_key.pem --cert data/user_at_mail.i2p.crt --file output/i2pseeds.su3
|
|
|
|
|
|
|
|
|
|
Note: this server is fine for testing, but for "production" environments please
|
|
|
|
|
use nginx webserver.
|
