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 #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
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
Hashes for hiddify_reality_scanner-1.8.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d64113eac8e33111e5772a504f77723f93d3f9e72de54026d6839e6ff8ddc67e |
|
MD5 | 3f131bdb22711ccf57bc2937893926e9 |
|
BLAKE2b-256 | 4f9a00bb87e550a9e09d345407d4593ae12ee926877b6381d916e1b1f3e48224 |
Hashes for hiddify_reality_scanner-1.8.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bac99087611de13243ca31842d8dbe81ab748aebdef68ee5f62b709123199558 |
|
MD5 | db24a149783ed7e730134043a77298f1 |
|
BLAKE2b-256 | 144a69f40a4a8e8639b2b8f492482f5501a24e460869b784f5ac6ba4a7066bce |