source: installer/resources/eepsite/docroot/help/index.html @ 0c54b6d

Last change on this file since 0c54b6d was 0c54b6d, checked in by zzz <zzz@…>, 10 months ago

Eepsite Help page:
Add links to Arabic, Hungarian, Indonesian
Fix link to Italian

  • Property mode set to 100644
File size: 14.1 KB
Line 
1<!DOCTYPE html>
2<html lang="en">
3<head>
4  <title>I2P Anonymous WebServer</title>
5  <link rel="shortcut icon" href="favicon.ico" />
6  <link rel="stylesheet" type="text/css" href="lib/eepsite.css" />
7  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
8</head>
9<body>
10
11   <div class="main">
12
13   <div class="langbar">
14      <a href="index.html"><img src="lib/us.png" title="English" alt="English"></a>
15      <a href="index_ar.html"><img src="lib/lang_ar.png" title="ﻉﺮﺒﻳﺓ" alt="ﻉﺮﺒﻳﺓ"></a>
16      <a href="index_az.html"><img src="lib/az.png" title="Azerbaijani" alt="Azerbaijani"></a>
17      <a href="index_zh.html"><img src="lib/cn.png" title="中文" alt="中文"></a>
18      <a href="index_de.html"><img src="lib/de.png" title="Deutsch" alt="Deutsch"></a>
19      <a href="index_es.html"><img src="lib/es.png" title="Español" alt="Español"></a>
20      <a href="index_fr.html"><img src="lib/fr.png" title="Français" alt="Français"></a>
21      <a href="index_hu.html"><img src="lib/hu.png" title="Magyar" alt="Magyar"></a>
22      <a href="index_in.html"><img src="lib/id.png" title="bahasa Indonesia" alt="bahasa Indonesia"></a>
23      <a href="index_it.html"><img src="lib/it.png" title="Italian" alt="Italian"></a>
24      <a href="index_nl.html"><img src="lib/nl.png" title="Nederlands" alt="Nederlands"></a>
25      <a href="index_pl.html"><img src="lib/pl.png" title="Polish" alt="Polish"></a>
26      <a href="index_pt.html"><img src="lib/pt.png" title="Português" alt="Português"></a>
27      <a href="index_ru.html"><img src="lib/ru.png" title="Русский" alt="Русский"></a>
28      <a href="index_sv.html"><img src="lib/se.png" title="Svenska" alt="Svenska"></a>
29      <a href="index_pl.html"><img src="lib/tr.png" title="Turkish" alt="Turkish"></a>
30    </div>
31
32    <h1>I2P Anonymous Webserver</h1>
33
34    <h2>Guide to Anonymous Webserving on I2P</h2>
35
36    <p>
37      This is your own anonymous I2P webserver (traditionally referred to as an <i>eepsite</i>).
38      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.
39    </p>
40
41    <p id="dir">The webserver's root directory can be found in one of the following locations, depending on your operating system:
42    </p>
43
44    <ul>
45      <li><b>Linux</b><br>
46        Standard install: <code>~/.i2p/eepsite/docroot/</code><br>
47        Package install, running as a service: <code>/var/lib/i2p/i2p-config/eepsite/docroot/</code>
48      </li>
49      <li><b>Windows</b><br>
50        <code>%APPDATA%\I2P\eepsite\docroot\</code>
51      </li>       
52      <li><b>Mac</b><br>
53        <code>/Users/(user)/Library/Application Support/i2p</code>
54      </li>
55    </ul>
56
57    <p>In I2P, hidden services are addressed using a Base32 address ending in ".b32.i2p", or a Destination represented as a long Base64 string.
58      The Base32 address may be used as a hostname, until you register a name following the instructions below.
59      The Destination 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>.
60    </p>
61
62    <p>The instructions below detail how to assign a name like "mysite.i2p" to your website and enable access by others.
63       You may reach your site locally via <a href="http://127.0.0.1:7658/">http://127.0.0.1:7658/</a>.
64    </p>
65
66    <h2>How to set up and announce your hidden service</h2>
67
68     <p>Your webserver is running by default, but is not accessible by others until you start the hidden service tunnel.
69      After you start your I2P Webserver tunnel, it will be difficult for other people to find.
70      It can only be accessed with the long Destination or with the shorter Base32 address (.b32.i2p), which is a hash of the Destination.
71      You could just tell people the Destnation or the Base32 address, but thankfully I2P has an address book and several easy ways to tell people about your website.
72      Here are detailed instructions.
73    </p>
74
75    <ul>
76      <li>Pick a name for your website (<i>something</i>.i2p), using lower-case.
77        You may wish to check first in your own router's <a href="http://127.0.0.1:7657/susidns/addressbook?book=router&amp;filter=none">address book</a> to see if your name is already taken.
78        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".
79        This will replace the default "mysite.i2p".
80        Also, if you would like your I2P Webserver tunnel to be automatically started when you start I2P, check the "Auto Start" box.
81        Your website will now start every time you start your router.
82        Be sure to click "Save".
83      </li>
84      <li>Click the start button for your webserver tunnel on the <a href="http://127.0.0.1:7657/i2ptunnel/">main Hidden Service Manager page</a>.
85         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>.
86         Your website is now running.
87      </li>
88      <li>Highlight and copy the entire Local destination on the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service Configuration page</a>.
89         Make sure you copy the whole thing, it is over 500 characters.
90      </li>
91      <li>Enter the name and paste the destination into your <a href="http://127.0.0.1:7657/susidns/addressbook?book=router&amp;filter=none">address book</a>.
92         Click "Add" to save the new entry.
93      </li>
94      <li>In your browser, enter in your website name (<i>something</i>.i2p) and you should be right back here.
95          Hopefully it worked!
96      </li>
97      <li>Before you tell the world about your new website, you should add some content.
98          Go to the server's root directory <a href="#dir">listed above</a> and replace the index.html redirect page with your own content.
99      </li>
100    </ul>           
101
102    <p>Directory listings are enabled, so you may host files from a subdirectory without providing a page with links to the files.
103      You may change the appearance of the directory by supplying an edited <a href="lib/jetty-dir.css">jetty-dir.css</a> file for each directory.
104      The <a href="lib/">lib subdirectory</a> demonstrates a custom style.
105      The <a href="lib/resources">resources subdirectory</a> demonstrates the default style.
106      If you need a template for a basic site, feel free to adapt <a href="pagetemplate.html">this page</a> and <a href="lib/">associated content</a>.
107    </p>
108
109    <p>If you're returned to this page after editing the content, try clearing your browser's web cache:</p>
110
111    <ul>
112      <li><b>Firefox:</b> Preferences ➜ Advanced ➜ Network ➜ Cached Web Content ➜ Clear Now</li>
113      <li><b>Chrome/Chromium:</b> Settings ➜ Advanced Settings ➜ Privacy ➜ Clear browsing data</li>
114      <li><b>Opera:</b> Settings ➜ Privacy ➜ Clear browsing data</li>
115    </ul>
116
117    <h2>Register your own I2P Domain</h2>
118
119    <p>Now it is 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>.
120      You must enter your website name and Destination (or Registration Authentication string) on one or more of these sites.
121    </p><p>Some registration sites require the Destination.
122      If so, highlight and copy the entire Local destination on the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service Configuration page</a>.
123      Make sure you copy the whole thing, it is over 500 characters.
124    </p><p>Some registration sites, including <a href="http://stats.i2p/i2p/addkey.html" target="_blank">stats.i2p</a>, require the Registration Authentication string.
125      It is found on the <a href="http://127.0.0.1:7657/i2ptunnel/register?tunnel=3">Registration Authentication page</a> linked from the <a href="http://127.0.0.1:7657/i2ptunnel/edit?tunnel=3">Hidden Service configuration page</a>.
126      Copy the entire authentication string and paste it on the registration page.
127      Make sure you copy the whole thing, it is over 500 characters.
128      Describe your site briefly if the site requests this information.
129      If your site is a HTTP service, leave the checkbox selected; if not, unselect it.
130    </p><p>For all registration sites, read through the Terms of Service carefully.
131      Click the "Submit" button.
132      Verify the submission was successful.
133      Since many routers periodically get address book updates from these sites, within several hours others will be able to find your website by simply entering your hostname in their browser.</p>
134
135    <h2>Adding Addressbook Subscriptions</h2>
136
137    <p>Speaking of address book updates, this would be a good time to add some more addressbooks to your own subscription list.
138       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:
139    </p>
140
141    <ul>
142      <li><code>http://stats.i2p/cgi-bin/newhosts.txt</code> (<a href="http://stats.i2p/cgi-bin/newhosts.txt" target="_blank">stats.i2p</a>)
143      </li>
144      <li><code>http://no.i2p/export/alive-hosts.txt</code> (<a href="http://no.i2p/export/alive-hosts.txt" target="_blank">no.i2p</a>)
145      </li>
146    </ul>
147   
148    <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.
149      This will work within a few minutes of your registering your hostname on the same site.
150      Test it yourself first by entering <code>http://stats.i2p/cgi-bin/jump.cgi?a=<i>something</i>.i2p</code> into your browser.
151      Once it is working, you can tell others to use it.
152    </p>
153
154    <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.
155      There are plenty of other ways to tell people. Here are a few ideas:
156    </p>
157
158    <ul>
159      <li>Post a message on the <a href="http://i2pforum.i2p/" target="_blank">I2P forum</a> telling everyone about your new I2P website!
160      </li>
161      <li>Tell people about it on the #i2p or #i2p-chat channels on IRC.
162      </li>
163      <li>Put it on the <a href="http://i2pwiki.i2p/index.php?title=Eepsite/Services" target="_blank">I2PWiki Eepsite Index</a>
164      </li>
165    </ul>
166
167    <p>Note that some sites recommend pasting in that really long destination.
168      You can if you want, but if you have successfully registered your hostname on a registration 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>
169
170    <h2>Using an alternative webserver to host your site</h2>
171
172    <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.
173      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.
174    </p>
175
176     <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>.
177       Ensure that the listening port configured for the webserver (7658 by default) is also configured in the Hidden Services settings.
178       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.
179        </p> 
180
181        <p>Beware that a poorly configured webserver or web appplication can leak potentially compromising information such as
182          your real IP address or server details that may reduce your anonymity or assist a hacker.
183          We recommend using the default server unless you feel comfortable doing server administration.
184          Please ensure your web server is secure prior to placing it online.
185          There are plenty of guides online, for example if you search for "nginx security hardening guide" you will find a number of guides that have good recommendations.
186        </p> 
187
188        <p>There is one important issue with the Apache web server.
189          The <code>mod_status</code> and <code>mod_info</code> Apache modules are enabled by default on some operating systems.
190          These modules expose internal data which can lead to serious compromise of anonymity when used on an anonymous network.
191          Removing the lines in the configuration file where these modules are loaded is the easiest way to prevent these issues.
192        </p>
193
194    <h2>Further Assistance</h2>
195
196        <p>If you have any questions, the following places are available for support:
197        </p>
198
199        <ul>
200          <li>Our IRC support channel:
201             <ul>
202                <li><a href="irc://irc.freenode.net/i2p">#i2p on Freenode</a>
203                </li>
204                <li>Anonymously using your local <a href="irc://127.0.0.1:6668/i2p">I2P IRC tunnel</a>.</li>
205             </ul>
206            <li>The project forum <a href="http://i2pforum.i2p/" target="_blank">i2pforum.i2p</a>.
207            </li>
208            <li><a href="http://i2pwiki.i2p/index.php?title=EepsiteHosting" target="_blank">I2PWiki Eepsite Hosting guide</a>
209            </li>
210        </ul>
211
212        <hr>
213        <div class="notify">
214          This page, the project website and the router console need translations!
215          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>.
216        </div>
217        <hr>
218
219  </div>
220</body>
221</html>
Note: See TracBrowser for help on using the repository browser.