Skip to main content

Awesome hiddify_reality_scanner created by hiddify

Project description

Lang_farsi  فارسی          


Hiddify Logo

Hiddify Reality Scanner

This is a TLS scanner that finds the best Reality SNI for you based on a list of SNIs. For more information about development, you can read through our Contribution Guidelines .

⚙️ Installation

The installation of this scanner has 2 parts. The first part is a server-side application and the 2nd part is client-side.

🛠️ Server-side Installation

  • First you need to install our custom Xray core on the server using the following command:
#remove old xray
bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ remove

systemctl stop hiddify-xray

#install hiddify custom xray
bash -c "$(curl -L https://github.com/hiddify/Xray-core-custom/raw/main/install-release.sh)" @ install
  • Now you should create a config with empty nameserver in your panel or add the following config:
curl -o server_config.json https://raw.githubusercontent.com/hiddify/Hiddify_Reality_Scanner/main/server_config.json

echo "---------------IPV6---------"
echo "vless://hiddify@$(curl -6 ip.sb):11443/?fp=chrome&security=reality&pbk=Z84J2IelR9ch3k8VtlVhhs5ycBUlXA7wHBWcBrjqnAw&sid=6ba85179e30d4fc2&sni=www.google.com&type=tcp&flow=xtls-rprx-vision&encryption=none#Hiddify"

echo "---------------IPV4---------"
echo "vless://hiddify@$(curl -4 ip.sb):11443/?fp=chrome&security=reality&pbk=Z84J2IelR9ch3k8VtlVhhs5ycBUlXA7wHBWcBrjqnAw&sid=6ba85179e30d4fc2&sni=www.google.com&type=tcp&flow=xtls-rprx-vision&encryption=none#Hiddify"

  • Then you need to run the config via Xray like the command below. This will create a temporary Xray server for you :
xray run -c server_config.json
  • You can use your Reality config like the the following link:
vless://hiddify@SERVER_IP:11443/?fp=chrome&security=reality&pbk=Z84J2IelR9ch3k8VtlVhhs5ycBUlXA7wHBWcBrjqnAw&sid=6ba85179e30d4fc2&sni=www.yahoo.com&type=tcp&flow=xtls-rprx-vision&encryption=none#Hiddify

🛠️ Client-side Installation

For client-side, you just need to use Pypi and run the following command:

pip install -U hiddify_reality_scanner

🚀 Basic Usage

In order to run the scanner, use one of the following commands on your client:

python -m hiddify_reality_scanner "vless_link"
#or
hiddify_reality_scanner "vless_link"

🚀 Advanced Usage

  • If you want to consider more items when scanning, use the following command on your client:
hiddify_reality_scanner --jobs 10 --sni yahoo.com,google.com "vless_link"
  • Here:

    • --jobs defines the number of concurrent scans.
    • --sni defines the desired SNIs for scanning.
  • If you want to add a list of SNIs, use the following command

hiddify_reality_scanner --jobs 10 --sni path_to_the_list vless_link
  • Here:
    • --jobs defines the number of concurrent scans.
    • --sni path_to_the_list desines the path for the list of SNIs.

Note: during the scan, if you want to intrupt it, you can simply use ctrl+c .

📊 Results

The results will be stored in results-list.txt and results-list.json on your client. You can use these SNIs as a Reality domain in your server. How to add relaity domain on Hiddify Manager

Note: If you have installed server-side scanner on your Hiddify Manager; You need to run the following command after finishing the scan:

systemctl start hiddify-xray

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hiddify_reality_scanner-1.6.8.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

hiddify_reality_scanner-1.6.8-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file hiddify_reality_scanner-1.6.8.tar.gz.

File metadata

File hashes

Hashes for hiddify_reality_scanner-1.6.8.tar.gz
Algorithm Hash digest
SHA256 71ca361934111003d2076e6c3d84426ad3ad8dbb7740abc1778ceaa31f172ca1
MD5 b9024aa10da5a17b65fa48b767a38dcd
BLAKE2b-256 72273f90d15c257a49c2a6f49fe262802e95a1a148de628b37abdf0a5046fcf0

See more details on using hashes here.

File details

Details for the file hiddify_reality_scanner-1.6.8-py3-none-any.whl.

File metadata

File hashes

Hashes for hiddify_reality_scanner-1.6.8-py3-none-any.whl
Algorithm Hash digest
SHA256 a6e784d2ea2152d4d92777dbf421ba8d5ecbdb117525051249abb0d17a5a7a67
MD5 6ddf63567d6c49240c5c3613b0c0a3dd
BLAKE2b-256 098c520ed6f335850aabbe00d4b113a8b4ad23ab6a869f8649e80c33ae3fe3ba

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page