English | 简体中文 | 繁體中文 | 日本語 | Русский | فارسی | Tiếng Việt | Español | Türkçe | Українська | Português (Brasil)
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.
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 Xrayconfig.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, andhysteria2-realmlisteners- 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
ANDrules - 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
![]() Overview | ![]() Client: quota, expiry, traffic reset and auto-renewal |
![]() Outbounds and proxy groups | ![]() Routing rules |
![]() Import from Xray / 3x-ui | ![]() shadcn theme, dark |
![]() Material Design 3 theme | ![]() Liquid Glass theme |
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.
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-uiIf 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.
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 sslThe 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.
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.
- Installation and Panel Configuration
- Migrating from 3x-ui
- Inbounds and Clients and Mihomo Settings
- Subscriptions and Subscription Templates
- Multi-control, Cloudflare WARP, and VPNGate
- Maintenance, API, and Common Questions
Run from source on Windows; the panel opens at http://127.0.0.1:2053 with the account admin / admin:
.\scripts\run.ps1Build Windows and Linux amd64 binaries, or all release archives:
.\scripts\build.ps1
.\scripts\build-release.ps1Validate 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.
- MetaCubeX/mihomo: the proxy core and configuration model
- MHSanaei/3x-ui: interface density and workflow
- Sub-Store: reference behavior for client subscription formats
- liquid-glass-webgl: the Liquid Glass controls (Apache-2.0, see
NOTICE) - Lucide and Material Symbols icons, Geist and Roboto fonts: the shadcn and Material Design 3 themes (ISC, Apache-2.0 and OFL-1.1, see
NOTICE)
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.









