# Meridian

> Deploy censorship-resistant proxy servers with one command. Meridian sets up VLESS+Reality, XHTTP, and Hysteria2 behind a hardened firewall, verifies real traffic, and returns a connection page to share.

Driving the CLI as an agent? Start with the agent guide, also printed by `meridian help agents`.

## Agents

- [Agent guide](https://getmeridian.org/agents.md): how Meridian works and how to drive it safely

## Docs

- [Getting Started](https://getmeridian.org/en/getting-started.md): Install Meridian and deploy your first proxy server.
- [Installation](https://getmeridian.org/en/installation.md): Install the Meridian CLI on your local machine.
- [Windows and WSL Setup](https://getmeridian.org/en/wsl.md): Set up Meridian on Windows using Windows Subsystem for Linux.
- [Choosing hosting](https://getmeridian.org/en/hosting.md): How to pick and test a VPS for an exit or a relay before you commit to it.
- [Deploy Guide](https://getmeridian.org/en/deploy.md): Full deployment walkthrough with all configuration options.
- [Domain Mode](https://getmeridian.org/en/domain-mode.md): Add CDN fallback via Cloudflare for IP-blocking resilience.
- [Client Management](https://getmeridian.org/en/client-management.md): Add users, share connection details, and manage access keys.
- [Connecting](https://getmeridian.org/en/connecting.md): You received a Meridian link. Install an app, add the connection, and get it working again when it stops.
- [Relay Nodes](https://getmeridian.org/en/relay.md): Route traffic through a domestic server for IP-blocking resilience.
- [Split Routing (Russia)](https://getmeridian.org/en/split-routing.md): Route Russian traffic directly while proxying everything else — keep VPS IP protected and Russian sites working.
- [Use Meridian on a router](https://getmeridian.org/en/routers.md): Connect a home router to your Meridian server with podkop on OpenWrt or XKeen on Keenetic, so every device is covered without an app.
- [IP Blocked Recovery](https://getmeridian.org/en/recovery.md): What to do when your server's IP gets blocked — diagnosis and recovery options.
- [Troubleshooting](https://getmeridian.org/en/troubleshooting.md): Common issues, fixes, and diagnostic tools.
- [Architecture](https://getmeridian.org/en/architecture.md): System architecture, traffic flow, and service topology.
- [CLI Reference](https://getmeridian.org/en/cli-reference.md): Complete reference for all Meridian CLI commands and flags.
- [AI Agents](https://getmeridian.org/en/agents.md): Let Claude Code, Codex, Cursor, or another AI agent run Meridian for you, safely.
- [Security](https://getmeridian.org/en/security.md): Security design, vulnerability reporting, and scope.
- [Contributing](https://getmeridian.org/en/contributing.md): Development setup, PR guidelines, and testing approach.

## Optional

- [All docs in one file](https://getmeridian.org/llms-full.txt)
- [Source code](https://github.com/getmeridian/meridian)