• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..03-May-2022-

.github/ISSUE_TEMPLATE/H04-Sep-2019-5538

plugins/H04-Sep-2019-15,69712,555

src/H04-Sep-2019-27,31321,513

tools/coffee/H04-Sep-2019-132105

.gitignoreH A D04-Sep-2019345 3223

.gitlab-ci.ymlH A D04-Sep-20191.5 KiB4841

.travis.ymlH A D04-Sep-20191.4 KiB4443

CHANGELOG.mdH A D04-Sep-201918.3 KiB452365

DockerfileH A D04-Sep-2019681 2920

LICENSEH A D04-Sep-201917.6 KiB341281

README-ru.mdH A D04-Sep-201911.3 KiB212151

README-zh-cn.mdH A D04-Sep-20197.1 KiB189132

README.mdH A D04-Sep-20195.8 KiB171117

VagrantfileH A D04-Sep-20191.2 KiB4633

start.pyH A D04-Sep-2019291 188

update.pyH A D04-Sep-20194.5 KiB12196

zeronet.pyH A D03-May-20224 KiB138106

README-ru.md

1# ZeroNet [![Build Status](https://travis-ci.org/HelloZeroNet/ZeroNet.svg?branch=master)](https://travis-ci.org/HelloZeroNet/ZeroNet) [![Documentation](https://img.shields.io/badge/docs-faq-brightgreen.svg)](https://zeronet.io/docs/faq/) [![Help](https://img.shields.io/badge/keep_this_project_alive-donate-yellow.svg)](https://zeronet.io/docs/help_zeronet/donate/)
2
3[简体中文](./README-zh-cn.md)
4[English](./README.md)
5
6Децентрализованные вебсайты использующие Bitcoin криптографию и BitTorrent сеть - https://zeronet.io
7
8
9## Зачем?
10
11* Мы верим в открытую, свободную, и не отцензуренную сеть и коммуникацию.
12* Нет единой точки отказа: Сайт онлайн пока по крайней мере 1 пир обслуживает его.
13* Никаких затрат на хостинг: Сайты обслуживаются посетителями.
14* Невозможно отключить: Он нигде, потому что он везде.
15* Быстр и работает оффлайн: Вы можете получить доступ к сайту, даже если Интернет недоступен.
16
17
18## Особенности
19 * Обновляемые в реальном времени сайты
20 * Поддержка Namecoin .bit доменов
21 * Лёгок в установке: распаковал & запустил
22 * Клонирование вебсайтов в один клик
23 * Password-less [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki)
24   based authorization: Ваша учетная запись защищена той же криптографией, что и ваш Bitcoin-кошелек
25 * Встроенный SQL-сервер с синхронизацией данных P2P: Позволяет упростить разработку сайта и ускорить загрузку страницы
26 * Анонимность: Полная поддержка сети Tor с помощью скрытых служб .onion вместо адресов IPv4
27 * TLS зашифрованные связи
28 * Автоматическое открытие uPnP порта
29 * Плагин для поддержки многопользовательской (openproxy)
30 * Работает с любыми браузерами и операционными системами
31
32
33## Как это работает?
34
35* После запуска `zeronet.py` вы сможете посетить зайты (zeronet сайты) используя адрес
36  `http://127.0.0.1:43110/{zeronet_address}`
37(например. `http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D`).
38* Когда вы посещаете новый сайт zeronet, он пытается найти пиров с помощью BitTorrent
39  чтобы загрузить файлы сайтов (html, css, js ...) из них.
40* Каждый посещенный зайт также обслуживается вами. (Т.е хранится у вас на компьютере)
41* Каждый сайт содержит файл `content.json`, который содержит все остальные файлы в хэше sha512
42  и подпись, созданную с использованием частного ключа сайта.
43* Если владелец сайта (у которого есть закрытый ключ для адреса сайта) изменяет сайт, то он/она
44  подписывает новый `content.json` и публикует его для пиров. После этого пиры проверяют целостность `content.json`
45  (используя подпись), они загружают измененные файлы и публикуют новый контент для других пиров.
46
47####  [Слайд-шоу о криптографии ZeroNet, обновлениях сайтов, многопользовательских сайтах »](https://docs.google.com/presentation/d/1_2qK1IuOKJ51pgBvllZ9Yu7Au2l551t3XBgyTSvilew/pub?start=false&loop=false&delayms=3000)
48####  [Часто задаваемые вопросы »](https://zeronet.io/docs/faq/)
49
50####  [Документация разработчика ZeroNet »](https://zeronet.io/docs/site_development/getting_started/)
51
52
53## Скриншоты
54
55![Screenshot](https://i.imgur.com/H60OAHY.png)
56![ZeroTalk](https://zeronet.io/docs/img/zerotalk.png)
57
58#### [Больше скриншотов в ZeroNet документации »](https://zeronet.io/docs/using_zeronet/sample_sites/)
59
60
61## Как вступить
62
63* Скачайте ZeroBundle пакет:
64  * [Microsoft Windows](https://github.com/HelloZeroNet/ZeroNet-win/archive/dist/ZeroNet-win.zip)
65  * [Apple macOS](https://github.com/HelloZeroNet/ZeroNet-mac/archive/dist/ZeroNet-mac.zip)
66  * [Linux 64-bit](https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux64.tar.gz)
67  * [Linux 32-bit](https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux32.tar.gz)
68* Распакуйте где угодно
69* Запустите `ZeroNet.exe` (win), `ZeroNet(.app)` (osx), `ZeroNet.sh` (linux)
70
71### Linux терминал
72
73* `wget https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux64.tar.gz`
74* `tar xvpfz ZeroBundle-linux64.tar.gz`
75* `cd ZeroBundle`
76* Запустите с помощью `./ZeroNet.sh`
77
78Он загружает последнюю версию ZeroNet, затем запускает её автоматически.
79
80#### Ручная установка для Debian Linux
81
82* `sudo apt-get update`
83* `sudo apt-get install msgpack-python python-gevent`
84* `wget https://github.com/HelloZeroNet/ZeroNet/archive/master.tar.gz`
85* `tar xvpfz master.tar.gz`
86* `cd ZeroNet-master`
87* Запустите с помощью `python2 zeronet.py`
88* Откройте http://127.0.0.1:43110/ в вашем браузере.
89
90### [Arch Linux](https://www.archlinux.org)
91
92* `git clone https://aur.archlinux.org/zeronet.git`
93* `cd zeronet`
94* `makepkg -srci`
95* `systemctl start zeronet`
96* Откройте http://127.0.0.1:43110/ в вашем браузере.
97
98Смотрите [ArchWiki](https://wiki.archlinux.org)'s [ZeroNet
99article](https://wiki.archlinux.org/index.php/ZeroNet) для дальнейшей помощи.
100
101### [Gentoo Linux](https://www.gentoo.org)
102
103* [`layman -a raiagent`](https://github.com/leycec/raiagent)
104* `echo '>=net-vpn/zeronet-0.5.4' >> /etc/portage/package.accept_keywords`
105* *(Опционально)* Включить поддержку Tor: `echo 'net-vpn/zeronet tor' >>
106  /etc/portage/package.use`
107* `emerge zeronet`
108* `rc-service zeronet start`
109* Откройте http://127.0.0.1:43110/ в вашем браузере.
110
111Смотрите `/usr/share/doc/zeronet-*/README.gentoo.bz2` для дальнейшей помощи.
112
113### [FreeBSD](https://www.freebsd.org/)
114
115* `pkg install zeronet` or `cd /usr/ports/security/zeronet/ && make install clean`
116* `sysrc zeronet_enable="YES"`
117* `service zeronet start`
118* Откройте http://127.0.0.1:43110/ в вашем браузере.
119
120### [Vagrant](https://www.vagrantup.com/)
121
122* `vagrant up`
123* Подключитесь к VM с помощью `vagrant ssh`
124* `cd /vagrant`
125* Запустите `python2 zeronet.py --ui_ip 0.0.0.0`
126* Откройте http://127.0.0.1:43110/ в вашем браузере.
127
128### [Docker](https://www.docker.com/)
129* `docker run -d -v <local_data_folder>:/root/data -p 15441:15441 -p 127.0.0.1:43110:43110 nofish/zeronet`
130* Это изображение Docker включает в себя прокси-сервер Tor, который по умолчанию отключён.
131  Остерегайтесь что некоторые хостинг-провайдеры могут не позволить вам запускать Tor на своих серверах.
132  Если вы хотите включить его,установите переменную среды `ENABLE_TOR` в` true` (по умолчанию: `false`) Например:
133
134 `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`
135* Откройте http://127.0.0.1:43110/ в вашем браузере.
136
137### [Virtualenv](https://virtualenv.readthedocs.org/en/latest/)
138
139* `virtualenv env`
140* `source env/bin/activate`
141* `pip install msgpack gevent`
142* `python2 zeronet.py`
143* Откройте http://127.0.0.1:43110/ в вашем браузере.
144
145## Текущие ограничения
146
147* ~~Нет torrent-похожего файла разделения для поддержки больших файлов~~ (поддержка больших файлов добавлена)
148* ~~Не анонимнее чем Bittorrent~~ (добавлена встроенная поддержка Tor)
149* Файловые транзакции не сжаты ~~ или незашифрованы еще ~~ (добавлено шифрование TLS)
150* Нет приватных сайтов
151
152
153## Как я могу создать сайт в Zeronet?
154
155Завершите работу zeronet, если он запущен
156
157```bash
158$ zeronet.py siteCreate
159...
160- Site private key (Приватный ключ сайта): 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq
161- Site address (Адрес сайта): 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
162...
163- Site created! (Сайт создан)
164$ zeronet.py
165...
166```
167
168Поздравляем, вы закончили! Теперь каждый может получить доступ к вашему зайту используя
169`http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2`
170
171Следующие шаги: [ZeroNet Developer Documentation](https://zeronet.io/docs/site_development/getting_started/)
172
173
174## Как я могу модифицировать Zeronet сайт?
175
176* Измените файлы расположенные в data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 директории.
177  Когда закончите с изменением:
178
179```bash
180$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
181- Signing site (Подпись сайта): 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
182Private key (Приватный ключ) (input hidden):
183```
184
185* Введите секретный ключ, который вы получили при создании сайта, потом:
186
187```bash
188$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
189...
190Site:13DNDk..bhC2 Publishing to 3/10 peers...
191Site:13DNDk..bhC2 Successfuly published to 3 peers
192- Serving files....
193```
194
195* Вот и всё! Вы успешно подписали и опубликовали свои изменения.
196
197
198## Поддержите проект
199
200- Bitcoin: 1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX
201- Paypal: https://zeronet.io/docs/help_zeronet/donate/
202
203### Спонсоры
204
205* Улучшенная совместимость с MacOS / Safari стала возможной благодаря [BrowserStack.com](https://www.browserstack.com)
206
207#### Спасибо!
208
209* Больше информации, помощь, журнал изменений, zeronet сайты: https://www.reddit.com/r/zeronet/
210* Приходите, пообщайтесь с нами: [#zeronet @ FreeNode](https://kiwiirc.com/client/irc.freenode.net/zeronet) или на [gitter](https://gitter.im/HelloZeroNet/ZeroNet)
211* Email: hello@zeronet.io (PGP: CB9613AE)
212

README-zh-cn.md

1# ZeroNet [![Build Status](https://travis-ci.org/HelloZeroNet/ZeroNet.svg?branch=master)](https://travis-ci.org/HelloZeroNet/ZeroNet) [![Documentation](https://img.shields.io/badge/docs-faq-brightgreen.svg)](https://zeronet.io/docs/faq/) [![Help](https://img.shields.io/badge/keep_this_project_alive-donate-yellow.svg)](https://zeronet.io/docs/help_zeronet/donate/)
2
3[English](./README.md)
4
5使用 Bitcoin 加密和 BitTorrent 网络的去中心化网络 - https://zeronet.io
6
7
8## 为什么?
9
10* 我们相信开放,自由,无审查的网络
11* 不会受单点故障影响:只要有在线的节点,站点就会保持在线
12* 无托管费用: 站点由访问者托管
13* 无法关闭: 因为节点无处不在
14* 快速并可离线运行: 即使没有互联网连接也可以使用
15
16
17## 功能
18 * 实时站点更新
19 * 支持 Namecoin 的 .bit 域名
20 * 安装方便: 只需解压并运行
21 * 一键克隆存在的站点
22 * 无需密码、基于 [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) 的认证:用与比特币钱包相同的加密方法用来保护你的账户
23你的账户被使用和比特币钱包相同的加密方法
24 * 内建 SQL 服务器和 P2P 数据同步: 让开发更简单并提升加载速度
25 * 匿名性: 完整的 Tor 网络支持,支持通过 .onion 隐藏服务相互连接而不是通过IPv4地址连接
26 * TLS 加密连接
27 * 自动打开 uPnP 端口
28 * 插件和多用户 (开放式代理) 支持
29 * 全平台兼容
30
31
32## 原理
33
34* 在你运行`zeronet.py`后你将可以通过`http://127.0.0.1:43110/{zeronet_address}` (比如.
35`http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D`)。访问 zeronet 中的站点。
36
37* 在你浏览 zeronet 站点时,客户端会尝试通过 BitTorrent 网络来寻找可用的节点,从而下载需要的文件 (html, css, js...)
38
39* 你将会储存每一个浏览过的站点
40* 每个站点都包含一个名为 `content.json` ,它储存了其他所有文件的 sha512 hash 值
41  和一个通过站点私钥建立的签名
42* 如果站点的所有者 (拥有私钥的那个人) 修改了站点, 并且他/她签名了新的 `content.json` 然后推送至其他节点,
43那么所有节点将会在验证 `content.json` 的真实性 (使用签名)后, 下载修改后的文件并推送至其他节点。
44
45####  [有关于 ZeroNet 加密, 站点更新, 多用户站点的幻灯片 »](https://docs.google.com/presentation/d/1qBxkroB_iiX2zHEn0dt-N-qRZgyEzui46XS2hEa3AA4/pub?start=false&loop=false&delayms=3000)
46####  [常见问题 »](https://zeronet.io/docs/faq/)
47
48####  [ZeroNet开发者文档 »](https://zeronet.io/docs/site_development/getting_started/)
49
50
51## 屏幕截图
52
53![Screenshot](https://i.imgur.com/H60OAHY.png)
54![ZeroTalk](https://zeronet.io/docs/img/zerotalk.png)
55
56#### [在 ZeroNet 文档里查看更多的屏幕截图 »](https://zeronet.io/docs/using_zeronet/sample_sites/)
57
58
59## 如何加入 ?
60
61* 下载 ZeroBundle 文件包:
62  * [Microsoft Windows](https://github.com/HelloZeroNet/ZeroNet-win/archive/dist/ZeroNet-win.zip)
63  * [Apple macOS](https://github.com/HelloZeroNet/ZeroNet-mac/archive/dist/ZeroNet-mac.zip)
64  * [Linux 64bit](https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux64.tar.gz)
65  * [Linux 32bit](https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux32.tar.gz)
66* 解压缩
67* 运行 `ZeroNet.exe` (win), `ZeroNet(.app)` (osx), `ZeroNet.sh` (linux)
68
69### Linux 命令行
70
71* `wget https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux64.tar.gz`
72* `tar xvpfz ZeroBundle-linux64.tar.gz`
73* `cd ZeroBundle`
74* 执行 `./ZeroNet.sh` 来启动
75
76在你打开时他将会自动下载最新版本的 ZeroNet 。
77
78#### 在 Debian Linux 中手动安装
79
80* `sudo apt-get update`
81* `sudo apt-get install msgpack-python python-gevent`
82* `wget https://github.com/HelloZeroNet/ZeroNet/archive/master.tar.gz`
83* `tar xvpfz master.tar.gz`
84* `cd ZeroNet-master`
85* 执行 `python2 zeronet.py` 来启动
86* 在你的浏览器中打开 http://127.0.0.1:43110/
87
88### [FreeBSD](https://www.freebsd.org/)
89
90* `pkg install zeronet` 或者 `cd /usr/ports/security/zeronet/ && make install clean`
91* `sysrc zeronet_enable="YES"`
92* `service zeronet start`
93* 在你的浏览器中打开 http://127.0.0.1:43110/
94
95### [Vagrant](https://www.vagrantup.com/)
96
97* `vagrant up`
98* 通过 `vagrant ssh` 连接到 VM
99* `cd /vagrant`
100* 运行 `python2 zeronet.py --ui_ip 0.0.0.0`
101* 在你的浏览器中打开 http://127.0.0.1:43110/
102
103### [Docker](https://www.docker.com/)
104* `docker run -d -v <local_data_folder>:/root/data -p 26552:26552 -p 43110:43110 nofish/zeronet`
105* 这个 Docker 镜像包含了 Tor ,但默认是禁用的,因为一些托管商不允许你在他们的服务器上运行 Tor。如果你希望启用它,
106设置 `ENABLE_TOR` 环境变量为 `true` (默认: `false`). E.g.:
107
108 `docker run -d -e "ENABLE_TOR=true" -v <local_data_folder>:/root/data -p 26552:26552 -p 43110:43110 nofish/zeronet`
109* 在你的浏览器中打开 http://127.0.0.1:43110/
110
111### [Virtualenv](https://virtualenv.readthedocs.org/en/latest/)
112
113* `virtualenv env`
114* `source env/bin/activate`
115* `pip install msgpack gevent`
116* `python2 zeronet.py`
117* 在你的浏览器中打开 http://127.0.0.1:43110/
118
119## 现有限制
120
121* ~~没有类似于 BitTorrent 的文件拆分来支持大文件~~ (已添加大文件支持)
122* ~~没有比 BitTorrent 更好的匿名性~~ (已添加内置的完整 Tor 支持)
123* 传输文件时没有压缩~~和加密~~ (已添加 TLS 支持)
124* 不支持私有站点
125
126
127## 如何创建一个 ZeroNet 站点?
128
129
130如果 zeronet 在运行,把它关掉
131执行:
132```bash
133$ zeronet.py siteCreate
134...
135- Site private key: 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq
136- Site address: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
137...
138- Site created!
139$ zeronet.py
140...
141```
142
143你已经完成了! 现在任何人都可以通过
144`http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2`
145来访问你的站点
146
147下一步: [ZeroNet 开发者文档](https://zeronet.io/docs/site_development/getting_started/)
148
149
150## 我要如何修改 ZeroNet 站点?
151
152* 修改位于 data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 的目录.
153  在你改好之后:
154
155```bash
156$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
157- Signing site: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
158Private key (input hidden):
159```
160
161* 输入你在创建站点时获得的私钥
162
163```bash
164$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
165...
166Site:13DNDk..bhC2 Publishing to 3/10 peers...
167Site:13DNDk..bhC2 Successfuly published to 3 peers
168- Serving files....
169```
170
171* 就是这样! 你现在已经成功的签名并推送了你的更改。
172
173
174## 帮助这个项目
175
176- Bitcoin: 1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX
177- Paypal: https://zeronet.io/docs/help_zeronet/donate/
178
179### 赞助商
180
181* 在 OSX/Safari 下 [BrowserStack.com](https://www.browserstack.com) 带来更好的兼容性
182
183#### 感谢!
184
185* 更多信息, 帮助, 变更记录和 zeronet 站点: https://www.reddit.com/r/zeronet/
186* 在: [#zeronet @ FreeNode](https://kiwiirc.com/client/irc.freenode.net/zeronet) 和我们聊天,或者使用 [gitter](https://gitter.im/HelloZeroNet/ZeroNet)
187* [这里](https://gitter.im/ZeroNet-zh/Lobby)是一个 gitter 上的中文聊天室
188* Email: hello@noloop.me
189

README.md

1# ZeroNet [![Build Status](https://travis-ci.org/HelloZeroNet/ZeroNet.svg?branch=master)](https://travis-ci.org/HelloZeroNet/ZeroNet) [![Documentation](https://img.shields.io/badge/docs-faq-brightgreen.svg)](https://zeronet.io/docs/faq/) [![Help](https://img.shields.io/badge/keep_this_project_alive-donate-yellow.svg)](https://zeronet.io/docs/help_zeronet/donate/)
2
3Decentralized websites using Bitcoin crypto and the BitTorrent network - https://zeronet.io
4
5
6## Why?
7
8* We believe in open, free, and uncensored network and communication.
9* No single point of failure: Site remains online so long as at least 1 peer is
10  serving it.
11* No hosting costs: Sites are served by visitors.
12* Impossible to shut down: It's nowhere because it's everywhere.
13* Fast and works offline: You can access the site even if Internet is
14  unavailable.
15
16
17## Features
18 * Real-time updated sites
19 * Namecoin .bit domains support
20 * Easy to setup: unpack & run
21 * Clone websites in one click
22 * Password-less [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki)
23   based authorization: Your account is protected by the same cryptography as your Bitcoin wallet
24 * Built-in SQL server with P2P data synchronization: Allows easier site development and faster page load times
25 * Anonymity: Full Tor network support with .onion hidden services instead of IPv4 addresses
26 * TLS encrypted connections
27 * Automatic uPnP port opening
28 * Plugin for multiuser (openproxy) support
29 * Works with any browser/OS
30
31
32## How does it work?
33
34* After starting `zeronet.py` you will be able to visit zeronet sites using
35  `http://127.0.0.1:43110/{zeronet_address}` (eg.
36  `http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D`).
37* When you visit a new zeronet site, it tries to find peers using the BitTorrent
38  network so it can download the site files (html, css, js...) from them.
39* Each visited site is also served by you.
40* Every site contains a `content.json` file which holds all other files in a sha512 hash
41  and a signature generated using the site's private key.
42* If the site owner (who has the private key for the site address) modifies the
43  site, then he/she signs the new `content.json` and publishes it to the peers.
44  Afterwards, the peers verify the `content.json` integrity (using the
45  signature), they download the modified files and publish the new content to
46  other peers.
47
48####  [Slideshow about ZeroNet cryptography, site updates, multi-user sites »](https://docs.google.com/presentation/d/1_2qK1IuOKJ51pgBvllZ9Yu7Au2l551t3XBgyTSvilew/pub?start=false&loop=false&delayms=3000)
49####  [Frequently asked questions »](https://zeronet.io/docs/faq/)
50
51####  [ZeroNet Developer Documentation »](https://zeronet.io/docs/site_development/getting_started/)
52
53
54## Screenshots
55
56![Screenshot](https://i.imgur.com/H60OAHY.png)
57![ZeroTalk](https://zeronet.io/docs/img/zerotalk.png)
58
59#### [More screenshots in ZeroNet docs »](https://zeronet.io/docs/using_zeronet/sample_sites/)
60
61
62## How to join
63
64### Windows
65
66 - Download [ZeroNet-py3-win64.zip](https://github.com/HelloZeroNet/ZeroNet-win/archive/dist-win64/ZeroNet-py3-win64.zip) (18MB)
67 - Unpack anywhere
68 - Run `ZeroNet.exe`
69
70### Other platforms: Install from source
71
72Fetch and extract the source:
73
74    wget https://github.com/HelloZeroNet/ZeroNet/archive/py3/ZeroNet-py3.tar.gz
75    tar xvpfz ZeroNet-py3.tar.gz
76    cd ZeroNet-py3
77
78Install Python module dependencies either:
79
80* (Option A) into a [virtual env](https://virtualenv.readthedocs.org/en/latest/)
81
82    ```
83    python3 -m venv zeronet
84    source zeronet/bin/activate
85    python3 -m pip install -r requirements.txt
86    ```
87
88* (Option B) into the system (requires root), for example, on Debian/Ubuntu:
89
90    ```
91    sudo apt-get update
92    sudo apt-get install python3-pip
93    sudo python3 -m pip install -r requirements.txt
94    ```
95
96Start Zeronet:
97
98    python3 zeronet.py
99
100Open the ZeroHello landing page in your browser by navigating to:
101
102    http://127.0.0.1:43110/
103
104## Current limitations
105
106* ~~No torrent-like file splitting for big file support~~ (big file support added)
107* ~~No more anonymous than Bittorrent~~ (built-in full Tor support added)
108* File transactions are not compressed ~~or encrypted yet~~ (TLS encryption added)
109* No private sites
110
111
112## How can I create a ZeroNet site?
113
114Shut down zeronet if you are running it already
115
116```bash
117$ zeronet.py siteCreate
118...
119- Site private key: 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq
120- Site address: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
121...
122- Site created!
123$ zeronet.py
124...
125```
126
127Congratulations, you're finished! Now anyone can access your site using
128`http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2`
129
130Next steps: [ZeroNet Developer Documentation](https://zeronet.io/docs/site_development/getting_started/)
131
132
133## How can I modify a ZeroNet site?
134
135* Modify files located in data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 directory.
136  After you're finished:
137
138```bash
139$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
140- Signing site: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
141Private key (input hidden):
142```
143
144* Enter the private key you got when you created the site, then:
145
146```bash
147$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
148...
149Site:13DNDk..bhC2 Publishing to 3/10 peers...
150Site:13DNDk..bhC2 Successfuly published to 3 peers
151- Serving files....
152```
153
154* That's it! You've successfully signed and published your modifications.
155
156
157## Help keep this project alive
158
159- Bitcoin: 1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX
160- Paypal: https://zeronet.io/docs/help_zeronet/donate/
161
162### Sponsors
163
164* Better macOS/Safari compatibility made possible by [BrowserStack.com](https://www.browserstack.com)
165
166#### Thank you!
167
168* More info, help, changelog, zeronet sites: https://www.reddit.com/r/zeronet/
169* Come, chat with us: [#zeronet @ FreeNode](https://kiwiirc.com/client/irc.freenode.net/zeronet) or on [gitter](https://gitter.im/HelloZeroNet/ZeroNet)
170* Email: hello@zeronet.io (PGP: CB9613AE)
171