HelloZeroNet
/
ZeroNet
mirror of https://github.com/HelloZeroNet/ZeroNet.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
ZeroNet - Decentralized websites using Bitcoin crypto and BitTorrent network
83 Commits 3 Branches 24 Tags 18 MiB
JavaScript 56%
Python 36%
CSS 3.8%
CoffeeScript 3.7%
HTML 0.5%
Go to file
HelloZeroNet 2d588a5006 Utf8 js merge error fix, no peer found error fix, Large site confirmation dialog display fix 2015-04-03 14:31:15 +02:00
plugins site connection stats, msgpack unpacker stats, make sure we dont skip any namecoin blocks, no more sha1 hash to content.json, keep 5 open connection in passive mode, publish got content to 5 peers, upnp retry 3 times, keep connection loggers 2015-04-03 02:47:51 +02:00
src Utf8 js merge error fix, no peer found error fix, Large site confirmation dialog display fix 2015-04-03 14:31:15 +02:00
tools/coffee Merging in upnp_punch_squashed 2015-02-24 08:02:05 -05:00
.gitignore ignore hidden files, ignore data dir, dont close on startup error, create necessary files and dirs on first start, start function to main.py, bad file solved log to info 2015-01-12 19:11:35 +01:00
LICENSE Initial commit 2015-01-12 01:41:38 +01:00
README.md More detailed linux install 2015-03-25 12:40:12 +01:00
requirements.txt Pip Requirements File Added 2015-01-19 09:56:03 -05:00
start.py version 0.2.1, better browser open, site size limit, save number of peers to sites.json to faster warmup, silent wsgihandler error, siteSetLimit API comment, grant ADMIN permissions to wrapper, display site changetime from includes too, loading screen warning support 2015-02-14 14:05:00 +01:00
update.py Dnschain is experimental, updater fix 2015-03-31 00:09:25 +02:00
zeronet.py version 0.2.7, plugin system, multiuser plugin for zeroproxies, reworked imports, cookie parse, stats moved to plugin, usermanager class, dont generate site auth on listing, multiline notifications, allow server side prompt from user, update script keep plugins disabled status 2015-03-24 01:33:09 +01:00

README.md

ZeroNet

Decentralized websites using Bitcoin crypto and the BitTorrent network

Why?

  • We believe in open, free, and uncensored network and communication.
  • No single point of failure: Site remains online so long as at least 1 peer serving it.
  • No hosting costs: Sites are served by visitors.
  • Impossible to shut down: It's nowhere because it's everywhere.
  • Fast and works offline: You can access the site even if your internet is unavailable.

How does it work?

  • After starting zeronet.py you will be able to visit zeronet sites using http://127.0.0.1:43110/{zeronet_address} (eg. http://127.0.0.1:43110/1EU1tbG9oC1A8jz2ouVwGZyQ5asrNsE4Vr).
  • When you visit a new zeronet site, it tries to find peers using the BitTorrent network so it can download the site files (html, css, js...) from them.
  • Each visited site becomes also served by you.
  • Every site contains a site.json which holds all other files in a sha512 hash and a signature generated using site's private key.
  • If the site owner (who has the private key for the site address) modifies the site, then he/she signs the new content.json and publishes it to the peers. After the peers have verified the content.json integrity (using the signature), they download the modified files and publish the new content to other peers.

Screenshot

Screenshot

How to join?

Windows

Linux

Debian

  • sudo apt-get update
  • sudo apt-get install build-essential python-dev python-pip git
  • sudo pip install pyzmq gevent msgpack-python
  • git clone https://github.com/HelloZeroNet/ZeroNet.git
  • cd ZeroNet
  • Start with python zeronet.py
  • Open http://127.0.0.1:43110/ in your browser and enjoy! :)

Other Linux or without root access

  • Check your python version using python --version if the returned version is not Python 2.7.X then try python2 or python2.7 command and use it from now
  • wget https://bootstrap.pypa.io/get-pip.py
  • python get-pip.py --user pyzmq gevent msgpack-python
  • Start with python zeronet.py

Current limitations

  • No torrent-like, file splitting for big file support
  • No more anonymous than Bittorrent
  • File transactions are not compressed or encrypted yet
  • No private sites
  • You must have an open port to publish new changes
  • Timeout problems on slow connections

How can I create a ZeroNet site?

Shut down zeronet if you are running it already

$ zeronet.py siteCreate
...
- Site private key: 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq
- Site address: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
- Site created!
$ zeronet.py
...

Congratulations, you're finished! Now anyone can access your site using http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2

Next steps: ZeroNet Developer Documentation

How can I modify a ZeroNet site?

  • Modify files located in data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 directory. After you're finished:
$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
- Signing site: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
Private key (input hidden):
  • Enter the private key you got when created the site, then:
$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
Site:13DNDk..bhC2 Publishing to 3/10 peers...
Site:13DNDk..bhC2 Successfuly published to 3 peers
- Serving files....
  • That's it! You've successfully signed and published your modifications.

If you want to help keep this project alive

Bitcoin: 1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX

Thank you!