Appearance
mihoro 快速配置与详细使用指南
mihoro 是一款高度围绕 Mihomo (Clash.Meta) 生态打造的客户端。从它的命名方式就可以看出，它与底层的 Mihomo 核心有着血浓于水的联系。
这款客户端在开发者的圈子内享有很高的声誉，通常以轻量、极客化和多平台适应性著称。它不仅可能在桌面端提供一套直观的交互界面，甚至在某些版本中还提供强大的命令行 (CLI) / 文本界面 (TUI) 支持，让服务器管理员和纯键盘流玩家爱不释手。
1. 软件下载与安装准备
由于这类工具带有极强的技术属性，推荐始终从 GitHub 官方 Release 页面拉取。
第一步：获取最新版本
- 访问 GitHub 项目主页的 Release 板块。
- 桌面用户：下载对应操作系统的压缩包（Windows 为
.zip或.exe，Mac 为.dmg，Linux 为.tar.gz）。 - 注意系统架构：苹果 M 系芯片和 ARM 服务器请下载带
arm64 / aarch64标识的包；常规电脑下载x64或amd64。
*👉 点击前往 mihoro 官方 Github 下载页面 (请以 Github 搜索的实际最新仓库为准)
第二步：安装与应对环境限制
- 绿色版解压：如果您下载的是免安装绿色版，请将其解压在一个完全没有中文字符和空格的路径下，这是避免核心启动失败的关键。
- Mac 权限限制：如果遇到“应用已损坏”的警告，打开终端执行隔离解除命令：bash
sudo xattr -r -d com.apple.quarantine /Applications/mihoro.app
2. 获取机场订阅链接
再极客的工具也离不开稳定的数据节点支持。
- 登录您的机场服务商后台（如果您还在寻找节点，请查看本站为您整理的 👉 2026 优质稳定机场榜单）。
- 找到您的服务面板或控制台中的 “一键订阅” 区域。
- 请点击 “复制 Clash 订阅链接” 或者 “复制 Clash.Meta 订阅”。因为 mihoro 与该生态深度绑定，对 YAML 格式的解析非常完美。
3. 导入节点与开启代理（图文流程）
如果您使用的是 mihoro 的图形化版本，配置逻辑如下：
步骤一：进入配置中心
运行程序后，进入主界面，在侧边导航找到 配置 (Profiles) 或订阅管理面板。
步骤二：添加远端订阅链接
点击添加（+号），填入一个好记的备注名称（如机场名），将刚刚复制的订阅 URL 粘贴进地址栏。保存后点击 更新 (Update) 从云端拉取节点。
步骤三：激活该配置文件
拉取成功后，该卡片会出现在列表中。一定要用鼠标点击选中它，使其状态变为已激活（高亮或打钩状态），此时内核正式接管配置。
步骤四：开启系统代理
返回软件的 仪表盘 (Dashboard)，找到醒目的 系统代理 (System Proxy) 开关并将其开启。此刻，您的默认网页浏览器已经可以访问外网了。
步骤五：节点测速与分流
前往 代理 (Proxies) 选项卡。首先确保顶部的路由模式为 规则 (Rule) 以便智能分流。点击界面上的测速图标，选一个延迟极低的绿色节点即可开始冲浪。
4. 进阶玩法：TUN 模式与终端命令行玩法
mihoro 绝不仅限于普通的网页代理，它对极客玩家有着更深度的支持。
开启底层 TUN (虚拟网卡) 模式： 如果您要玩海外端游、使用电报或是 Docker，普通的代理是无效的。在设置中找到 TUN 模式 并开启它。Windows 下需要点击 UAC 弹窗赋予管理员权限；Mac 下需要输入开机密码。开启后系统实现全局无感翻墙。
环境变量与 CLI 支持： 如果您是在 Linux 服务器或没有桌面的终端里使用 mihoro，您可以利用环境变量直接让终端命令走代理。执行以下命令即可：
bashexport http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890(注：7890 是通常的默认混合端口，具体请参考您软件面板里的设定)
5. 常见问题排查与 FAQ
不论使用何种形式（GUI 还是 CLI），底层的网络排障逻辑是一模一样的：
1. 为什么导入订阅时一直提示拉取失败或 Timeout？
这通常是因为您的本地宽带 DNS 被污染，无法解析机场服务器。 解决办法：请联系机场客服索要“备用防封锁订阅链接”，或者临时用手机 4G/5G 开热点给电脑提供网络，成功更新出节点文件后再换回宽带环境。
2. 系统代理已经开了，为什么谷歌打不开，甚至连国内网站也断网了？
这是发生了代理端口（如 7890）冲突，或者陷入了系统的回环死循环。 解决办法：请检查电脑后台是否同时开着其他加速器或翻墙工具，务必彻底关闭它们。然后在 mihoro 中先把“系统代理”开关关掉，等待几秒钟后再重新开启以刷新系统注册表。
3. 为什么在代理界面点击测速，所有节点全部报红显示 Timeout？
全部超时说明客户端已经和所有的境外节点彻底失联。
- 请先登录机场官网检查套餐流量是否用尽或过期。
- 可能是目前的旧节点 IP 已被防火墙大规模封锁，请去“配置”列表点击“更新”，重新拉取最新的节点。
4. 我开启了 TUN 模式，为什么某款外服游戏依然连不上？
TUN 模式虽然截获了流量，但如果软件自带的分流规则判定该游戏流量为“直连（Direct）”，就不会走海外节点。 解决办法：在 Proxies (代理) 面板，把路由模式从“规则 (Rule)”强制切换为“全局代理 (Global)”，手动选定专属游戏节点，再启动游戏。
5. 如何让其开机自动在后台静默运行？
作为核心工具，您可以进入 设置 (Settings)，勾选 开机启动 (Start on boot) 以及 静默启动 (Silent Start / Hidden) 选项，这样下次开机它就会在系统托盘安静待命了。