Miao

开箱即用的透明代理分流器，基于 sing-box 内核。单文件、零依赖，支持 Linux 与 OpenWrt。

快速开始

mkdir ~/miao && cd ~/miao
# amd64
wget https://github.com/YUxiangLuo/miao/releases/latest/download/miao-rust-linux-amd64 -O miao && chmod +x miao

mkdir ~/miao && cd ~/miao
# arm64
wget https://github.com/YUxiangLuo/miao/releases/latest/download/miao-rust-linux-arm64 -O miao && chmod +x miao

运行（需要 root 权限以创建 TUN 网卡）：

sudo ./miao

访问 http://localhost:6161，首次启动会进入引导页面，添加订阅链接或手动节点即可开始使用。

配置文件位置

Miao 会按以下顺序选择配置文件：

1. 命令行 --config /path/to/config.yaml
2. 可执行文件同目录下已有的 config.yaml
3. /etc/miao/config.yaml

如果启动时没有找到配置文件，Miao 只会使用内存中的默认配置并进入引导页面，不会主动写入空配置文件。只有通过面板添加订阅、添加节点、自动初始化 VPS，或其它需要持久化的配置变更时，才会写入配置文件。

运行时文件（sing-box、生成的 config.json、缓存、最后选择的节点）仍放在 /tmp/miao-sing-box，避免频繁写入闪存。通过面板切换“分流/全局”只更新当前运行会话，不会写入配置文件；配置文件中的 route_mode 会被忽略，启动默认使用分流模式。

进阶：手动编写配置文件

你也可以在可执行文件同目录或 /etc/miao/config.yaml 预先创建配置文件跳过引导：

port: 6161  # Web 面板端口，默认 6161

# 订阅链接（推荐，Clash.Meta 格式）
subs:
  - "https://your-subscription-url"

# 或手动配置节点（可与 subs 混合使用）
nodes:
  - '{"type":"hysteria2","tag":"HY2","server":"example.com","server_port":443,"password":"xxx","tls":{"enabled":true}}'
  - '{"type":"anytls","tag":"AnyTLS","server":"example.com","server_port":443,"password":"xxx","tls":{"enabled":true}}'
  - '{"type":"shadowsocks","tag":"SS","server":"example.com","server_port":443,"method":"2022-blake3-aes-128-gcm","password":"xxx"}'

实验性功能

自动初始化 Hysteria2 VPS

如果你有一台全新的 VPS，并且当前运行 Miao 的 root 环境可以通过 SSH 私钥免交互登录 root@<vps_ip>，可以在当前配置文件中添加：

vps_ip: "203.0.113.10"

启动时，Miao 会检查 nodes 中是否已经存在 server 相同的手动节点。不存在时，它会通过 SSH 在该 VPS 上安装 Hysteria2，写入 /etc/hysteria/config.yaml，使用 543 端口、自签名证书、随机密码和 Gecko 混淆，然后重启 hysteria-server.service。部署成功后，Miao 会把对应的 Hysteria2 手动节点写回解析到的本地配置文件。

如果 vps_ip 仍保留，但本地对应的手动节点被删除，Miao 会先尝试通过 SSH 读取远端已有的 /etc/hysteria/config.yaml 并恢复本地节点；如果远端配置缺少 Gecko 混淆，Miao 会补写后再恢复本地节点。只有远端没有可复用配置时才重新初始化。

运行前建议先确认：

sudo ssh -o BatchMode=yes root@203.0.113.10 true

如果这条命令失败，自动初始化也会失败。使用 root 运行 Miao 时，SSH 使用的是 /root/.ssh 下的密钥和配置。