302 lines
8.1 KiB
HTML
302 lines
8.1 KiB
HTML
<html>
|
|
<head>
|
|
<title>
|
|
I2P Reseed Tools
|
|
</title>
|
|
<meta name="author" content="eyedeekay" />
|
|
<meta name="description" content="reseed-tools" />
|
|
<meta name="keywords" content="master" />
|
|
<link rel="stylesheet" type="text/css" href="style.css" />
|
|
<link rel="stylesheet" type="text/css" href="showhider.css" />
|
|
</head>
|
|
<body>
|
|
<div id="navbar">
|
|
<a href="#shownav">
|
|
Show navigation
|
|
</a>
|
|
<div id="shownav">
|
|
<div id="hidenav">
|
|
<ul>
|
|
<li>
|
|
<a href="..">
|
|
Up one level ^
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="index.html">
|
|
index
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="CHANGELOG.html">
|
|
CHANGELOG
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="content/index.html">
|
|
content/index.html
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/index.html">
|
|
docs/index.html
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="index.html">
|
|
index.html
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/DEBIAN.html">
|
|
docs/DEBIAN
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/DOCKER.html">
|
|
docs/DOCKER
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/EXAMPLES.html">
|
|
docs/EXAMPLES
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/PLUGIN.html">
|
|
docs/PLUGIN
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/index.html">
|
|
docs/index
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/SERVICES.html">
|
|
docs/SERVICES
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/TLS.html">
|
|
docs/TLS
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="docs/index.html">
|
|
docs/index.html
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
<br>
|
|
<a href="#hidenav">
|
|
Hide Navigation
|
|
</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<a id="returnhome" href="/">
|
|
/
|
|
</a>
|
|
<h1>
|
|
I2P Reseed Tools
|
|
</h1>
|
|
<p>
|
|
<img src="content/images/reseed.png" alt="Reseed Tools Poster" />
|
|
</p>
|
|
<p>
|
|
This tool provides a secure and efficient reseed server for the I2P network.
|
|
There are several utility commands to create, sign, and validate SU3 files.
|
|
Please note that this requires at least Go version 1.13, and uses Go Modules.
|
|
</p>
|
|
<p>
|
|
Standard reseeds are distributed with the I2P packages. To get your reseed
|
|
included, apply on
|
|
<a href="http://zzz.i2p">
|
|
zzz.i2p
|
|
</a>
|
|
.
|
|
</p>
|
|
<h2>
|
|
Dependencies
|
|
</h2>
|
|
<p>
|
|
<code>
|
|
go
|
|
</code>
|
|
,
|
|
<code>
|
|
git
|
|
</code>
|
|
, and optionally
|
|
<code>
|
|
make
|
|
</code>
|
|
are required to build the project.
|
|
Precompiled binaries for most platforms are available at my github mirror
|
|
<a href="https://github.com/eyedeekay/i2p-tools-1">
|
|
https://github.com/eyedeekay/i2p-tools-1
|
|
</a>
|
|
.
|
|
</p>
|
|
<p>
|
|
In order to install the build-dependencies on Ubuntu or Debian, you may use:
|
|
</p>
|
|
<pre><code class="language-sh">sudo apt-get install golang-go git make
|
|
</code></pre>
|
|
<h2>
|
|
Installation
|
|
</h2>
|
|
<p>
|
|
Reseed-tools can be run as a user, as a freestanding service, or be installed
|
|
as an I2P Plugin. It will attempt to configure itself automatically. You should
|
|
make sure to set the
|
|
<code>
|
|
--signer
|
|
</code>
|
|
flag or the
|
|
<code>
|
|
RESEED_EMAIL
|
|
</code>
|
|
environment variable
|
|
to configure your signing keys/contact info.
|
|
</p>
|
|
<h3>
|
|
Installation(From Source)
|
|
</h3>
|
|
<pre><code>git clone https://i2pgit.org/idk/reseed-tools
|
|
cd reseed-tools
|
|
make build
|
|
# Optionally, if you want to install to /usr/bin/reseed-tools
|
|
sudo make install
|
|
</code></pre>
|
|
<h2>
|
|
Usage
|
|
</h2>
|
|
<h4>
|
|
Debian/Ubuntu note:
|
|
</h4>
|
|
<p>
|
|
It is possible to create a
|
|
<code>
|
|
.deb
|
|
</code>
|
|
package using
|
|
<a href="docs/DEBIAN.md">
|
|
these instructions
|
|
</a>
|
|
.
|
|
</p>
|
|
<p>
|
|
Debian users who are running I2P as a system service must also run the
|
|
<code>
|
|
reseed-tools
|
|
</code>
|
|
as the same user. This is so that the reseed-tools can access
|
|
the I2P service’s netDb directory. On Debian and Ubuntu, that user is
|
|
<code>
|
|
i2psvc
|
|
</code>
|
|
and the netDb directory is:
|
|
<code>
|
|
/var/lib/i2p/i2p-config/netDb
|
|
</code>
|
|
.
|
|
</p>
|
|
<h2>
|
|
Example Commands:
|
|
</h2>
|
|
<h3>
|
|
Without a webserver, standalone with TLS support
|
|
</h3>
|
|
<p>
|
|
If this is your first time running a reseed server (ie. you don’t have any existing keys),
|
|
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
|
|
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
|
|
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).
|
|
</p>
|
|
<pre><code>reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld
|
|
</code></pre>
|
|
<h3>
|
|
Locally behind a webserver (reverse proxy setup), preferred:
|
|
</h3>
|
|
<p>
|
|
If you are using a reverse proxy server it may provide the TLS certificate instead.
|
|
</p>
|
|
<pre><code>reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
|
|
</code></pre>
|
|
<ul>
|
|
<li>
|
|
<strong>
|
|
Usage
|
|
</strong>
|
|
<a href="docs/EXAMPLES.md">
|
|
More examples can be found here.
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<strong>
|
|
Docker
|
|
</strong>
|
|
<a href="docs/DOCKER.md">
|
|
Docker examples can be found here
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
<div id="sourcecode">
|
|
<span id="sourcehead">
|
|
<strong>
|
|
Get the source code:
|
|
</strong>
|
|
</span>
|
|
<ul>
|
|
<li>
|
|
<a href="https://i2pgit.org/idk/reseed-tools">
|
|
Source Repository: (https://i2pgit.org/idk/reseed-tools)
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div>
|
|
<a href="#show">
|
|
Show license
|
|
</a>
|
|
<div id="show">
|
|
<div id="hide">
|
|
<pre><code>Copyright (c) 2014 Matt Drollette
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.
|
|
</code></pre>
|
|
<a href="#hide">
|
|
Hide license
|
|
</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<iframe src="https://snowflake.torproject.org/embed.html" width="320" height="240" frameborder="0" scrolling="no"></iframe>
|
|
</div>
|
|
<div>
|
|
<a href="https://geti2p.net/">
|
|
<img src="i2plogo.png"></img>
|
|
I2P
|
|
</a>
|
|
</div>
|
|
</body>
|
|
</html> |