![]() |
2 years ago | |
---|---|---|
backup_file | 2 years ago | |
upgrade_file | 2 years ago | |
README.md | 2 years ago | |
install.sh | 2 years ago | |
restore.sh | 2 years ago |
README.md
main reference:
V3 Hidden Service support
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
- https://github.com/HelloZeroNet/ZeroNet/issues/1292
- or from ZeroNet GitCenter
In particular it manages the tracker function ( bootstrap plugin enable ) verifying and distributing onion V3 peers to others ( to both patched and unpatched clients ).
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
- from this repo move
upgrade_file/CryptEd25519.py
andupgrade_file/CryptRsa.py
toZeroPath/src/Crypt/
- replace in
ZeroPath/src/Tor/TorManager.py
the 2 wordsRSA1024
withED25519-V3
- add the line
from Crypt import CryptEd25519
to the top of :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)
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/
now move inside core/ dir and download this repo
cd core
( not necessary if you use git source code ZeroTalk Post - clearnet)git clone https://git.disroot.org/anonymoose/ZeroNet_OnionV3.git
move inside downloaded folder and launch install.sh
script.
cd ZeroNet_OnionV3
./install.sh
back to main foldercd ../..
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
if you want to start immediately in tracker - tor always mode these are configurations tested on debian10, more information about Tor installation/configuration 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
- https://zeronet.io/docs/faq/#how-to-make-zeronet-work-with-tor-under-linuxmacos Then :
- add a file named
zeronet.conf
on ZeroNet-linux-dist-linux64 with
[global]
tor = always
- enable tracker plugin,
- from terminal in ZeroNet-linux-dist-linux64 :
mv core/plugins/disabled-Bootstrapper core/plugins/Bootstrapper
- from ZeroNet UI, go to Plugins page - change Bootstrapper flag to active
- from terminal in ZeroNet-linux-dist-linux64 :
- launch
./ZeroNet.sh
- open Stats Page to check the operation and used port (first line).
- each address generated under Tor Hidden Services in Stats Page can be used as tracker. ! every time the client restarts the onion addresses will change
to make a tracker link to share with an example in Stats:
Tor hidden services (status: OK (10 onions running)):
- global : xxxxxx36uz5xxxxxrve6orjtxxxxxuvatlpcsqnvxxxxxw3kcqefpjad
...
...
zero://[onion_v3_string].onion:[port]
tozero://xxxxxx36uz5xxxxxrve6orjtxxxxxuvatlpcsqnvxxxxxw3kcqefpjad.onion:15441
Tips
For bootstrap list:
zero://k5w77dozo3hy5zualyhni6vrh73iwfkaofa64abbilwyhhd3wgenbjqd.onion:15441
zero://2kcb2fqesyaevc4lntogupa4mkdssth2ypfwczd2ov5a3zo6ytwwbayd.onion:15441
zero://my562dxpjropcd5hy3nd5pemsc4aavbiptci5amwxzbelmzgkkuxpvid.onion:15441
zero://pn4q2zzt2pw4nk7yidxvsxmydko7dfibuzxdswi6gu6ninjpofvqs2id.onion:15441
zero://6i54dd5th73oelv636ivix6sjnwfgk2qsltnyvswagwphub375t3xcad.onion:15441
zero://tl74auz4tyqv4bieeclmyoe4uwtoc2dj7fdqv4nc4gl5j2bwg2r26bqd.onion:15441
zero://wlxav3szbrdhest4j7dib2vgbrd7uj7u7rnuzg22cxbih7yxyg2hsmid.onion:15441
zero://zy7wttvjtsijt5uwmlar4yguvjc2gppzbdj4v6bujng6xwjmkdg7uvqd.onion:15441
zero://rlcjomszyitxpwv7kzopmqgzk3bdpsxeull4c3s6goszkk6h2sotfoad.onion:15441
zero://havmj4jgv66jbrlhb74vvw4vxoffljbmljsoltimw6zk6js2tbk2siqd.onion:15441
OnionV3 trackers file list:
Syncronite trackers file list :
Todo
understand why onion addresses aren't shared as shared trackerspermanent tracker onion addresswrite wiki for permanent tracker, ref: ZeroTalk Post - clearnet- upgrade plugins/StemPort for V3 support
- default stem lib for manage hidden services