2013-09-01 15:09:28 +00:00
|
|
|
i2pd
|
|
|
|
====
|
|
|
|
|
2014-11-04 00:49:40 +00:00
|
|
|
I2P router written in C++
|
2013-09-01 17:49:06 +00:00
|
|
|
|
2015-01-12 15:54:09 +00:00
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
|
|
|
This project is licensed under the BSD 3-clause license, which can be found in the file
|
|
|
|
LICENSE in the root of the project source code.
|
|
|
|
|
2014-11-04 00:49:40 +00:00
|
|
|
Requirements for Linux/FreeBSD/OSX
|
|
|
|
----------------------------------
|
2014-01-09 19:59:35 +00:00
|
|
|
|
2014-11-04 00:49:40 +00:00
|
|
|
GCC 4.6 or newer, Boost 1.46 or newer, crypto++. Clang can be used instead of
|
|
|
|
GCC.
|
2014-01-09 19:59:35 +00:00
|
|
|
|
2014-11-04 00:49:40 +00:00
|
|
|
Requirements for Windows
|
|
|
|
------------------------
|
|
|
|
|
2014-11-08 13:29:15 +00:00
|
|
|
VS2013 (known to work with 12.0.21005.1 or newer), Boost 1.46 or newer,
|
|
|
|
crypto++ 5.62. See Win32/README-Build.txt for instructions on how to build i2pd
|
|
|
|
and its dependencies.
|
2014-01-31 00:39:16 +00:00
|
|
|
|
2014-07-26 05:04:19 +00:00
|
|
|
Build Statuses
|
|
|
|
---------------
|
|
|
|
|
|
|
|
- Linux x64 - [![Build Status](https://jenkins.nordcloud.no/buildStatus/icon?job=i2pd-linux)](https://jenkins.nordcloud.no/job/i2pd-linux/)
|
2014-11-04 00:49:40 +00:00
|
|
|
- Linux ARM - To be added
|
2014-12-29 16:12:05 +00:00
|
|
|
- Mac OS X - Got it working, but not well tested. (Only works with clang, not GCC.)
|
2014-11-04 00:49:40 +00:00
|
|
|
- Microsoft VC13 - To be added
|
2014-04-03 16:18:56 +00:00
|
|
|
|
2014-01-31 00:39:16 +00:00
|
|
|
|
|
|
|
Testing
|
|
|
|
-------
|
|
|
|
|
|
|
|
First, build it.
|
|
|
|
|
2015-01-06 20:52:13 +00:00
|
|
|
On Ubuntu/Debian based
|
|
|
|
* sudo apt-get install libboost-dev libboost-filesystem-dev libboost-program-options-dev libboost-regex-dev libcrypto++-dev libboost-date-time-dev
|
2014-01-31 00:42:27 +00:00
|
|
|
* $ cd i2pd
|
|
|
|
* $ make
|
2014-01-31 00:39:16 +00:00
|
|
|
|
|
|
|
Next, find out your public ip. (find it for example at http://www.whatismyip.com/)
|
|
|
|
|
|
|
|
Then, run it with:
|
|
|
|
|
|
|
|
$ ./i2p --host=YOUR_PUBLIC_IP
|
|
|
|
|
2014-01-31 06:35:21 +00:00
|
|
|
The client should now reseed by itself.
|
2014-01-31 00:39:16 +00:00
|
|
|
|
|
|
|
To visit an I2P page, you need to find the b32 address of your destination.
|
2014-10-21 11:44:48 +00:00
|
|
|
After that, go to the webconsole and add it behind the url. (Remove http:// from the address)
|
2014-01-31 00:39:16 +00:00
|
|
|
|
|
|
|
This should resulting in for example:
|
2014-10-21 11:44:48 +00:00
|
|
|
http://localhost:7070/4oes3rlgrpbkmzv4lqcfili23h3cvpwslqcfjlk6vvguxyggspwa.b32.i2p
|
2014-01-31 00:39:16 +00:00
|
|
|
|
2014-02-04 23:43:50 +00:00
|
|
|
|
2014-12-11 04:59:22 +00:00
|
|
|
Cmdline options
|
|
|
|
---------------
|
2014-02-04 23:43:50 +00:00
|
|
|
|
|
|
|
* --host= - The external IP
|
|
|
|
* --port= - The port to listen on
|
|
|
|
* --httpport= - The http port to listen on
|
|
|
|
* --log= - Enable or disable logging to file. 1 for yes, 0 for no.
|
2014-09-08 20:43:20 +00:00
|
|
|
* --daemon= - Enable or disable daemon mode. 1 for yes, 0 for no.
|
2014-10-17 13:55:41 +00:00
|
|
|
* --service= - 1 if uses system folders (/var/run/i2pd.pid, /var/log/i2pd.log, /var/lib/i2pd).
|
2014-09-08 20:43:20 +00:00
|
|
|
* --unreachable= - 1 if router is declared as unreachable and works through introducers.
|
2014-11-04 00:49:40 +00:00
|
|
|
* --v6= - 1 if supports communication through ipv6, off by default
|
2014-03-17 22:31:29 +00:00
|
|
|
* --httpproxyport= - The port to listen on (HTTP Proxy)
|
2014-08-14 14:20:22 +00:00
|
|
|
* --socksproxyport= - The port to listen on (SOCKS Proxy)
|
2014-11-04 00:49:40 +00:00
|
|
|
* --ircport= - The local port of IRC tunnel to listen on. 6668 by default
|
|
|
|
* --ircdest= - I2P destination address of IRC server. For example irc.postman.i2p
|
|
|
|
* --irckeys= - optional keys file for local destination
|
2014-12-11 18:05:21 +00:00
|
|
|
* --eepkeys= - File name containing destination keys, for example privKeys.dat.
|
|
|
|
The file will be created if it does not already exist (issue #110).
|
2014-11-04 00:49:40 +00:00
|
|
|
* --eephost= - Address incoming trafic forward to. 127.0.0.1 by default
|
|
|
|
* --eepport= - Port incoming trafic forward to. 80 by default
|
|
|
|
* --samport= - Port of SAM bridge. Usually 7656. SAM is off if not specified
|
2014-12-07 22:29:09 +00:00
|
|
|
* --bobport= - Port of BOB command channel. Usually 2827. BOB is off if not specified
|
2015-01-08 18:28:51 +00:00
|
|
|
* --i2pcontrolport= - Port of I2P control service. Usually 7650. I2PControl is off if not specified
|
2014-12-11 04:59:22 +00:00
|
|
|
* --conf= - Config file (default: ~/.i2pd/i2p.conf or /var/lib/i2pd/i2p.conf)
|
2014-12-11 18:05:21 +00:00
|
|
|
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.
|
2014-12-11 04:59:22 +00:00
|
|
|
|
|
|
|
Config file
|
|
|
|
-----------
|
2014-02-04 23:43:50 +00:00
|
|
|
|
2014-12-11 04:59:22 +00:00
|
|
|
INI-like, syntax is the following : <key> = <value>.
|
2014-12-11 18:05:21 +00:00
|
|
|
All command-line parameters are allowed as keys, for example:
|
|
|
|
|
|
|
|
log = 1
|
|
|
|
v6 = 0
|
|
|
|
ircdest = irc.postman.i2p
|