PurpleI2P/i2pd
1
0
Fork 0
mirror of https://github.com/PurpleI2P/i2pd.git synced 2025-01-11 17:37:53 +00:00
Code Issues Releases Activity

* update docs

Browse Source
This commit is contained in:
hagen 2016-03-28 00:00:00 +00:00
parent e6dbeda18e
commit cc25b22f11
3 changed files with 91 additions and 84 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
docs/configuration.md
View File

@ -4,9 +4,12 @@ i2pd configuration
Command line options Command line options
-------------------- --------------------
Options specified on the command line take precedence over those in the config file.
If you are upgrading your very old router (< 2.3.0) see also [this](config_opts_after_2.3.0.md) page.
* --help - Show builtin help message (default value of option will be shown in braces)
* --conf= - Config file (default: ~/.i2pd/i2pd.conf or /var/lib/i2pd/i2pd.conf) * --conf= - Config file (default: ~/.i2pd/i2pd.conf or /var/lib/i2pd/i2pd.conf)
This parameter will be silently ignored if the specified config file does not exist. This parameter will be silently ignored if the specified config file does not exist.
Options specified on the command line take precedence over those in the config file.
* --tunconf= - Tunnels config file (default: ~/.i2pd/tunnels.conf or /var/lib/i2pd/tunnels.conf) * --tunconf= - Tunnels config file (default: ~/.i2pd/tunnels.conf or /var/lib/i2pd/tunnels.conf)
* --pidfile= - Where to write pidfile (dont write by default) * --pidfile= - Where to write pidfile (dont write by default)
* --log= - Logs destination: stdout, file (stdout if not set, file - otherwise, for compatibility) * --log= - Logs destination: stdout, file (stdout if not set, file - otherwise, for compatibility)
@ -24,6 +27,8 @@ Command line options
* --family= - Name of a family, router belongs to * --family= - Name of a family, router belongs to
* --svcctl= - Windows service management (--svcctl="install" or --svcctl="remove") * --svcctl= - Windows service management (--svcctl="install" or --svcctl="remove")
All options below still possible in cmdline, but better write it in config file:
* --http.address= - The address to listen on (HTTP server) * --http.address= - The address to listen on (HTTP server)
* --http.port= - The port to listen on (HTTP server) * --http.port= - The port to listen on (HTTP server)
@ -69,11 +74,13 @@ i2pd.conf:
[httpproxy] [httpproxy]
port = 4444 port = 4444
# ^^ this will be --httproxy.port= in cmdline # ^^ this will be --httproxy.port= in cmdline
# another one # another comment
[sam] [sam]
enabled = true enabled = true
tunnels.conf See also commented config with examples of all options in ``docs/i2pd.conf``.
tunnels.conf:
# outgoing tunnel sample, to remote service # outgoing tunnel sample, to remote service
# mandatory parameters: # mandatory parameters:
@ -107,6 +114,7 @@ tunnels.conf
host = 127.0.0.1 host = 127.0.0.1
port = 80 port = 80
keys = site-keys.dat keys = site-keys.dat
#
[IRC-SERVER] [IRC-SERVER]
type = server type = server
host = 127.0.0.1 host = 127.0.0.1

30
docs/family.md
View File

@ -6,27 +6,31 @@ There are two possibilities: create new family or joing to existing.
New family New family
----------- -----------
You must create family self-signed certificate and key. You must create family self-signed certificate and key.
The only key type supposted is prime256v1. The only key type supposted is prime256v1.
Use the following list of commands: Use the following list of commands:
openssl ecparam -name prime256v1 -genkey -out <your family name>.key
openssl req -new -key <your family name>.key -out <your family name>.csr
touch v3.ext
openssl x509 -req -days 3650 -in <your family name>.csr -signkey <your family name>.key -out <your family name>.crt -extfile v3.ext
specify <your family name>.family.i2p.net for CN. openssl ecparam -name prime256v1 -genkey -out <your family name>.key
openssl req -new -key <your family name>.key -out <your family name>.csr
touch v3.ext
openssl x509 -req -days 3650 -in <your family name>.csr -signkey <your family name>.key -out <your family name>.crt -extfile v3.ext
Once you are done with it place <your family name>.key and <your family name>.crt to <ip2d data>/family folder (for exmple ~/.i2pd/family). Specify <your family name>.family.i2p.net for CN (Common Name) when requested.
Once you are done with it place <your-family-name>.key and <your-family-name>.crt to <ip2d data>/family folder (for exmple ~/.i2pd/family).
You should provide these two files to other members joining your family. You should provide these two files to other members joining your family.
If you want to register you family and let I2P network recorgnize it, create pull request for you .crt file into contrib/certificate/family. If you want to register you family and let I2P network recorgnize it, create pull request for you .crt file into contrib/certificate/family.
It will appear in i2pd and I2P next releases packages. Don't place .key file, it must be shared betwwen you family members only. It will appear in i2pd and I2P next releases packages. Dont place .key file, it must be shared between you family members only.
Join existing family How to join existing family
-------------------- ---------------------------
Once you and that family agree to do it, they must give you .key and .crt file and you must place to <ip2d data>/family folder.
Once you and that family agree to do it, they must give you .key and .crt file and you must place in <i2pd datadir>/certificates/family/ folder.
Publish your family Publish your family
------------------ -------------------
Run i2pd with parameter 'family=<your family name>', make sure you have <your family name>.key and <your family name>.crt in your 'family' folder.
If everything is set properly, you router.info will contain two new fields: 'family' and 'family.sig'.
Run i2pd with parameter 'family=<your-family-name>', make sure you have <your-family-name>.key and <your-family-name>.crt in your 'family' folder.
If everything is set properly, you router.info will contain two new fields: 'family' and 'family.sig'.
Otherwise your router will complain on startup with log messages starting with "Family:" prefix and severity 'warn' or 'error'.

131
docs/i2pd.conf
View File

@ -6,109 +6,104 @@
## that begin with just "#" are disabled commands: you can enable them ## that begin with just "#" are disabled commands: you can enable them
## by removing the "#" symbol. ## by removing the "#" symbol.
## Tunnels config file ## Tunnels config file
## Default: ~/.i2pd/tunnels.conf or /var/lib/i2pd/tunnels.conf ## Default: ~/.i2pd/tunnels.conf or /var/lib/i2pd/tunnels.conf
#tunconf = /var/lib/i2pd/tunnels.conf # tunconf = /var/lib/i2pd/tunnels.conf
## Where to write pidfile (don't write by default) ## Where to write pidfile (don't write by default)
#pidfile = /var/run/i2pd.pid # pidfile = /var/run/i2pd.pid
## Logging configuration section ## Logging configuration section
## By default logs go to stdout with level info ## By default logs go to stdout with level 'info' and higher
## ##
## Logs destination (stdout, file, syslog) ## Logs destination (valid values: stdout, file, syslog)
## stdout - print log entries to stdout ## * stdout - print log entries to stdout
## file - log entries to a file ## * file - log entries to a file
## syslog - use syslog, see man 3 syslog ## * syslog - use syslog, see man 3 syslog
#log = file # log = file
## Path to logfile (default - autodetect) ## Path to logfile (default - autodetect)
#logfile = /var/log/i2pd.log # logfile = /var/log/i2pd.log
## Log messages above this level (debug, *info, warn, error) ## Log messages above this level (debug, *info, warn, error)
#loglevel = info # loglevel = info
## Path to storage of i2pd data (RI, keys, peer profiles, ...) ## Path to storage of i2pd data (RI, keys, peer profiles, ...)
## Default: ~/.i2pd or /var/lib/i2pd ## Default: ~/.i2pd or /var/lib/i2pd
#datadir = /var/lib/i2pd # datadir = /var/lib/i2pd
## Daemon mode. Router will go to background after start ## Daemon mode. Router will go to background after start
#daemon = true # daemon = true
## Run as a service. Router will use system folders like ‘/var/lib/i2pd’ ## Run as a service. Router will use system folders like ‘/var/lib/i2pd’
#service = true # service = true
## External IP address to listen for connections ## External IP address to listen for connections
## By default i2pd sets IP automatically ## By default i2pd sets IP automatically
#host = 1.2.3.4 # host = 1.2.3.4
## Port to listen for connections ## Port to listen for connections
## By default i2pd picks random port. You MUST pick a random number too, ## By default i2pd picks random port. You MUST pick a random number too,
## don't just uncomment this ## don't just uncomment this
#port = 4321 # port = 4321
##Enable communication through ipv6
## Enable communication through ipv6
ipv6 = true ipv6 = true
## Bandwidth configuration ## Bandwidth configuration
## L limit bandwidth to 32Kbs/sec, O - to 256Kbs/sec, P - unlimited ## L limit bandwidth to 32Kbs/sec, O - to 256Kbs/sec, P - unlimited
## Default is P for floodfill, L for regular node ## Default is P for floodfill, L for regular node
#bandwidth = L # bandwidth = L
## Router will not accept transit tunnels at startup ## Router will not accept transit tunnels at startup
#notransit = true # notransit = true
## Router will be floodfill ## Router will be floodfill
#floodfill = true # floodfill = true
## Section for Web Console
## By default it's available at 127.0.0.1:7070 even if it's not configured
[http] [http]
## The address to listen on ## Uncomment and set to 'false' to disable Web Console
address = 127.0.0.1 # enabled = true
## The port to listen on ## Address and port service will listen on
port = 7070 address = 127.0.0.1
port = 7070
## Section for HTTP proxy
## By default it's available at 127.0.0.1:4444 even if it's not configured
[httpproxy] [httpproxy]
## The address to listen on ## Uncomment and set to 'false' to disable HTTP Proxy
address = 127.0.0.1 # enabled = true
## The port to listen on ## Address and port service will listen on
port = 4444 # address = 127.0.0.1
# port = 4444
## Optional keys file for proxy local destination ## Optional keys file for proxy local destination
#keys = http-proxy-keys.dat # keys = http-proxy-keys.dat
## Uncomment if you want to disable HTTP proxy
#enabled = false
## Section for Socks proxy [socksproxy]
## By default it's available at 127.0.0.1:4447 even if it's not configured ## Uncomment and set to 'false' to disable SOCKS Proxy
#[socksproxy] # enabled = true
## The address to listen on ## Address and port service will listen on
#address = 127.0.0.1 # address = 127.0.0.1
## The port to listen on # port = 4447
#port = 4447
## Optional keys file for proxy local destination ## Optional keys file for proxy local destination
#keys = socks-proxy-keys.dat # keys = socks-proxy-keys.dat
## Uncomment if you want to disable Socks proxy
#enabled = false
## Socks outproxy. Example below is set to use Tor for all connections except i2p ## Socks outproxy. Example below is set to use Tor for all connections except i2p
## Address of outproxy ## Address and port of outproxy
#outproxy = 127.0.0.1 # outproxy = 127.0.0.1
## Outproxy remote port # outproxyport = 9050
#outproxyport = 9050
## Section for SAM bridge [sam]
#[sam] ## Uncomment and set to 'true' to enable SAM Bridge
## The address to listen on # enabled = false
#address = 127.0.0.1 ## Address and port service will listen on
## Port of SAM bridge # address = 127.0.0.1
#port = 7656 # port = 7656
## Section for BOB command channel [bob]
#[bob] ## Uncomment and set to 'true' to enable BOB command channel
## The address to listen on # enabled = false
#address = 127.0.0.1 ## Address and port service will listen on
## Port of BOB command channel. Usually 2827. BOB is off if not specified # address = 127.0.0.1
#port = 2827 # port = 2827
## Section for I2PControl protocol [i2pcontrol]
#[i2pcontrol] ## Uncomment and set to 'true' to enable I2PControl protocol
## The address to listen on # enabled = false
#address = 127.0.0.1 ## Address and port service will listen on
## Port of I2P control service # address = 127.0.0.1
#port = 7650 # port = 7650