Skip to content

ClashForge Mobile v0.1.0-beta.54

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Jul 23:11
· 7 commits to main since this release
v0.1.0-beta.54
e624cd4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

ClashForge v0.1.0-beta.54

Mihomo (Clash.Meta) 透明代理管理器，适用于 OpenWrt — 单二进制文件，内嵌 Web UI。

💻 第一步：在电脑上安装 clashforgectl（一键脚本，推荐）

clashforgectl 是从你自己电脑远程管理路由器用的命令行工具（装/升级/诊断路由器上的 ClashForge），跟装在路由器上的 ClashForge 本体是两回事。装好之后，任意新开的终端窗口直接敲 clashforgectl 即可，无需再下载或指定路径。

Windows（PowerShell）：

irm https://dl.wei1xuan.com/install.ps1 | iex

macOS / Linux：

curl -fsSL https://dl.wei1xuan.com/install.sh | sh

一行装完直接执行命令（irm | iex 本身不能带参数，需要包一层 scriptblock）：

&([scriptblock]::Create((irm https://dl.wei1xuan.com/install.ps1))) -Router 192.168.20.1 upgrade
curl -fsSL https://dl.wei1xuan.com/install.sh | sh -s -- --router 192.168.20.1 upgrade

🇨🇳 dl.wei1xuan.com 访问不了时，直接从 GitHub 装：

irm https://raw.githubusercontent.com/wujun4code/clashforge/main/scripts/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/wujun4code/clashforge/main/scripts/install.sh | sh

🚀 用 clashforgectl 管理路由器

以下命令里的 <路由器IP> 换成你路由器的局域网 IP（如 192.168.20.1）。PowerShell 用 -Router，macOS/Linux 用 --router——下面统一用 PowerShell 语法举例，Unix 下把 -Xxx 换成 --xxx（小写）即可，例如 -Router → --router。

① 首次安装 ClashForge 到路由器：

clashforgectl -Router <路由器IP> compat     # 安装前兼容性检查（可选但推荐）
clashforgectl -Router <路由器IP> upgrade    # 下载并安装（首次运行=全新安装，非首次=原地升级）

全新安装时如果服务没有自动启动，SSH 到路由器执行：/etc/init.d/clashforge enable && /etc/init.d/clashforge start，然后打开 http://<路由器IP>:7777。

② 网络与服务状况诊断（netdiag）：

clashforgectl -Router <路由器IP> netdiag

直接从你电脑访问路由器的 ClashForge HTTP API 做诊断（不需要 SSH），依次检查：路由器连通性、DNS 解析（含 fake-ip 污染检测）、透明代理/防火墙接管状态、mihomo 核心状态等。加 -Monitor 可持续监控：

clashforgectl -Router <路由器IP> netdiag -Monitor

③ 升级 ClashForge 到最新版（或指定版本）：

clashforgectl -Router <路由器IP> upgrade                       # 升级到最新版
clashforgectl -Router <路由器IP> upgrade -Version v0.1.0-beta.1 # 升级到指定版本
clashforgectl -Router <路由器IP> upgrade -Purge                 # 先清空旧配置再升级（全新开始）

④ 停止 / 启动路由器上的 ClashForge 服务：

clashforgectl -Router <路由器IP> stop    # 停止服务并完全退出接管模式（DNS/防火墙规则一并恢复）

目前没有单独的"启动"命令。stop 之后要重新跑起来，SSH 到路由器执行：

/etc/init.d/clashforge start

⚠️ clashforgectl reset 也能把服务重新拉起来，但它会清空所有订阅、规则、覆盖配置和缓存，恢复到刚装完的状态——只是想重启服务的话不要用这个，用上面的 /etc/init.d/clashforge start。真的要清空重来时才用 clashforgectl -Router <路由器IP> reset -Start（-Start 表示清空后立即启动）。

⑤ 卸载路由器上的 ClashForge 服务：

clashforgectl -Router <路由器IP> uninstall                # 完全卸载（删除 /etc/metaclash 配置）
clashforgectl -Router <路由器IP> uninstall -KeepConfig    # 卸载但保留订阅/配置，方便以后重装

其它常用命令：status（查看当前状态）、diag（生成完整诊断报告）、openclash -Kill（检测并清理 OpenClash 残留）。完整参数说明：clashforgectl help。

🗑️ 在电脑上卸载 clashforgectl

移除的是你电脑上的 clashforgectl 命令本身，不影响路由器上已安装的 ClashForge（路由器那边请用上面的 ⑤ uninstall）。

Windows：

irm https://dl.wei1xuan.com/uninstall.ps1 | iex

macOS / Linux：

curl -fsSL https://dl.wei1xuan.com/uninstall.sh | sh

🖥️ 路由器本机安装

SSH 进入路由器后执行，自动检测 CPU 架构，自动下载并安装最新版：

wget -qO- https://dl.wei1xuan.com/releases/latest/clashforgectl.sh | sh -s -- upgrade

🇨🇳 GitHub 访问慢时：

wget -qO- https://ghproxy.com/https://raw.githubusercontent.com/wujun4code/clashforge/main/scripts/clashforgectl.sh | sh -s -- upgrade

也可手动指定镜像：sh clashforgectl.sh upgrade --mirror https://ghproxy.com

安装本版本（v0.1.0-beta.54）：

wget -qO- https://dl.wei1xuan.com/releases/latest/clashforgectl.sh | sh -s -- upgrade --version v0.1.0-beta.54

全新安装（清除旧版所有残留后重装）：

wget -qO- https://dl.wei1xuan.com/releases/latest/clashforgectl.sh | sh -s -- upgrade --purge

💡 安装脚本地址固定，无需随版本更新

🌩️ 通过 Cloudflare R2 托管安装（Fork 用户）

如果你 fork 了本仓库并配置了自己的 Cloudflare R2 存储，可以使用自定义域名直接安装，无需依赖 GitHub：

wget -qO- https://raw.githubusercontent.com/wujun4code/clashforge/main/scripts/clashforgectl.sh | \
  sh -s -- upgrade --base-url https://releases.example.com

安装指定版本：

wget -qO- https://raw.githubusercontent.com/wujun4code/clashforge/main/scripts/clashforgectl.sh | \
  sh -s -- upgrade --base-url https://releases.example.com --version v0.1.0-beta.54

将 https://releases.example.com 替换为你在 R2 bucket 上绑定的自定义域名。
R2 配置方法参见：Fork 后配置自己的 Cloudflare R2 下载加速

🖥️ Hyper-V / x86_64 OpenWrt 快速安装（R2 最新版）

如果你是在 Hyper-V 里的 x86_64 OpenWrt 虚拟机中安装，可以直接使用 R2 上的最新 x86_64 IPK：

cd /tmp
wget -O clashforge-latest-x86_64.ipk https://dl.wei1xuan.com/clashforge-latest-x86_64.ipk
opkg install --nodeps ./clashforge-latest-x86_64.ipk
/etc/init.d/clashforge enable
/etc/init.d/clashforge restart

安装完成后打开：http://<OpenWrt-IP>:7777

Windows 主机也可以下载最新 ctl 脚本后远程安装：

Invoke-WebRequest 'https://dl.wei1xuan.com/clashforgectl.ps1' -OutFile .\clashforgectl.ps1
.\clashforgectl.ps1 -Router <OpenWrt-IP> upgrade

手动安装 IPK

先下载对应架构的 IPK，再通过 opkg 安装（--nodeps 跳过依赖检查，因 mihomo 已打包在内）：

x86_64（PC 路由 / x86 OpenWrt）

wget https://github.com/wujun4code/clashforge/releases/download/v0.1.0-beta.54/clashforge_0.1.0-beta.54_x86_64.ipk
opkg install --nodeps clashforge_0.1.0-beta.54_x86_64.ipk

AArch64 通用（Cortex-A72/A73/A55，NanoPi R4S/R5S 等）

wget https://github.com/wujun4code/clashforge/releases/download/v0.1.0-beta.54/clashforge_0.1.0-beta.54_aarch64_generic.ipk
opkg install --nodeps clashforge_0.1.0-beta.54_aarch64_generic.ipk

AArch64 Cortex-A53（Raspberry Pi 3, MT7981/MT7986/MT7622 等）

wget https://github.com/wujun4code/clashforge/releases/download/v0.1.0-beta.54/clashforge_0.1.0-beta.54_aarch64_cortex-a53.ipk
opkg install --nodeps clashforge_0.1.0-beta.54_aarch64_cortex-a53.ipk

手动安装 APK（OpenWrt 25.12+）

OpenWrt 25.12 及以上使用 apk，下载对应架构 APK 后安装：

x86_64

wget https://github.com/wujun4code/clashforge/releases/download/v0.1.0-beta.54/clashforge_0.1.0-beta.54_x86_64.apk
apk add --allow-untrusted ./clashforge_0.1.0-beta.54_x86_64.apk

aarch64_generic

wget https://github.com/wujun4code/clashforge/releases/download/v0.1.0-beta.54/clashforge_0.1.0-beta.54_aarch64_generic.apk
apk add --allow-untrusted ./clashforge_0.1.0-beta.54_aarch64_generic.apk

aarch64_cortex-a53

wget https://github.com/wujun4code/clashforge/releases/download/v0.1.0-beta.54/clashforge_0.1.0-beta.54_aarch64_cortex-a53.apk
apk add --allow-untrusted ./clashforge_0.1.0-beta.54_aarch64_cortex-a53.apk

安装完成后

# Web UI（浏览器打开）
http://<路由器IP>:7777

# 查看运行状态
/etc/init.d/clashforge status

# 编辑配置（通常不需要手动编辑，通过 Web UI 操作即可）
vi /etc/metaclash/config.toml

卸载

opkg remove clashforge
# OpenWrt 25.12+:
apk del clashforge
# 或完全清除（含配置和数据）：
uninstall-clashforge

SHA256 校验

见附件 SHA256SUMS.txt

Assets 16
Loading