Merge pull request #88 from Programmator9000/master

update README-ru
This commit is contained in:
caryoscelus 2022-05-28 15:14:10 +04:00 committed by GitHub
commit 73e23aa1e3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 80 additions and 88 deletions

View File

@ -1,27 +1,19 @@
[English](./README.md)
[简体中文](./README-zh-cn.md)
(ОСТОРОЖНО: русскоязычная версия README может быть не полностью обновлена)
# zeronet-conservancy # zeronet-conservancy
Минималистичный форк [ZeroNet](https://github.com/HelloZeroNet/ZeroNet) с [English](./README.md) [简体中文](./README-zh-cn.md)
поддержкой onion-v3 tor (и возможных других необходимых фиксов и закрытий
уязвимостей)
## Зачем форк? zeronet-conservancy — это форк/продолжение проекта [ZeroNet](https://github.com/HelloZeroNet/ZeroNet)
(покинутого его создателем), предназначенный для поддержки существующей сети p2p и развития
идей ценности децентрализации и свободы, постепенно развивающийся в более совершенную сеть
Нам нужен форк работающий с onion-v3 и не зависящий от доверия к одному или двум ## Зачем нужен этот форк?
личностям. Этот форк нужен прямо сейчас. Данный форк представляет из себя
минимальный [сет изменений по сравнению с последним коммитом
ZeroNet/py3](https://github.com/HelloZeroNet/ZeroNet/compare/py3...zeronet-conservancy:master)
, их легко проверить самостоятельно.
Этот форк является временной мерой и может закончиться, если/когда автор сего Во время кризиса onion-v3 появилась необходимость в форке, который работал бы с onion-v3 и не зависел от доверия к конкретным личностям.
форка решит, что существует альтернативный, активный, заслуживающий доверия Для выполнения этой задачи форк начался с внесения минимальных изменений в
форк. [ZeroNet/py3](https://github.com/HelloZeroNet/ZeroNet/tree/py3), которые легко проверяются. В то время как остается возможность использования ранних версий форка для работы с onion-v3, цель данного форка изменилась и мы стали стремиться решать больше проблем и повышать удобность и безопасность для пользователей до тех пор, пока новая, полностью прозрачная и проверенная сеть не будет готова, и необходимость в этом проекте не отпадет.
## Зачем?
## Зачем нужен 0net?
* Мы верим в открытую, свободную, и не поддающуюся цензуре сеть и коммуникацию. * Мы верим в открытую, свободную, и не поддающуюся цензуре сеть и коммуникацию.
* Нет единой точки отказа: Сайт онлайн пока по крайней мере 1 пир обслуживает его. * Нет единой точки отказа: Сайт онлайн пока по крайней мере 1 пир обслуживает его.
@ -30,6 +22,8 @@ ZeroNet/py3](https://github.com/HelloZeroNet/ZeroNet/compare/py3...zeronet-conse
* Быстр и работает оффлайн: Вы можете получить доступ к сайту, даже если Интернет недоступен. * Быстр и работает оффлайн: Вы можете получить доступ к сайту, даже если Интернет недоступен.
## Особенности ## Особенности
* Обновляемые в реальном времени сайты * Обновляемые в реальном времени сайты
* Клонирование вебсайтов в один клик * Клонирование вебсайтов в один клик
@ -44,7 +38,7 @@ ZeroNet/py3](https://github.com/HelloZeroNet/ZeroNet/compare/py3...zeronet-conse
## Как это работает? ## Как это работает?
* После запуска `zeronet.py` вы сможете посетить зайты (zeronet сайты) используя адрес * После запуска `zeronet.py` вы сможете посетить zeronet сайты используя адрес
`http://127.0.0.1:43110/{zeronet_address}` `http://127.0.0.1:43110/{zeronet_address}`
(например. `http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D`). (например. `http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D`).
* Когда вы посещаете новый сайт zeronet, он пытается найти пиров с помощью BitTorrent * Когда вы посещаете новый сайт zeronet, он пытается найти пиров с помощью BitTorrent
@ -56,104 +50,102 @@ ZeroNet/py3](https://github.com/HelloZeroNet/ZeroNet/compare/py3...zeronet-conse
подписывает новый `content.json` и публикует его для пиров. После этого пиры проверяют целостность `content.json` подписывает новый `content.json` и публикует его для пиров. После этого пиры проверяют целостность `content.json`
(используя подпись), они загружают измененные файлы и публикуют новый контент для других пиров. (используя подпись), они загружают измененные файлы и публикуют новый контент для других пиров.
Ссылки c информацией о ZeroNet:
#### [Слайд-шоу о криптографии ZeroNet, обновлениях сайтов, многопользовательских сайтах »](https://docs.google.com/presentation/d/1_2qK1IuOKJ51pgBvllZ9Yu7Au2l551t3XBgyTSvilew/pub?start=false&loop=false&delayms=3000) #### [Слайд-шоу о криптографии ZeroNet, обновлениях сайтов, многопользовательских сайтах »](https://docs.google.com/presentation/d/1_2qK1IuOKJ51pgBvllZ9Yu7Au2l551t3XBgyTSvilew/pub?start=false&loop=false&delayms=3000)
#### [Часто задаваемые вопросы »](https://zeronet.io/docs/faq/) #### [Часто задаваемые вопросы »](https://zeronet.io/docs/faq/)
#### [Документация разработчика ZeroNet »](https://zeronet.io/docs/site_development/getting_started/) #### [Документация разработчика ZeroNet »](https://zeronet.io/docs/site_development/getting_started/)
#### [Скриншоты в ZeroNet документации »](https://zeronet.io/docs/using_zeronet/sample_sites/)
## Скриншоты
![Screenshot](https://i.imgur.com/H60OAHY.png)
![ZeroTalk](https://zeronet.io/docs/img/zerotalk.png)
#### [Больше скриншотов в ZeroNet документации »](https://zeronet.io/docs/using_zeronet/sample_sites/)
## Как вступить ## Как вступить
(WIP) ### Install from source (recommended)
### Install from source #### System dependencies
- clone this repo ##### Generic unix-like (including mac os x)
- install python3 and pip if needed (the following instructions are for apt-based distributions)
- `sudo apt update`
- `sudo apt install python3-pip`
- `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/
## Текущие ограничения Установите autoconf и другие базовые инструменты разработки, python3 и pip.
##### Apt-based (debian, ubuntu, etc)
- `sudo apt update`
- `sudo apt install pkg-config python3-pip python3-venv`
##### Android/Termux
- Установите [Termux](https://termux.com/) (в Termux вы можете устанавливать пакеты через команду `pkg install <package-names>`)
- `pkg update`
- `pkg install python automake git binutils` (TODO: проверьте новую установку на наличие дополнительных зависимостей для установки)
- (optional) `pkg install tor`
- (optional) запустить тор через команду `tor --ControlPort 9051 --CookieAuthentication 1` (вы можете открыть новый сеанс свайпом вправо)
#### Создание зависимостей Python и запуск
- клонируйте репозиторий (NOTE: на Android/Termux вы должны клонировать его в «домашнюю» папку Termux, потому что виртуальная среда не может находиться в `storage/`)
- `python3 -m venv venv` (создайте виртуальную среду python, последнее `venv` это просто имя/название, если вы используете другое, вы должны заменить его в более поздних командах.)
- `source venv/bin/activate` (активируйте среду)
- `python3 -m pip install -r requirements.txt` (установите зависимости)
- `python3 zeronet.py` (**запустите zeronet-conservancy!**)
- откройте основную страницу в браузере, перейдя по: http://127.0.0.1:43110/
- для повторного запуска с нового терминала вам нужно перейти в деректорию репозитория и ввести :
- `source venv/bin/activate`
- `python3 zeronet.py`
#### альтернативный скрипт
- после установки общих зависимостей и клонирования репозитория (как указано выше) запустите `start-venv.sh` который создаст для вас виртуальную среду и установит требования Python
- больше удобных скриптов будует добавлено в ближайшее время
## Текущие ограничения
* Файловые транзакции не сжаты * Файловые транзакции не сжаты
* Нет приватных сайтов * Нет приватных сайтов
* ... * Отсутствует поддержка DHT
* Централизованные элементы, такие как Zeroid (мы работаем над этим!)
* Нет надежной защиты от спама (в процессе разработки)
* Не работает напрямую из браузера (один из главных приоритетов в ближайшем будущем)
* Нет прозрачности данных
## Как я могу создать сайт в Zeronet?
Завершите работу zeronet, если он запущен ## Как создать сайт ZeroNet?
```bash * Нажмите на **⋮** > **"Create new, empty site"** пункт меню на [admin page](http://127.0.0.1:43110/126NXcevn1AUehWFZLTBw7FrX1crEizQdr).
$ zeronet.py siteCreate * Вы будете перенаправлены **redirected** на совершенно новый сайт, который можете изменить только вы!
... * Вы можете найти и изменить содержимое своего сайта в каталоге **data/[yoursiteaddress]**
- Site private key (Приватный ключ сайта): 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq * После внесения изменений откройте свой сайт, перетащите верхнюю правую кнопку «0» влево, затем нажмите кнопки **sign** и **publish** , находящиеся внизу.
- Site address (Адрес сайта): 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
- Site created! (Сайт создан)
$ zeronet.py
...
```
Поздравляем, вы закончили! Теперь каждый может получить доступ к вашему зайту используя
`http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2`
Следующие шаги: [ZeroNet Developer Documentation](https://zeronet.io/docs/site_development/getting_started/) Следующие шаги: [ZeroNet Developer Documentation](https://zeronet.io/docs/site_development/getting_started/)
## Поддержите проект
## Как я могу модифицировать Zeronet сайт? ### Вы можете стать одним из сопровождающих
* Измените файлы расположенные в data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 директории. Нам нужно больше сопровождающих! Станьте им сегодня! Вам не нужно знать, как кодировать,
Когда закончите с изменением: есть много другой работы.
```bash ### Исправленные баги & новые функции
$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
- Signing site (Подпись сайта): 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
Private key (Приватный ключ) (input hidden):
```
* Введите секретный ключ, который вы получили при создании сайта, потом: Мы решили пойти дальше и создать идеальную сеть p2p, поэтому нам нужна дополнительная помощь в воплощении этой идеи.
```bash ### Создайте свой сайт / переносите свой контент
$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
Site:13DNDk..bhC2 Publishing to 3/10 peers...
Site:13DNDk..bhC2 Successfuly published to 3 peers
- Serving files....
```
* Вот и всё! Вы успешно подписали и опубликовали свои изменения. Мы знаем, что документации не хватает, но мы делаем все возможное, чтобы поддержать любого
кто хочет переехать. Не стесняйтесь спрашивать.
## Help this project stay alive ### Используйте его и делитесь информацией о его существовании
### Become a maintainer Обязательно расскажите людям, почему вы используете 0net и этот форк в частности! Люди
должны знать об альтернативах.
We need more maintainers! Become one today! Seriously, there's not going to be
that much new code to audit and auditing new code is the only requirement.
### Use it and spread the word ### Финансовая поддержка сопровождающих
Make sure to tell people why do you use 0net and this fork in particular! People В настоящее время ведущим разработчиком/сопровождающим этого форка является @caryoscelus. Вы можете
need to know their alternatives. посмотреть способы пожертвования на https://caryoscelus.github.io/donate/ (или проверьте
боковую панель, если вы читаете это на github, чтобы узнать больше). По мере роста нашей команды мы
также создаст командные аккаунты на дружественных краудфандинговых платформах.
### Financially support maintainers Если вы хотите, чтобы ваше пожертвование было признано пожертвованием для этого
проекта, для этого также есть специальный биткойн-адрес:
Currently the only maintainer of this fork is @caryoscelus. You can see ways to
donate to them on https://caryoscelus.github.io/donate/
If you want to make sure your donation is recognized as donation for this
project, there is a dedicated bitcoin address for that, too:
1Kjuw3reZvxRVNs27Gen7jPJYCn6LY7Fg6 1Kjuw3reZvxRVNs27Gen7jPJYCn6LY7Fg6
If you want to donate in a different way, feel free to contact maintainer or Если вы хотите сделать пожертвование другим способом, не стесняйтесь обращаться к сопровождающему или
create an issue создать запрос