WIP documentation

This commit is contained in:
nihilist 2025-01-21 08:38:54 +01:00
parent 7e765c9c02
commit 6dd04a41f3
2 changed files with 43 additions and 12 deletions

View file

@ -1,4 +1,4 @@
# [Darknet Lantern Project (WIP)](http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/)
# [Darknet Lantern Project (WIP)](http://lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/)
![logo](./www/img/ng-project-large.png)
@ -46,10 +46,6 @@ All you need is to run your own Darknet Lantern instance, and to join the Webrin
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.2-fpm, python and a few python libraries that you'll install via the apt package manager.
## How to join the Darknet Lantern Webring ? (TODO)
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
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
@ -72,10 +68,10 @@ As detailed above, this project aims to gain traction over time as more and more
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
→ cp nginx.conf /etc/nginx/sites-available/lantern.conf
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
→ vim /etc/nginx/sites-available/uptime.conf
→ vim /etc/nginx/sites-available/lantern.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
@ -100,7 +96,7 @@ SocksPort 127.0.0.1:9050
```sh
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
→ ln -s /etc/nginx/sites-available/uptime.conf /etc/nginx/sites-enabled/
→ ln -s /etc/nginx/sites-available/lantern.conf /etc/nginx/sites-enabled/
[ Wonderland ] [ /dev/pts/23 ] [/srv/darknet-lantern]
→ nginx -s reload
@ -112,7 +108,28 @@ SocksPort 127.0.0.1:9050
```
7) test if the uptimechecker python script works, it should output the following:
### TODO
Run scripts/lantern.py to confirm your own instance name
```sh
```
Validate that ~/darknet_participant_url has been created
```sh
[ Wonderland ] [ /dev/pts/2 ] [/srv/darknet-lantern]
→ cat ~/.darknet_participant_url
lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion
```
Run scripts/lantern.py again to start adding websites
```sh
```
```
7) Update the websites' uptime using scripts/uptimechecker.py, it should output the following:
```sh
[ Wonderland ] [ /dev/pts/24 ] [/srv/darknet-lantern]
→ python3 scripts/uptimechecker.py
@ -121,8 +138,8 @@ SocksPort 127.0.0.1:9050
[+] Checking if each .onion link is reachable:
[+] Editing the uptime score
0
[+] http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion 200
http://uptime.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion ✔️
[+] http://lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion 200
http://lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion ✔️
[+] Reading the CSV File: /srv/darknet-lantern/www/links/Exchanges.csv
[+] Checking if each .onion link is reachable:
[+] Editing the uptime score
@ -144,8 +161,11 @@ http://robosats6tkf3eva7x2voqso3a5wcorsnw34jveyxfqi2fu7oyheasid.onion/ ✔️
*/3 0 * * * python3 /srv/darknet-lantern/scripts/uptimechecker.py
```
## can I do the initial setup ?
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.
## What is the default trust model ?
When spinning up your own Darknet Lantern instance, you are automatically creating your instance folder in www/participants/yourinstancehostname.onion/ and in there you'll find a copy of the blank verified.csv, unverified.csv, and webring-participants.csv files, along with the default banner.png file.
@ -181,13 +201,24 @@ There is also a sensitive.csv file in your instance directory to list those keyw
## How can I add more links ?
Use the scripts/darknet_exploration.py to do the following:
Use the scripts/lantern.py to do the following:
```sh
```
## How can I verify links ?
Use the scripts/lantern.py to do the following:
```sh
```
## How can I edit the wordlists ?
Use the scripts/lantern.py to do the following:
```sh
```
```sh
```