发布时间

• 2026-10-12 11:40 GMT+0800

使用手册

• WIKI & SKILL

安装命令

:::SHELL
# [iptables for 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"


:::SHELL
# [iptables for 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"


:::SHELL
# [nftables for 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"


:::SHELL
# [nftables for 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"

• 启动前请先在插件设置页面的版本更新标签下确认内核编译版本，您也可以手动下载 Clash内核 后解压到 /etc/openclash/core/文件夹，并将二进制文件命名为clash_meta

常见问题

• 路由不建议开启IPV6和相关服务，目前反馈的网络连接问题多数与它有关。

  连接异常时请按照此页步骤先进行检查，解决不了再反馈

• 浏览器开启安全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
• 覆写模块加载时的安全限制
• 插件和内核更新时添加 sha256sum 检查
• 更新时 CDN 列表的自动远程同步
• 运行数据卡片添加折线视图
• 订阅添加时的步骤、视图指引强化，添加订阅转换模板预览，添加配置文件内容概览
• 覆写模块视图调整，添加 Google Play、Tailscale（解决本机代理时启用accept-dns可能导致的异常）、WifiCalling 默认模块
• 移除文件上传大小限制
• nginx 服务端的适配
• 页面交互细节、启动流程的增强和优化
• 已知错误和bug的修复

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