source: installer/resources/eepsite/docroot/help/index.html @ 18b61e7

Last change on this file since 18b61e7 was 18b61e7, checked in by zzz <zzz@…>, 4 years ago

Config files, eepsite help: Add path information for OS X
and Windows as a service. (ticket #1495)

  • Property mode set to 100644
File size: 8.8 KB
Line 
1<html>
2 <head>
3  <title>I2P Hidden Service Website</title>
4  <link rel="shortcut icon" href="favicon.ico" />
5    <link rel="stylesheet" type="text/css" href="lib/eepsite.css" />
6    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
7 </head>
8 <body>
9<div class="fairylights">
10<div class="main">
11 <h1>I2P Hidden Service Website</h1>
12<div class="langbar">
13<!-- Some of these languages listed here are yet to be translated -->
14<a href="index.html"><img src="lib/us.png" title="English" alt="English"></a>
15<a href="index_zh.html"><img src="lib/cn.png" title="中文" alt="中文"></a>
16<a href="index_de.html"><img src="lib/de.png" title="Deutsch" alt="Deutsch"></a>
17<a href="index_es.html"><img src="lib/es.png" title="Español" alt="Español"></a>
18<a href="index_fr.html"><img src="lib/fr.png" title="Français" alt="Français"></a>
19<a href="index_na.html"><img src="lib/ir.png" title="فارسی" alt="فارسی"></a>
20<a href="index_na.html"><img src="lib/jp.png" title="日本語" alt="日本語"></a>
21<a href="index_nl.html"><img src="lib/nl.png" title="Nederlands" alt="Nederlands"></a>
22<a href="index_ru.html"><img src="lib/ru.png" title="Русский" alt="Русский"></a>
23<a href="index_sv.html"><img src="lib/se.png" title="Svenska" alt="Svenska"></a>
24</div>
25<h2>Quick Guide to Anonymous Webserving on I2P</h2>
26
27 <p>This is your own anonymous I2P webserver ("eepsite") - simply edit the files under <code>~/.i2p/eepsite/docroot/</code> (Linux),
28 <code>%APPDATA%\I2P\eepsite\docroot\</code> (Windows),
29 or <code>/Users/(user)/Library/Application Support/i2p</code> (Mac),
30 and they'll be reachable by others once you follow the instructions below.
31 In I2P, hidden services are addressed using a 'key', which is represented as a really long Base64 string.
32 (The 'key' is somewhat analogous to an IP address, and
33 is shown on the hidden service
34 <a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">configuration page</a>).
35 The instructions below detail how to assign a name like "mysite.i2p" to your key and start up your website.</p>
36 <p>You can reach your site locally via
37 <a href="http://127.0.0.1:7658/">http://127.0.0.1:7658/</a>.
38</p>
39
40 <h2>How to set up and announce your hidden service website</h2>
41 Your website is stopped by default.
42 After you start it, it will be difficult for other people to find because it
43 doesn't have a name and they don't have your really long Base64 key.
44 You could just tell people that really long key, but thankfully I2P has an address book
45 and several easy ways to tell people about your website. Here's detailed instructions.
46 <ul>
47 <li>Pick a name for your website (<i>something</i>.i2p). Use all lower-case.
48     You may wish to check first in your own router's address book
49     <a href="http://127.0.0.1:7657/susidns/addressbook.jsp?book=router&amp;filter=none">here</a>,
50     or the file <code>i2p/hosts.txt</code> to see if your name is already taken.
51     Enter the new name for your website on the
52     <a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">hidden service configuration page</a>
53     where it says "Website name". This will replace the default "mysite.i2p".
54     Also, check the "Auto Start" box. Your website will now start every time you start your router.
55     Be sure to click "Save".</li>
56 <li>Click the start button for your website on the
57     <a href="http://127.0.0.1:7657/i2ptunnel/index.jsp">main i2ptunnel configuration page</a>.
58     You should now see it listed under "Hidden Services and Clients" on the left side of the
59     <a href="http://127.0.0.1:7657/index.jsp">I2P Router Console</a>.
60     Your website is now running.</li>
61 <li>Highlight the entire "Local destination" key on the
62     <a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">hidden service configuration page</a>.
63     and copy it for
64     later pasting. Make sure you get the whole thing - it's over 500 characters.</li>
65 <li>Enter the name and paste in the destination key into your
66     <a href="http://127.0.0.1:7657/susidns/addressbook.jsp?book=master">master address book</a>.
67     Click "Add" to add the destination to your address book.</li>
68 <li>In your browser, enter in your website name (<i>something</i>.i2p) and you should
69 be right back here. Hopefully it worked.</li>
70 <li>Before you tell the world about your new website, you should add some content.
71 Go to <code>~/.i2p/eepsite/docroot/</code> (Linux), <code>%APPDATA%\I2P\eepsite\docroot\</code> (Windows),
72 or <code>/Users/(user)/Library/Application Support/i2p</code> (Mac),
73 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>
74</ul>
75<h2>Register your own .I2P Domain</h2><ul>
76 <li>Now it's time to add your website to an I2P address book hosted by a site
77     such as <a href="http://stats.i2p/">stats.i2p</a> or <a href="http://no.i2p/">no.i2p</a>.
78     That is, you must enter
79     your website name and key into a web interface on one or more of these sites.
80     Here is <a href="http://stats.i2p/i2p/addkey.html">the key entry form at stats.i2p</a>.
81     Again, your key is the entire "Local destination" key on the
82     <a href="http://127.0.0.1:7657/i2ptunnel/edit.jsp?tunnel=3">hidden service configuration page</a>.
83     Be sure you get the whole thing.
84     Don't forget to click "add a key".
85     Check to see if it reports the key was added.
86     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>
87</ul><h2>Adding Addressbook Subscriptions</h2><ul>
88 <li>Speaking of address book updates, this would be a good time to add some more addressbooks
89     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>
90     <li><a href="http://stats.i2p/cgi-bin/newhosts.txt">http://stats.i2p/cgi-bin/newhosts.txt</a></li>
91     <li><a href="http://i2host.i2p/cgi-bin/i2hostetag">http://i2host.i2p/cgi-bin/i2hostetag</a></li>
92     <li><a href="http://no.i2p/export/alive-hosts.txt">http://no.i2p/export/alive-hosts.txt</a></li></ul>
93 <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.
94     This will work within a few minutes of your entering the key to an address book on the same site.
95     Test it yourself first by entering<code>
96     http://stats.i2p/cgi-bin/jump.cgi?a=<i>something</i>.i2p</code>
97     or <code>http://i2host.i2p/cgi-bin/i2hostjump?<i>something</i>.i2p</code>
98     into your browser.
99     Once it's working, then you can tell others to use it.</li>
100 <li>Some people check website lists such as
101 <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:
102     <ul>
103     <li>Post a message on the <a href="http://forum.i2p/viewforum.php?f=16">Eepsite announce forum</a>
104     on <a href="http://forum.i2p/">forum.i2p</a>.</li>
105     <li>Tell people about it on the #i2p or #i2p-chat channels on IRC.</li>
106     <li>Put it in a new post on <a href="http://syndie.i2p2.de/">the new Syndie</a>.</li>
107     <li>Put it in <a href="http://ugha.i2p/EepsiteIndex">Ugha's Eepsite Index Wiki</a></li>
108     </ul>
109     Note that some sites recommend pasting in that really long destination key.
110     You can if you want - but
111     if you have successfully posted your key at an add-key service,
112     tested it using a jump service, and waited 24 hours for the
113     address book update to propagate to others, that shouldn't be necessary.</ul>
114<h2>Further Assistance</h2><ul>
115        <li>If you have any questions, the following places are available for support:
116<ul>
117<li>Our IRC support channel: <ul><li><a href="irc://irc.freenode.net/i2p">#i2p on Freenode</a></li>
118<li>Anonymously via your resident <a href="irc://127.0.0.1:6668/i2p-help">I2P IRC tunnel</a>.</li></ul>
119        <li><a href="http://forum.i2p/viewforum.php?f=10">The technical problems section</a> on
120     <a href="http://forum.i2p/">forum.i2p</a>.</li></ul>
121 </ul><div class="notify">
122<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>
123<hr><div class="footnote">     
124Document last edited: November 2010.</div>
125</div></div>
126 </body>
127</html>
Note: See TracBrowser for help on using the repository browser.