ShineNETConfigs
-
Install / Use
/learn @shayanheidari01/ShineNETConfigsREADME
ShineNETConfigs
Automated V2Ray configuration scraper and tester that runs on GitHub Actions to collect, test, and maintain a list of working proxy configurations.
Features
- Scrapes V2Ray configurations from v2nodes.com
- Tests each configuration for connectivity using ping tests
- Automatically updates the configuration list every hour
- Only keeps configurations that pass connectivity tests
- Performs lightweight validation without external V2Ray tooling
How It Works
- Scraping: The script scrapes v2nodes.com for V2Ray configurations (vmess, vless, trojan, ss)
- Downloading: Downloads necessary binaries (xray, core_engine, hysteria)
- Testing: Tests each configuration using ping tests through the core_engine tester
- Filtering: Only configurations that pass the connectivity test are saved
- Updating: The configs.txt file is automatically updated every hour via GitHub Actions
GitHub Actions Workflow
The workflow runs on a schedule (every hour) and performs these steps:
- Checks out the repository
- Sets up Python environment
- Installs dependencies
- Downloads required binaries
- Ensures tester executable is available with the correct platform-specific name
- Runs the scraping and testing script
- Commits and pushes any updates to configs.txt
File Structure
v2ray_mining.py- Main scraping and testing scriptconfigs.txt- List of working configurations (automatically updated).github/workflows/scrape.yml- GitHub Actions workflow
Usage
The repository is designed to run automatically via GitHub Actions. To run locally:
python v2ray_mining.py
Requirements
- Python 3.10+
- requests
- beautifulsoup4
Install dependencies:
pip install requests beautifulsoup4
Configuration
You can modify the following settings in v2ray_mining.py:
BASE_URL- The website to scrape fromPAGES_TO_SCRAPE- Number of pages to scrapeREQUEST_TIMEOUT- Request timeout in seconds
Troubleshooting
If you encounter "Tester executable not found" errors:
- Ensure all binaries are downloaded properly
- Check that the core_engine executable exists in either vendor/ or core_engine/ directories
- Make sure the tester executable has proper execute permissions
- Verify the platform-specific naming (core_engine_linux for Linux, core_engine.exe for Windows)
License
This project is for educational purposes only. Users are responsible for complying with all applicable laws and regulations in their jurisdiction.
