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
265 Commits 3 Branches 24 Tags 18 MiB
JavaScript 56%
Python 36%
CSS 3.8%
CoffeeScript 3.7%
HTML 0.5%
Go to file
HelloZeroNet c9578e9037 Rev668, Stop if UiServer bind failed to avoid double start 2015-12-28 00:19:58 +01:00
plugins Version 0.3.4, Rev656, CryptMessage plugin for AES and ECIES encryption, Added pyelliptic lib for OpenSSSL based encryption methods, Test CryptMessage plugin, Force reload content.json before signing and after write, Escaped Sql IN queries support, Test Sql parameter escaping, ui_websocket Test fixture, Plugin testing support, Always return websocket errors as dict, Wait for file on weboscket fileGet command if its already in bad_files queue, PushState and ReplaceState url manipulation support in wrapper API, Per auth-address localstorage, Longer timeout for udp tracker query 2015-12-10 21:36:20 +01:00
src Rev668, Stop if UiServer bind failed to avoid double start 2015-12-28 00:19:58 +01:00
tools/coffee Remove useless assignment and fix newlines 2015-10-20 01:12:01 +02:00
.gitignore Add travis ci config 2015-09-20 12:30:32 +02:00
.travis.yml Version 0.3.4, Rev656, CryptMessage plugin for AES and ECIES encryption, Added pyelliptic lib for OpenSSSL based encryption methods, Test CryptMessage plugin, Force reload content.json before signing and after write, Escaped Sql IN queries support, Test Sql parameter escaping, ui_websocket Test fixture, Plugin testing support, Always return websocket errors as dict, Wait for file on weboscket fileGet command if its already in bad_files queue, PushState and ReplaceState url manipulation support in wrapper API, Per auth-address localstorage, Longer timeout for udp tracker query 2015-12-10 21:36:20 +01:00
Dockerfile Fix pyconfig.h: No such file or directory 2015-05-31 16:16:57 +02:00
LICENSE Initial commit 2015-01-12 01:41:38 +01:00
README.md Rev619, Fix sitesign without users.json, Fix readme typo 2015-11-28 18:04:59 +01:00
Vagrantfile Fix pyconfig.h: No such file or directory 2015-05-31 16:16:57 +02:00
requirements.txt Gevent 1.0.2 SSL handshake hangs under pytest 2015-10-01 03:13:14 +02:00
start.py partial cleanup of start.py 2015-06-17 22:32:29 +01:00
update.py rev280, The whole project reformatted to PEP8, UiRequest getPosted to query posted variables 2015-07-12 20:36:46 +02:00
zeronet.py Rev663, Faster SitePublish from command line if fileserver already running, Better OpenSSL lib close for update via webui, Close pyelliptic OpenSSL lib before update 2015-12-12 16:39:22 +01:00

README.md

ZeroNet Build Status Documentation Help

Decentralized websites using Bitcoin crypto and the BitTorrent network - http://zeronet.io

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.

Features

  • Real-time updated sites
  • Namecoin .bit domains support
  • Easy to setup: unpack & run
  • Clone websites in one click
  • Password-less BIP32 based authorization: Your account is protected by same cryptography as your Bitcoin wallet
  • Built-in SQL server with P2P data synchronization: Allows easier site development and faster page load times
  • Tor network support
  • TLS encrypted connections
  • Automatic, uPnP port opening
  • Plugin for multiuser (openproxy) support
  • Works with any browser/OS

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 content.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.

Slideshow about ZeroNet cryptography, site updates, multi-user sites »

Frequently asked questions »

Screenshots

Screenshot ZeroTalk

More screenshots in ZeroNet docs »

How to join?

Windows

It downloads the latest version of ZeroNet then starts it automatically.

Alternative method for Windows by installing Python

Linux

Debian

  • sudo apt-get update
  • sudo apt-get install msgpack-python python-gevent
  • wget https://github.com/HelloZeroNet/ZeroNet/archive/master.tar.gz
  • tar xvpfz master.tar.gz
  • cd ZeroNet-master
  • 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 gevent msgpack-python
  • Start with python zeronet.py

Mac

  • Install Homebrew
  • brew install python
  • pip install gevent msgpack-python
  • Download, Unpack, run python zeronet.py

Vagrant

  • vagrant up
  • Access VM with vagrant ssh
  • cd /vagrant
  • Run python zeronet.py --ui_ip 0.0.0.0
  • Open http://127.0.0.1:43110/ in your browser

Docker

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 you 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

Sponsors

Thank you!