mirror of https://github.com/PurpleI2P/i2pd.git
Jeff Becker
8 years ago
8 changed files with 247 additions and 7 deletions
@ -0,0 +1,85 @@
@@ -0,0 +1,85 @@
|
||||
Building on iOS |
||||
=================== |
||||
|
||||
How to build i2pd for iOS 9 and iOS Simulator 386/x64 |
||||
|
||||
Prerequisites |
||||
-------------- |
||||
|
||||
XCode7+, cmake 3.2+ |
||||
|
||||
Dependencies |
||||
-------------- |
||||
- precompiled openssl |
||||
- precompiled boost with modules `filesystem`, `program_options`, `date_time` and `system` |
||||
- ios-cmake toolchain from https://github.com/vovasty/ios-cmake.git |
||||
|
||||
Building |
||||
------------------------ |
||||
Assume you have folder structure |
||||
|
||||
``` |
||||
lib |
||||
libboost_date_time.a |
||||
libboost_filesystem.a |
||||
libboost_program_options.a |
||||
libboost_system.a |
||||
libboost.a |
||||
libcrypto.a |
||||
libssl.a |
||||
include |
||||
boost |
||||
openssl |
||||
ios-cmake |
||||
i2pd |
||||
``` |
||||
|
||||
|
||||
```bash |
||||
mkdir -p build/simulator/lib build/ios/lib include/i2pd |
||||
|
||||
pushd build/simulator && \ |
||||
cmake -DIOS_PLATFORM=SIMULATOR \ |
||||
-DPATCH=/usr/bin/patch \ |
||||
-DCMAKE_BUILD_TYPE=Release \ |
||||
-DCMAKE_TOOLCHAIN_FILE=../../ios-cmake/toolchain/iOS.cmake \ |
||||
-DWITH_STATIC=yes \ |
||||
-DWITH_BINARY=no \ |
||||
-DBoost_INCLUDE_DIR=../../include \ |
||||
-DOPENSSL_INCLUDE_DIR=../../include \ |
||||
-DBoost_LIBRARY_DIR=../../lib \ |
||||
-DOPENSSL_SSL_LIBRARY=../../lib/libssl.a \ |
||||
-DOPENSSL_CRYPTO_LIBRARY=../../lib/libcrypto.a \ |
||||
../../i2pd/build && \ |
||||
make -j16 VERBOSE=1 && \ |
||||
popd |
||||
|
||||
pushd build/ios |
||||
cmake -DIOS_PLATFORM=OS \ |
||||
-DPATCH=/usr/bin/patch \ |
||||
-DCMAKE_BUILD_TYPE=Release \ |
||||
-DCMAKE_TOOLCHAIN_FILE=../../ios-cmake/toolchain/iOS.cmake \ |
||||
-DWITH_STATIC=yes \ |
||||
-DWITH_BINARY=no \ |
||||
-DBoost_INCLUDE_DIR=../../include \ |
||||
-DOPENSSL_INCLUDE_DIR=../../include \ |
||||
-DBoost_LIBRARY_DIR=../../lib \ |
||||
-DOPENSSL_SSL_LIBRARY=../../lib/libssl.a \ |
||||
-DOPENSSL_CRYPTO_LIBRARY=../../lib/libcrypto.a \ |
||||
../../i2pd/build && \ |
||||
make -j16 VERBOSE=1 && \ |
||||
popd |
||||
|
||||
libtool -static -o lib/libi2pdclient.a build/*/libi2pdclient.a |
||||
libtool -static -o lib/libi2pd.a build/*/libi2pd.a |
||||
|
||||
cp i2pd/*.h include/i2pd |
||||
``` |
||||
|
||||
Include into project |
||||
--------------------------- |
||||
1. add all libraries in `lib` folder to `Project linked frameworks`. |
||||
2. add `libc++` and `libz` libraries from system libraries to `Project linked frameworks`. |
||||
3. add path to i2p headers to your `Headers search paths` |
||||
|
||||
Alternatively you may use swift wrapper https://github.com/vovasty/SwiftyI2P.git |
@ -0,0 +1,130 @@
@@ -0,0 +1,130 @@
|
||||
Usage and tutorials |
||||
=================== |
||||
|
||||
|
||||
i2pd can be used for: |
||||
|
||||
* [anonymous websites](#browsing-and-hosting-websites) |
||||
* [anonymous chats](#using-and-hosting-chat-servers) |
||||
* [anonymous file sharing](#file-sharing) |
||||
|
||||
and many more. |
||||
|
||||
## Browsing and hosting websites |
||||
|
||||
### Browse anonymous websites |
||||
|
||||
To browse anonymous websites inside Invisible Internet, configure your web browser to use HTTP proxy 127.0.0.1:4444 (available by default in i2pd). |
||||
|
||||
In Firefox: Preferences -> Advanced -> Network tab -> Connection Settings -> choose Manual proxy configuration, Enter HTTP proxy 127.0.0.1, Port 4444 |
||||
|
||||
In Chromium: run chromium executable with key |
||||
|
||||
chromium --proxy-server="http://127.0.0.1:4444" |
||||
|
||||
Note that if you wish to stay anonymous too you'll need to tune your browser for better privacy. Do your own research, [can start here](http://www.howtogeek.com/102032/how-to-optimize-mozilla-firefox-for-maximum-privacy/). |
||||
|
||||
Big list of Invisible Internet websites can be found at [identiguy.i2p](http://identiguy.i2p). |
||||
|
||||
### Host anonymous website |
||||
|
||||
|
||||
If you wish to run your own website in Invisible Internet, follow those steps: |
||||
|
||||
1) Run your webserver and find out which host:port it uses (for example, 127.0.0.1:8080). |
||||
|
||||
2) Configure i2pd to create HTTP server tunnel. Put in your ~/.i2pd/tunnels.conf file: |
||||
|
||||
[anon-website] |
||||
type = http |
||||
host = 127.0.0.1 |
||||
port = 8080 |
||||
keys = anon-website.dat |
||||
|
||||
3) Restart i2pd. |
||||
|
||||
4) Find b32 destination of your website. |
||||
|
||||
Go to webconsole -> [I2P tunnels page](http://127.0.0.1:7070/?page=i2p_tunnels). Look for Sever tunnels and you will see address like \<long random string\>.b32.i2p next to anon-website. |
||||
|
||||
Website is now available in Invisible Internet by visiting this address. |
||||
|
||||
5) (Optional) Register short and rememberable .i2p domain on [inr.i2p](http://inr.i2p). |
||||
|
||||
|
||||
## Using and hosting chat servers |
||||
|
||||
### Running anonymous IRC server |
||||
|
||||
1) Run your IRC server software and find out which host:port it uses (for example, 127.0.0.1:5555). |
||||
|
||||
For small private IRC servers you can use [miniircd](https://github.com/jrosdahl/miniircd), for large public networks [UnreadIRCd](https://www.unrealircd.org/). |
||||
|
||||
2) Configure i2pd to create IRC server tunnel. |
||||
|
||||
Simplest case, if your server does not support WebIRC, add this to ~/.i2pd/tunnels.conf: |
||||
|
||||
[anon-chatserver] |
||||
type = irc |
||||
host = 127.0.0.1 |
||||
port = 5555 |
||||
keys = chatserver-key.dat |
||||
|
||||
And that is it. |
||||
|
||||
Alternatively, if your IRC server supports WebIRC, for example, UnreadIRCd, put this into UnrealIRCd config: |
||||
|
||||
webirc { |
||||
mask 127.0.0.1; |
||||
password your_password; |
||||
}; |
||||
|
||||
Also change line: |
||||
|
||||
modes-on-connect "+ixw"; |
||||
|
||||
to |
||||
|
||||
modes-on-connect "+iw"; |
||||
|
||||
And this in ~/.i2pd/tunnels.conf: |
||||
|
||||
[anon-chatserver] |
||||
type = irc |
||||
host = 127.0.0.1 |
||||
port = 5555 |
||||
keys = chatserver-key.dat |
||||
webircpassword = your_password |
||||
|
||||
3) Restart i2pd. |
||||
|
||||
4) Find b32 destination of your anonymous IRC server. |
||||
|
||||
Go to webconsole -> [I2P tunnels page](http://127.0.0.1:7070/?page=i2p_tunnels). Look for Sever tunnels and you will see address like \<long random string\>.b32.i2p next to anon-chatserver. |
||||
|
||||
Clients will use this address to connect to your server anonymously. |
||||
|
||||
### Connect to anonymous IRC server |
||||
|
||||
To connect to IRC server at *walker.i2p*, add this to ~/.i2pd/tunnels.conf: |
||||
|
||||
[IRC2] |
||||
type = client |
||||
address = 127.0.0.1 |
||||
port = 6669 |
||||
destination = walker.i2p |
||||
#keys = walker-keys.dat |
||||
|
||||
Restart i2pd, then connect to irc://127.0.0.1:6669 with your IRC client. |
||||
|
||||
## File sharing |
||||
|
||||
You can share and download torrents with [Transmission-I2P](https://github.com/l-n-s/transmission-i2p). |
||||
|
||||
Alternative torrent-clients are [Robert](http://en.wikipedia.org/wiki/Robert_%28P2P_Software%29) and [Vuze](https://en.wikipedia.org/wiki/Vuze). |
||||
|
||||
Robert uses BOB protocol, i2pd must be run with parameter --bob.enabled=true. |
||||
|
||||
Vuze uses I2CP protocol, i2pd must be run with parameter --i2cp.enabled=true. |
||||
|
||||
Also, visit [postman tracker](http://tracker2.postman.i2p). |
Loading…
Reference in new issue