XP2P Connection Guide

This guide is organized from simple to complex. Start with a single A-B tunnel, then layer in redirects, DNS handling, and multi-node chains.

Start here

• Install xp2p: Install
• Create your first tunnel: First Tunnel (A-B)
• Add policy routing and name-based rules: Redirects Within A-B
• Build multi-node chains: Chain (C2-B-A-C1)
• Explore variants (multi-clients, split/full tunnel, DNS): Advanced variants

How xp2p works (flows)

• Deploy handshake (what it changes, what it does not): Deploy flow
• Desired → Live apply mechanism: Apply flow
• How Desired inputs become xray.json: Config compilation
• How runtime status is derived: Tunnel status logic

Concepts

• Terms used throughout the docs: Terminology

Lab scope

• OpenWrt hosts for A and B.
• Alpine guests for C1 and C2 (used in the chain scenario).
• Commands use the default paths and config dirs.

Conventions

• A = server node, B = client node.
• C1, C2 = downstream Alpine guests behind B and A.
• Replace example IPs, users, and passwords with your actual values.