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 #only if you have hiddify manager and hiddify panel

#install hiddify custom xray
bash -c "$(curl -L https://github.com/hiddify/Xray-core-custom/raw/main/install-release.sh)" @ install

systemctl start hiddify-xray #only if you have hiddify manager and hiddify panel
  • 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 you need to insall python first, then use one of the following commands on your client:

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

Be careful that instead of `vless_link' you have to replace it with your Reality config.

🚀 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.
    • --limit limit the number of working SNI.
  • If you want to add a list of SNIs, use the following command

hiddify_reality_scanner --jobs 10 --limit 100 --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.
    • --limit 100 desines the 100 limit for the working 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 Reality 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.8.0.tar.gz (11.2 kB view details)

Uploaded Source

Built Distribution

hiddify_reality_scanner-1.8.0-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for hiddify_reality_scanner-1.8.0.tar.gz
Algorithm Hash digest
SHA256 d64113eac8e33111e5772a504f77723f93d3f9e72de54026d6839e6ff8ddc67e
MD5 3f131bdb22711ccf57bc2937893926e9
BLAKE2b-256 4f9a00bb87e550a9e09d345407d4593ae12ee926877b6381d916e1b1f3e48224

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for hiddify_reality_scanner-1.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bac99087611de13243ca31842d8dbe81ab748aebdef68ee5f62b709123199558
MD5 db24a149783ed7e730134043a77298f1
BLAKE2b-256 144a69f40a4a8e8639b2b8f492482f5501a24e460869b784f5ac6ba4a7066bce

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