Files
i2p.i2p/installer/resources/eepsite/docroot/help/index.html

124 lines
8.7 KiB
HTML
Raw Normal View History

<html>
<head>
2015-01-06 14:10:25 +00:00
<title>I2P Hidden Service Website</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="fairylights">
<div class="main">
2015-01-06 14:10:25 +00:00
<h1>I2P Hidden Service Website</h1>
<div class="langbar">
2014-06-30 13:23:06 +00:00
<!-- Some of these languages listed here are yet to be translated -->
<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>
2014-06-30 13:23:06 +00:00
<a href="index_fr.html"><img src="lib/fr.png" title="Français" alt="Français"></a>
2010-11-19 17:58:30 +00:00
<a href="index_na.html"><img src="lib/ir.png" title="فارسی" alt="فارسی"></a>
<a href="index_na.html"><img src="lib/jp.png" title="日本語" alt="日本語"></a>
2014-06-30 13:23:06 +00:00
<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>
<h2>Quick Guide to Anonymous Webserving on I2P</h2>
2015-01-06 14:10:25 +00:00
<p>This is your own anonymous I2P webserver ("eepsite") - simply edit the files under <code>~/.i2p/eepsite/docroot/</code> (Linux) or <code>%APPDATA%\I2P\eepsite\docroot\</code> (Windows)
and they'll be reachable by others once you follow the instructions below.
2015-01-06 14:10:25 +00:00
In I2P, hidden services are addressed using a 'key', which is represented as a really long Base64 string.
(The 'key' is somewhat analogous to an IP address, and
2015-01-06 14:10:25 +00:00
is shown on the hidden service
<a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">configuration page</a>).
2015-01-06 14:10:25 +00:00
The instructions below detail how to assign a name like "mysite.i2p" to your key and start up your website.</p>
<p>You can reach your site locally via
<a href="http://127.0.0.1:7658/">http://127.0.0.1:7658/</a>.
</p>
2015-01-06 14:10:25 +00:00
<h2>How to set up and announce your hidden service website</h2>
Your website is stopped by default.
After you start it, it will be difficult for other people to find because it
doesn't have a name and they don't have your really long Base64 key.
You could just tell people that really long key, but thankfully I2P has an address book
2015-01-06 14:10:25 +00:00
and several easy ways to tell people about your website. Here's detailed instructions.
<ul>
2015-01-06 14:10:25 +00:00
<li>Pick a name for your website (<i>something</i>.i2p). Use all lower-case.
You may wish to check first in your own router's address book
<a href="http://127.0.0.1:7657/susidns/addressbook.jsp?book=router&amp;filter=none">here</a>,
or the file <code>i2p/hosts.txt</code> to see if your name is already taken.
2015-01-06 14:10:25 +00:00
Enter the new name for your website on the
<a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">hidden service configuration page</a>
where it says "Website name". This will replace the default "mysite.i2p".
2015-01-06 14:10:25 +00:00
Also, check the "Auto Start" box. Your website will now start every time you start your router.
2011-05-24 23:16:15 +00:00
Be sure to click "Save".</li>
2015-01-06 14:10:25 +00:00
<li>Click the start button for your website on the
<a href="http://127.0.0.1:7657/i2ptunnel/index.jsp">main i2ptunnel configuration page</a>.
2015-01-06 14:10:25 +00:00
You should now see it listed under "Hidden Services and Clients" on the left side of the
<a href="http://127.0.0.1:7657/index.jsp">I2P Router Console</a>.
2015-01-06 14:10:25 +00:00
Your website is now running.</li>
<li>Highlight the entire "Local destination" key on the
2015-01-06 14:10:25 +00:00
<a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">hidden service configuration page</a>.
and copy it for
later pasting. Make sure you get 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.jsp?book=master">master address book</a>.
2011-05-24 23:16:15 +00:00
Click "Add" to add the destination to your address book.</li>
2015-01-06 14:10:25 +00:00
<li>In your browser, enter in your website name (<i>something</i>.i2p) and you should
2011-05-24 23:16:15 +00:00
be right back here. Hopefully it worked.</li>
2015-01-06 14:10:25 +00:00
<li>Before you tell the world about your new website, you should add some content.
2011-05-24 23:16:15 +00:00
Go to <code>~/.i2p/eepsite/docroot/</code> (Linux) or <code>%APPDATA%\I2P\eepsite\docroot\</code> (Windows) and replace the index.html redirect page with your own content. Virtual folders work, so you can host files from a sub directory without explicitly needing to provide a page with links to files. 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>!</li>
</ul>
<h2>Register your own .I2P Domain</h2><ul>
2015-01-06 14:10:25 +00:00
<li>Now it's time to add your website to an I2P address book hosted by a site
2013-10-29 00:05:06 +00:00
such as <a href="http://stats.i2p/">stats.i2p</a> or <a href="http://no.i2p/">no.i2p</a>.
That is, you must enter
2015-01-06 14:10:25 +00:00
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">the key entry form at stats.i2p</a>.
Again, your key is the entire "Local destination" key on the
2015-01-06 14:10:25 +00:00
<a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">hidden service configuration page</a>.
Be sure you get the whole thing.
Don't forget to click "add a key".
Check to see if it reports the key was added.
2011-05-24 23:16:15 +00:00
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.</li>
</ul><h2>Adding Addressbook Subscriptions</h2><ul>
<li>Speaking of address book updates, this would be a good time to add some more addressbooks
to your own <a href="http://127.0.0.1:7657/susidns/subscriptions.jsp">subscription list</a>. Go to your subscriptions configuration page and add a couple of these for an automatically updated list of new hosts:<ul>
2011-05-24 23:16:15 +00:00
<li><a href="http://stats.i2p/cgi-bin/newhosts.txt">http://stats.i2p/cgi-bin/newhosts.txt</a></li>
2013-10-29 00:05:06 +00:00
<li><a href="http://i2host.i2p/cgi-bin/i2hostetag">http://i2host.i2p/cgi-bin/i2hostetag</a></li>
<li><a href="http://no.i2p/export/alive-hosts.txt">http://no.i2p/export/alive-hosts.txt</a></li></ul>
<li>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>
or <code>http://i2host.i2p/cgi-bin/i2hostjump?<i>something</i>.i2p</code>
into your browser.
2011-05-24 23:16:15 +00:00
Once it's working, then you can tell others to use it.</li>
2015-01-06 14:10:25 +00:00
<li>Some people check website lists such as
<a href="http://inproxy.tino.i2p/status.php">inproxy.tino.i2p/status.php</a> or <a href="http://perv.i2p">perv.i2p</a> for new eepsites, so you may start getting a few visitors. But there are plenty of other ways to tell people. Here are a few ideas:
<ul>
<li>Post a message on the <a href="http://forum.i2p/viewforum.php?f=16">Eepsite announce forum</a>
2011-05-24 23:16:15 +00:00
on <a href="http://forum.i2p/">forum.i2p</a>.</li>
<li>Tell people about it on the #i2p or #i2p-chat channels on IRC.</li>
<li>Put it in a new post on <a href="http://syndie.i2p2.de/">the new Syndie</a>.</li>
<li>Put it in <a href="http://ugha.i2p/EepsiteIndex">Ugha's Eepsite Index Wiki</a></li>
</ul>
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.</ul>
<h2>Further Assistance</h2><ul>
<li>If you have any questions, the following places are available for support:
<ul>
2011-05-24 23:16:15 +00:00
<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><a href="http://forum.i2p/viewforum.php?f=10">The technical problems section</a> on
<a href="http://forum.i2p/">forum.i2p</a>.</li></ul>
</ul><div class="notify">
<b>Note:</b> This page, the website and the console all need translating into YOUR language if it's not already been done or in progress. Please consider helping the project grow by <a href="http://www.i2p2.i2p/getinvolved.html">volunteering your time</a> to translate. Contact the project via the IRC channel listed above. Thanks in advance!</div>
<hr><div class="footnote">
Document last edited: November 2010.</div>
</div></div>
</body>
</html>