Awesome hiddify_reality_scanner created by hiddify
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file hiddify_reality_scanner-1.6.8.tar.gz
.
File metadata
- Download URL: hiddify_reality_scanner-1.6.8.tar.gz
- Upload date:
- Size: 10.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 71ca361934111003d2076e6c3d84426ad3ad8dbb7740abc1778ceaa31f172ca1 |
|
MD5 | b9024aa10da5a17b65fa48b767a38dcd |
|
BLAKE2b-256 | 72273f90d15c257a49c2a6f49fe262802e95a1a148de628b37abdf0a5046fcf0 |
File details
Details for the file hiddify_reality_scanner-1.6.8-py3-none-any.whl
.
File metadata
- Download URL: hiddify_reality_scanner-1.6.8-py3-none-any.whl
- Upload date:
- Size: 9.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6e784d2ea2152d4d92777dbf421ba8d5ecbdb117525051249abb0d17a5a7a67 |
|
MD5 | 6ddf63567d6c49240c5c3613b0c0a3dd |
|
BLAKE2b-256 | 098c520ed6f335850aabbe00d4b113a8b4ad23ab6a869f8649e80c33ae3fe3ba |