# v2rayN | 2dust | Knowledge Base | Instagit

A GUI client for Windows, Linux and macOS, support Xray and sing-box and others

GitHub Stars: 97.5k

Repository: https://github.com/2dust/v2rayN

---

## Articles

### [How v2rayN Handles SQLite Database Storage for Profiles and Settings](/2dust/v2rayN/how-v2rayn-handles-sqlite-database-storage)

Discover how v2rayN stores profiles and settings in an SQLite database. Learn about its SQLiteHelper class simplifying CRUD operations and managing all user data.

- Tags: internals
- Published: 2026-02-27

### [How v2rayN Exposes APIs for External Control and Integration](/2dust/v2rayN/how-v2rayn-exposes-apis-external-integration)

Understand how v2rayN exposes APIs for external control and integration. Query metrics and manage proxies locally without SDK dependencies.

- Tags: api-reference
- Published: 2026-02-27

### [How v2rayN Handles QR Code Scanning for vmess:// and ss:// URLs](/2dust/v2rayN/how-v2rayn-handles-qr-code-scanning-urls)

Discover how v2rayN scans QR codes using ZXing.SkiaSharp to decode vmess:// and ss:// URLs. Learn how it parses and stores configuration data in this technical deep dive.

- Tags: how-to-guide
- Published: 2026-02-27

### [How SpeedtestService Measures Server Latency and Bandwidth in v2rayN](/2dust/v2rayN/how-speedtestservice-measures-server-performance)

Discover how SpeedtestService measures server latency and bandwidth in v2rayN using TCP handshakes, ICMP pings, and proxy tunnel tests. Learn the technical details.

- Tags: deep-dive
- Published: 2026-02-27

### [How v2rayN Implements Load Balancing and Server Health Checking: A Technical Deep Dive](/2dust/v2rayN/how-v2rayn-implements-load-balancing-health-checking)

Explore how v2rayN offers advanced load balancing strategies like round-robin and least-ping, plus continuous server health checking with configurable HTTP probes. Optimize your proxy performance today.

- Tags: deep-dive
- Published: 2026-02-27

### [PAC Manager Architecture in v2rayN: How Proxy Auto-Configuration Works](/2dust/v2rayN/architecture-pac-manager-proxy-auto-configuration)

Explore the PAC manager architecture in v2rayN. Learn how this HTTP server generates PAC scripts to route Windows traffic through local proxies based on URL patterns.

- Tags: architecture
- Published: 2026-02-27

### [How ProcessService Manages Core Processes on Different Platforms in v2rayN](/2dust/v2rayN/how-processservice-manages-core-processes)

Understand how v2rayN's ProcessService manages core processes like v2ray and Xray across Windows, Linux, and macOS. Learn about cross-platform execution and privilege handling for stability.

- Tags: internals
- Published: 2026-02-27

### [How v2rayN Handles SSL Certificate Management with CertPemManager](/2dust/v2rayN/how-v2rayn-handles-ssl-certificate-management)

Discover how v2rayN's CertPemManager fetches X.509 certificates, enforces CA pinning, and exports PEM for secure proxy configurations. Learn about its SSL certificate management.

- Tags: internals
- Published: 2026-02-27

### [How UpdateService Checks for and Applies Core Updates in v2rayN](/2dust/v2rayN/how-updateservice-checks-applies-core-updates)

Discover how v2rayN's UpdateService checks for and applies core updates by interacting with the GitHub API and downloading specific binaries for installation.

- Tags: internals
- Published: 2026-02-27

### [How v2rayN Implements TUN Mode for Xray and sing-box Cores](/2dust/v2rayN/how-v2rayn-implements-tun-mode-for-cores)

Discover how v2rayN implements TUN mode using sing-box and Xray cores. Learn about parameter injection and MTU handling for enhanced network control.

- Tags: internals
- Published: 2026-02-27

### [Architecture of the Routing Service for V2Ray and Singbox Cores in v2rayN](/2dust/v2rayN/architecture-routing-service-v2ray-singbox)

Understand the routing service architecture unifying V2Ray and Singbox cores in v2rayN. Learn how global settings translate to core-specific JSON schemas for efficient network routing.

- Tags: architecture
- Published: 2026-02-27

### [How v2rayN Handles Subscription Updates and URL Parsing: A Technical Deep Dive](/2dust/v2rayN/how-v2rayn-handles-subscription-updates-parsing)

Discover how v2rayN manages subscription updates and URL parsing. Learn about URL validation, domain conversion, content downloading, and server profile creation with this technical deep dive.

- Tags: deep-dive
- Published: 2026-02-27

### [How v2rayN Implements System Proxy Handling Across Windows, Linux, and macOS](/2dust/v2rayN/how-v2rayn-implements-system-proxy-handling)

Discover how v2rayN handles system proxy settings on Windows, Linux, and macOS. Learn about native WinAPI calls, Bash scripts, gsettings, gsettings, kwriteconfig, and networksetup integration.

- Tags: how-to-guide
- Published: 2026-02-27

### [How ClashApiManager Works for Clash‑Compatible Clients in v2rayN](/2dust/v2rayN/how-clashapimanager-works-clash-clients)

Discover how ClashApiManager in v2rayN controls Clash-compatible clients via its REST API. Fetch groups, test nodes, switch selectors, and manage runtime configuration effortlessly.

- Tags: internals
- Published: 2026-02-27

### [How v2rayN Handles Profile Groups and Implements Server Switching](/2dust/v2rayN/how-v2rayn-handles-profile-groups-server-switching)

Learn how v2rayN manages profile groups and server switching using ProfileItem, ProtocolExtra, and a reactive event pipeline for seamless global configuration updates and reloads.

- Tags: internals
- Published: 2026-02-27

### [Difference Between v2fly, Xray, and sing-box Cores in v2rayN](/2dust/v2rayN/difference-between-v2fly-xray-singbox-cores)

Understand the differences between v2fly, Xray, and sing-box cores in v2rayN. Learn which core supports classic and modern proxy protocols for optimal performance.

- Tags: deep-dive
- Published: 2026-02-27

### [How SingboxConfigTemplateService Generates sing-box Configuration in v2rayN](/2dust/v2rayN/how-singboxconfigtemplatesservice-generates-singbox-config)

Discover how SingboxConfigTemplateService creates sing-box configurations in v2rayN by merging user templates with auto-generated node data, applying custom logic.

- Tags: internals
- Published: 2026-02-27

### [How to Configure Custom Inbound Protocols in v2rayN (SOCKS, HTTP, TUN)](/2dust/v2rayN/how-configure-custom-inbound-protocols-v2rayn)

Easily configure custom SOCKS HTTP and TUN inbound protocols in v2rayN. Learn how the V2rayInboundService and SingboxInboundService translate settings for your core.

- Tags: how-to-guide
- Published: 2026-02-27

### [How v2rayN Implements DNS Service for V2Ray and Singbox Cores: A Technical Deep Dive](/2dust/v2rayN/how-v2rayn-implements-dns-service-for-different-cores)

Explore how v2rayN uses V2rayDnsService and SingboxDnsService to generate distinct DNS configurations for V2Ray and Singbox cores. Understand their unique tagging and routing strategies.

- Tags: deep-dive
- Published: 2026-02-27

### [v2rayN Statistics Service Architecture: How Bandwidth Tracking Works](/2dust/v2rayN/architecture-statistics-service-bandwidth-usage)

Discover the v2rayN statistics service architecture and how it tracks bandwidth usage. Learn about polling endpoints, data deltas, and database persistence for accurate tracking.

- Tags: architecture
- Published: 2026-02-27

### [How Routing Rules Are Processed and Applied in v2rayN for V2Ray and sing-box Cores](/2dust/v2rayN/how-routing-rules-processed-applied-v2rayn)

Understand how v2rayN processes routing rules for V2Ray and sing-box cores. Learn how rule sets are converted and applied to your configuration for optimized network routing.

- Tags: how-to-guide
- Published: 2026-02-27

### [How v2rayN CoreManager Handles Core Lifecycle for Xray, sing-box, and mihomo](/2dust/v2rayN/how-coremanager-handles-core-lifecycle)

Discover how v2rayN's CoreManager effortlessly manages Xray, sing-box, and mihomo core lifecycles. Learn about initialization, configuration, and process execution for a seamless experience.

- Tags: internals
- Published: 2026-02-27

### [How v2rayN Manages Multiple Core Types: Xray, sing-box, v2fly, mihomo, and hysteria](/2dust/v2rayN/how-does-v2rayn-manage-multiple-core-types)

Discover how v2rayN seamlessly manages multiple proxy cores like Xray, sing-box, v2fly, mihomo, and hysteria using dynamic resolution. Learn about its flexible core management system.

- Tags: deep-dive
- Published: 2026-02-27