snowflake-cli
Snowflake is a system to defeat internet censorship, made by Tor Project.
The system works by volunteers who run the snowflake extension on browser.
Now, with this script, you can host a snowflake relay in another program or run it in CLI mode in a server!
Requirements
pip install -r requirements.txt
- Google Chrome 98
- Chromedriver
- Add Chromedriver to path (or to /usr/bin on linux)
Running snowflake in your program:
It's possible to import snowflake in your program's python code to host snowflake cuncurrently! This is very nice because you can allow users of your software to donate their bandwidth to snowflake's network :)
import snowflake
options = {
'just_run':False, # if true, runs snowflake discretly - without logging and saving data
'save_data':True, # if true, snowflake will save your peers data in database
'get_loc':True, # if true, snowflake will not get peers country and region
'log':True # if true, snowflake will print every log
}
# runs snowflake concurrently in another thread while your main program runs
snowflake.start_run(options)
Running (cli mode)
$ python snowflake.py
Options:
--just-run - Just run snowflake with all options below
--no-persist - Run without storing peer's data
--no-location - Doesn't get IPs locations
--no-logging - Doesn't print anything (just the starting log)
Features
You can watch all peers that conects with you live, store this data with the peer's location to further analisys.
Database Tables Schema
peers
- timestamp (int)
- ip (text)
- country (text)
- region (text)
162 Nov 25, 2022
12 Dec 12, 2022
2 Jan 11, 2022
1 Dec 13, 2021
232 Nov 21, 2022
16 Dec 8, 2022
172 Nov 17, 2022
15 Dec 1, 2022
6 Aug 7, 2021
![[feature] Use Geckodriver](https://avatars.githubusercontent.com/u/26512375?v=4)
12 Jan 06, 2022
1 Nov 10, 2021
41 Nov 09, 2022
15 Dec 22, 2022
5 Jul 19, 2022
123 Dec 19, 2022
130 Dec 29, 2022
112 Nov 25, 2022
16 Dec 19, 2022
16 Nov 15, 2022
2 Jun 01, 2022
5 Apr 04, 2022
112 Dec 01, 2022
10 Jul 28, 2022
12 Nov 22, 2022
8 Dec 20, 2022
1 Jan 24, 2022
7 Sep 30, 2022
6 Mar 10, 2022
6 Jan 22, 2022