From 6dd04a41f3dc615d73ec6172c0323569faacb624 Mon Sep 17 00:00:00 2001 From: nihilist Date: Tue, 21 Jan 2025 08:38:54 +0100 Subject: [PATCH] WIP documentation --- README.md | 55 +++++++++++++++---- .../{darknet_exploration.py => lantern.py} | 0 2 files changed, 43 insertions(+), 12 deletions(-) rename scripts/{darknet_exploration.py => lantern.py} (100%) diff --git a/README.md b/README.md index f6840fa..f81d5c5 100644 --- a/README.md +++ b/README.md @@ -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 +``` diff --git a/scripts/darknet_exploration.py b/scripts/lantern.py similarity index 100% rename from scripts/darknet_exploration.py rename to scripts/lantern.py