This commit is contained in:
jimbo 2021-08-03 14:33:22 +00:00
parent 7f997af8a6
commit 27fcbd16aa
1 changed files with 20 additions and 24 deletions

View File

@ -1,10 +1,10 @@
main reference:
## main reference:
- https://zeronet.io
- V3 mirror http://zeronet34m3r5ngdu54uj57dcafpgdjhxsgq5kla5con4qvcmfzpvhad.onion
- https://github.com/HelloZeroNet/ZeroNet
# V3 Hidden Service support
sadly script with small patch to integrate support for hidden (onion) service V3 on ZeroNet darknet.
sadly script with small patch to integrate support for hidden (onion) service V3 on ZeroNet darknet ( still support V2 ).
this patch refers these issue:
- https://github.com/HelloZeroNet/ZeroNet/issues/2351
@ -15,10 +15,22 @@ In particular it manages the tracker function ( bootstrap plugin enable ) verify
As you may know the hiddien service V2 are deprecated and in October will cease to exist permanently, is why in the transition phase (wait for V3 support to be released from the official repo) it's important to enable the boostrap plugin (and add v3 trackers in bootstrap list) to verify and share OnionV3 peers that cannot be verified by current trackers with the stable version.
### Patch explained
This patch doesn't definitively differentiate onion v2 from v3, via `CryptRsa.py` I've maintained the v2 functions unchanged and added a copy of those funcionts ( sign, verify key .. ) with library required by onion v3 (`CryptEd25519.py`), recognising the type of address version from the length of the hidden service keys used in the functions ( **definitely could be improved!** ).
### Script explained
- move `upgrade_file/CryptEd25519.py` and `upgrade_file/CryptRsa.py` to `ZeroPath/src/Crypt/`
- replace in `ZeroPath/src/Tor/TorManager.py` the 2 words `RSA1024` with `ED25519-V3`
- add the line to the top:
`from Crypt import CryptEd25519` to :
- `ZeroPath/src/Tor/TorManager.py`
- `ZeroPath/plugins/AnnounceZero/AnnounceZeroPlugin.py`
---
For the installation guide i will use a fresh new client, following the installation guide on the official repo : https://github.com/HelloZeroNet/ZeroNet
### Linux (x86-64bit)
#### Linux (x86-64bit)
- `wget https://github.com/HelloZeroNet/ZeroNet-linux/archive/dist-linux64/ZeroNet-py3-linux64.tar.gz`
- `tar xvpfz ZeroNet-py3-linux64.tar.gz`
- `cd ZeroNet-linux-dist-linux64/`
@ -37,9 +49,7 @@ now the client is enabled to support V3 hidden services
you can launch the client normally from ZeroNet-linux-dist-linux64
- `./ZeroNet.sh`
---
## Tor configuration and tracker settings
#### Tor configuration and tracker settings
if you want to start immediately in tracker - tor always mode these are configurations tested on debian10, more information can be found in the official FAQ:
- https://zeronet.io/docs/faq/#how-to-use-zeronet-with-the-tor-browser
- https://zeronet.io/docs/faq/#how-to-use-zeronet-with-tor
@ -61,34 +71,20 @@ tor = always
- enable tracker plugin, always from ZeroNet-linux-dist-linux64
`mv core/plugins/disabled-Bootstrapper core/plugins/Bootstrapper`
- launch `./ZeroNet.sh`
- open http://127.0.0.1:43110/Stats to check the operation
---
## Tips
v3 tracker to add in bootstrap list:
### Tips
OnionV3 tracker to add in bootstrap list:
- `zero://tnjppdoc4famqa62mldlzc3fqw2wlsfxov7iz3pz5ex6umnqpaupflqd.onion:16227`
Syncronite trackers file list :
- http://127.0.0.1:43110/15CEFKBRHFfAP9rmL6hhLmHoXrrgmw4B5o
---
## Todo
### Todo
- understand why onion addresses aren't shared as shared trackers
- permanent tracker onion address
- upgrade plugins/StemPort for V3 support
- default stem lib for manage hidden services
## Patch explained
This patch doesn't definitively differentiate onion v2 from v3, via `CryptRsa.py` I've maintained the v2 functions unchanged and added a copy of those funcionts ( sign, verify key .. ) with library required by onion v3 (`Ed25519.py`), recognising the type of address version from the length of the hidden service keys used in the functions ( definitely could be improved! ).
## Script explained
- move `upgrade_file/CryptEd25519.py` and `upgrade_file/CryptRsa.py` to `ZeroPath/src/Crypt/`
- replace in `ZeroPath/src/Tor/TorManager.py` the 2 words `RSA1024` with `ED25519-V3`
- add the line to the top:
`from Crypt import CryptEd25519` to :
- `ZeroPath/src/Tor/TorManager.py`
- `ZeroPath/plugins/AnnounceZero/AnnounceZeroPlugin.py`
works