mirror of
http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/darknet-lantern.git
synced 2025-05-16 20:26:58 +00:00
updated readme, still wip
This commit is contained in:
nihilist
parent
a73dbe5e08
commit
696a03b1b1
1 changed files with 127 additions and 38 deletions
165
README.md
165
README.md
|
|
@ -302,7 +302,7 @@ It may take a few minutes depending on the size of your list of links to check a
|
|||
## 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.
|
||||
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, to speed up the exploration of the Darknet at large.
|
||||
|
||||
## What is the default trust model ?
|
||||
|
||||
|
|
@ -310,8 +310,9 @@ When spinning up your own Darknet Lantern instance, you are automatically creati
|
|||
|
||||
By default, as they are in the templates/ directory, the verified.csv and unverified.csv files are empty as you shouldn't trust random links that other people are trusting, you should verify them yourself one by one, to make sure that they aren't malicious.
|
||||
|
||||
That is why by default, when you first setup your own lantern instance, you are not listing anything, nor trusting any links, nor trusting any webring participants. This is a safety measure by default to avoid vector of abuse.
|
||||
That is why by default, when you first setup your own lantern instance, you are not listing anything, nor trusting any links, nor trusting any webring participants. This is a safety measure by default to avoid vectors of abuse.
|
||||
|
||||
If you choose to do so, you can trust another webring participant, which means that in turn you'll automatically trust the links that they are trusting. But be warned that this is potentially dangerous in case if it turns out that they start to trust malicious links later down the line.
|
||||
|
||||
## What is the lifecycle of a Lantern instance ?
|
||||
|
||||
|
|
@ -319,40 +320,151 @@ At first, you have an empty Lantern, no links listed, no links trusted, no webri
|
|||
|
||||
If you want to go your own way to explore the darknet yourself, you can start to list links yourself, into the unverified.csv file, and later on once you browse them enough to verify their authenticity, you may choose to trust them, to move them from unverified.csv to verified.csv
|
||||
|
||||
If you want to avoid doing the same work that other webring participants may have already done, you may choose to synchronize with their lists of links, and to add the ones that you didn't list yet into your own unverified.csv file. That way you'll be able to start exploring the Darknet starting from where others's progress.
|
||||
If you want to avoid doing the same work that other webring participants may have already done, you may choose to synchronize with their lists of links, and to add the links that you didn't list yet into your own unverified.csv file. That way you'll be able to start exploring the Darknet starting from where others left off.
|
||||
|
||||
After a while of adding new links and verifying them, you may choose to trust another webring participant's list of links, to automatically add their verified links into your own verified.csv file. However be warned that this is risky due to the fact that you may inadvertently trust malicious links.
|
||||
After a while of adding new links and verifying them, you may choose to trust another webring participant's list of links, to automatically add their verified links into your own verified.csv file. However as stated above be warned that this is risky due to the fact that you may inadvertently trust malicious links because of that other peer.
|
||||
|
||||
## What if there are malicious Lantern Instances ?
|
||||
|
||||
As stated above, it is possible that there will be malicious Lantern instances, meaning that you may have malicious peers that start to list some extremely illegal websites into their verified.csv file. This is why by default you are not trusting any Lantern webring participant, nor any links.
|
||||
|
||||
This is also the reason why there is a blacklist.csv file. That way, if there are any malicious keywords or links to be found, they will be immediately deleted. I for instance, refuse to list any porn sites and i encourage you to do the same, as those can link to some extremely illegal content, that you definitely don't want to get associated with.
|
||||
This is also the reason why there is a blacklist.csv file. That way, if there are any malicious keywords or links to be found, they will be immediately deleted. I for instance, refuse to list any porn sites or list any instance that lists porn websites, and i encourage you to do the same (hence the blacklist.csv file containing those words by default), as those can link to some extremely illegal content that you definitely don't want to get associated with.
|
||||
|
||||
Using the blacklist.csv file you can list blacklisted words or links that will automatically be removed if encountered by the python scripts.
|
||||
Using the blacklist.csv file you can list blacklisted words, links and even links to blacklisted webring participants, that will automatically be removed if encountered by the python scripts.
|
||||
|
||||
## When should I mark websites as sensitive ?
|
||||
|
||||
In order to avoid putting all eggs in one basket, i recommend marking websites that are related to Drugs (as this is the most popular sensitive darknet topic) as sensitive whenever you add them into your unverified.csv file.
|
||||
In order to avoid putting all eggs in one basket, i recommend marking websites that are related to Drugs (as this is the most popular sensitive darknet topic) as sensitive whenever you add them into your unverified.csv file, that way you can give your audience a safe browsing searching experience, and an opt-in sensitive browsing search experience (with ample disclaimers/warnings) if they choose to do so.
|
||||
|
||||
There is also a sensitive.csv file in your instance directory to list those keywords, so that they get automatically marked as sensitive by the python scripts.
|
||||
|
||||
## How can I add more links ?
|
||||
|
||||
Use the scripts/lantern.py to do the following:
|
||||
```sh
|
||||
```
|
||||
|
||||
## How can I verify links ?
|
||||
|
||||
Use the scripts/lantern.py to do the following:
|
||||
To Verify links (meaning that you are moving links from your unverified.csv file into your verified.csv file), use scripts/lantern.py to do the following:
|
||||
```sh
|
||||
|
||||
[ Wonderland ] [ /dev/pts/33 ] [/srv/darknet-lantern]
|
||||
→ python3 scripts/lantern.py
|
||||
[+] Instance Name: lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion True
|
||||
[+] file exists, your Webring URL is lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
[+] Welcome to your own Darknet Lantern Instance, where you can explore the Darknet and help others do the same.
|
||||
|
||||
Managing Websites:
|
||||
1) Add a new Website entry (into unverified.csv)
|
||||
2) Trust a Website entry (move an entry from unverified to verified.csv)
|
||||
3) Untrust a Website entry (move an entry from unverified to verified.csv)
|
||||
|
||||
Managing Webring Participants:
|
||||
4) Synchronize new links from existing webring participants, into your unverified.csv file
|
||||
5) Add a new webring participant (and download their files into their directory (without trusting them yet!))
|
||||
6) Trust/UnTrust/Blacklist a webring participant (Potentially dangerous)
|
||||
|
||||
Managing Wordlists:
|
||||
7) Add/Remove Words/URLs in the sensitive list (ex: drug)
|
||||
8) Add/Remove Words/URLs or links in the blacklist (ex: porn)
|
||||
|
||||
Maintenance:
|
||||
9) Remove the duplicate URLs for your own instance
|
||||
10) Perform sanity checks on all csv files for all instances (to mark them as sensitive / or remove the ones that are blacklisted)
|
||||
|
||||
0) Exit
|
||||
|
||||
Select Option? (0-11): 2
|
||||
2
|
||||
[+] Trust a Website entry (move an entry from unverified to verified.csv)
|
||||
Name URL
|
||||
0 Houdini Swap https://houdiniswap.com/
|
||||
1 xchange me http://xmxmrjoqo63c5notr2ds2t3pdpsg4ysqqe6e6uu...
|
||||
2 Exch http://hszyoqwrcp7cxlxnqmovp6vjvmnwj33g4wviuxq...
|
||||
3 Magestic Bank http://majestictfvnfjgo5hqvmuzynak4kjl5tjs3j5z...
|
||||
4 Infinity https://exchanger.infinity.taxi/
|
||||
.. ... ...
|
||||
78 AirVPN https://airvpn3epnw2fnsbx5x2ppzjs6vxtdarldas7w...
|
||||
79 Orange Website https://orangewebsite.com/
|
||||
80 UDN http://ax3zoslh2ujdq3joyibdn657mhjfxjm637vxiix...
|
||||
81 My Nym Box https://mynymbox.io/
|
||||
82 SporeStack http://spore64i5sofqlfz5gq2ju4msgzojjwifls7rok...
|
||||
|
||||
[83 rows x 2 columns]
|
||||
What is the Website name you want to trust ? (ex: Nowhere)Qubes
|
||||
Name URL
|
||||
72 Qubes OS Website http://qubesosfasa4zl44o4tws22di6kepyzfeqv3tg4...
|
||||
What is the index of the entry that you want to move to verified.csv ? (ex: 3) 72
|
||||
['lantern.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion'
|
||||
'Tools' 'Qubes OS Website'
|
||||
'http://qubesosfasa4zl44o4tws22di6kepyzfeqv3tg4e3ztknltfxqrymdad.onion/'
|
||||
'❌'
|
||||
'OS based on Xen that focuses on compartmentalization and virtualization.'
|
||||
'✔️' 100.0]
|
||||
[+] New row added to verified.csv! now writing to the csv
|
||||
[+] Link is now moved to verified.csv!
|
||||
|
||||
[+] Want to trust another website ? (y/n) n
|
||||
|
||||
```
|
||||
|
||||
## How can I Synchronize new links from the existing webring participants ?
|
||||
Option 4 in scripts/lantern.py will synchronize the links you didn't list yet in your own unverified.csv or verified.csv files from other peers whose directory exist in www/participants/
|
||||
|
||||
```sh
|
||||
Select Option? (0-11): 4
|
||||
4
|
||||
4) Synchronize new links from existing webring participants, into your unverified.csv file
|
||||
http://lantern.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion/participants/lantern.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion/
|
||||
[+] Downloading the files of lantern.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion :
|
||||
[+] Webring Participant is reachable, updating their csv files:
|
||||
/srv/darknet-lantern/www/participants/lantern.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion/verified.csv
|
||||
['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'Blogs', 'Hackliberty Writers', 'http://lvgjoige2hl5qm5xcxhxuulyhdnq2wk3277eu34zpukxvacmvwva6vid.onion/read', '❌', nan, '✔️', 100.0]
|
||||
[-] Skipping row as it is already added in verified.csv ['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'Blogs', 'Hackliberty Writers', 'http://lvgjoige2hl5qm5xcxhxuulyhdnq2wk3277eu34zpukxvacmvwva6vid.onion/read', '❌', nan, '✔️', 100.0]
|
||||
[-] Rows to delete: []
|
||||
['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'Blogs', 'The Nihilism Blog', 'http://blog.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/', '❌', nan, '❌', 99.0]
|
||||
[-] Skipping row as it is already added in verified.csv ['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'Blogs', 'The Nihilism Blog', 'http://blog.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/', '❌', nan, '❌', 99.0]
|
||||
[-] Rows to delete: []
|
||||
['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'Chat', 'SimpleX Chat', 'https://simplex.chat/', '❌', nan, '✔️', 100.0]
|
||||
[-] Skipping row as it is already added in verified.csv ['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'Chat', 'SimpleX Chat', 'https://simplex.chat/', '❌', nan, '✔️', 100.0]
|
||||
[-] Rows to delete: []
|
||||
|
||||
[...]
|
||||
|
||||
['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'VPS', 'UDN', 'http://ax3zoslh2ujdq3joyibdn657mhjfxjm637vxiix7iilxnfbsabces4qd.onion/', '❌', nan, '✔️', 100.0]
|
||||
[-] Skipping row as it is already added in unverified.csv ['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'VPS', 'UDN', 'http://ax3zoslh2ujdq3joyibdn657mhjfxjm637vxiix7iilxnfbsabces4qd.onion/', '❌', nan, '✔️', 100.0]
|
||||
[-] Rows to delete: []
|
||||
['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'VPS', 'SporeStack', 'http://spore64i5sofqlfz5gq2ju4msgzojjwifls7rok2cti624zyq3fcelad.onion/', '❌', nan, '✔️', 100.0]
|
||||
[-] Skipping row as it is already added in unverified.csv ['webring.nowhevi57f4lxxd6db43miewcsgtovakbh6v5f52ci7csc2yjzy5rnid.onion', 'VPS', 'SporeStack', 'http://spore64i5sofqlfz5gq2ju4msgzojjwifls7rok2cti624zyq3fcelad.onion/', '❌', nan, '✔️', 100.0]
|
||||
[-] Rows to delete: []
|
||||
|
||||
```
|
||||
|
||||
## TODO: How can I add a new webring participant ?
|
||||
TODO: check with someone that wants to run a lantern instance, and list their own instance from your own
|
||||
```sh
|
||||
```
|
||||
|
||||
## How can I edit the wordlists ?
|
||||
## TODO: How can I officially get listed as a webring participant on the git repository ?
|
||||
TODO: ping me directly on SimpleX to get your lantern instance listed on my own 2 instances, and if after checking it is OK to get added (meaning you don't have any porn links listed) i'll push a git commit with the updated files.
|
||||
```sh
|
||||
```
|
||||
|
||||
## How can I officially get listed as a trusted webring participant on the git repository ?
|
||||
I officially won't officially trust any webring participant. Instead i will leave it up to whoever wants to run that risk themselves. I prefer to only manually approve new webring participants on my own, because if i try to let it loose and automate it, many blacklisted links may end up listed inadvertently.
|
||||
|
||||
## TODO: How can I trust / untrust / blacklist a webring participant ?
|
||||
```sh
|
||||
```
|
||||
|
||||
|
||||
## TODO: How can I edit the sensitive.csv and blacklist.csv wordlists ?
|
||||
```sh
|
||||
```
|
||||
|
||||
Use the scripts/lantern.py to do the following:
|
||||
```sh
|
||||
|
||||
```
|
||||
|
||||
```sh
|
||||
|
|
@ -361,27 +473,4 @@ Use the scripts/lantern.py to do the following:
|
|||
|
||||
|
||||
|
||||
## OLD (for archival purposes)
|
||||
1) run your own darknet-lantern instance as detailed below
|
||||
|
||||
|
||||
```
|
||||
|
||||
2) As you keep on exploring the darknet, make sure you list the new onion links you find in the CSV files that are in www/links/, (i like to keep them separated in categories, so that they can be displayed in groups in the php pages afterward.)
|
||||
|
||||
<u>Option A:</u>
|
||||
|
||||
3) If you want to contribute your findings to the master repository that i'm running, just [ping me directly on simplex](https://simplex.chat/contact#/?v=2-5&smp=smp%3A%2F%2F1OwYGt-yqOfe2IyVHhxz3ohqo3aCCMjtB-8wn4X_aoY%3D%40smp11.simplex.im%2FsM96T2YMg4As7FiVoUVEttBgZQVPxWnb%23%2F%3Fv%3D1-2%26dh%3DMCowBQYDK2VuAyEAsKONXcyHAFEd79i13QZf8vDRUU5dVgQKQqUy_0S7ay4%253D%26srv%3D6ioorbm6i3yxmuoezrhjk6f6qgkc4syabh7m3so74xunb5nzr4pwgfqd.onion) so that i can create you a gitea account first
|
||||
|
||||
4) Then create a pull request so that i can add your own links (AND the link to your list of links too in the index.php page) to the git repo directly. (**Please make sure you are keeping the sensitive websites in the same page, so the risk-based separation is kept (non-sensitive websites / sensitive websites))**
|
||||
|
||||
<u>Option B:</u>
|
||||
|
||||
3) If you want to go your own way just let us know that you're running your own list of onion links in the [Darknet Exploration SimpleX Chatroom](https://simplex.chat/contact#/?v=2-7&smp=smp%3A%2F%2FL5jrGV2L_Bb20Oj0aE4Gn-m5AHet9XdpYDotiqpcpGc%3D%40nowhere.moe%2FDkWtBNDdIPVjaap5trLwtmBBEUjyqxSZ%23%2F%3Fv%3D1-3%26dh%3DMCowBQYDK2VuAyEAcQLIsWEJ0xCv9sMSYVQV_sfMTkK_pisAtN55jgH08T8%253D%26srv%3Dt3srl5etd5y7nfvamlkdsjmm2okfu7db2jp4crxvf3tkwo42odme3kid.onion&data=%7B%22groupLinkId%22%3A%22iK4_U76rW6AdmZZfgVDDVQ%3D%3D%22%7D) so that we can add the link to your list of links in our own.
|
||||
|
||||
|
||||
4) make sure you spread awareness of the darknet onion webring on darknet forums (there's [dread](http://g66ol3eb5ujdckzqqfmjsbpdjufmjd5nsgdipvxmsh7rckzlhywlzlqd.onion/) for example)
|
||||
|
||||
|
||||
## How to run your own Darknet Onion Webring instance ?
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue