Changeset b1541db for installer


Ignore:
Timestamp:
Jun 13, 2018 11:43:23 AM (2 years ago)
Author:
zzz <zzz@…>
Branches:
master
Children:
14e4cba
Parents:
da5de2f
Message:

Eepsite help: more edits

File:
1 edited

Legend:

Unmodified
Added
Removed
  • installer/resources/eepsite/docroot/help/index.html

    rda5de2f rb1541db  
    4747    </ul>
    4848
    49     <p>In I2P, hidden services are addressed using a 'key', which is represented as a long Base64 string.
    50       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>.
    51     </p>
    52 
    53     <p>The instructions below detail how to assign a name like "mysite.i2p" to your key and start up your website.
     49    <p>In I2P, hidden services are addressed using a Base32 address ending in ".b32.i2p", or a Destination represented as a long Base64 string.
     50      The Base32 address may be used as a hostname, until you assign a register a name following the instructions below.
     51      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>.
     52    </p>
     53
     54    <p>The instructions below detail how to assign a name like "mysite.i2p" to your website and enable access by others.
    5455       You may reach your site locally via <a href="http://127.0.0.1:7658/">http://127.0.0.1:7658/</a>.
    5556    </p>
    5657
    57     <h2>How to set up and announce your hidden service website</h2>
    58 
    59      <p>Your website is stopped by default.
     58    <h2>How to set up and announce your hidden service</h2>
     59
     60     <p>Your webserver is running by default, but is not accessible by others until you start the hidden service tunnel.
    6061      After you start your I2P Webserver tunnel, it will be difficult for other people to find
    61       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.
    62       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.
     62      It can only be accessed with the long Destination or with the shorter Base32 address (.b32.i2p), which is a hash of the Destination.
     63      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.
    6364      Here are detailed instructions.
    6465    </p>
     
    7374        Be sure to click "Save".
    7475      </li>
    75       <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>.
     76      <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>.
    7677         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>.
    7778         Your website is now running.
    7879      </li>
    79       <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.
    80          Make sure you copy the whole thing - it's over 500 characters.
    81       </li>
    82       <li>Enter the name and paste in the destination key into your
    83          <a href="http://127.0.0.1:7657/susidns/addressbook?book=master">master address book</a>.
    84          Click "Add" to add the destination to your address book.
     80      <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>.
     81         Make sure you copy the whole thing, it is over 500 characters.
     82      </li>
     83      <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>.
     84         Click "Add" to save the new entry.
    8585      </li>
    8686      <li>In your browser, enter in your website name (<i>something</i>.i2p) and you should be right back here.
     
    9494    <p>Directory listings are enabled, so you may host files from a subdirectory without providing a page with links to the files.
    9595      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.
    96       The <a href="lib/">lib</a> subdirectory demonstrates a custom style.
    97       The <a href="lib/resources">resources</a> subdirectory demonstrates the default style.
     96      The <a href="lib/">lib subdirectory</a> demonstrates a custom style.
     97      The <a href="lib/resources">resources subdirectory</a> demonstrates the default style.
    9898      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>.
    9999    </p>
     
    102102
    103103    <ul>
    104       <li><b>Firefox</b> via: Preferences ➜ Advanced ➜ Network ➜ Cached Web Content ➜ Clear Now</li>
    105       <li><b>Chrome/Chromium</b> via: Settings ➜ Advanced Settings ➜ Privacy ➜ Clear browsing data...</li>
    106       <li><b>Opera</b> via: Settings ➜ Privacy ➜ Clear browsing data...
     104      <li><b>Firefox:</b> Preferences ➜ Advanced ➜ Network ➜ Cached Web Content ➜ Clear Now</li>
     105      <li><b>Chrome/Chromium:</b> Settings ➜ Advanced Settings ➜ Privacy ➜ Clear browsing data</li>
     106      <li><b>Opera:</b> Settings ➜ Privacy ➜ Clear browsing data</li>
    107107    </ul>
    108108
    109109    <h2>Register your own I2P Domain</h2>
    110110
    111     <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>.
    112       That is, you must enter your website name and key into a web interface on one or more of these sites.
    113       Here is <a href="http://stats.i2p/i2p/addkey.html" target="_blank">the key entry form</a> at stats.i2p.
    114       You will need your <b>Authentication String</b> for the next step, this can be found on the <b>Registration Authentication</b> page which is linked from the Hidden Service configuration page.
    115       Copy the entire authentication string and paste it on the key entry page.
    116       Describe your site briefly, this step is recommended.
    117       If your site is a HTTP service, leave the checkbox selected - if not unselect it.
    118       Read through the Terms of Service carefully.
    119       Click the "Submit" button at the bottom of the page.
     111    <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>.
     112      You must enter your website name and Destination (or Registration Authentication string) on one or more of these sites.
     113    </p><p>Some registration sites require the Destination.
     114      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>.
     115      Make sure you copy the whole thing, it is over 500 characters.
     116    </p><p>Some registration sites, including <a href="http://stats.i2p/i2p/addkey.html" target="_blank">stats.i2p</a>, require the Registration Authentication string.
     117      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>.
     118      Copy the entire authentication string and paste it on the registration page.
     119      Make sure you copy the whole thing, it is over 500 characters.
     120      Describe your site briefly if the site requests this information.
     121      If your site is a HTTP service, leave the checkbox selected; if not, unselect it.
     122    </p><p>For all registration sites, read through the Terms of Service carefully.
     123      Click the "Submit" button.
    120124      Verify the submission was successful.
    121       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>
     125      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>
     126
    122127    <h2>Adding Addressbook Subscriptions</h2>
    123128
     
    134139   
    135140    <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.
    136       This will work within a few minutes of your entering the key to an address book on the same site.
     141      This will work within a few minutes of your registering your hostname on the same site.
    137142      Test it yourself first by entering <code>http://stats.i2p/cgi-bin/jump.cgi?a=<i>something</i>.i2p</code> into your browser.
    138       Once it's working, you can tell others to use it.
     143      Once it is working, you can tell others to use it.
    139144    </p>
    140145
     
    152157    </ul>
    153158
    154     <p>Note that some sites recommend pasting in that really long destination key.
    155       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>
     159    <p>Note that some sites recommend pasting in that really long destination.
     160      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>
    156161
    157162    <h2>Using an alternative webserver to host your site</h2>
     
    162167
    163168     <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>.
    164        Ensure that the listening port configured for the webserver (7658 by default) is also configured in the Hidden Services webserver settings.
     169       Ensure that the listening port configured for the webserver (7658 by default) is also configured in the Hidden Services settings.
    165170       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.
    166171        </p>
     
    173178        </p>
    174179
    175         <p>There is one important issue with the <b>Apache</b> web server.
     180        <p>There is one important issue with the Apache web server.
    176181          The <code>mod_status</code> and <code>mod_info</code> Apache modules are enabled by default on some operating systems.
    177182          These modules expose internal data which can lead to serious compromise of anonymity when used on an anonymous network.
     
    179184        </p>
    180185
    181         <h2>Further Assistance</h2>
     186    <h2>Further Assistance</h2>
    182187
    183188        <p>If you have any questions, the following places are available for support:
Note: See TracChangeset for help on using the changeset viewer.