1. 项目定位与用途
本项目是面向Linux系统的mihomo代理部署工具集,定位为降低Linux环境下代理服务部署与运维门槛的轻量工具包。核心提供预编译的mihomo代理内核、配套GeoIP/GeoSite规则数据库、metacubexd Web控制面板部署指引,以及代理配置自动更新脚本,无需用户自行编译内核、逐个下载组件、手动编写复杂配置,即可快速搭建带Web管理界面的代理服务。
本页面提供Linux系统下mihomo代理的完整部署方案,包含预编译内核、Web控制面板配置、系统代理/TUN透明代理配置教程,以及代理订阅自动更新脚本的使用说明,可快速搭建带管理界面的代理服务。
面向Linux系统的mihomo代理部署工具集,提供预编译内核、Web控制面板部署指引与配置自动更新脚本,支持系统代理与TUN透明代理模式,降低代理服务部署门槛。
本项目是面向Linux系统的mihomo代理部署工具集,定位为降低Linux环境下代理服务部署与运维门槛的轻量工具包。核心提供预编译的mihomo代理内核、配套GeoIP/GeoSite规则数据库、metacubexd Web控制面板部署指引,以及代理配置自动更新脚本,无需用户自行编译内核、逐个下载组件、手动编写复杂配置,即可快速搭建带Web管理界面的代理服务。
解决了Linux系统下手动部署mihomo代理服务流程繁琐、组件来源分散、配置门槛高的问题,避免了用户自行查找内核版本、下载规则库、配置Web面板、编写启动脚本的重复劳动;同时解决了代理订阅节点更新需要手动修改配置文件的痛点,提供自动化的配置更新与备份机制,大幅降低运维成本。
适用于需要在Linux服务器、个人Linux设备上部署代理服务的各类场景,包括开发测试环境网络访问、服务器流量代理、局域网透明代理搭建等;支持系统代理、TUN透明代理两种模式,可适配命令行工具代理、全局流量代理等不同使用需求,配套Web控制面板支持可视化管理代理节点与规则。
安装流程分为组件准备与依赖安装两步:首先创建/opt/clash目录,下载对应系统架构的mihomo内核解压后添加执行权限,下载Country.mmdb地理IP库、geosite.dat域名规则库放置到/opt/clash目录,下载metacubexd控制面板解压到/opt/clash/ui目录,准备config.yaml配置文件并配置external-controller、external-ui等必要参数;其次安装update_config.py的运行依赖:requests、ruamel.yaml。
使用方式分为服务启动、配置更新、代理模式配置三类:直接运行mihomo内核即可启动代理服务,访问http://<主机IP>:9090/ui通过Web面板管理代理节点;执行python update_config.py [订阅链接]可自动更新config.yaml中的代理节点、分组、规则,支持--config指定配置文件、--no-backup关闭备份参数;系统代理模式需配置.bashrc环境变量指向本地代理端口,TUN模式需开启内核流量转发、配置DNS后可通过systemd托管服务。
项目配套的配置更新脚本采用原子替换机制,自动备份原配置文件为config.yaml.bak,保障配置更新安全性;TUN模式配置需注意2025年3月后海外DoH/DoT服务被屏蔽,需通过指定代理形式访问或启用fake-ip模式;项目未明确提供systemd服务配置文件模板,需用户自行配置。
直接运行预编译的mihomo内核文件即可启动服务,访问http://<主机IP>:9090/ui即可进入Web控制面板管理代理节点。
安装requests、ruamel.yaml依赖后,执行python update_config.py [订阅链接]即可自动更新config.yaml中的代理节点、分组与规则,支持--config指定配置文件、--no-backup关闭备份。
需先开启系统内核流量转发,关闭默认systemd-resolved服务避免53端口冲突,配置Clash内置DNS;2025年3月后海外DoH/DoT服务被屏蔽,需通过代理形式访问或启用fake-ip模式。
在.bashrc文件中配置http_proxy、https_proxy、all_proxy环境变量指向本地代理端口,执行source ~/.bashrc即可生效。
前台运行需停止当前进程后重新启动内核,若使用systemd托管服务,执行systemctl restart clash即可使新配置生效。