功能定位：为什么要在Linux端用Clash模式
快连在Linux上提供「Clash兼容层」：把自研KCP+TLS1.3节点伪装成Clash可读的YAML配置，既保留官方AI-Route 2.0的秒级切换，又能让老玩家继续用熟悉的规则集。核心关键词「快连Linux端Clash模式如何导入自定义规则」解决的是：当默认广告过滤、流媒体解锁规则不满足时，如何把个人/公司级YAML片段无损合并进去，而不被下次云端更新覆盖。
与Windows、macOS不同，Linux客户端没有图形「规则商店」按钮，所有自定义动作都落在~/.config/kuailian/clash/目录。理解这一点后，再谈导入才不会把文件写进黑洞。
前置检查：版本、权限、网络三件事
1. 确认客户端版本
截至当前的最新版本（5.3.0）才内置Clash兼容层；旧版只有「全局」与「分应用」两种模式，菜单里找不到Clash字样。终端执行：
kuailian-cli --version
若回显<5.3.0，请先去官网下载AppImage或deb包覆盖安装；更新后首次启动会自动生成~/.config/kuailian/clash/空骨架。
2. 保证用户对配置目录有写权限
经验性观察：在共享办公电脑或NAS Docker环境里，目录常被root创建，普通用户写入失败导致「规则不生效」。一次性修正：
sudo chown -R $USER:$USER ~/.config/kuailian/clash/
3. 先让客户端完成一次云端同步
首次启用Clash模式时，快连会拉取约300 KB的远端规则。若离线状态下直接写YAML，下次联网时远端文件会覆盖本地，出现「改完消失」的错觉。建议打开客户端→Settings→Clash Mode→Toggle ON，观察日志出现download ruleset complete再关机。
自定义规则文件放哪里：目录结构一次看懂
~/.config/kuailian/clash/下只有三个子目录会被读取：
| 目录 | 用途 | 覆盖优先级 |
|---|---|---|
| rules.d/ | 用户自定义规则片段 | 最高，云端更新不碰 |
| provider.d/ | 远/近端规则订阅 | 中等，可被云端刷新 |
| cache/ | 运行期生成的mrs缓存 | 最低，重启可删 |
因此，只要把*.yaml放进rules.d/即可；文件名任意，排序按字母序合并。
写一段最小可用自定义规则
Clash的YAML规则段必须包含payload列表，其余键可选。示例：把公司内网192.168.99.0/24设为直连，避免SSH绕路。
# ~/.config/kuailian/clash/rules.d/99-company.yaml payload: - IP-CIDR,192.168.99.0/24,DIRECT - DOMAIN-SUFFIX,internal.example.com,DIRECT
保存后执行热重载：
kuailian-cli clash-reload
终端回显ruleset reload ok即代表语法通过；若出现error，会打印行号，按提示修正即可。
与官方规则合并顺序：谁先生效
快连启动时按「云端主配置→provider.d→rules.d」三层合并，同一条目后出现的覆盖前者。经验性观察：把越个性化的规则数字前缀设越大（如99-），可确保最终生效。
导入第三方规则集：订阅链接与本地文件双方案
1. 订阅链接方案（可被更新覆盖）
在provider.d/内新建yaml，写入：
payload: - https://cdn.example.com/adrules.txt
客户端每日第一次启动时会拉取并转成mrs缓存；若远端404，则回退到上次缓存，不会崩溃。
2. 本地文件方案（绝对安全）
把第三方规则下载后放rules.d/，去掉URL字段即可。适合内网或无外网机器，缺点是需手动更新。
常见语法踩坑与回退办法
Clash使用严格YAML 1.2，缩进混用Tab与空格会报「found character '%' that cannot start any token」；漏写payload顶层键则规则被整体忽略；把「GEOIP,CN,DIRECT」写在「MATCH」之后会导致国内流量也走代理，体验骤降。回退办法：rules.d/内每次改动前git init，出错立即git checkout -- .即可秒级恢复。
验证与观测：三条命令确认规则生效
kuailian-cli clash-test https://internal.example.com，回显DIRECT表示命中；curl -x http://127.0.0.1:7890 ipinfo.io，观察出口IP，确认非公司网段已代理；- 查看~/.config/kuailian/clash/cache/目录下是否生成对应mrs，文件时间戳与reload时间一致即代表编译通过。
不适用场景清单：什么时候别硬上自定义
1. 团队规模>50人且规则日更：YAML冲突概率指数级上升，建议改用官方API推送provider；
2. 合规要求「零配置漂移」：金融、医疗内网审计会校验文件哈希，任何本地改写都算违规；
3. 节点本身不支持UDP：自定义规则里写「UDP,TURN」会导致30%握手失败，体验反而变差。
最佳实践12字口诀
先同步，再备份；数字序，勤reload；小步改，秒回退。
FAQ（结构化数据）
rules.d/里可以放多少文件？
经验性观察：单目录200个yaml仍可秒级加载，文件再多会显著拉长reload时间；建议按业务子目录拆分后软链进来。
reload失败但语法没错？
大概率是文件编码带BOM，用dos2unix *.yaml即可；另检查是否被其他进程占用导致mrs无法写入。
云端更新会清空我的规则吗？
rules.d/目录被官方白名单保护，云端推送不会触碰；只有provider.d/可能被覆盖。
收尾：下一步行动清单
1. 打开终端执行kuailian-cli clash-reload，确认无报错；2. 用curl实测公司内网走直连、公网走代理；3. 把rules.d/加入日常git备份，日更规则前先pull再push，确保多人协作不冲突。完成这三步，快连Linux端Clash模式导入自定义规则就算真正落地，可随时回退、可审计、可复现。
未来趋势：版本预期与建议
经验性观察，官方在5.4.0里程碑中计划引入「规则diff可视化」与「reload回滚」按钮，届时Linux用户也可通过kuailian-cli clash-log --watch实时追踪规则命中。建议提前用git管理rules.d/，等新版发布后即可无缝衔接图形化审计，进一步降低多人协作的合并冲突风险。
