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
4,047 Commits 3 Branches 24 Tags 18 MiB
JavaScript 56%
Python 36%
CSS 3.8%
CoffeeScript 3.7%
HTML 0.5%
Go to file
canewsin 00db9c9f87 Rust Version Compatibility for update Protocol msg 
and diff patch
 		2022-04-08 23:12:10 +05:30
.github v 0.7.6 (4565) 2022-01-12 05:13:17 +05:30
plugins@dbbeaee405 Update Plugins Repo 2022-03-12 11:14:10 +05:30
src Rust Version Compatibility for update Protocol msg 2022-04-08 23:12:10 +05:30
tools/coffee Remove tor files 2018-04-29 15:31:30 +02:00
.gitignore Add GitHub Actions workflow 2020-03-05 23:03:23 +03:00
.gitlab-ci.yml Fix sslcrypto thread safety (#2454) 2020-03-05 17:54:46 +01:00
.gitmodules v 0.7.6 (4565) 2022-01-12 05:13:17 +05:30
.travis.yml Revert "Travis CI: Run a current version of pytest (#2648)" 2020-10-29 02:49:04 +01:00
CHANGELOG.md Update changelog with 0.6.5, 0.7.0, 0.7.1 2020-09-03 16:56:41 +02:00
COPYING Change to GPLv3 license 2020-03-17 14:48:24 +01:00
Dockerfile Update Docker Image 2021-12-03 01:18:53 +05:30
Dockerfile.arm64v8 arm64 arch docker image request #2568 2020-07-18 17:45:32 +05:30
LICENSE Update LICENSE 2020-03-25 03:30:41 +05:30
README-ru.md v 0.7.6 (4565) 2022-01-12 05:13:17 +05:30
README-zh-cn.md v 0.7.6 (4565) 2022-01-12 05:13:17 +05:30
README.md v0.7.8 (4580) 2022-03-02 20:17:14 +05:30
Vagrantfile Use msgpack pip package everywhere 2018-02-27 02:48:15 +01:00
requirements.txt Update requirements.txt (#2617) 2020-09-24 18:24:24 +02:00
start.py Fix starting ZeroNet via start.py (#2052) 2019-06-28 00:58:58 +02:00
update.py Fix plugin config error when running update.py 2020-09-04 17:17:15 +02:00
zeronet.py Fix Repo Url for Bug Report 2022-03-12 17:38:23 +05:30

README.md

ZeroNet tests Documentation Help Docker Pulls Support me on Patreon

Decentralized websites using Bitcoin crypto and the BitTorrent network - https://zeronet.dev / ZeroNet Site, Unlike Bitcoin, ZeroNet Doesn't need a blockchain to run, But uses cryptography used by BTC, to ensure data integrity and validation.

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/1HELLoE3sFD9569CLCbHEAVqvqV7U2Ri9d).
  • 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 and 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.

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

Frequently asked questions »

ZeroNet Developer Documentation »

Screenshots

Screenshot ZeroTalk

More screenshots in ZeroNet docs »

How to join

Windows

macOS

Linux (x86-64bit)

  • wget https://github.com/ZeroNetX/ZeroNet/releases/latest/download/ZeroNet-linux.zip
  • unzip ZeroNet-linux.zip
  • cd ZeroNet-linux
  • Start with: ./ZeroNet.sh
  • Open the ZeroHello landing page in your browser by navigating to: http://127.0.0.1:43110/

Tip: Start with ./ZeroNet.sh --ui_ip '*' --ui_restrict your.ip.address to allow remote connections on the web interface.

Android (arm, arm64, x86)

Android (arm, arm64, x86) Thin Client for Preview Only (Size 1MB)

  • minimum Android version supported 16 (JellyBean)
  • Download from Google Play

Docker

There is an official image, built from source at: https://hub.docker.com/r/canewsin/zeronet/

Install from source

  • wget https://github.com/ZeroNetX/ZeroNet/releases/latest/download/ZeroNet-src.zip
  • unzip ZeroNet-src.zip
  • cd ZeroNet
  • sudo apt-get update
  • sudo apt-get install python3-pip
  • sudo python3 -m pip install -r requirements.txt
  • Start with: python3 zeronet.py
  • Open the ZeroHello landing page in your browser by navigating to: http://127.0.0.1:43110/

Current limitations

  • File transactions are not compressed
  • No private sites

How can I create a ZeroNet site?

  • Click on ⋮ > "Create new, empty site" menu item on the site ZeroHello.
  • You will be redirected to a completely new site that is only modifiable by you!
  • You can find and modify your site's content in data/[yoursiteaddress] directory
  • After the modifications open your site, drag the topright "0" button to left, then press sign and publish buttons on the bottom

Next steps: ZeroNet Developer Documentation

Help keep this project alive

Thank you!