https://github.com/red-life/filternet-checker

Filternet domain checker using ISPs' dns servers
https://github.com/red-life/filternet-checker

Last synced: about 1 month ago
JSON representation

Filternet domain checker using ISPs' dns servers

• Host: GitHub
• URL: https://github.com/red-life/filternet-checker
• Owner: red-life
• License: mit
• Created: 2023-09-05T20:13:23.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-09-07T23:41:30.000Z (over 1 year ago)
• Last Synced: 2023-09-08T01:10:06.901Z (over 1 year ago)
• Language: Go
• Size: 7.81 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Filternet Checker

A simple CLI application for checking whether provided domains are censored or not.

## Usage

You just need to provide a configuration file that contains DNS resolvers of different ISPs and a list of domains to check.

1. First of all, you have to build the app. \

`go mod download && go build . -o filternet`

2. Make your own configuration file or use the default configuration

3. Provide some domains and check them.\

`./filternet -domain youtube.com,whatsapp.com -config default.json`

```

$ ./filternet -help

Usage of ./filternet:

  -config string

    	Config file path which contains resolvers (default "default.json")

  -domains string

    	Domains to check. Separated with, (default "twitter.com,instagram.com,facebook.com")

  -no-color

    	Disable color output

```

## Configuration file

Currently, DNS-over-UDP and DNS-over-HTTPS resolvers are supported.\

Each resolver object must have `name` and `servers` keys. 

- `name`: Name of the provider.

- `servers`: list of resolvers. Note that UDP addresses must contain a port and HTTPS addresses must start with `https://`

***Examples are available in the `default.json` file.***