跳到主要内容
项目档案应用项目

Linux mihomo代理部署工具集 - 带Web控制面板的透明代理完整部署方案

本页面提供Linux系统下mihomo代理的完整部署方案,包含预编译内核、Web控制面板配置、系统代理/TUN透明代理配置教程,以及代理订阅自动更新脚本的使用说明,可快速搭建带管理界面的代理服务。

5PythonStar 于 2026年9月6日2026年9月6日 更新

AI 总结

面向Linux系统的mihomo代理部署工具集,提供预编译内核、Web控制面板部署指引与配置自动更新脚本,支持系统代理与TUN透明代理模式,降低代理服务部署门槛。

中文项目介绍

本项目是面向Linux系统的mihomo(Clash兼容内核)代理部署工具集,核心包含预编译的mihomo代理内核、GeoIP/GeoSite规则数据库、metacubexd Web控制面板部署指引,以及代理配置自动更新Python脚本,旨在简化Linux环境下代理服务的部署与运维流程。 它解决了Linux下手动部署mihomo代理内核、配置Web管理面板、更新代理订阅配置流程繁琐、门槛高的问题,提供了系统代理、TUN透明代理两种模式的标准化配置方案,无需用户逐个查找组件、手动编写复杂配置。 适用于Linux服务器、个人设备快速部署带Web管理界面的代理服务,支持通过Web面板可视化管理代理节点与规则,配套的update_config.py脚本可实现代理订阅配置的原子化自动更新,自动备份原配置文件保障更新安全性,适配不同用户的代理使用需求。

详细信息与使用说明

1. 项目定位与用途

本项目是面向Linux系统的mihomo代理部署工具集,定位为降低Linux环境下代理服务部署与运维门槛的轻量工具包。核心提供预编译的mihomo代理内核、配套GeoIP/GeoSite规则数据库、metacubexd Web控制面板部署指引,以及代理配置自动更新脚本,无需用户自行编译内核、逐个下载组件、手动编写复杂配置,即可快速搭建带Web管理界面的代理服务。

2. 解决的问题

解决了Linux系统下手动部署mihomo代理服务流程繁琐、组件来源分散、配置门槛高的问题,避免了用户自行查找内核版本、下载规则库、配置Web面板、编写启动脚本的重复劳动;同时解决了代理订阅节点更新需要手动修改配置文件的痛点,提供自动化的配置更新与备份机制,大幅降低运维成本。

3. 适用场景

适用于需要在Linux服务器、个人Linux设备上部署代理服务的各类场景,包括开发测试环境网络访问、服务器流量代理、局域网透明代理搭建等;支持系统代理、TUN透明代理两种模式,可适配命令行工具代理、全局流量代理等不同使用需求,配套Web控制面板支持可视化管理代理节点与规则。

4. 安装方式

安装流程分为组件准备与依赖安装两步:首先创建/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。

5. 使用方式

使用方式分为服务启动、配置更新、代理模式配置三类:直接运行mihomo内核即可启动代理服务,访问http://<主机IP>:9090/ui通过Web面板管理代理节点;执行python update_config.py [订阅链接]可自动更新config.yaml中的代理节点、分组、规则,支持--config指定配置文件、--no-backup关闭备份参数;系统代理模式需配置.bashrc环境变量指向本地代理端口,TUN模式需开启内核流量转发、配置DNS后可通过systemd托管服务。

6. 补充说明与实现特点

项目配套的配置更新脚本采用原子替换机制,自动备份原配置文件为config.yaml.bak,保障配置更新安全性;TUN模式配置需注意2025年3月后海外DoH/DoT服务被屏蔽,需通过指定代理形式访问或启用fake-ip模式;项目未明确提供systemd服务配置文件模板,需用户自行配置。

思维导图

mihomo Linux代理部署工具集
核心组件
mihomo代理内核
GeoIP/GeoSite规则库
metacubexd Web控制面板
配置更新脚本
部署流程
组件下载
权限配置
配置文件准备
服务启动
代理模式
系统代理
TUN透明代理
配置管理
订阅自动更新
配置原子备份
Web可视化配置

常见问题

如何启动mihomo代理服务?

直接运行预编译的mihomo内核文件即可启动服务,访问http://<主机IP>:9090/ui即可进入Web控制面板管理代理节点。

如何自动更新代理订阅配置?

安装requests、ruamel.yaml依赖后,执行python update_config.py [订阅链接]即可自动更新config.yaml中的代理节点、分组与规则,支持--config指定配置文件、--no-backup关闭备份。

TUN模式配置需要注意什么?

需先开启系统内核流量转发,关闭默认systemd-resolved服务避免53端口冲突,配置Clash内置DNS;2025年3月后海外DoH/DoT服务被屏蔽,需通过代理形式访问或启用fake-ip模式。

如何配置系统代理?

在.bashrc文件中配置http_proxy、https_proxy、all_proxy环境变量指向本地代理端口,执行source ~/.bashrc即可生效。

更新配置后如何重启服务?

前台运行需停止当前进程后重新启动内核,若使用systemd托管服务,执行systemctl restart clash即可使新配置生效。