V2Ray Hubv2rayN Guides

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ]
}

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:private", "geoip:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

{
  "dns": {
    "servers": [
      {
        "type": "udp",
        "tag": "dns-direct",
        "server": "223.5.5.5",
        "server_port": 53
      }
    ],
    "final": "dns-direct",
    "strategy": "prefer_ipv4"
  }
}

{
  "inbounds": [
    {
      "listen": "0.0.0.0",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}

The configuration window shows selected fields and cannot replace a complete configuration. A graphical client combines inbounds, outbounds, routing, and DNS. When getting started, make changes in the settings interface, one at a time, and note the original value before changing it.

1. 01

   Add a subscription, then refresh the configuration list

   In v2rayN, open “Subscription Groups,” add the subscription URL and a name, save, and update. In v2rayNG for Android, manage URLs under “Subscription Group Settings,” then return to the main screen and update. When copying a URL, check for spaces, line breaks, or extra text. Import share links from the clipboard; do not enter them as subscription URLs.

   After the update, the imported configurations should appear in the list. If it is still empty, check the log to distinguish between an unreachable URL, an empty response, and an unsupported format. Subscription links may contain access credentials, so do not post the full URL in a public forum. The client reads configurations; it does not provide a subscription service.

2. 02

   Select a configuration, then choose a proxy mode

   Select a server configuration from the list to start its corresponding kernel. On desktop, choose “Set up system proxy automatically” to proxy browser traffic. On Android, tap Connect and allow the VPN connection when prompted. For your first test, follow one clear setup path and avoid running multiple tools that capture the same traffic.

   Start with a routing preset rather than pasting a complete configuration found online. The system proxy determines whether an app sends requests to a local port; routing determines which outbound the kernel uses after receiving them. If an app ignores the system proxy, changing routing rules repeatedly will not solve the traffic capture issue. Check the app’s own network settings instead.

3. 03

   Test access, then troubleshoot issues

   Open a page you use regularly in your browser and confirm that its content loads. Do not rely only on a connection icon or test result. A successful kernel test only confirms that a specific test path works; it does not mean every app and domain is working. Then test another type of destination to confirm that direct connections follow your routing policy and local services are not mistakenly sent through a proxy.

   Troubleshoot in this order: “Is the kernel running? → Is the app using the proxy? → Is the routing rule matching? → Is DNS working?” Timeouts, certificate errors, and DNS resolution failures have different causes, so keep the relevant error details. Before sharing logs, remove subscription URLs, server credentials, and personal file paths.

View all articles →Browse frequently asked questions →