mihomo-docs

Guide mihomo YAML configuration for DNS, proxies, and routing rules.

7|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/wenerme/ai --skill mihomo-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mihomo-docs
Source: https://github.com/wenerme/ai/tree/main/skills/mihomo-docs
Command: npx skills add https://github.com/wenerme/ai --skill mihomo-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you quickly find the correct options, structures, and relationships when configuring mihomo (Clash Meta), especially for complex YAML such as DNS, inbounds, proxy nodes, proxy groups, routing rules, and deployment/API settings.

Core Features & Use Cases

  • Configuration guidance coverage: provides reference guidance across general settings, DNS (including hosts/policy routing), inbounds (TUN/TProxy/ports/listeners), proxies (major protocols), proxy groups (select/url-test/fallback/load-balance/relay), and routing rules/sub-rules/rule providers/proxy providers.
  • Troubleshooting support via indexed references: includes an explicit “CRITICAL” reminder to check references content before answering, helping ensure responses align with the documentation set.
  • Deployment & API support: covers startup/deployment and REST API endpoints to help you operate mihomo after the YAML is written.

Quick Start

Ask about how to configure mihomo DNS routing for a rule-based domain strategy and explain what YAML sections and fields you should set.

Frequently Asked Questions about mihomo-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure DNS routing in mihomo or Clash Meta YAML?

Mihomo proxy groups like select, url-test, fallback, load-balance, and relay organize nodes under a `proxy-groups` YAML array. Each group type dictates traffic distribution behavior, allowing you to chain proxies or automatically select the fastest node based on latency testing.

Does mihomo support VLESS, TUIC, and WireGuard protocols in YAML?

Yes, mihomo supports VLESS, VMess, Trojan, Shadowsocks, WireGuard, and TUIC protocols. You configure these nodes under the `proxies` section in your YAML file, specifying the correct protocol fields and transport methods to establish secure proxy connections.

How do I set up TUN inbound mode for Clash Meta?

Setting up TUN inbound for Clash Meta requires configuring the `tun` section in your YAML file with specific device parameters and routing rules. This creates a virtual network interface to capture system traffic, requiring proper system permissions for TProxy or TUN deployment.

What are rule providers and how do I use them in mihomo?

Rule providers in mihomo are external rule sets referenced in the `rule-providers` YAML section, allowing you to fetch and update routing rules dynamically. You apply these providers within your `rules` section to route traffic without manually maintaining long domain or IP lists.

Why is my mihomo YAML configuration not working as expected?

Mihomo YAML misconfigurations often occur in DNS routing, proxy groups, or rule definitions due to incorrect indentation or invalid field values. You must verify protocol structures and consult indexed references to ensure your YAML sections align with the documented configuration scope.