Skip to content
hdmi1519Public
forked from Miroshka000/mikan

About

A fast, beautiful VPN panel on the mihomo core — one command to install, nothing to babysit.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

mikan — VPN panel on the mihomo core

A fast, beautiful VPN panel on the mihomo core — one command to install, nothing to babysit.

Release Image License mihomo

English · Русский · 简体中文 · فارسی · Türkçe · Español


Install

On a fresh Ubuntu 22.04+ or Debian 12+ server (amd64 or arm64):

curl -fsSL https://github.com/Miroshka000/mikan/releases/latest/download/install.sh | sudo bash

The installer asks for the panel language and an optional domain, checks that the domain points to the server, installs Docker if needed, picks REALITY camouflage sites next to your server and prints your admin link. Run mikan again at any time for the management menu.

A node for an existing panel: the panel's Nodes page (or mikan node add) gives the command with its key:

curl -fsSL https://github.com/Miroshka000/mikan/releases/latest/download/install.sh | sudo bash -s -- --join KEY

Without questions, for scripts: … | sudo bash -s -- --yes --lang en --domain vpn.example.com --email you@example.com (all flags: mikan install --help).

Why mikan

🛡️ Survives blocking on its own

mikan watches whether real clients still reach each protocol. When a port gets blocked on the way, it moves the protocol to a free HTTPS port; when a REALITY camouflage site stops working, it picks a new one next to your server.

📱 Every app gets what it can use

Subscriptions detect the app — Happ, v2RayTun, Koala Clash, SlothClash, Clash Verge, FlClash, ClashFest, Hiddify, Shadowrocket and more — and hand it only the protocols it actually supports. No more “it doesn't work for me”.

📊 Byte-exact accounting

mihomo is embedded as a library, so traffic is counted per user on every connection — not sampled. Plans by time and gigabytes, billing days, device limits and device binding against key sharing. Since every connection is known by its user, the torrent blocker bans the one who torrents on every node, not a shared IP.

🤖 Telegram bot and Mini App built in

Subscribers check their plan, devices and connection guides in a bot you set up in the panel, open the subscription page as a Telegram Mini App and get notified before it expires. They can also buy and renew — Telegram Stars, cards and SBP through YooKassa, or crypto through CryptoBot — and the panel hands out the link by itself. Broadcasts respect Telegram's limits.

🪶 Light as a mandarin

Go and PostgreSQL, three small containers. On a working server with clients: ~14 MB RAM for the panel, ~50 MB for the database, ~40 MB for the VPN core.

🔒 Locked down by default

Secret admin link on a random port, HTTPS with Let's Encrypt (even for a bare IP), argon2id, TOTP 2FA, CSRF protection, strict CSP, audit log. Containers run non-root, read-only, with all capabilities dropped.

🌐 WARP and server cascades

Each node can have its own WARP — registered in one click or from your WireGuard config — and protocols can leave through another node of the panel (client → node A → node B → internet). Chosen protocols, domains and networks take those ways out, everything else goes direct.

🧩 API and keys for integrations

A REST API documented right in the panel, with read-only or full-access keys for bots, billing and monitoring.

Promo codes

Admins can create discount codes and codes for bonus days or traffic. Subscribers apply codes in the Telegram Mini App, which also shows their redemption history. Bonus traffic can go to the main balance or a selected pool. Discounted invoices are available only through payment methods that support refunds: Telegram Stars and adapters that advertise refund support. Mikan can then return a payment if its promo reservation expires before the provider confirms it.

Screenshots

Overview Users
Protocols Telegram bot

Subscription page    Overview on a phone

Protocols

Fifteen protocols, each a preset with keys generated for you. The subscription gives every app only what it runs:

Protocol Clash apps
mihomo core
Xray apps
Happ, v2RayTun
sing-box apps
Hiddify, Karing
VLESS · REALITY · Vision ✅ ✅ ✅
VLESS · REALITY · XHTTP ✅ ✅ —
VLESS · REALITY · gRPC ✅ ✅ ✅
VLESS PQ (post-quantum encryption) ✅ ✅ —
Trojan · REALITY ✅ ✅ ✅
Hysteria2 ✅ ✅ ✅
TUIC v5 ✅ — ✅
AnyTLS ✅ — ✅
TrustTunnel ✅ — —
ShadowQUIC ✅ — —
Mieru ✅ — —
Shadowsocks-2022 ¹ ✅ ✅ ✅
Sudoku ¹ ✅ — —
Snell ¹ ✅ — —
VMess (custom config) ✅ ✅ ✅

¹ One key for all users in mihomo: no per-user accounting or limits on these. Newer protocols are sent to Clash apps only when their core is new enough.

How it works

flowchart LR
    A[Browser] -- HTTPS, secret link --> P[mikan panel<br>users · plans · subscriptions]
    P -- unix socket / pinned TLS --> N1[mikan node<br>mihomo inside]
    P -- pinned TLS --> N2[remote node]
    C[VPN apps] -- REALITY · QUIC · … --> N1
    C --> N2
    C -. subscription .-> P
Loading

The panel and the node are two processes from one image. Update or restart the panel — VPN keeps running. Add remote nodes with a join key from the Nodes page.

Managing the server

Run mikan for the menu, or use the commands directly:

Command What it does
mikan status containers, versions, health, available update
mikan logs [panel|node] live logs
mikan url admin link
mikan reset-password · reset-path · disable-2fa regain access
mikan update update now (backup first, automatic rollback)
mikan backup · restore FILE backups in /opt/mikan/backups
mikan node … · mikan inbound … nodes and protocols
mikan targets scan · apply REALITY camouflage sites next to the server
mikan join KEY on a node: take a new key from the panel
mikan restart restart the containers
mikan uninstall stop and remove the command, keep the data

Updates

The panel checks for a new release once a day and shows what changed. Turn on auto-update in settings, or press Update: the host updater pulls the image from GitHub Packages, backs up, migrates the database, restarts and rolls back if the new version does not come up healthy. Every release manifest is signed.

On 0.4.4 or older, update to 0.4.5 first; the move to 0.5 and PostgreSQL then comes through the Update button too. If you skipped 0.4.5, the install command above updates an existing server.

Building from source

docker buildx build -t mikan:dev .            # panel + node image
cd web && pnpm install && pnpm dev            # admin UI with hot reload
MIKAN_TEST_DATABASE_URL=postgres://… go test ./...   # Go 1.27, a test PostgreSQL 18 and pg_dump
cd installer && cargo test                    # the installer (Rust)

Development happens on the dev branch; pull requests into main are built and tested, releases are published from tags.

License

mikan is free software under the GNU GPL v3. It embeds mihomo (GPL-3.0). Fonts: Unbounded, Onest, JetBrains Mono (SIL OFL 1.1).

Made with 🍊

About

A fast, beautiful VPN panel on the mihomo core — one command to install, nothing to babysit.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages