# hiddify/hiddify-manager architecture

> Architecture diagram of the GitHub repository hiddify/hiddify-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hiddify/hiddify-manager
- Repository: https://github.com/hiddify/hiddify-manager

## Overview

Hiddify-Manager is a multi-user anti-censorship server panel. Its documented workflow is installation, administrator setup and user/configuration management, then client connections through supported proxy protocols. The repository includes the panel entry point, command runner, service configurations, and components for DNS, certificates, and network handling. The README documents broad capabilities, but most implementation details were not sampled; dashed edges mark those documented or plausible links whose source-level wiring is not shown.

Main entry points: [`services/hiddify-core`](https://github.com/hiddify/hiddify-manager/tree/dev/services/hiddify-core) (Hiddify core), [`services/panel/src`](https://github.com/hiddify/hiddify-manager/tree/dev/services/panel/src) (Web panel), [`scripts/common/commander.py`](https://github.com/hiddify/hiddify-manager/blob/dev/scripts/common/commander.py) (Manager CLI), [`scripts/common/jinja.py`](https://github.com/hiddify/hiddify-manager/blob/dev/scripts/common/jinja.py) (Template rendering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Management"]
  node_cli["Manager CLI<br/>[commander.py]"]
  node_panel["Web panel"]
  node_panel_entry["Panel entry point<br/>[app.py]"]
  node_mysql[("MySQL service")]
  node_redis[("Redis service")]
end

subgraph group_deployment["Deployment"]
  node_installer["Install workflow<br/>[install.sh]"]
  node_config_render["Template rendering<br/>[jinja.py]"]
end

subgraph group_proxy["Proxy services"]
  node_xray["Xray service"]
  node_core["Hiddify core"]
  node_telegram["Telegram proxy"]
  node_warp["WARP connectivity"]
end

subgraph group_support["Network support"]
  node_nginx["Web gateway"]
  node_acme["Certificate management<br/>[acme.sh]"]
  node_dns["DNS proxy"]
  node_firewall["Firewall"]
end

node_admin(("Administrator"))
node_user(("Proxy user"))
node_client(("Client application"))

node_admin -->|"runs commands"| node_cli
node_cli -->|"runs install"| node_installer
node_admin -.->|"manages users"| node_panel
node_panel_entry -->|"creates app"| node_panel
node_panel -.->|"stores management data"| node_mysql
node_panel -.->|"uses cache"| node_redis
node_panel -.->|"provides configurations"| node_config_render
node_config_render -.->|"renders configs"| node_core
node_client -.->|"connects for access"| node_user
node_user -.->|"uses proxy configs"| node_core
node_user -.->|"uses supported protocols"| node_xray
node_user -.->|"uses Telegram proxy"| node_telegram
node_core -.->|"routes through gateway"| node_nginx
node_nginx -.->|"uses TLS certificates"| node_acme
node_dns -.->|"supports proxy transport"| node_core
node_firewall -.->|"allows proxy traffic"| node_core
node_warp -.->|"provides outbound routing"| node_core

click node_cli "https://github.com/hiddify/hiddify-manager/blob/dev/scripts/common/commander.py"
click node_panel "https://github.com/hiddify/hiddify-manager/tree/dev/services/panel/src"
click node_panel_entry "https://github.com/hiddify/hiddify-manager/blob/dev/services/panel/app.py"
click node_installer "https://github.com/hiddify/hiddify-manager/blob/dev/scripts/install.sh"
click node_config_render "https://github.com/hiddify/hiddify-manager/blob/dev/scripts/common/jinja.py"
click node_nginx "https://github.com/hiddify/hiddify-manager/tree/dev/services/nginx"
click node_acme "https://github.com/hiddify/hiddify-manager/tree/dev/services/acme.sh"
click node_dns "https://github.com/hiddify/hiddify-manager/tree/dev/services/dns_proxy"
click node_firewall "https://github.com/hiddify/hiddify-manager/tree/dev/services/firewall"
click node_xray "https://github.com/hiddify/hiddify-manager/tree/dev/services/xray"
click node_core "https://github.com/hiddify/hiddify-manager/tree/dev/services/hiddify-core"
click node_telegram "https://github.com/hiddify/hiddify-manager/tree/dev/services/telegram"
click node_warp "https://github.com/hiddify/hiddify-manager/tree/dev/services/warp"
click node_mysql "https://github.com/hiddify/hiddify-manager/tree/dev/services/mysql"
click node_redis "https://github.com/hiddify/hiddify-manager/tree/dev/services/redis"

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_cli,node_panel,node_panel_entry,node_mysql,node_redis,node_user,node_client toneBlue
class node_installer,node_config_render toneAmber
class node_xray,node_core,node_telegram,node_warp toneMint
class node_nginx,node_acme,node_dns,node_firewall toneRose
class node_admin toneIndigo
```

## Components

### Management

- [Manager CLI](https://github.com/hiddify/hiddify-manager/blob/dev/scripts/common/commander.py): `scripts/common/commander.py`
- [Web panel](https://github.com/hiddify/hiddify-manager/tree/dev/services/panel/src): `services/panel/src`
- [Panel entry point](https://github.com/hiddify/hiddify-manager/blob/dev/services/panel/app.py): `services/panel/app.py`
- [MySQL service](https://github.com/hiddify/hiddify-manager/tree/dev/services/mysql): `services/mysql`
- [Redis service](https://github.com/hiddify/hiddify-manager/tree/dev/services/redis): `services/redis`

### Deployment

- [Install workflow](https://github.com/hiddify/hiddify-manager/blob/dev/scripts/install.sh): `scripts/install.sh`
- [Template rendering](https://github.com/hiddify/hiddify-manager/blob/dev/scripts/common/jinja.py): `scripts/common/jinja.py`

### Proxy services

- [Xray service](https://github.com/hiddify/hiddify-manager/tree/dev/services/xray): `services/xray`
- [Hiddify core](https://github.com/hiddify/hiddify-manager/tree/dev/services/hiddify-core): `services/hiddify-core`
- [Telegram proxy](https://github.com/hiddify/hiddify-manager/tree/dev/services/telegram): `services/telegram`
- [WARP connectivity](https://github.com/hiddify/hiddify-manager/tree/dev/services/warp): `services/warp`

### Network support

- [Web gateway](https://github.com/hiddify/hiddify-manager/tree/dev/services/nginx): `services/nginx`
- [Certificate management](https://github.com/hiddify/hiddify-manager/tree/dev/services/acme.sh): `services/acme.sh`
- [DNS proxy](https://github.com/hiddify/hiddify-manager/tree/dev/services/dns_proxy): `services/dns_proxy`
- [Firewall](https://github.com/hiddify/hiddify-manager/tree/dev/services/firewall): `services/firewall`

### Other components

- **Administrator**
- **Proxy user**
- **Client application**

## Connections

- Administrator → Manager CLI: runs commands (evidence: `scripts/common/commander.py`)
- Manager CLI → Install workflow: runs install (evidence: `scripts/common/commander.py`)
- Administrator → Web panel: manages users (evidence: `README.md`)
- Panel entry point → Web panel: creates app (evidence: `services/panel/app.py`)
- Web panel → MySQL service: stores management data
- Web panel → Redis service: uses cache
- Web panel → Template rendering: provides configurations (evidence: `README.md`)
- Template rendering → Hiddify core: renders configs
- Client application → Proxy user: connects for access (evidence: `README.md`)
- Proxy user → Hiddify core: uses proxy configs (evidence: `README.md`)
- Proxy user → Xray service: uses supported protocols (evidence: `README.md`)
- Proxy user → Telegram proxy: uses Telegram proxy (evidence: `README.md`)
- Hiddify core → Web gateway: routes through gateway
- Web gateway → Certificate management: uses TLS certificates
- DNS proxy → Hiddify core: supports proxy transport
- Firewall → Hiddify core: allows proxy traffic
- WARP connectivity → Hiddify core: provides outbound routing
