Skip to content
RomanovCaesarPublic

About

A simple Mihomo server manage panel supporting multi-protocol and multi-user (Vmess, Vless, Trojan, ShadowSocks, Snell, Hysteria2, Mixed, Socks, HTTP, Tuic, AnyTLS, Mieru, Sudoku, ShadowQuic, TrustTunnel, Hysteria2-Realm)

Topics

Resources

Stars

47 stars

Watchers

0 watching

Forks

Latest commit

 

History

66 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | 简体中文 | 繁體中文 | 日本語 | Русский | فارسی | Tiếng Việt | Español | Türkçe | Українська | Português (Brasil)

m-ui logo

m-ui

Release Build Go Version Downloads License

A server management panel powered by Mihomo. Its workflow follows 3x-ui, its interface comes in three themes (shadcn by default, Material Design 3 and Apple's Liquid Glass), and its configuration model is Mihomo's native YAML. The panel is available in 11 languages.

Important

Use this project only on servers and networks that you own or are authorized to administer. Follow local law, upstream provider terms, and the policies of the services you access.

For complete documentation, visit the m-ui Wiki. Subscribe to our Telegram channel for development news.

Inbounds and clients

Features

Panel and Mihomo

  • Dashboard with system, traffic, connection, and Mihomo status; Mihomo starts automatically with the panel
  • Native Mihomo YAML generation and validation, raw configuration preview and download
  • Mihomo version switching from official MetaCubeX releases, and GeoIP / GeoSite / MetaDB updates
  • Full backup and restore: settings, inbounds, Multi-control identity (opt-in), cross-panel cache, subscription templates, and Multi-control client devices
  • Migrate from 3x-ui in one click: import x-ui.db (v2.9.3–v3.10.2) or an Xray config.json; inbounds, clients with their quotas, expiry and traffic, outbounds, balancers, and routing rules are added next to what the panel already has, and a downloadable conversion log lists anything Mihomo cannot do
  • Interface in English, Simplified Chinese, Traditional Chinese, Japanese, Russian, Persian, Vietnamese, Spanish, Turkish, Ukrainian, and Brazilian Portuguese

Inbounds and clients

  • mixed, socks, http, shadowsocks, snell, vmess, vless, trojan, hysteria2, tuic, anytls, mieru, sudoku, shadowquic, trusttunnel, and hysteria2-realm listeners
  • TLS, Reality, ShadowTLS, RestTLS, TLSMirror, JLS, Trojan SS, XHTTP, mKCP, Mekya, and obfuscation settings
  • Per-client credentials, traffic quotas, expiry, traffic reset schedules, auto-renewal on expiry, and online state; inbound-level limits too
  • Share links, QR codes, inbound import from Mihomo listener YAML, and bulk traffic reset

Subscriptions

  • Browser subscription page with usage, quota, expiry, nodes, and one-click import into Clash Caesar
  • Subscription templates: every subscription is a complete client profile built from the built-in China / Russia / Iran template or your own Mihomo template
  • Full profiles for Mihomo/Clash, Stash, sing-box, Surge, Surfboard, Loon, Quantumult X, and Egern; node lists for V2Box, V2RayNG, Shadowrocket, and other share-link clients
  • Per-user subscription tokens and an optional dedicated subscription port

Mihomo Settings

  • Basics: routing mode, direct IP version, IPv6, TCP concurrency, statistics, logs, and basic routing
  • Outbounds (including Snell, WireGuard, and OpenVPN) and policy groups, with a form editor, native YAML, and share-link conversion
  • Ordered routing rules, including AND rules
  • Cloudflare WARP outbounds and VPNGate residential exits by country and ISP

Multi-control

  • Peer-to-peer panel network with signed identities and no master node
  • Encrypted inbound synchronization between trusted panels
  • Cross-panel subscription aggregation
  • Client devices: Clash Caesar imports the network file, signs in once with the panel admin account, and can then see every panel and pull any panel's or the merged subscription through whichever panel it can reach

Screenshots

Overview
Overview
Client: quota, expiry, traffic reset and auto-renewal
Client: quota, expiry, traffic reset and auto-renewal
Outbounds and proxy groups
Outbounds and proxy groups
Routing rules
Routing rules
Import from Xray / 3x-ui
Import from Xray / 3x-ui
shadcn theme, dark
shadcn theme, dark
Material Design 3 theme
Material Design 3 theme
Liquid Glass theme
Liquid Glass theme

Linux installation

Run as root on a Linux system using systemd or OpenRC:

bash <(curl -Ls https://raw.githubusercontent.com/RomanovCaesar/m-ui/main/install.sh)

The installer picks an unused five-digit panel port and generates a 16-character panel path, a 14-character username, and a 16-character password. It prints the access URL and credentials once at the end. You can also set them explicitly:

bash <(curl -Ls https://raw.githubusercontent.com/RomanovCaesar/m-ui/main/install.sh) \
  --port 34567 \
  --path MyPanelA1b2C3d4 \
  --username AdminUserA1234 \
  --password 'ChangeThisA12345'

m-ui is installed under /usr/local/m-ui, with its data in /usr/local/m-ui/data. The installer also downloads a Mihomo core for the current architecture; an existing core is kept unless you pass --update-mihomo.

m-ui update upgrades m-ui and keeps all settings. Before updating, it snapshots the data directory into data/backups/ and keeps the newest 3 snapshots.

Releases contain m-ui-linux-<architecture>.tar.gz for 386, amd64, arm64, armv5, armv6, armv7, and s390x, plus m-ui-windows-amd64.zip.

Docker

The Docker image targets Linux amd64 and contains m-ui plus a pinned, checksum-verified Mihomo core. The Compose file uses host networking, so inbound ports added in the panel work without extra port mappings.

git clone https://github.com/RomanovCaesar/m-ui.git
cd m-ui
cp .env.example .env
docker compose up -d --build
docker compose logs m-ui

If MUI_PASSWORD and MUI_PATH are empty, the first start generates them and prints the URL and credentials once in the log. Releases also publish ghcr.io/romanovcaesar/m-ui:<tag> and latest; use docker compose pull instead of building when the image is available to you. Data lives in the m-ui-data and m-ui-core volumes; do not run docker compose down -v unless you want to delete it.

TLS certificates

The first interactive installation offers a Let's Encrypt domain certificate, a short-lived Let's Encrypt IPv4 certificate, an existing certificate pair, or skipping TLS. After installation, run:

m-ui ssl

The menu can issue domain and IP certificates, use the Cloudflare DNS API for domain and wildcard certificates when port 80 is unavailable, renew, revoke, list, and apply an existing certificate pair. m-ui completes certificate files that contain only the leaf certificate, because clients such as Mihomo Party and FlClash reject them.

Management commands

m-ui                  interactive menu
m-ui start | stop | restart | status | logs
m-ui settings | configure | set-port
m-ui reset-credentials | reset-path
m-ui update | update-menu | ssl
m-ui enable | disable | clear-logs | uninstall
m-ui --lang <code>    menu language, e.g. m-ui --lang zh-cn

The menu speaks the same 11 languages as the panel and remembers your choice. The installer stays in English.

Documentation

Development

Run from source on Windows; the panel opens at http://127.0.0.1:2053 with the account admin / admin:

.\scripts\run.ps1

Build Windows and Linux amd64 binaries, or all release archives:

.\scripts\build.ps1
.\scripts\build-release.ps1

Validate with go test ./... and go vet ./.... The version is injected with -X main.version=... from MUI_VERSION or the current Git tag. See Development and Releases for the source layout and release flow, and LIQUID-GLASS.md for the interface.

Acknowledgements

License

m-ui is licensed under the GNU General Public License version 3. The Mihomo sharing-link conversion code keeps its GPL-3.0 attribution in internal/mihomoconvert/NOTICE.md.

About

A simple Mihomo server manage panel supporting multi-protocol and multi-user (Vmess, Vless, Trojan, ShadowSocks, Snell, Hysteria2, Mixed, Socks, HTTP, Tuic, AnyTLS, Mieru, Sudoku, ShadowQuic, TrustTunnel, Hysteria2-Realm)

Topics

Resources

Stars

47 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages