iKuai Bypass 是一款爱快路由器专用的分流规则自动同步工具。它可以自动从网上下载 IP/域名列表并同步到你的路由器，让你的流量自动走正确的线路。比如：主流网站和国内ip流量通过光猫直连、特殊流量走旁路由/网关，可以自动同步更新并兼容手动维护的其他分流规则。
提供两种安装方式：
- GUI：图形化工具支持桌面和手机 App，支持 Windows / macOS / Linux 和 Android / iOS
- CLI：命令行 + 可选 WebUI，适合 服务器/OpenWrt / NAS / PVE / Docker 等部署
| 分类 | 文档链接 |
|---|---|
| 🚀 入门指南 | 功能特性、下载配置、CLI 运行、WebUI/GUI |
| 🔀 分流模式 | 自定义运营商 vs IP 分组模式详解 |
| ⚡ CLI 参数 | 运行模式、分流模式、清理参数 |
| 📦 部署方式 | Docker / CLI / OpenWRT / ipkg 全场景覆盖 |
| 📖 更新日志 | 版本历史与变更记录 |
| 📚 完整文档 | 文档首页 |
| 部署方式 | 快速命令 / 说明 |
|---|---|
| Docker | docker run -itd --name ikuai-bypass --restart=always -e APP_RUN_MODE=ispdomain -p 19001:19001 -v ./data:/etc/ikuai-bypass joyanhui/ikuai-bypass:latest |
| Linux/OpenWRT | 安装为系统服务 |
| iKuai v4 应用市场 | 下载 .ipkg 包，高级应用→应用市场→本地安装上传 |
| LXC/PVE CT | 使用 ikuai-bypass-lxc-alpine-musl-x86_64.tar.gz 导入 CT 模板 |
| Unraid / 群晖 | Docker 套件中搜索 joyanhui/ikuai-bypass |
配置文件
# config.yml
ikuai-url: http://192.168.9.1
username: admin
password: your_password
cron: "0 7 * * *"
custom-isp:
- tag: "国内IP"
url: "https://example.com/cn-ip.txt"启动命令
./ikuai-bypass -r cron -c ./config.yml # 定时更新（推荐）
./ikuai-bypass -r once -c ./config.yml # 单次运行完整的 CLI 参数说明、运行模式、分流模式请查看 CLI 参数说明 ，支持定时任务、单独或者组合不同的分流规则。
虽世道艰难也一直在坚持维护这个项目，您的一份心意能让我更有动力继续完善这个工具，非常感谢您的支持！
- TRX (Tron TRC20) 钱包地址：
TLiv9F6i38uZEGdp8VoB5qLxJx43aV9XSZ - 在 GitHub 上给项目点一个 Star 也是莫大的支持！
- 交流讨论：GitHub Discussions · Telegram 电报群
- Bug 反馈：GitHub Issues
- 致谢：感谢 ztc1997 的初始版本思路，以及所有 PR 贡献者。
- 欢迎 PR，Rust/TS 代码请须严格遵循零 Clone、零隐式 Panic 及零 Any 原则。