forked from I2P_Developers/i2p.i2p
zzz
7b3791627c
Remove dead links and commented-out text Put each sentence on separate line Clarify and simplify language
219 lines
13 KiB
HTML
219 lines
13 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<title>I2P Anonymous WebServer</title>
|
|
<link rel="shortcut icon" href="favicon.ico" />
|
|
<link rel="stylesheet" type="text/css" href="lib/eepsite.css" />
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
</head>
|
|
<body>
|
|
|
|
<div class="main">
|
|
|
|
<div class="langbar">
|
|
<a href="index.html"><img src="lib/us.png" title="English" alt="English"></a>
|
|
<a href="index_zh.html"><img src="lib/cn.png" title="中文" alt="中文"></a>
|
|
<a href="index_de.html"><img src="lib/de.png" title="Deutsch" alt="Deutsch"></a>
|
|
<a href="index_es.html"><img src="lib/es.png" title="Español" alt="Español"></a>
|
|
<a href="index_fr.html"><img src="lib/fr.png" title="Français" alt="Français"></a>
|
|
<a href="index_nl.html"><img src="lib/nl.png" title="Nederlands" alt="Nederlands"></a>
|
|
<a href="index_ru.html"><img src="lib/ru.png" title="Русский" alt="Русский"></a>
|
|
<a href="index_sv.html"><img src="lib/se.png" title="Svenska" alt="Svenska"></a>
|
|
</div>
|
|
|
|
<h1>I2P Anonymous Webserver</h1>
|
|
|
|
<h2>Guide to Anonymous Webserving on I2P</h2>
|
|
|
|
<p>
|
|
This is your own anonymous I2P webserver (traditionally referred to as an <i>eepsite</i>).
|
|
To serve your own content, simply edit the files in the webserver's root directory and the site will be public once you follow the instructions below.
|
|
</p>
|
|
|
|
<p>The webserver's root directory can be found in the following locations, depending on your operating system:
|
|
</p>
|
|
|
|
<ul>
|
|
<li> <b>Linux</b><br>
|
|
Standard install: <code>~/.i2p/eepsite/docroot/</code><br>
|
|
Package install, running as a service: <code>~/var/lib/i2p/i2p-config/eepsite/docroot/</code>
|
|
</li>
|
|
<li> <b>Windows</b><br>
|
|
<code>%APPDATA%\I2P\eepsite\docroot\</code>
|
|
</li>
|
|
<li> <b>Mac</b><br>
|
|
<code>/Users/(user)/Library/Application Support/i2p</code>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>In I2P, hidden services are addressed using a 'key', which is represented as a long Base64 string.
|
|
The 'key' is somewhat like an IP address, and is shown on the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service Configuration page</a>.
|
|
</p>
|
|
|
|
<p>The instructions below detail how to assign a name like "mysite.i2p" to your key and start up your website.
|
|
You may reach your site locally via <a href="http://127.0.0.1:7658/">http://127.0.0.1:7658/</a>.
|
|
</p>
|
|
|
|
<h2>How to set up and announce your hidden service website</h2>
|
|
|
|
<p>Your website is stopped by default.
|
|
After you start your I2P Webserver tunnel, it will be difficult for other people to find
|
|
It can only be accessed with the long Base64 key or with the shorter Base32 address (.b32.i2p), which is a hash of the Base64 key.
|
|
You could just tell people the long key or the Base32 address, but thankfully I2P has an address book and several easy ways to tell people about your website.
|
|
Here are detailed instructions.
|
|
</p>
|
|
|
|
<ul>
|
|
<li>Pick a name for your website (<i>something</i>.i2p), using lower-case.
|
|
You may wish to check first in your own router's <a href="http://127.0.0.1:7657/susidns/addressbook?book=router&filter=none">address book</a> to see if your name is already taken.
|
|
Enter the new name for your website on the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service Configuration page</a> where it says "Website name".
|
|
This will replace the default "mysite.i2p".
|
|
Also, if you would like your I2P Webserver tunnel to be automatically started when you start I2P, check the "Auto Start" box.
|
|
Your website will now start every time you start your router.
|
|
Be sure to click "Save".
|
|
</li>
|
|
<li>Click the start button for your website on the <a href="http://127.0.0.1:7657/i2ptunnel/">main Hidden Service Manager page</a>.
|
|
You should now see it listed under "Local Tunnels" on the left side of the <a href="http://127.0.0.1:7657/">I2P Router Console</a>.
|
|
Your website is now running.
|
|
</li>
|
|
<li>Highlight the entire "Local destination" key on the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service Configuration page</a>. and copy it for later pasting.
|
|
Make sure you copy the whole thing - it's over 500 characters.
|
|
</li>
|
|
<li>Enter the name and paste in the destination key into your
|
|
<a href="http://127.0.0.1:7657/susidns/addressbook?book=master">master address book</a>.
|
|
Click "Add" to add the destination to your address book.
|
|
</li>
|
|
<li>In your browser, enter in your website name (<i>something</i>.i2p) and you should be right back here.
|
|
Hopefully it worked.
|
|
</li>
|
|
<li>Before you tell the world about your new website, you should add some content.
|
|
Go to the following directory and replace the index.html redirect page with your own content:
|
|
<ul>
|
|
<li> <b>Linux</b><br>
|
|
<code>~/.i2p/eepsite/docroot/</code>
|
|
</li>
|
|
<li> <b>Windows</b><br>
|
|
<code>%APPDATA%\I2P\eepsite\docroot\</code>
|
|
</li>
|
|
<li> <b>Mac</b><br>
|
|
<code>/Users/(user)/Library/Application Support/i2p</code>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>Virtual folders work, so you may host files from a subdirectory without explicitly needing to provide a page with links to files.
|
|
You can change the appearance of the directory listing by supplying an edited jetty-dir.css file
|
|
for each of the directories you are serving, demonstrated <a href="lib/">here</a>.
|
|
The <a href="lib/resources">resources sub-directory</a> (containing filetype images for the directory listing)
|
|
reverts to the default style.
|
|
If you need a template for a basic site, feel free to borrow and adapt <a href="pagetemplate.html">this page</a> and <a href="lib/">content</a>!
|
|
</p>
|
|
|
|
<p>If you're returned to this page after editing the content, try clearing your browser's web cache:</p>
|
|
|
|
<ul>
|
|
<li>in <b>Firefox</b> via: Preferences ➜ Advanced ➜ Network ➜ Cached Web Content ➜ Clear Now</li>
|
|
<li>in <b>Chrome/Chromium</b> via: Settings ➜ Advanced Settings ➜ Privacy ➜ Clear browsing data...</li>
|
|
<li> in <b>Opera</b> via: Settings ➜ Privacy ➜ Clear browsing data...
|
|
</ul>
|
|
|
|
<h2>Register your own I2P Domain</h2>
|
|
|
|
<p>Now it's time to add your website to an I2P address book hosted by a site such as <a href="http://stats.i2p/ " target="_blank">stats.i2p</a> or <a href="http://no.i2p/" target="_blank">no.i2p</a>.
|
|
That is, you must enter your website name and key into a web interface on one or more of these sites.
|
|
Here is <a href="http://stats.i2p/i2p/addkey.html" target="_blank">the key entry form</a> at stats.i2p.
|
|
Your key is the entire "Local destination" key on the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service Configuration page</a>.
|
|
Be sure you copy the whole thing.
|
|
Don't forget to click "add a key".
|
|
Check to see if it reports the key was added.
|
|
Since many routers periodically get address book updates from these sites, within several hours others will be able to find your website by simply typing <i>something</i>.i2p into their browser.</p>
|
|
<h2>Adding Addressbook Subscriptions</h2>
|
|
|
|
<p>Speaking of address book updates, this would be a good time to add some more addressbooks to your own subscription list.
|
|
Go to your <a href="http://127.0.0.1:7657/susidns/subscriptions">Subscriptions Configuration page</a> and add one or more for an automatically updated list of new hosts:
|
|
</p>
|
|
|
|
<ul>
|
|
<li><code>http://stats.i2p/cgi-bin/newhosts.txt</code> (<a href="http://stats.i2p/cgi-bin/newhosts.txt" target="_blank">stats.i2p</a>)
|
|
</li>
|
|
<li><code>http://no.i2p/export/alive-hosts.txt</code> (<a href="http://no.i2p/export/alive-hosts.txt" target="_blank">no.i2p</a>)
|
|
</li>
|
|
</ul>
|
|
|
|
<p>If you are in a hurry and can't wait a few hours, you can tell people to use a "jump" address helper redirection service.
|
|
This will work within a few minutes of your entering the key to an address book on the same site.
|
|
Test it yourself first by entering <code>http://stats.i2p/cgi-bin/jump.cgi?a=<i>something</i>.i2p</code> into your browser.
|
|
Once it's working, you can tell others to use it.
|
|
</p>
|
|
|
|
<p>Some people check website lists such as <a href="http://identiguy.i2p/" target="_blank">Identiguy's eepsite status list</a> or <a href="http://no.i2p/browse/" target="_blank">no.i2p's active host list</a> for new eepsites, so your site may start getting some traffic.
|
|
There are plenty of other ways to tell people. Here are a few ideas:
|
|
</p>
|
|
|
|
<ul>
|
|
<li>Post a message on the <a href="http://i2pforum.i2p/" target="_blank">I2P forum</a> telling everyone about your new I2P website!
|
|
</li>
|
|
<li>Tell people about it on the #i2p or #i2p-chat channels on IRC.
|
|
</li>
|
|
<li>Put it on the <a href="http://i2pwiki.i2p/index.php?title=Eepsite/Services" target="_blank">I2PWiki Eepsite Index</a>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>Note that some sites recommend pasting in that really long destination key.
|
|
You can if you want, but if you have successfully posted your key at an add-key service, tested it using a jump service, and waited 24 hours for the address book update to propagate to others, that shouldn't be necessary.</p>
|
|
|
|
<h2>Using an alternative webserver to host your site</h2>
|
|
|
|
<p>This site (and the I2P router console) is running on the <a href="https://en.wikipedia.org/wiki/Jetty_(web_server)" target="_blank">Jetty webserver</a>, but you may wish to use a different webserver to host your content.
|
|
To maintain anonymity, be sure that your webserver is configured to only allow connections from localhost (127.0.0.1), and check the documentation to ensure your webserver isn't advertising details that may compromise your anonymity.
|
|
</p>
|
|
|
|
<p>To configure your webserver for use on I2P, you may either use the existing webserver tunnel and <a href="http://127.0.0.1:7657/configclients">disable the default webserver</a> from running, or create a new HTTP Server tunnel in the <a href="http://127.0.0.1:7657/i2ptunnelmgr">Hidden Services Manager</a>.
|
|
Ensure that the listening port configured for the webserver (7658 by default) is also configured in the Hidden Services webserver settings.
|
|
For example, if your webserver is listening by default on address 127.0.0.1 port 80, you'd need to also ensure that the Target port in the Hidden Service Manager settings page for the service is also configured to port 80.
|
|
</p>
|
|
|
|
<p>Beware that a poorly configured webserver or web appplication can leak potentially compromising information such as
|
|
your real IP address or server details that may reduce your anonymity or assist a hacker.
|
|
We recommend using the default server unless you feel comfortable doing server administration.
|
|
The following may help:
|
|
</p>
|
|
|
|
<ul>
|
|
<li><a href="https://geekflare.com/apache-web-server-hardening-security/" target="_blank">Apache Web Server Security Guide</a>
|
|
</li>
|
|
<li><a href="https://geekflare.com/nginx-webserver-security-hardening-guide/" target="_blank">Nginx Web Server Security Guide</a>
|
|
</li>
|
|
<li><a href="https://www.wordfence.com/learn/how-to-harden-wordpress-sites/" target="_blank">How to Harden Your WordPress Site</a></li>
|
|
</ul>
|
|
|
|
<h2>Further Assistance</h2>
|
|
|
|
<p>If you have any questions, the following places are available for support:
|
|
</p>
|
|
|
|
<ul>
|
|
<li>Our IRC support channel:
|
|
<ul>
|
|
<li><a href="irc://irc.freenode.net/i2p">#i2p on Freenode</a>
|
|
</li>
|
|
<li>Anonymously via your resident <a href="irc://127.0.0.1:6668/i2p-help">I2P IRC tunnel</a>.</li>
|
|
</ul>
|
|
<li>The project forum <a href="http://i2pforum.i2p/" target="_blank">i2pforum.i2p</a>.
|
|
</li>
|
|
<li><a href="http://i2pwiki.i2p/index.php?title=EepsiteHosting" target="_blank">I2PWiki Eepsite Hosting guide</a>
|
|
</li>
|
|
</ul>
|
|
|
|
<div class="notify">
|
|
This page, the project website and the router console need translations!
|
|
Please help the project grow by <a href="http://i2p-projekt.i2p/getinvolved.html" target="_blank"> getting involved</a> or <a href="http://i2p-projekt.i2p/en/get-involved/guides/new-translators" target="_blank">translating</a>.
|
|
</div>
|
|
|
|
<hr>
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|