A Python package to manage V2Ray proxy configurations with native extensions.
V2Root provides a Python interface to interact with the V2Ray proxy software using a custom C library (libv2root.dll on Windows, libv2root.so on Linux). It allows users to load configurations, start/stop V2Ray, test connections, and parse VLESS, VMess, and Shadowsocks strings into V2Ray-compatible config files.
- Load and validate V2Ray configuration files
- Start and stop V2Ray processes
- Test server connections with ping and protocol-specific tests
- Parse VLESS, VMess, and Shadowsocks strings into V2Ray-compatible JSON configs
- Cross-platform support for Windows and Linux
- Comprehensive documentation with examples and troubleshooting
Install via pip:
pip install v2rootBasic example to start V2Ray with a VLESS configuration:
from v2root import V2ROOT
# Initialize V2ROOT
v2 = V2ROOT()
# Set a VLESS string
vless_str = "vless://your-uuid@your-server:443?security=tls&type=tcp"
v2.set_config_string(vless_str)
# Start V2Ray
v2.start()
# Stop V2Ray when done
v2.stop()- Python 3.6 or higher
- V2Ray executable (v2ray.exe on Windows, v2ray on Linux)
- Windows or Linux OS
- Standard libraries: ctypes, colorama
Detailed documentation, including installation instructions, usage examples, and supported configuration options, is available at: Read the Docs
This project is licensed under the MIT License - see the file for details.
Contributions are welcome! Please fork the repository and submit a pull request with your changes. See the Contributing Guide for more details.
- Fixed Shadowsocks parser
- Resolved service execution issues with the latest V2Ray version on Linux
- Updated Explain Error section for better error handling and user friendly troubleshooting
If you encounter any issues or have questions, feel free to open an issue on the GitHub repository or join our Support Channel.