OpenClash 下载

# 发布时间
* 2026-10-12 11:40 GMT+0800

# 使用手册
* [WIKI & SKILL](https://github.com/vernesong/OpenClash/blob/dev/.github/skills/openclash-user-guide/SKILL.md)

# 安装命令

在路由器上以 root 身份执行（需要 `curl` 与 `ca-bundle`）：

```shell
(curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/vernesong/OpenClash/dev/install.sh || curl -fsSL -o /tmp/install.sh https://cdn.jsdelivr.net/gh/vernesong/OpenClash@dev/install.sh) && sh /tmp/install.sh
```

<details>
<summary>手动安装（不使用脚本时）</summary>

安装依赖并下载最新版（iptables 防火墙）：

```shell
# opkg 系统（ipk）
opkg update
opkg install bash iptables dnsmasq-full curl ca-bundle ipset ip-full iptables-mod-tproxy iptables-mod-extra ruby ruby-yaml kmod-tun kmod-inet-diag unzip luci-compat luci luci-base
curl -L --retry 2 https://api.github.com/repos/vernesong/OpenClash/releases/latest -o /tmp/openclash_version
[ -f "/tmp/openclash_version" ] && download_url=$(cat /tmp/openclash_version | jsonfilter -e '@.assets[*].browser_download_url' | grep '\.ipk$') && curl -L --retry 2 "$download_url" -o /tmp/openclash.ipk || echo "OpenClash last version get failed"
[ -f "/tmp/openclash.ipk" ] && opkg install /tmp/openclash.ipk || echo "OpenClash download failed"

# apk 系统（apk）
apk update
apk add bash iptables dnsmasq-full curl ca-bundle ipset ip-full iptables-mod-tproxy iptables-mod-extra ruby ruby-yaml kmod-tun kmod-inet-diag unzip luci-compat luci luci-base
curl -L --retry 2 https://api.github.com/repos/vernesong/OpenClash/releases/latest -o /tmp/openclash_version
[ -f "/tmp/openclash_version" ] && download_url=$(cat /tmp/openclash_version | jsonfilter -e '@.assets[*].browser_download_url' | grep '\.apk$') && curl -L --retry 2 "$download_url" -o /tmp/openclash.apk || echo "OpenClash last version get failed"
[ -f "/tmp/openclash.apk" ] && apk add -q --force-overwrite --clean-protected --allow-untrusted /tmp/openclash.apk || echo "OpenClash download failed"
```

安装依赖并下载最新版（nftables 防火墙，Firewall4）：

```shell
# opkg 系统（ipk）
opkg update
opkg install bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip kmod-nft-tproxy luci-compat luci luci-base
curl -L --retry 2 https://api.github.com/repos/vernesong/OpenClash/releases/latest -o /tmp/openclash_version
[ -f "/tmp/openclash_version" ] && download_url=$(cat /tmp/openclash_version | jsonfilter -e '@.assets[*].browser_download_url' | grep '\.ipk$') && curl -L --retry 2 "$download_url" -o /tmp/openclash.ipk || echo "OpenClash last version get failed"
[ -f "/tmp/openclash.ipk" ] && opkg install /tmp/openclash.ipk || echo "OpenClash download failed"

# apk 系统（apk）
apk update
apk add bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip kmod-nft-tproxy luci-compat luci luci-base
curl -L --retry 2 https://api.github.com/repos/vernesong/OpenClash/releases/latest -o /tmp/openclash_version
[ -f "/tmp/openclash_version" ] && download_url=$(cat /tmp/openclash_version | jsonfilter -e '@.assets[*].browser_download_url' | grep '\.apk$') && curl -L --retry 2 "$download_url" -o /tmp/openclash.apk || echo "OpenClash last version get failed"
[ -f "/tmp/openclash.apk" ] && apk add -q --force-overwrite --clean-protected --allow-untrusted /tmp/openclash.apk || echo "OpenClash download failed"
```

</details>

> 插件安装失败时安装包会保留在 `/tmp/`，可按脚本输出的命令手动安装；内核下载失败时可在插件安装完成后，通过 LuCI 的「版本更新」页重新下载。

* 启动前请先在插件设置页面的版本更新标签下确认`内核编译版本`，您也可以手动下载 [Clash内核](https://github.com/MetaCubeX/mihomo/releases) 后解压到 `/etc/openclash/core/`文件夹，并将二进制文件命名为`clash_meta`

# 常见问题
* 路由不建议开启IPV6和相关服务，目前反馈的网络连接问题多数与它有关。
> [连接异常时请按照此页步骤先进行检查，解决不了再反馈](https://github.com/vernesong/OpenClash/wiki/网络连接异常时排查原因)
* 浏览器开启安全DNS，会导致分流异常，请关闭！
* 部分软件会修改设备HOSTS，会导致分流异常，请注意检查！
* 控制面板打开空白时请尝试刷新浏览器缓存
* 默认代理路由本机流量，BT、PT下载等请尽量使用redir模式并注意进行流量规避（可在规则中将路由地址设置为直连）
* 备份插件设置后可在配置文件管理页面上传压缩包进行还原

# 版本变化
* 首页添加初始引导
* Ruby 加载性能的优化，包括 ruby - uci 的读取和转换，缩短读取转换时间
* 主题颜色允许自定义
* 连通性检查页面添加常见服务解锁情况模式
* 默认禁用 tcp_fastopen_blackhole_timeout_sec ，防止旧版固件使用 TFO 异常
* TUN 模式默认启用GSO，默认使用 MIPS，相关模式、性能对比请查看 [性能实测数据](https://github.com/vernesong/OpenClash/blob/dev/.github/skills/openclash-user-guide/08-settings-mode-traffic.md#84-%E6%80%A7%E8%83%BD%E5%AE%9E%E6%B5%8B%E6%95%B0%E6%8D%AE)
* 覆写模块加载时的安全限制
* 插件和内核更新时添加 sha256sum 检查
* 更新时 CDN 列表的自动远程同步
* 运行数据卡片添加折线视图
* 订阅添加时的步骤、视图指引强化，添加订阅转换模板预览，添加配置文件内容概览
* 覆写模块视图调整，添加 Google Play、Tailscale（解决本机代理时启用accept-dns可能导致的异常）、WifiCalling 默认模块
* 移除文件上传大小限制
* nginx 服务端的适配
* 页面交互细节、启动流程的增强和优化
* 已知错误和bug的修复

**Full Changelog**: https://github.com/vernesong/OpenClash/compare/v0.47.156...v0.48.002