# hwanz/ssr-v2ray-trojan architecture

> Architecture diagram of the GitHub repository hwanz/ssr-v2ray-trojan, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hwanz/ssr-v2ray-trojan
- Repository: https://github.com/hwanz/ssr-v2ray-trojan

## Overview

1. This repository is not an application codebase; it is a single-document content repository centered on `README.md`. The architecture is essentially a curated knowledge base for “机场” recommendations, reviews, pricing, and usage notes.

2. The core subsystem is the recommendation catalog. The README is organized as a ranked list of providers, each with a repeated information block: name, price, protocol, region, access notes, limitations, payment methods, and a short editorial assessment.

3. A second subsystem is the decision-support layer near the top and bottom of the document. It summarizes buying guidance by price range, protocol support, client compatibility, reliability, and special cases such as “only official client” or “not usable outside mainland China.”

4. The document also acts as a compatibility matrix. It maps provider offerings to client ecosystems such as Clash variants, Shadowrocket, V2rayN, OpenWRT plugins, Sing-box, and platform-specific apps. This is important because protocol/client support materially affects how readers choose a service.

5. Another important boundary is the distinction between internal content and external services. The repo itself contains no backend, no subscription service, and no data processing; it only links out to provider registration pages, Telegram channels, tutorial pages, and measurement pages hosted elsewhere.

6. The external measurement and evidence layer is hosted on separate sites referenced throughout the README, especially `jichangcesu.com` and `jichangtuijian.com`. Those pages appear to provide topology notes, historical speed tests, streaming unlock checks, and screenshots that justify the recommendations.

7. Embedded images and `<details>` blocks are used as lightweight presentation controls. That means the README is intended for human browsing on GitHub or a markdown renderer, with optional expansion for speed-test screenshots and deeper evidence.

8. The information flow is manual and editorial: the author collects operational observations, speed results, and availability notes, then updates the README. There is no indication of automated scraping, CI, or generated content in this repo.

9. The primary consumer workflow is: read the summary tables, compare providers by budget or protocol, then click through to an external provider site or tutorial page. In other words, the README functions as a funnel from comparison to off-repo signup.

10. Telegram is part of the communication layer, not the codebase. The README points readers to a Telegram channel for updates, discounts, and announcements, which acts as the ongoing news/alert channel for this curated list.

11. Operationally, the content emphasizes several axes that shape the architecture of the recommendations: entry/relay type, protocol, node geography, bandwidth, device limits, payment options, and regional accessibility. These are the “dimensions” the document standardizes across providers.

12. From an architecture-diagram perspective, the only real system in the repository is a markdown knowledge base with outbound dependencies. Everything else—provider infrastructure, test results, and tutorials—lives in external services and is referenced, not implemented, here.

Main entry points: [`README.md`](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md) (README.md)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_internal["Internal content"]
  node_readme["README.md<br/>markdown knowledge base<br/>[README.md]"]
  node_catalog["Provider catalog<br/>ranked list<br/>[README.md]"]
  node_guidance["Buying guidance<br/>decision layer<br/>[README.md]"]
  node_compatibility["Compatibility matrix<br/>comparison layer<br/>[README.md]"]
  node_provider_card["Provider block<br/>record template<br/>[README.md]"]
  node_pricing["Pricing bands<br/>selection axis<br/>[README.md]"]
  node_protocols["Protocols<br/>technical axis<br/>[README.md]"]
  node_clients["Client ecosystem<br/>compatibility axis<br/>[README.md]"]
  node_limits["Usage limits<br/>operational axis<br/>[README.md]"]
  node_presentation["Markdown UI<br/>presentation controls<br/>[README.md]"]
  node_workflow["Editorial workflow<br/>manual curation<br/>[README.md]"]
  node_funnel["Signup funnel<br/>off-repo transition<br/>[README.md]"]
end

subgraph group_external["External references"]
  node_measurements["Evidence sites<br/>external evidence"]
  node_jichangcesu["jichangcesu.com<br/>speed test site"]
  node_jichangtuijian["jichangtuijian.com<br/>review site"]
  node_telegram(("Telegram channel<br/>update channel"))
  node_providers["Provider sites<br/>external signup"]
  node_tutorials["Tutorial pages<br/>external docs"]
end

node_readme -->|"contains"| node_catalog
node_readme -->|"frames"| node_guidance
node_readme -->|"compares"| node_compatibility
node_catalog -->|"repeats"| node_provider_card
node_provider_card -->|"includes"| node_pricing
node_provider_card -->|"includes"| node_protocols
node_provider_card -->|"includes"| node_limits
node_compatibility -->|"maps to"| node_clients
node_compatibility -->|"depends on"| node_protocols
node_guidance -->|"sorts by"| node_pricing
node_guidance -->|"warns on"| node_limits
node_readme -->|"uses"| node_presentation
node_readme -->|"reflects"| node_workflow
node_workflow -->|"consults"| node_measurements
node_measurements -->|"includes"| node_jichangcesu
node_measurements -->|"includes"| node_jichangtuijian
node_readme -->|"links to"| node_telegram
node_readme -->|"links out"| node_providers
node_readme -->|"links out"| node_tutorials
node_guidance -->|"drives"| node_funnel
node_funnel -->|"ends at"| node_providers

click node_readme "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_catalog "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_guidance "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_compatibility "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_provider_card "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_pricing "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_protocols "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_clients "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_limits "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_presentation "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_workflow "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"
click node_funnel "https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_catalog,node_guidance,node_compatibility,node_provider_card,node_pricing,node_protocols,node_clients,node_limits,node_presentation,node_workflow,node_funnel toneBlue
class node_measurements,node_jichangcesu,node_jichangtuijian,node_telegram,node_providers,node_tutorials toneAmber
```

## Components

### Internal content

Repository-local markdown knowledge base and its sections

- [README.md](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): markdown knowledge base · Single-document repository centered on curated airport recommendations and usage notes · `README.md`
- [Provider catalog](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): ranked list · Main recommendation list of providers with repeated attribute blocks · `README.md`
- [Buying guidance](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): decision layer · Top and bottom summary advice by price, protocol, client fit, and edge cases · `README.md`
- [Compatibility matrix](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): comparison layer · Maps providers to client ecosystems and protocol support · `README.md`
- [Provider block](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): record template · Repeated provider fields: price, protocol, region, limits, payment, assessment · `README.md`
- [Pricing bands](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): selection axis · Budget-oriented sorting and price comparisons across providers · `README.md`
- [Protocols](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): technical axis · Protocol support such as SSR, V2Ray, Trojan, and Sing-box-oriented options · `README.md`
- [Client ecosystem](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): compatibility axis · Client families including Clash variants, Shadowrocket, V2rayN, OpenWRT plugins, and Sing-box · `README.md`
- [Usage limits](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): operational axis · Bandwidth, device limits, region restrictions, and official-client-only cases · `README.md`
- [Markdown UI](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): presentation controls · Embedded images and details blocks used for expandable evidence and browsing · `README.md`
- [Editorial workflow](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): manual curation · Human-written updates based on observations, speed tests, and availability notes · `README.md`
- [Signup funnel](https://github.com/hwanz/ssr-v2ray-trojan/blob/main/README.md): off-repo transition · Primary reader path from comparison to external registration or tutorials · `README.md`

### External references

Off-repo sites, channels, and signup destinations referenced by the README

- **Evidence sites**: external evidence · Referenced measurement and review sites providing speed tests, topology notes, and screenshots
- **jichangcesu.com**: speed test site · Referenced source for performance measurements and evidence
- **jichangtuijian.com**: review site · Referenced source for recommendations and supporting screenshots
- **Telegram channel**: update channel · Outbound announcements channel for discounts, updates, and alerts
- **Provider sites**: external signup · Provider registration and subscription pages linked from the README
- **Tutorial pages**: external docs · Off-repo guides and setup instructions linked for client and usage help

## Connections

- README.md → Provider catalog: contains · README organizes the main ranked recommendation list
- README.md → Buying guidance: frames · README opens and closes with decision support
- README.md → Compatibility matrix: compares · README acts as a client and protocol compatibility matrix
- Provider catalog → Provider block: repeats · Each provider is described with the same information template
- Provider block → Pricing bands: includes · Price is one of the core fields in each provider entry
- Provider block → Protocols: includes · Protocol support is part of each provider entry
- Provider block → Usage limits: includes · Operational limits and accessibility notes are part of each provider entry
- Compatibility matrix → Client ecosystem: maps to · The document maps offerings to specific client ecosystems
- Compatibility matrix → Protocols: depends on · Compatibility is shaped by supported transport protocols
- Buying guidance → Pricing bands: sorts by · Buying advice is organized partly by budget
- Buying guidance → Usage limits: warns on · Summary guidance highlights regional and client restrictions
- README.md → Markdown UI: uses · Markdown presentation features support expandable browsing
- README.md → Editorial workflow: reflects · Content appears manually curated rather than generated
- Editorial workflow → Evidence sites: consults · Editorial updates rely on external evidence sources
- Evidence sites → jichangcesu.com: includes · Measurement site referenced throughout the README
- Evidence sites → jichangtuijian.com: includes · Recommendation and evidence site referenced throughout the README
- README.md → Telegram channel: links to · Telegram is used as the ongoing update channel
- README.md → Provider sites: links out · Readers are directed to external provider registration pages
- README.md → Tutorial pages: links out · Readers are directed to off-repo tutorials and setup guides
- Buying guidance → Signup funnel: drives · Decision support funnels readers toward signup or further docs
- Signup funnel → Provider sites: ends at · Primary call to action is external signup
