cdn-fallback

cdn-fallback is a skill for Claude Code, Codex from pyworkload/3x-ui-mcp. It costs 83 tokens per session (1,487 once invoked), scanned A, original, MIT.

A setup guide for putting 3x-ui proxy connections behind a content delivery network (CDN), such as Cloudflare, or sharing one HTTPS port among several connections. It covers WebSocket, gRPC, xhttp, and Xray fallbacks, which pass connections to different services.

In plain words
What is it for?
Use it to configure CDN fronting, choose a supported transport, or route connections on port 443 to a web server and multiple proxy protocols.
Why use it?
It helps hide a server's IP behind a CDN, handle cases where REALITY is unsuitable, and avoid needing a separate public port for every protocol. It also explains the domain, certificate, and transport requirements.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/pyworkload/3x-ui-mcp/cdn-fallback
Any agent
npx skills add pyworkload/3x-ui-mcp --skill cdn-fallback
Clone the repo
git clone --depth 1 https://github.com/pyworkload/3x-ui-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cdn-fallback

README.md
[![agentmods](https://agentmods.dev/badge/skills/pyworkload/3x-ui-mcp/cdn-fallback.svg)](https://agentmods.dev/skills/pyworkload/3x-ui-mcp/cdn-fallback)
Your own site
<a href="https://agentmods.dev/skills/pyworkload/3x-ui-mcp/cdn-fallback"><img src="https://agentmods.dev/badge/skills/pyworkload/3x-ui-mcp/cdn-fallback.svg" alt="Measured on agentmods" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,487 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.01487
Opus 5 $0.00042 $0.00744
Sonnet 5 $0.00017 $0.00297
Haiku 4.5 $0.00008 $0.00149

Measured today against content hash b6b99a8e18af, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

cdn-fallback scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/cdn-fallback/SKILL.md · 125 lines

How it starts

The opening of the file, as written. The whole thing — 125 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CDN transports and fallbacks

Two different jobs that are often confused:

  • CDN fronting hides the server's IP behind Cloudflare (or another CDN) and makes the traffic look like ordinary HTTPS to a real website. It needs a domain, a certificate, and a transport the CDN can proxy: WebSocket, gRPC or xhttp.
  • Fallbacks let one TLS inbound on 443 hand connections to other inbounds by path or ALPN, so a web server and several proxy protocols share the port.

They combine well — a CDN-fronted WS inbound as the fallback child of a master inbound on 443 — but decide which problem you are solving first.

CDN fronting

REALITY cannot be CDN-fronted: it impersonates someone else's TLS, and the CDN terminates TLS itself. Fronting means a real certificate for a domain you control.

Pick the transport. WebSocket is the most widely supported and the safest default. gRPC multiplexes better on a busy link but needs gRPC enabled on the CDN side. xhttp is the modern option and the most flexible over HTTP/2, but is the most sensitive to CDN buffering — try it after WS works, not before.

Ports the CDN will proxy matter. Cloudflare proxies HTTPS only on 443, 2053, 2083, 2087, 2096 and 8443. An inbound on any other port must be grey-clouded, which defeats the purpose. Set the inbound's port to one of those, or terminate on 443 and fall back internally.

Create it — the transport carries no TLS of its own when the CDN terminates in front of it and the origin is plain HTTP; give it TLS when the origin must also be encrypted (Cloudflare "Full" mode).

create_inbound
  remark="ws-cdn"
  port=2053
  protocol="vless"
  settings={"clients":[],"decryption":"none"}
  stream_settings={"network":"ws","security":"none","wsSettings":{"path":"/vlws","host":""}}

Then add_client inbound_ids=[<id>] email="alice" — and no flow. xtls-rprx-vision is valid only on TCP-based VLESS; setting it on a ws/grpc/xhttp client produces a connection failure that looks like a broken server.

Read the full file on GitHub · 125 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 125 lines · 83 tokens per session scan A b6b99a8e18af

Subscribe to this mod's changes

cdn-fallback is a skill published in the GitHub repository pyworkload/3x-ui-mcp (5 stars, last pushed 3d ago), licensed MIT. It adds 83 tokens to every session and 1,487 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-05.

Related

Other skills, from other repositories

chainstack

Work with the Chainstack MCP server to manage blockchain nodes and projects. Use when deploying nodes, migrating to Chainstack from another RPC provider such as QuickNode or Alchemy, checking platform status, searching Chainstack docs, contacting the Chainstack team, or interacting with the Chainstack platform API via…

chainstacklabs/mcp-server · 66 tokens

deploy

Build, deploy, verify, or roll back this server on the host. Use when asked to ship a change, rebuild a container, update nginx, or diagnose why the service is down. Covers the memory-capped build, the reload-not-restart rule, and the unhealthy-container failure mode.

HalemoGPA/whatsapp-mcp-server · 61 tokens

publish-release

Releases a new McpOrchestrator version end to end — version bump PR, tag, and the automated deploy to GitHub Releases, NuGet, and the MCP Registry. Use when asked to release, publish, deploy, ship, or bump the version of McpOrchestrator.

Byggarepop/dotnet-mcp-orchestrator · 63 tokens

cloudflare-management

Manage Cloudflare Workers, KV, R2, DNS, and cache via MCP. Use when the user asks to list zones, edit DNS records, purge cache, inspect Workers, read/write KV, or list R2 buckets on Cloudflare.

ofershap/mcp-server-cloudflare · 53 tokens

api-workers

Cloudflare Workers deployment using createWorkerHandler from @cyanheads/mcp-ts-core/worker. Covers the full handler signature, binding types, CloudflareBindings extensibility, runtime compatibility guards, and wrangler.toml requirements.

cyanheads/mcp-ts-core · 51 tokens

api-workers

Cloudflare Workers deployment using createWorkerHandler from @cyanheads/mcp-ts-core/worker. Covers the full handler signature, binding types, CloudflareBindings extensibility, runtime compatibility guards, and wrangler.toml requirements.

cyanheads/pubmed-mcp-server · 51 tokens