mirror of
http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/darknet-lantern.git
synced 2025-05-16 20:26:58 +00:00
updated readme (WIP)
This commit is contained in:
nihilist
parent
61ee271ac8
commit
d7d60069c9
1 changed files with 119 additions and 108 deletions
227
README.md
227
README.md
|
|
@ -1,6 +1,8 @@
|
|||
# [Darknet Onion Webring (WIP)](http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/)
|
||||
# [Darknet Lantern (WIP)](http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/)
|
||||
|
||||
|
||||
|
||||
## TODOLIST: 95% completed
|
||||
```
|
||||
# Main features:
|
||||
DONE:
|
||||
|
|
@ -22,29 +24,133 @@ TODO:
|
|||
```
|
||||
|
||||
|
||||
Darknet Onion Webring is powered by a Minimalistic Onion Hidden Service uptime checker, written in only PHP and Python, because javascript is NOT needed.
|
||||
# What is the Darknet Lantern Project ?
|
||||
Darknet Lantern is a minimalistic Peer to Peer Decentralised Search Engine for the Darknet.
|
||||
|
||||
## Why is the Darknet Onion Webring relevant ?
|
||||
## Why is the Darknet Lantern relevant ?
|
||||
|
||||
The Darknet depends on peers (like you and me) to run their own lists of onion links for visibility, as search engines can't crawl onion websites like they do on the clearnet. This project is there to list people's lists of onion links so that you don't have to search those links yourself.
|
||||
The Darknet is fundamentally different compared to the Clearnet. Where the Clearnet is like an open city where every destination is visible from the sky, where every website is indexable and searchable using popular search engines, the Darknet is like an immense, dense dark forest where you can't see any destination from the sky.
|
||||
|
||||
The more people join the Darknet Onion Webring, the more visibility darknet websites will be able to have over time, just like how it would be on the clearnet while keeping the decentralisation and censorship-resistance intact. Let's make it happen.
|
||||
To explore the Darknet, you need peers (like you and me) to run their own lists of onion links, to know where to go, as search engines can't crawl onion websites like they do on the clearnet. The Darknet Lantern Project is a serious attempt at solving the fundamental lack of search engines on the Darknet, to make sure websites can get visibility while maintaining their anonymity.
|
||||
|
||||
## How to join the Darknet Onion Webring ?
|
||||
## Why is the Darknet Lantern Webring relevant ?
|
||||
|
||||
The Darknet Lantern Project includes a Webring, as otherwise the Darknet Lanterns would remain scattered and remain hidden from each other, to participate in the webring means that you are exponentially increase the visibility of the Onion websites you listed, the more webring participants there are.
|
||||
|
||||
The more people join the Darknet Lantern Webring, the more visibility Darknet websites will be able to have over time, just like how it would be on the clearnet, while keeping the decentralisation and censorship-resistance intact.
|
||||
All you need is to run your own Darknet Lantern instance, and to join the Webring as a new participant.
|
||||
|
||||
|
||||
As detailed above, this project aims to gain traction over time as more and more people join the webring, so that a decentralized ecosystem can be formed accross online communities.
|
||||
## How can I setup my own Darknet Lantern ?
|
||||
We'll first cover how you can run your own Darknet Lantern instance, In short you'll need the latest debian (which is debian 12 currently), Tor, php8, python and a few python libraries that you'll install via the apt package manager.
|
||||
|
||||
1) run your own darknet-onion-webring instance as detailed below
|
||||
|
||||
1.2) Once you have a working webring instance spun up, make a 240x60 banner image like the one i made below, and upload it into the www/img/ folder:
|
||||
|
||||
|
||||
## How to join the Darknet Lantern Webring ?
|
||||
|
||||
1.3) Once done, you can add a line in the webring.php page like so:
|
||||
As detailed above, this project aims to gain traction over time as more and more people join the webring, so that a decentralized, peer to peer, anonymous search engine can be formed accross multiple communities.
|
||||
|
||||
0) git clone the repository in your directory of choice:
|
||||
```sh
|
||||
<a href="http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion"><img src="img/nowhere-banner.png" class="banner"></a>
|
||||
<a href="http://uptime.wdawadwdadwawaddawdawdwawadwdadwwp5dawdwadawdawadwdwaadw.onion"><img src="img/yournew-banner.png" class="banner"></a>
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ apt install tor git torsocks -y
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ torsocks git clone http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/darknet-lantern /srv/darknet-lantern
|
||||
|
||||
```
|
||||
1) Install nginx and php8.2-fpm
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ apt install php8.2-fpm nginx -y
|
||||
```
|
||||
|
||||
2) use the nginx.conf and drop it in /etc/nginx/sites-available/
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ ls
|
||||
nginx.conf README.md scripts todo.txt torrc www
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ cp nginx.conf /etc/nginx/sites-available/uptime.conf
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ vim /etc/nginx/sites-available/uptime.conf
|
||||
```
|
||||
3) use [mkp244o](http://blog.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/opsec/torwebsite/index.html) if you want to have a custom vanity v3 hidden service domain name
|
||||
|
||||
4) use the torrc config to have a local socks5 port (as it will be used by the python script to check the uptime of the listed onion links)
|
||||
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ vim /etc/tor/torrc
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ cat /etc/tor/torrc
|
||||
|
||||
HiddenServiceDir /var/lib/tor/onions/nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/
|
||||
HiddenServicePort 80 127.0.0.1:4443
|
||||
SocksPort 127.0.0.1:9050
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ systemctl restart tor@default
|
||||
|
||||
```
|
||||
5) enable the nginx config and validate that it can be accessed on Tor
|
||||
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ ln -s /etc/nginx/sites-available/uptime.conf /etc/nginx/sites-enabled/
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ nginx -s reload
|
||||
|
||||
6) install the python script dependencies:
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ apt install python3-pandas python3-requests python3-socks
|
||||
|
||||
```
|
||||
|
||||
7) test if the uptimechecker python script works, it should output the following:
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/24 ] [/srv/darknet-lantern]
|
||||
→ python3 scripts/uptimechecker.py
|
||||
[+] ONION UPTIME CHECKER
|
||||
[+] Reading the CSV File: /srv/darknet-lantern/www/links/webring.csv
|
||||
[+] Checking if each .onion link is reachable:
|
||||
[+] Editing the uptime score
|
||||
0
|
||||
[+] http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion 200
|
||||
http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion ✔️
|
||||
[+] Reading the CSV File: /srv/darknet-lantern/www/links/Exchanges.csv
|
||||
[+] Checking if each .onion link is reachable:
|
||||
[+] Editing the uptime score
|
||||
0
|
||||
http://exchanger.infinityjs5qob5euyao745kp5x2hh4xquh7qs5cze3kcxv63xdwxlad.onion/ ❌
|
||||
[+] Editing the uptime score
|
||||
1
|
||||
[+] http://robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion/ 200
|
||||
http://robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion/ ✔️
|
||||
[+] Editing the uptime score
|
||||
2
|
||||
|
||||
```
|
||||
|
||||
8) make sure the cronjob for scripts/uptimechecker.py is running at least once every 3 hours so that the csv files are automatically kept up to date.
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
|
||||
→ crontab -e
|
||||
|
||||
*/3 0 * * * python3 /srv/darknet-lantern/scripts/uptimechecker.py
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
## OLD (for archival purposes)
|
||||
1) run your own darknet-lantern instance as detailed below
|
||||
|
||||
|
||||
```
|
||||
|
||||
|
|
@ -65,99 +171,4 @@ As detailed above, this project aims to gain traction over time as more and more
|
|||
|
||||
|
||||
## How to run your own Darknet Onion Webring instance ?
|
||||
0) git clone the repository in your directory of choice:
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ apt install tor git torsocks -y
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ torsocks git clone http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/darknet-onion-webring /srv/darknet-onion-webring
|
||||
|
||||
```
|
||||
1) Install nginx and php8.2-fpm
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ apt install php8.2-fpm nginx -y
|
||||
```
|
||||
|
||||
2) use the nginx.conf and drop it in /etc/nginx/sites-available/
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ ls
|
||||
nginx.conf README.md scripts todo.txt torrc www
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ cp nginx.conf /etc/nginx/sites-available/uptime.conf
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ vim /etc/nginx/sites-available/uptime.conf
|
||||
```
|
||||
3) use [mkp244o](http://blog.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/opsec/torwebsite/index.html) if you want to have a custom vanity v3 hidden service domain name
|
||||
|
||||
4) use the torrc config to have a local socks5 port (as it will be used by the python script to check the uptime of the listed onion links)
|
||||
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ vim /etc/tor/torrc
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ cat /etc/tor/torrc
|
||||
|
||||
HiddenServiceDir /var/lib/tor/onions/nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/
|
||||
HiddenServicePort 80 127.0.0.1:4443
|
||||
SocksPort 127.0.0.1:9050
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ systemctl restart tor@default
|
||||
|
||||
```
|
||||
5) enable the nginx config and validate that it can be accessed on Tor
|
||||
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ ln -s /etc/nginx/sites-available/uptime.conf /etc/nginx/sites-enabled/
|
||||
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ nginx -s reload
|
||||
|
||||
6) install the python script dependencies:
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ apt install python3-pandas python3-requests python3-socks
|
||||
|
||||
```
|
||||
|
||||
7) test if the uptimechecker python script works, it should output the following:
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/24 ] [/srv/darknet-onion-webring]
|
||||
→ python3 scripts/uptimechecker.py
|
||||
[+] ONION UPTIME CHECKER
|
||||
[+] Reading the CSV File: /srv/darknet-onion-webring/www/links/webring.csv
|
||||
[+] Checking if each .onion link is reachable:
|
||||
[+] Editing the uptime score
|
||||
0
|
||||
[+] http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion 200
|
||||
http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion ✔️
|
||||
[+] Reading the CSV File: /srv/darknet-onion-webring/www/links/Exchanges.csv
|
||||
[+] Checking if each .onion link is reachable:
|
||||
[+] Editing the uptime score
|
||||
0
|
||||
http://exchanger.infinityjs5qob5euyao745kp5x2hh4xquh7qs5cze3kcxv63xdwxlad.onion/ ❌
|
||||
[+] Editing the uptime score
|
||||
1
|
||||
[+] http://robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion/ 200
|
||||
http://robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion/ ✔️
|
||||
[+] Editing the uptime score
|
||||
2
|
||||
|
||||
```
|
||||
|
||||
8) make sure the cronjob for scripts/uptimechecker.py is running at least once every 3 hours so that the csv files are automatically kept up to date.
|
||||
```sh
|
||||
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-onion-webring]
|
||||
→ crontab -e
|
||||
|
||||
*/3 0 * * * python3 /srv/darknet-onion-webring/scripts/uptimechecker.py
|
||||
```
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue