Git Product home page Git Product logo

zeronet's Introduction

ZeroNet Build Status Documentation Help

简体中文

Decentralized websites using Bitcoin crypto and the BitTorrent network - https://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 is 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 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 the same cryptography as your Bitcoin wallet
  • Built-in SQL server with P2P data synchronization: Allows easier site development and faster page load times
  • Anonymity: Full Tor network support with .onion hidden services instead of IPv4 addresses
  • 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/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D).
  • 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 is also served by you.
  • Every site contains a content.json file which holds all other files in a sha512 hash and a signature generated using the 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. Afterwards, the peers verify the content.json integrity (using the signature), they download the modified files and publish the new content to other peers.

Screenshots

Screenshot ZeroTalk

How to join

If you get "classic environment no longer supported" error on OS X: Open a Terminal window and drop ZeroNet.app on it

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

Linux terminal

  • wget https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux64.tar.gz
  • tar xvpfz ZeroBundle-linux64.tar.gz
  • cd ZeroBundle
  • Start with ./ZeroNet.sh

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

Manual install for Debian Linux

  • 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
  • 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 run -d -v <local_data_folder>:/root/data -p 15441:15441 -p 127.0.0.1:43110:43110 nofish/zeronet
  • This Docker image includes the Tor proxy, which is disabled by default. Beware that some hosting providers may not allow you running Tor in their servers. If you want to enable it, set ENABLE_TOR environment variable to true (Default: false). E.g.:

docker run -d -e "ENABLE_TOR=true" -v <local_data_folder>:/root/data -p 15441:15441 -p 127.0.0.1:43110:43110 nofish/zeronet

  • virtualenv env
  • source env/bin/activate
  • pip install msgpack-python gevent
  • python zeronet.py
  • Open http://127.0.0.1:43110/ in your browser

Current limitations

  • No torrent-like file splitting for big file support
  • No more anonymous than Bittorrent (built-in full Tor support added)
  • File transactions are not compressed or encrypted yet (TLS encryption added)
  • No private sites

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.

Help keep this project alive

Sponsors

Thank you!

zeronet's People

Contributors

aitorpazos avatar anonym avatar cxgreat2014 avatar danielquinn avatar erqan avatar frerepoulet avatar hellozeronet avatar hostfat avatar idealcoder avatar ishift avatar jerry-wolf avatar jteego avatar krikmo avatar matthewrobertbell avatar mkg20001 avatar muxzeronet avatar n3r0-ch avatar nathantym avatar olivercole avatar rainlime avatar rarbg avatar rcmorano avatar shortcutme avatar sinkuu avatar sirmackk avatar thenain38 avatar vicalejuri avatar volker48 avatar yowmamasita avatar ysc3839 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.