https://github.com/vernette/censorcheck
🔒 A bash script that checks website accessibility under DPI censorship and geo-restriction systems
https://github.com/vernette/censorcheck
bash censorship-circumvention curl dpi geoblock linux
Last synced: about 2 months ago
JSON representation
🔒 A bash script that checks website accessibility under DPI censorship and geo-restriction systems
- Host: GitHub
- URL: https://github.com/vernette/censorcheck
- Owner: vernette
- License: mit
- Created: 2025-04-19T12:17:42.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2025-04-27T10:01:07.000Z (about 2 months ago)
- Last Synced: 2025-04-27T11:18:43.193Z (about 2 months ago)
- Topics: bash, censorship-circumvention, curl, dpi, geoblock, linux
- Language: Shell
- Homepage:
- Size: 35.2 KB
- Stars: 12
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# censorcheck
A bash script for checking the accessibility of websites potentially affected by Deep Packet Inspection (DPI) blocking or geographic restrictions.
## Important note about status codes
> [!WARNING]
> Some websites may not return expected status codes due to various security measures
- Sites like [chatgpt.com](https://chatgpt.com), [claude.ai](https://claude.ai) consistently return `403` status due to JavaScript verification checks, even when accessed from unrestricted locations
- Sites like [intel.com](https://intel.com) may return `200` status but still display blocking notifications in the actual content
- Results should be verified manually when behavior seems inconsistent with your actual location
## Features
- Tests both HTTP and HTTPS protocols for each domain
- Detects different access scenarios: available, blocked, redirected, or access denied
- Includes predefined lists of commonly DPI-blocked and geo-restricted websites
- Supports custom domain lists via file input
- Configurable connection timeout and retry parameters
- Color-coded output for easy readability
## Included Domain Lists
The script contains predefined lists of websites commonly affected by:
- **DPI Blocking**: Includes social media, video platforms, and other commonly restricted services
- **Geographic Restrictions**: Popular streaming services and platforms that implement geo-blocking
## Dependencies
- bash
- curl
- nslookup
## Usage
### Run directly
Basic usage:
```bash
bash <(wget -qO- https://github.com/vernette/censorcheck/raw/master/censorcheck.sh)
```
Check only DPI-blocked sites
```bash
bash <(wget -qO- https://github.com/vernette/censorcheck/raw/master/censorcheck.sh) --mode dpi
```
Use custom User-Agent
```bash
bash <(wget -qO- https://github.com/vernette/censorcheck/raw/master/censorcheck.sh) --user-agent "CustomAgent/2.0"
```
Check domains from a local file with 10 second timeout
```bash
bash <(wget -qO- https://github.com/vernette/censorcheck/raw/master/censorcheck.sh) --file ~/my-domains.txt --timeout 10
```
### Local usage
Download and run locally:
```bash
wget https://github.com/vernette/censorcheck/raw/master/censorcheck.sh
chmod +x censorcheck.sh
# Basic run
./censorcheck.sh
# Run with parameters
./censorcheck.sh --mode geoblock
./censorcheck.sh --mode dpi --timeout 10 --retries 3
./censorcheck.sh --file custom-domains.txt
```
## Options
```
Usage: censorcheck.sh [OPTIONS]
Checks accessibility of websites that might be blocked by DPI or geolocation restrictions
Options:
-h, --help Display this help message and exit
-m, --mode Set checking mode: 'dpi', 'geoblock', or 'both' (default: both)
-t, --timeout Set connection timeout in seconds (default: 5)
-r, --retries Set number of connection retries (default: 2)
-u, --user-agent Set custom User-Agent string (default: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:129.0) Gecko/20100101 Firefox/129.0)
-f, --file Read domains from specified file instead of using built-in lists
-6, --ipv6 Use IPv6 (default: IPv4)
Examples:
censorcheck.sh # Check all predefined domains with default settings
censorcheck.sh --mode dpi # Check only DPI-blocked sites
censorcheck.sh --timeout 10 --retries 3 # Use longer timeout and more retries
censorcheck.sh --user-agent "MyAgent/1.0" # Use custom User-Agent
censorcheck.sh --file my-domains.txt # Check domains from custom file
censorcheck.sh --ipv6 # Use IPv6 instead of IPv4
The domain file should contain one domain per line. Lines starting with # are ignored
```
## Custom domain list
You can check your own list of domains by creating a text file with one domain per line:
```
# My custom domains to check
example.com
test-site.net
# Commented lines are ignored
another-domain.org
# Empty lines are also ignored
```
Then run the script with:
```bash
./censorcheck.sh --file my-domains.txt
```
## Test results
The script provides color-coded results for each domain:
- **Green**: Site is available (HTTP 200)
- **Red**: Site is blocked, unreachable, or access denied (HTTP 403)
- **Blue**: Site redirects to another URL
- **Orange**: Other HTTP status codes
## Contributing
Contributions are welcome! Feel free to submit pull requests to add new domains to the predefined lists or improve the script's functionality.
## TODO
- [ ] DNS spoofing detection by ISP or hosting provider
- [ ] Results table
- [ ] JSON output
- [ ] Debug mode