Home

Welcome to the v2link-client wiki!

v2link-client Wiki

v2link-client is a Linux desktop client for V2Ray-style links, currently focused on vless:// (early beta).
Built with Python 3.11+ + PyQt6, and runs Xray-core under the hood.

Project status

• Stage: Early beta
• Supported now: vless:// (subset), Xray-core in PATH, SOCKS/HTTP local proxies, diagnostics/logs, light/dark theme
• Not yet: vmess/trojan/ss, REALITY, advanced routing, multi-profile management (see Roadmap)

What this Wiki is for

• How to install & run (source + packaging)
• How to use features (system proxy, metrics, diagnostics)
• Known limitations & troubleshooting
• Roadmap and release process

Start here

• Quick Start
• Installation
• Usage Guide
• Troubleshooting
• Roadmap

Key folders (runtime)

• Config/profile: ~/.config/v2link-client/profile.json
• State + generated core config: ~/.local/state/v2link-client/
• Logs: ~/.local/state/v2link-client/logs/

Support / Feedback

If something breaks, please open an Issue and include:

• Your distro + desktop environment (GNOME/KDE/etc.)
• xray version output
• Relevant log snippets from the logs folder