ACL4SSR 教程

OpenClash 教程：安装、订阅转换选 ACL4SSR 模板、运行模式选择

分类：客户端教程更新于 约 6 分钟读完9 份官方资料
本文目录
  1. 安装
  2. 下载内核
  3. 添加订阅并用 ACL4SSR 模板转换
  4. 运行模式怎么选
  5. 出问题怎么排查
  6. 常见问题

OpenClash 是运行在 OpenWrt 路由器上的 Clash 插件，在 LuCI 网页界面中管理，内核使用 mihomo（Meta）。本文写作时的最新正式版是 v0.47.156（2026-08-10）。下文的中文选项名来自官方使用手册，路由器上的实际显示取决于 LuCI 语言包，可能略有出入。

安装#

先确认路由器用的是 iptables（firewall3）还是 nftables（firewall4），两者的额外依赖不同。官方发布页列出的依赖：

需要安装的包
公共依赖bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip luci-compat luci luci-base
iptables 额外iptables ipset iptables-mod-tproxy iptables-mod-extra
nftables 额外kmod-nft-tproxy

README 的说明：luci-compat 需要 LuCI 19.07 或更新版本，kmod-tun 用于 TUN 模式，kmod-inet-diag 用于 PROCESS-NAME 规则。

安装包有两种格式：用 opkg 的系统装 .ipk，用 apk 的新版 OpenWrt 装 .apk。最简单的方法是从 GitHub Releases 下载对应的包，在 LuCI 的“系统 → 软件包”里上传安装，然后到“服务 → OpenClash”里配置。发布页也给出了命令行安装方式。

下载内核#

OpenClash 首次运行时会下载内核，需要路由器能正常访问网络。内核相关设置在“插件设置 → 版本更新”里：

  • “编译版本”：选择与路由器处理器对应的版本，例如 linux-amd64-v1、linux-arm64、linux-armv7。没选会提示 “No Compiled Version Selected”。
  • “更新分支”：master 是稳定版，dev 是开发版。
  • “Smart 内核”：关闭时使用 Meta 内核，开启时使用 Smart 内核。
  • 下载 CDN：GitHub 访问不畅时，可以换成 jsdelivr 等镜像，或填自定义地址。

官方使用手册里没有内核自动更新的开关，内核需要在这一页手动更新；运行状态页的“检查更新”会一键更新插件、内核、订阅和 GEO 数据。也可以手动下载 mihomo 内核，放到 /etc/openclash/core/ 下，命名为 clash_meta。

添加订阅并用 ACL4SSR 模板转换#

在“配置订阅”里添加一条订阅，主要字段：

字段说明
订阅名称不能和其他订阅重复
订阅地址机场订阅链接
User-Agent预设有 clash-verge、clash.meta、clash
在线订阅转换默认关闭。开启后，订阅会先经过订阅转换后端，按所选模板生成 Clash 配置
订阅转换模板开启在线订阅转换后选择
筛选节点 / 排除节点按关键字保留或排除节点，多个关键字用 & 表示同时满足，用 | 表示满足其一

OpenClash 内置的转换模板列表里有 30 多个 ACL4SSR 模板，名称形如“ACL4SSR 规则 Online”“ACL4SSR 规则 Online Full”“ACL4SSR 规则 Online Mini”，对应 ACL4SSR 仓库 Clash/config/ 目录下的同名 .ini 文件，例如：

ACL4SSR 规则 Online,ACL4SSR_Online.ini,https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online.ini

按 ACL4SSR 原配置文件统计，三个常用模板的规模如下，不确定时可以从 Online 开始：

模板规则集策略组特点
ACL4SSR 规则 Online1411含去广告、自动测速、微软和苹果分流
ACL4SSR 规则 Online Full3129分流更细，并增强中国 IP 段和国外 GFW 规则
ACL4SSR 规则 Online Mini115精简版，没有微软、苹果分流

列表最后的 “Custom Template” 可以填写自己的模板地址。开启在线订阅转换后，还会出现这些选项：

  • 转换后端地址：源码中默认是 https://api.asailor.org/sub，另一个内置选项是 https://api.wcc.best/sub，都是第三方公共服务。
  • Emoji、UDP、排序：默认关闭。
  • skip-cert-verify：默认开启。
在线转换时，订阅链接会发给转换后端。不想让订阅经过第三方服务器，可以自己部署 subconverter，见本站的 subconverter Docker 部署。

订阅的自动更新可以选两种模式：“预约模式”按每天或每周某天的固定钟点更新；“循环模式”按间隔分钟数更新，默认 60 分钟。

更新出配置文件后，到“配置管理”的配置文件列表里点击目标配置的切换按钮，OpenClash 会把它设为当前配置并自动重启内核。

运行模式怎么选#

在“插件设置 → 模式设置”的“选择运行模式”里，有以下六种：

模式说明
Fake-IP 模式官方建议日常使用首选
Fake-IP (混合)TCP 和 UDP 分开处理，UDP 走 TUN；部分应用出现 NAT 问题时改用
Fake-IP (TUN)路由器上装有 Docker 时可以考虑
兼容模式 (Redir-Host)、兼容模式 (TUN)、兼容模式 (混合)Redir-Host 方式的对应版本

TUN 和混合模式需要 kmod-tun，以及 nftables 下的 kmod-nft-tproxy 或 iptables 下的 kmod-ipt-tproxy。TUN 和混合模式还可以选“TUN 堆栈类型”：system、gvisor 或 mixed。

官方发布说明还建议不要在路由器上开启 IPv6，因为大部分连接问题与 IPv6 有关。

出问题怎么排查#

官方推荐的第一步是生成调试日志：在 LuCI 的“运行日志 → 调试日志”里点“生成日志”，或者 SSH 登录路由器运行：

/usr/share/openclash/openclash_debug.sh
cat /tmp/openclash_debug.log

其他常用命令：

pidof clash                        # 内核是否在运行
tail -30 /tmp/openclash.log        # 运行日志
tail -30 /tmp/openclash_start.log  # 启动日志
/etc/init.d/openclash reload       # 重载，不断开现有连接
/etc/init.d/openclash restart      # 重启，会断网几秒

官方手册列出的常见报错关键字包括 Core Start Failed, Please Check The Log Infos!（内核启动失败）、Config File Subscribed Failed（订阅下载失败）、Download Failed: HTML Response Detected（下载到的是网页而不是配置）、Core Update Failed（内核更新失败）和 Parse config error（配置解析错误）。看到这些关键字后，结合调试日志查看具体原因。

常见问题

OpenClash 订阅转换模板选哪个？
OpenClash 内置了 30 多个 ACL4SSR 模板。常用的是 ACL4SSR 规则 Online（14 个规则集、11 个策略组），分流更细的 Online Full（31 个规则集、29 个策略组），以及精简的 Online Mini（11 个规则集、5 个策略组），不确定时从 Online 开始。
OpenClash 的在线订阅转换安全吗？
在线转换会把订阅链接发给转换后端，默认后端是第三方公共服务。不想经过第三方，可以自建 subconverter 后端。
OpenClash 运行模式选 Fake-IP 还是 Redir-Host？
官方建议日常使用首选 Fake-IP 模式；部分应用有 NAT 问题时用 Fake-IP (混合)。
OpenClash 启动失败怎么排查？
先在“运行日志 → 调试日志”里生成日志，或运行 /usr/share/openclash/openclash_debug.sh 并查看 /tmp/openclash_debug.log。
资料来源
同类教程

本站是非官方的学习笔记站，与 ACL4SSR 原项目维护者无隶属关系。文中引用的规则与文档版权归原作者所有。