-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathfreespeechme.html
263 lines (230 loc) · 22.2 KB
/
freespeechme.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="">
<meta name="author" content="">
<link rel="shortcut icon" href="bootstrap/docs-assets/ico/favicon.png">
<title>Dot-Bit: Secure Decentralized DNS - FreeSpeechMe</title>
<!-- Bootstrap core CSS -->
<link href="bootstrap/dist/css/bootstrap.css" rel="stylesheet">
<style type="text/css">
.lead img { width: 100%; max-width: 683px; height: auto; }
</style>
<!-- Just for debugging purposes. Don't actually copy this line! -->
<!--[if lt IE 9]><script src="bootstrap/docs-assets/js/ie8-responsive-file-warning.js"></script><![endif]-->
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
<![endif]-->
<!-- Custom styles for this template -->
<link href="carousel.css" rel="stylesheet">
</head>
<!-- NAVBAR
================================================== -->
<body>
<div class="navbar-wrapper">
<div class="container">
<div class="navbar navbar-inverse navbar-static-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#">Dot-Bit</a>
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li><a href="index.html">Home</a></li>
<li class="dropdown">
<a data-toggle="dropdown">Browsing Instructions</a>
<ul class="dropdown-menu">
<li><a href="browse.html">Basic Browsing Information</a></li>
<li><a class="active" href="freespeechme.html">FreeSpeechMe</a></li>
</ul>
</li>
<li><a href="your_website.html">Webmaster Instructions</a></li>
<li><a href="security.html">Security Model</a></li>
<li><a href="http://www.namecoin.info/">Powered by Namecoin</a></li>
<!--
<li><a href="#about">About</a></li>
<li><a href="#contact">Contact</a></li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li class="dropdown-header">Nav header</li>
<li><a href="#">Separated link</a></li>
<li><a href="#">One more separated link</a></li>
</ul>
</li>
-->
</ul>
</div>
</div>
</div>
</div>
</div>
<!-- Carousel
================================================== -->
<div id="myCarousel" class="carousel slide" data-ride="carousel">
<div class="carousel-inner">
<div class="item active">
<img data-src="holder.js/900x500/auto/#777:#7a7a7a/text:%20" alt="">
<div class="container">
<div class="carousel-caption">
<h1>FreeSpeechMe</h1>
<p>FreeSpeechMe is a browser extension for Mozilla Firefox which enables viewing .bit websites. FreeSpeechMe was the first implementation of .bit's protections against MITM attacks, and still offers the best protections in this area. FreeSpeechMe also supports viewing .bit websites hosted behind the Tor and I2P anonymity networks (although viewing such websites is not anonymous).</p>
</div>
</div>
</div>
</div>
</div><!-- /.carousel -->
<!-- Marketing messaging and featurettes
================================================== -->
<!-- Wrap the rest of the page in another container to center all the content. -->
<div class="container marketing">
<!-- START THE FEATURETTES -->
<div class="row featurette">
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 class="featurette-heading">FreeSpeechMe Is Replaced by ncdns and dns-prop279</h2>
<p class="lead">FreeSpeechMe has been replaced by <a href="https://www.namecoin.org/docs/ncdns/">ncdns</a> and <a href="https://www.namecoin.org/download/betas/#dns-prop279">dns-prop279</a>. All information below is historical.</p>
</div>
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
</div>
<hr class="featurette-divider">
<div class="row featurette">
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 class="featurette-heading">System Requirements</h2>
<ul class="lead">
<li><strong>Compatibility note:</strong> FreeSpeechMe is currently not compatible with the Windows release of Firefox 33 and higher. Previous Windows releases (including version 31ESR) as well as GNU/Linux releases (both ESR and latest) are believed to be unaffected. We are working on a fix.</li>
<li>Windows or GNU/Linux (32-bit or 64-bit).</li>
<li>Mozilla Firefox (similar browsers such as Iceweasel may also work).</li>
<li>(Optional) Namecoin Client and NMControl; these are bundled with the Firefox extension, so you probably don't need to download these seperately.</li>
<li>Enough system resources to run the Namecoin Client and NMControl. This means about 1.6 GB of free disk space to store the blockchain, and about an hour to download the blockchain.</li>
<li>32-bit GNU/Linux users will need to install the Namecoin Client and NMControl themselves.</li>
</ul>
<p class="lead">This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.</p>
<p class="lead">This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. <a href="https://www.gnu.org/licenses/gpl-3.0.txt">See the GNU General Public License for more details.</a></p>
</div>
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
</div>
<hr class="featurette-divider">
<div class="row featurette">
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 class="featurette-heading">Before You Install</h2>
<p class="lead">Certain antivirus software silently deletes any program that it has never seen before. Norton is notorious for doing this. We have received reports that this causes some antivirus programs to delete the Namecoin Client and NMControl which are bundled with FreeSpeechMe. If you use such an antivirus program, you have a few options:</p>
<ol class="lead">
<li>Complain to your antivirus vendor.</li>
<li>Find a better antivirus program.</li>
<li>Download and install the Namecoin Client and NMControl yourself, in the hopes that this won't trigger the antivirus.</li>
</ol>
<p class="lead">FreeSpeechMe contains no viruses, spyware, adware or malware. Of course, you shouldn't take our word for this. FreeSpeechMe is GPL-licensed Free Software (source code <a href="https://github.com/namecoin/Convergence">on GitHub</a>) and anyone can vet it; technically savvy users are encouraged to build from source code if they desire. Disabling your antivirus software just to make a single application work is extremely unwise, and we do not recommend it. We are investigating better methods of improving compatibility with antivirus software.</p>
<p class="lead">If you already have the Namecoin Client or NMControl, be aware that the bundled versions included in FreeSpeechMe will not play well with the versions you already have. This means that you should either not enable the bundled versions, or you should close the versions you already have before you start Firefox. Nothing horrible will happen if you don't do this; one of the versions will simply fail to work until the other is closed. <strong>This behavior is heavily improved in our internal betas which will be released soon.</strong></p>
</div>
</div>
<hr class="featurette-divider">
<div class="row featurette">
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 class="featurette-heading">Installation</h2>
<p class="lead">You can install by clicking this link from Firefox: <strong>download unavailable, see notice at top of page</strong>.</p>
<p class="lead">Next, you will get this pop-up. Click “Allow”:</p>
<p class="lead"><a href="images/freespeechme/2-Allow.jpg"><img alt="(Image of a Firefox security warning; click Allow.)" src="images/freespeechme/2-Allow.jpg"></a></p>
<p class="lead">You will see a download bar in the top left, and almost simultaneously, another pop-up about only allowing software from authors you trust. Click “Install Now”:</p>
<p class="lead"><a href="images/freespeechme/3-downloading-install-from-authors-you-trust1.jpg"><img alt="(Image of another Firefox security warning; click Install Now)." src="images/freespeechme/3-downloading-install-from-authors-you-trust1.jpg"></a></p>
<p class="lead">(In the future, we intend to submit FreeSpeechMe to the Mozilla Add-Ons website, which would remove these scary security warnings.)</p>
<p class="lead">You'll get a dialog box asking you to restart Firefox. Click "Restart Now".</p>
<p class="lead"><a href="images/freespeechme/4-Restart-to-Install.jpg"><img alt="(Image of Firefox prompt; click Restart Now.)" src="images/freespeechme/4-Restart-to-Install.jpg"></a></p>
<p class="lead"><strong>If you already have both the Namecoin Client and NMControl installed, then you're done. Scroll down to <a href="#fsm-testing">"Making sure it works".</a></strong> If not, you'll need to tell FreeSpeechMe to use the bundled versions. Look for the new icon near the top-right corner of Firefox. Click the arrow, and click Options.</p>
<p class="lead"><a href="images/freespeechme/added-icon1.jpg"><img alt="(Image of Firefox's UI)" src="images/freespeechme/added-icon1.jpg"></a></p>
<p class="lead">On the resulting dialog box, click the Namecoin tab. Select “I don’t have namecoind or nmcontrol; use the bundled versions” from the drop-down menu. Then click “OK”.</p>
<p class="lead"><a href="images/freespeechme/PickThisOption-here.jpg"><img alt="(Image of the Options dialog.)" src="images/freespeechme/PickThisOption-here.jpg"></a></p>
<p class="lead">You probably don't need to mess with the other settings and tabs unless you're the kind of person who likes tinkering with things.</p>
<p class="lead">If you're on Windows, two black command prompt windows will pop up. Minimize them, but don't close them. If you close them by accident, FreeSpeechMe will stop working until you go back to the Options dialog and click OK again. (Our latest internal beta hides the command prompt windows for your convenience. They are already hidden on GNU/Linux.)</p>
<p class="lead">You might get a warning (or multiple warnings) from your firewall software, asking whether namecoind or nmcontrol should be allowed to access the network. You should allow access.</p>
<p class="lead">The bundled Namecoin client will now begin downloading the Namecoin blockchain. This usually takes about an hour, but might take longer or shorter than that depending on your Internet connection and system specs. You can use Firefox normally in the meantime, but you will need to keep Firefox running for the blockchain download to keep going.</p>
<p class="lead">After a while you can go back into the Options dialog and click the Status tab, which will show you how much of the blockchain (measured in blocks) has downloaded. If it says "namecoind not responding, try again in a couple minutes", then either namecoind is still booting or maybe it crashed. Click OK and try again later. If it instead shows a block count, compare it to the latest block shown on a Namecoin block explorer such as <a href="https://namecha.in/">https://namecha.in/</a>. Once the block count matches, you should be able to visit .bit websites (see the next section of this page).<p>
</div>
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
</div>
<hr class="featurette-divider">
<div class="row featurette">
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 id="fsm-testing" class="featurette-heading">Making sure it works</h2>
<p class="lead">Try visiting <a href="https://dot-bit.bit">https://dot-bit.bit</a>. If it loads properly, then FreeSpeechMe is working and ready to use. You can now close or re-open Firefox freely, even if you're using the bundled Namecoin Client and NMControl.</p>
<p class="lead">If you get an error like this:</p>
<p class="lead"><a href="images/freespeechme/add-exception.jpg"><img alt='Firefox says "This connection is untrusted" and asks you to "Add Exception".' src="images/freespeechme/add-exception.jpg"></a></p>
<p class="lead"><strong>Don’t add an exception</strong>, something’s wrong. This could be a problem on your end (maybe your blockchain isn’t fully downloaded), or it could be an issue in the website’s configuration, but it could also mean that someone is trying to hijack your connection. FreeSpeechMe’s security features <strong>rely</strong> on you <strong>not</strong> bypassing this warning. Unlike non-Dot-Bit sites where this warning may indicate that the website owner simply doesn’t have the money for a proper certificate, Dot-Bit sites don’t need the website owner to spend any money to fix this. If the website owner tries to tell you that this is normal and to add an exception, politely tell the website owner that he or she needs to fix the website’s configuration. Better safe than sorry.</p>
</div>
</div>
<hr class="featurette-divider">
<div class="row featurette">
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 class="featurette-heading">Tor and I2P support</h2>
<p class="lead"><strong>This is experimental; do not use it if you need anonymity.</strong><p>
<p class="lead">FreeSpeechMe supports a new feature of Dot-Bit domains: the ability to point to anonymously hosted websites using <a href="https://www.torproject.org/">Tor</a> or <a href="https://geti2p.net/">I2P</a>. Tor and I2P are networks that allow users to host websites without revealing their identities or locations.<p>
<p class="lead">Tor and I2P are a necessity for human rights activists and whistleblowers working in repressive countries, and both networks were critical in keeping citizens safe during the Arab Spring. Unfortunately, Tor- and I2P-hosted domain names normally have some issues: Tor domains (ending in .onion) are not human-memorable (e.g. duskgytldkxiuqc6.onion), and I2P domains (ending in .i2p) can resolve to different websites for different users (bad for security and censorship-resistance). FreeSpeechMe allows Dot-Bit domains to be used to point to Tor- and I2P- hosted websites, and as with all Dot-Bit domains, they are human-memorable and only can point to the correct website. Note that Dot-Bit only keeps the location and IP address of the domain owner private (assuming the domain is registered using Tor); the identity of the domain owner may be linkable with that person’s other usage of Namecoin (e.g. usernames at exchanges). Because FreeSpeechMe is not compatible with TorBrowser, you will not be anonymous while <em>viewing</em> .bit websites, even if they are hosted via Tor or I2P. As examples, FreeSpeechMe.org has set up two Dot-Bit domains using this: <a href="http://federalistpapers.bit">federalistpapers.bit</a> (requires Tor) and <a href="http://anonymous-git-hosting.bit">anonymous-git-hosting.bit</a> (requires I2P). (These websites are not hosted by Namecoin or FreeSpeechMe.org, and are solely present as examples.)</p>
<p class="lead">Setup is a little bit tricky right now (meaning this is for advanced users only). Instructions are below:</p>
<ol class="lead">
<li>You'll need to have a Tor and/or I2P SOCKS proxy running, and you'll need to know its port. This is usually 9050 for standalone Tor, or 9150 if you're running the Tor that came with the Tor Browser Bundle. Leaving the Tor Browser Bundle running should be sufficient for Tor to be listening for SOCKS connections. I2P generally requires messing with the settings in your I2P client, since typically a SOCKS proxy is not enabled by default.</li>
<li>In FreeSpeechMe settings, go to the "Proxies" tab. Fill in the IP (probably 127.0.0.1) and port where Tor or I2P is listening.</li>
<li>In FreeSpeechMe settings, go to the "Namecoin" tab. At the bottom of the dialog is a list of resolvers (currently including IPv4, IPv6, Tor, and I2P). Increase the priority of Tor and/or I2P so that it is above "Resolvers below this line will not be used." If a .bit domain offers more than one resolver (e.g. offering both IPv4 and Tor, or both Tor and I2P), the order you choose here will determine which one is used.</li>
<li>By default, only the .bit domains that resolve to .onion or .i2p will go over the Tor or I2P proxy. If you want all of your other Firefox traffic to go through Tor or I2P too, you should setup the SOCKS proxy in Firefox's proxy settings. Make sure that remote DNS is enabled in Firefox proxy settings.</li>
</ol>
<p class="lead">And, again, a warning: using FreeSpeechMe with Tor/I2P will harm your anonymity, both because TorBrowser isn't supported, and because possessing the ability to resolve .bit will, by itself, narrow your anonymity set massively. <strong>Do not use this if you need anonymity.</strong></p>
</div>
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
</div>
<hr class="featurette-divider">
<div class="row featurette">
<!--<div class="col-md-5">
<img class="featurette-image img-responsive" data-src="holder.js/500x500/auto" alt="">
</div>-->
<!-- <div class="col-md-7"> --> <div class="col-md-12">
<h2 class="featurette-heading">Support / Troubleshooting</h2>
<p class="lead"><strong>Q: Loading .bit websites is giving an "invalid certificate" error, even for websites with a correct configuration, or .bit websites aren't loading at all.</strong><br>A: One thing that sometimes helps is clicking the green icon in the toolbar so that it’s gray, and then clicking it again so that it’s green again; this basically reboots some components of FreeSpeechMe.</p>
<p class="lead"><strong>Q: I'm having problems on Arch Linux.</strong><br>A: On Arch Linux you'll need to install the Namecoin Client and NMControl yourself; the version of NMControl which is bundled with the current release of FreeSpeechMe is broken on Arch due to a Python 2/3 conflict. This will be fixed in the next release.</p>
<p class="lead"><strong>Q: I'm getting the error "namecoin resolution error Failed to connect to nmcontrol".</strong><br>A: Either configure FreeSpeechMe to use the bundled Namecoin Client and NMControl (see installation instructions), or make sure that your own NMControl is running on localhost on the default RPC port.</p>
<p class="lead"><strong>Q: I'm running NMControl myself on a nonstandard RPC port; can I use it with FreeSpeechMe?</strong><br>A: Not yet, but adding support for this will probably be easy.</p>
<p class="lead"><strong>If you're still having trouble, please ask on the <a href="https://forum.namecoin.info/viewforum.php?f=7">Technical Support forum</a></strong> or on IRC (#namecoin on Freenode).</p>
</div>
</div>
<hr class="featurette-divider">
<!-- /END THE FEATURETTES -->
<!-- FOOTER -->
<footer>
<p class="pull-right"><a href="#">Back to top</a></p>
<p>© 2013-2014 Dot-Bit Contributors. Some content © 2014 FreeSpeechMe.org. <!--· <a href="#">Privacy</a> · <a href="#">Terms</a>--></p>
</footer>
</div><!-- /.container -->
<!-- Bootstrap core JavaScript
================================================== -->
<!-- Placed at the end of the document so the pages load faster -->
<script src="https://code.jquery.com/jquery-1.10.2.min.js"></script>
<script src="bootstrap/dist/js/bootstrap.min.js"></script>
<script src="bootstrap/docs-assets/js/holder.js"></script>
</body>
</html>