{% extends "_layout.html" %}
{% block title %}i2ptunnel{% endblock %}
{% block content %}Description of i2ptunnel and tunneling modes

default services
client modes
serrver modes

<h1>I2PTunnel</h1>
<h2 id="overview">Overview</h2>
<p>
I2PTunnel a tool for interfacing with and providing services on I2P.
 By directing an I2PTunnel to a destination, via a <a href="naming.html">hostname</a>,
 <a href="naming.html#base32">Base32</a> or a full 516-byte destination key, a localhost:port
 interface to that servie is provided. Providing a service is as simple as creating a server I2PTunnel 
 to the appropriate ip:port, a 516-byte destination key will be generated for the service and it
 will be avaliable throughout I2P.
 A web interface is avaliable on <a href="http://localhost:7657/i2ptunnel/">localhost:7657/i2ptunnel/</a>.
</p>

<br>
<h2 id="default-services">Default Services</h2>
<h3 id="default-server-tunnels">Server tunnels</h3>
<ul>
<li><b>I2P Webserver</b> - A tunnel pointed to a Jetty webserver run
 on <a href="http://localhost:7658">localhost:7658</a> for convenient and quick hosting on I2P.
<br>The document root is:
<br><b>Unix</b> - %APPDATA%\I2P\eepsite\docroot
<br><b>Windows</b> - C:\Users\**username**\AppData\Roaming\I2P\eepsite\docroot
</li>
</ul>
<h3 id="default-client-tunnels">Client tunnels</h3>
<ul>
<li><b>I2P HTTP Proxy</b> - <i>localhost:4444</i></a> - A HTTP proxy used for browsing I2P and the regular internet anonymously through I2P. 
Browsing internet through I2P uses a random proxy specified by the "Outproxies:" option.
</li>
<li><b>IRC Proxy</b> - <i>localhost:6668</i> - A IRC proxy to the default anonymous IRC-servers.</li>
<li><b>mtn.i2p2.i2p</b> - <i>localhost:8998</i> - The anonymous <a href="http://en.wikipedia.org/wiki/Monotone_%28software%29">monotone</a>
 sourcecode repository for I2P
</li>
<li><b>smtp.postman.i2p</b> - <i>localhost:7659</i> - A SMTP service provided by postman at
 <a href="http://hq.postman.i2p/?page_id=16">hq.postman.i2p</a>
 (<a href="http://hq.postman.i2p.to/?page_id=16">via inproxy</a>)
</li>
<li><b>pop3.postman.i2p</b> - <i>localhost:7660</i> - The accompanying POP sevice of postman at
 <a href="http://hq.postman.i2p/?page_id=16">hq.postman.i2p</a>
 (<a href="http://hq.postman.i2p.to/?page_id=16">via inproxy</a>)
</ul>

<br>
<h2 id="client-modes">Client Modes</h2>
<h3 id="client-modes-standard">Standard</h3>
Opens a local TCP port that connects to a service (like HTTP, FTP or SMTP) on a destination inside of I2P.
The tunnel is directed to a random host from the comma seperated (", ") list of destinations.

<br>
<h3 id="client-mode-http">HTTP</h3>
A HTTP-client tunnel. The tunnel connects to the destination specified by the URL
 in a HTTP request. Supports proxying onto internet if an outproxy is provided. Strips HTTP connections of the following headers:
<ul>
<li><b>Accept, Accept-Charset, Accept-Encoding, Accept-Language
 and Accept-Ranges</b> as they vary greatly between browsers and can be used as an identifier.
</li>
<li><b>Referer:</b></li>
<li><b>Via:</b></li>
<li><b>From:</b></li>
</ul>

<h3 id="client-mode-irc">IRC</h3>
Creates a connection to a random IRC server specified by the comma seprated (", ") 
list of destinations. Only a whitelisted subset of IRC commands are allowed due to anonymity concerns.
<br>Whitelist:
<ul>
<li>MODE</li>
<li>JOIN</li>
<li>NICK</li>
<li>QUIT</li>
<li>PART</li>
<li>WALLOPS</li>
<li>ERROR</li>
<li>KICK</li>
<li>H</li>
<li>TOPIC</li>
</ul>

<h3 id="client-mode-socks">SOCKS 4/4a/5</h3>
Enables using the I2P router as a SOCKS proxy.

<h3 id="client-mode-socks-irc">SOCKS IRC</h3>
Enables using the I2P router as a SOCKS proxy with the command whitelist specified by
 <a href="#client-mode-irc">IRC</a> client mode.

<h3 id="client-mode-connect">CONNECT</h3>
Creates a HTTP tunnel and uses the HTTP request method "CONNECT" 
to build a TCP tunnel that usually is used for SSL and HTTPS.

<h3 id="client-mode-streamr">Streamr</h3>
Creates a UDP-server attached to a Streamr client I2PTunnel. The streamr client tunnel will 
subscribe to a streamr server tunnel.
<br>
<img src="../static/images/I2PTunnel-streamr.png">


<br>
<h2 id="server-modes">Server Modes</h2>
<h3 id="server-modes">Standard</h3>
Creates a destination to a local ip:port with an open TCP port.

<h3 id="server-modes">HTTP</h3>
Creates a destination to a local HTTP server ip:port. Supports gzip for requests with 
Accept-encoding: x-i2p-gzip. Replies
<h3 id="server-modes">HTTP Bidirectional</h3>
A HTTP proxy with no outproxying capabilities.
<h3 id="server-modes">IRC</h3>
Creates a destination that filters the reqistration sequence of a client and passes 
the destination hash as a hostname to the IRC-server.
<h3 id="server-modes">Streamr</h3>
A UDP-client that connects to a media server is created. The UDP-Client is coupled with a Streamr server I2PTunnel.
{% endblock %}