configure-v2ray

name: configure-v2ray description: 'Configure v2ray or Xray-core proxies with VMess, VLESS, Shadowsocks, or SOCKS5 protocols. Use when creating or editing v2ray/Xray JSON config files with inbounds, outbounds, and routing rules.' license: Apache-2.0 compatibility: Requires v2ray-core v5+ or Xray-core v1.8+. Download from https://github.com/XTLS/Xray-core/releases metadata: author: proxy-tools version: "1.0" allowed-tools: docker bash

Configure v2ray / Xray

v2ray and Xray use a JSON configuration with three core sections: inbounds, outbounds, and routing.

Config Skeleton

{
  "log": { "loglevel": "info" },
  "inbounds": [
    {
      "port": 1080,
      "protocol": "socks",
      "settings": { "auth": "noauth", "udp": true },
      "tag": "socks-in"
    }
  ],
  "outbounds": [
    {
      "protocol": "freedom",
      "tag": "direct"
    },
    {
      "protocol": "blackhole",
      "tag": "blocked"
    }
  ],
  "routing": {
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "blocked"
      }
    ]
  }
}

Protocol Quick Reference

Transport Options (streamSettings.network)

tcp | kcp | ws (WebSocket) | http | grpc | quic

Workflow

1. Choose example from v2ray/examples/:
   • vmess-server.json / vmess-client.json — VMess over WebSocket
   • vless-xtls.json — VLESS with TLS (Xray)
   • shadowsocks.json — Shadowsocks inbound
2. Update UUIDs (id field) — generate with: cat /proc/sys/kernel/random/uuid
3. Update server addresses and ports.
4. Run:

   docker compose -f v2ray/docker-compose.yml up -d
   # or: xray run -c v2ray/config.json
   

References

• Xray docs: https://xtls.github.io/en_US/
• Repository: v2ray/