I2PTunnel

Übersicht

I2PTunnel is a tool for interfacing with and providing services on I2P.
Destination of an I2PTunnel can be defined using a hostname,
Base32, or a full 516-byte destination key.
An established I2PTunnel will be available on your client machine as localhost:port.
If you wish to provide a service on I2P network, you simply create I2PTunnel to the
appropriate ip_address:port. A corresponding 516-byte destination key will be generated
for the service and it will become avaliable throughout I2P.
A web interface for I2PTunnel management is avaliable on
localhost:7657/i2ptunnel/.

Standarddienste

Server tunnels

I2P Webserver - A tunnel pointed to a Jetty webserver run
on localhost:7658 for convenient and quick hosting on I2P.
The document root is:
Unix - %APPDATA%\I2P\eepsite\docroot
Windows - C:\Users\**username**\AppData\Roaming\I2P\eepsite\docroot

Client tunnels

I2P HTTP Proxy - localhost:4444 - 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.

Configuration

Client Modes

Standard

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.

HTTP

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:

Accept, Accept-Charset, Accept-Language
and Accept-Ranges as they vary greatly between browsers and can be used as an identifier.

IRC Client

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.
The following whitelist is for commands inbound from the IRC server to the IRC client.
Weiße Liste:

AUTHENTICATE

CAP

ERROR

H

JOIN

KICK

MODE

NICK

PART

PING

PROTOCTL

QUIT

TOPIC

WALLOPS

There is also a whitelist is for commands outbound from the IRC client to the IRC server.
It is quite large due to the number of IRC administrative commands.
See the IRCFilter.java source for details.
The outbound filter also modifies the following commands to strip identifying information:

NOTICE

PART

PING

PRIVMSG

QUIT

USER

SOCKS 4/4a/5

Enables using the I2P router as a SOCKS proxy.

SOCKS IRC

Enables using the I2P router as a SOCKS proxy with the command whitelist specified by
IRC client mode.

CONNECT

Creates a HTTP tunnel and uses the HTTP request method "CONNECT"
to build a TCP tunnel that usually is used for SSL and HTTPS.

Streamr

Creates a UDP-server attached to a Streamr client I2PTunnel. The streamr client tunnel will
subscribe to a streamr server tunnel.

Servermodi

Standard

Creates a destination to a local ip:port with an open TCP port.

HTTP

Creates a destination to a local HTTP server ip:port. Supports gzip for requests with
Accept-encoding: x-i2p-gzip, replies with Content-encoding: x-i2p-gzip in such a request.

HTTP Bidirectional

Functions as both a I2PTunnel HTTP Server, and a I2PTunnel HTTP client with no outproxying
capabilities. An example application would be a web application that does client-type
requests, or loopback-testing an eepsite as a diagnostic tool.

IRC Server

Creates a destination that filters the reqistration sequence of a client and passes
the clients destination key as a hostname to the IRC-server.

Streamr

A UDP-client that connects to a media server is created. The UDP-Client is coupled with a Streamr server I2PTunnel.