{"id":35644053,"url":"https://github.com/joyanhui/ikuai-bypass","last_synced_at":"2026-04-26T22:04:44.614Z","repository":{"id":209247749,"uuid":"723572322","full_name":"joyanhui/ikuai-bypass","owner":"joyanhui","description":"爱快分流规则维护：自动将通过指定的远程配置文件把区域ip，域名等，整理到到爱快，实现旁路由自动切换，域名分流、端口分流（IP分组分流）、自定义运营商、广告屏蔽等","archived":false,"fork":false,"pushed_at":"2026-04-26T00:00:50.000Z","size":113688,"stargazers_count":585,"open_issues_count":3,"forks_count":66,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-26T01:19:29.706Z","etag":null,"topics":["ikuai","openwrt"],"latest_commit_sha":null,"homepage":"https://dev.leiyanhui.com/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joyanhui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":"CLA.md"}},"created_at":"2023-11-26T04:49:55.000Z","updated_at":"2026-04-26T00:17:28.000Z","dependencies_parsed_at":"2026-02-10T07:01:26.784Z","dependency_job_id":null,"html_url":"https://github.com/joyanhui/ikuai-bypass","commit_stats":null,"previous_names":["joyanhui/ikuai-bypass"],"tags_count":152,"template":false,"template_full_name":null,"purl":"pkg:github/joyanhui/ikuai-bypass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joyanhui%2Fikuai-bypass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joyanhui%2Fikuai-bypass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joyanhui%2Fikuai-bypass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joyanhui%2Fikuai-bypass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joyanhui","download_url":"https://codeload.github.com/joyanhui/ikuai-bypass/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joyanhui%2Fikuai-bypass/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32314119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T21:09:39.134Z","status":"ssl_error","status_checked_at":"2026-04-26T21:09:21.240Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ikuai","openwrt"],"created_at":"2026-01-05T12:09:25.342Z","updated_at":"2026-04-26T22:04:44.603Z","avatar_url":"https://github.com/joyanhui.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# iKuai Bypass\n\n![iKuai](https://img.shields.io/badge/Router-iKuai-brightgreen) ![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg) ![Rust](https://img.shields.io/badge/Language-Rust-orange)\n\n**iKuai Bypass** 是一款爱快路由器专用的分流规则自动同步工具。它可以自动从网上下载 IP/域名列表并同步到你的路由器，让你的流量自动走正确的线路。比如：主流网站和国内ip流量通过光猫直连、特殊流量走旁路由，无需手动配置每一条规则。\n并可以灵活控制内网每台设备的流量并可适配爱快ACL规则。\n\n提供两种安装方式：\n- GUI：图形化桌面和手机 App，支持 Windows / macOS / Linux 桌面端和 Android / iOS 移动端\n- CLI：命令行，可以完全不使用图形界面完成所有功能，也有一个可选的基于浏览器的web界面。适合 Nas AIO PVE Docker 等部署使用。\n\u003e **提示**：旧版本go代码已归档到分支[v4.4.13](https://github.com/joyanhui/ikuai-bypass/releases/tag/v4.4.13),新版本使用rust+tauri构建,因分支替换之前fork本仓库的可能需要重新操作。 如果你在使用 爱快3.7以及以前的版本，请使用[v4.2.0](https://github.com/joyanhui/ikuai-bypass/releases/tag/v4.2.0)。你可能需要阅读[update‐to‐v4.4.10x](https://github.com/joyanhui/ikuai-bypass/wiki/v4.4.13%E2%80%90update%E2%80%90to%E2%80%90v4.4.10x)\n\u003e 如果这个项目对你有帮助，请点个 Star！star数是作者唯一的维护动力。\n\n\u003e 关于dns分流解析，建议用单 ADGuard home自建，这里有一个本人利用github action自动维护相关规则文件的adguardhome规则.[[joyanhui/adguardhome-rules]](https://github.com/joyanhui/adguardhome-rules)（规则文件在release_file分支48小时更新一次）。可以简单自动更新dns分流解析规则，广告屏蔽，以及ipv4优先等功能\n\n---\n\u003cimg src=\"screenshot/index.gif\"  alt=\"\"\u003e\n\n## 爱快两种分流模式解析\n\n本项目支持两种主流的分流实现方案，您可以根据自己的网络拓扑选择最合适的模式。\n\n### 1. 自定义运营商分流模式 (推荐)\n\n**适用场景：** 追求极致稳定性、网络自愈、终端无感分流。（需要多网卡或能添加虚拟网卡）\n\n**实现逻辑：**\n这种模式下，iKuai 将 旁路由（通常是openwrt）视为一个\"虚拟的上级运营商\"。\n1. 链路设计：旁路由 作为 iKuai 的下级设备接收流量，处理后再将出口流量\"绕回\"给 iKuai 的 WAN 口。\n2. 规则同步：本工具将目标 IP 列表导入 iKuai 的\"自定义运营商\"。iKuai 会认为这些 IP 属于该\"虚拟运营商\"，从而将流量转发给 旁路由。\n\n**核心优势：**\n- 极高可靠性：旁路由 宕机只会导致被分流的流量中断，普通流量依然通过主线直连，不会全家断网。\n- 配置无感：终端设备无需更改网关配置，完全由 iKuai 在内核层级完成调度。\n- 性能优异：直连速度最快，旁路仅处理特定流量。\n\n**参考文档**：[查看具体实现方式](https://dev.leiyanhui.com/route/ikuai-bypass-joyanhui/) 或 [恩山eezz的教程](https://www.right.com.cn/forum/thread-8252571-1-1.html)。\n\n\u003cdetails\u003e\n\u003csummary\u003e点击这里展开查看详细图文说明\u003c/summary\u003e\n\u003cimg src=\"golang_archive/assets/img.png\"  alt=\"自定义运营商分流模式拓扑图\"\u003e\n\u003c/details\u003e\n\n### 2. IP 分组与端口分流模式 (传统模式)\n\n**适用场景：** 简单的旁路由方案，逻辑直接。\n\n**实现逻辑：**\n1. IP 分组：本工具将订阅的 IP 列表同步到 iKuai 的\"IP 分组\"中。\n2. 策略路由：利用 iKuai 的\"端口分流\"功能，匹配目标地址为该分组的流量，将其\"下一跳网关\"指向 旁路由 的 IP。\n\n**特点**：配置简单直接，旁路由 宕机时匹配到该分组的规则将无法上网。\n\n**参考文档**：[实现方式参考](https://github.com/joyanhui/ikuai-bypass/issues/7) 或 [恩山y2kji的教程](https://www.right.com.cn/forum/thread-8288009-1-1.html)。\n\n---\n\n## 主要功能特性\n\n- 安全可靠：更新规则时不会中断现有分流功能。如果下载失败，会保留旧规则不清理，确保你的网络始终正常。\n- 多种分流模式：支持自定义运营商、IP分组、域名分流、端口分流等，满足不同网络需求。\n- 全自动运行：设置好后定时自动更新规则。\n- 一键清理：不需要了可以一键删除所有规则，干净利落。\n- 全平台支持：Windows、macOS、Linux、FreeBSD、Android(termux)、Android、iOS 全平台覆盖，还有 Docker 和 PVE LXC/CT版本。甚至支持mips、arm5等上古硬件。\n- 界面友好：提供网页管理界面和桌面/手机 App，多端界面统一。\n\n---\n\n## 快速上手\n\n### 1. 下载\n\n从 [Releases](https://github.com/joyanhui/ikuai-bypass/releases) 下载适合你系统的版本。\n\n**选哪个版本？**\n\n| 你的系统 | 推荐下载 |\n| :--- | :--- |\n| Windows 桌面 | `ikuai-bypass-gui-windows-x86_64.exe.zip` 解压即可 |\n| macOS 桌面 | `ikuai-bypass-gui-macos-aarch64.dmg`（M芯片）或 `x86_64.dmg`（Intel） |\n| Linux 桌面 | `ikuai-bypass-gui-linux-x86_64.zip` 解压后运行（需系统已安装 WebKitGTK/GTK3） |\n| Android 手机 | `.apk` |\n| iOS 手机 | `.ipa`（仅支持自签名或越狱设备） |\n| 服务器/路由器/容器 | CLI 版本 `ikuai-bypass-cli-linux-xxx.zip` |\n| LXC/PVE CT 容器 | `ikuai-bypass-lxc-alpine-musl-x86_64.tar.gz` |\n| Docker | [joyanhui/ikuai-bypass](https://hub.docker.com/r/joyanhui/ikuai-bypass/tags) |\n| iKuai v4 应用市场 | `ikuai-bypass-x86_64.ipkg`，在爱快“高级应用 -\u003e 应用市场 -\u003e 本地安装”上传 |\n\n\u003e **新手建议**：如果你在电脑上使用，直接下载 GUI 版本即可；Windows / Linux 解压后运行，macOS 打开 DMG 安装，无需命令行。\n\n### 2. 配置\n\n编辑 `config.yml` 文件，填写以下基本信息：\n\n```yaml\n# 爱快路由器地址和登录信息\nikuai-url: http://192.168.9.1   # 改成你的爱快地址\nusername: admin                   # 登录用户名\npassword: your_password           # 登录密码\n\n# 定时更新（每天早上7点）\ncron: \"0 7 * * *\"\n\n# 要同步的规则列表\ncustom-isp:\n  - tag: \"国内IP\"\n    url: \"https://example.com/cn-ip.txt\"\n```\n\n\u003e **提示**：完整配置示例请参考 [config.yml](./config.yml)，里面有详细注释。GUI 版本可以在界面里直接配置。\n\u003e 关于 proxy 与 github-proxy 的区别 [wiki](https://github.com/joyanhui/ikuai-bypass/wiki/%E9%85%8D%E7%BD%AE%E9%A1%B9%E4%B8%AD-%E5%85%B3%E4%BA%8E-proxy-%E4%B8%8E-github%E2%80%90proxy-%E7%9A%84%E5%8C%BA%E5%88%AB)\n### 3. 运行\n\n**GUI 用户**：双击打开应用，在界面里配置即可，无需命令行。\n\n**CLI 用户**：\n\n```bash\n# 最常用：定时自动更新（推荐）\n./ikuai-bypass -r cron -c ./config.yml\n# 只运行一次就退出\n./ikuai-bypass -r once -c ./config.yml\n# 导出域名分流列表到 TXT（不连接 iKuai，仅用于调试/人工导入）\n./ikuai-bypass -r exportDomainSteamToTxt -c ./config.yml -exportPath /tmp\n# 清理所有规则（慎用）\n./ikuai-bypass -r clean -tag cleanAll -c ./config.yml\n\n# WebUI：cron / cronAft 启动后，若配置中启用 WebUI（webui.enable=true），\n# 可直接访问 http://你的IP:19001 查看状态、修改配置、停止定时任务\n```\n\n---\n\n## WebUI 与 GUI\n\n### WebUI（网页管理界面）\n\nCLI版本在使用计划任务模式启动后用可用浏览器访问 `http://你的IP:19001` 就能看到管理界面，可以在网页上：\n- 修改配置\n- 手动触发更新\n- 查看运行日志\n- 一键诊断（生成脱敏报告，便于反馈问题）\n\n默认端口 `19001`，可以在配置文件里修改。\n\n### GUI（桌面/手机应用）\n\n如果你不想折腾命令行，直接下载 GUI 版本：\n- 桌面版：Windows / macOS / Linux，下载对应包后运行即可\n- 手机版：Android 直接安装 APK；iOS 仅支持自签名或越狱用户\n\nLinux 桌面版补充说明：需要系统已安装 `WebKitGTK` 和 `GTK3` 运行库；如果启动时报缺少动态库、白屏或图形初始化失败，先安装对应发行版的软件包再运行。\n\nGUI 功能：\n- 一键运行/停止\n- 实时查看日志\n\n\u003e 懒人首选 GUI，不用记参数。\n\n---\n\n## CLI 参数说明\n\n### 常用参数\n\n| 参数 | 说明 |\n| :--- | :--- |\n| `-c` | 配置文件路径 |\n| `-r` | 运行模式（见下表） |\n| `-m` | 分流模式（默认 `ispdomain`，一般不用改） |\n| `-tag` | 清理模式必填，指定要清理的规则名 |\n| `-login` | 覆盖配置文件登录信息（格式：`http://IP,username,password`） |\n| `-exportPath` | 域名分流规则列表导出目录（用于调试/人工检查，默认 `/tmp`） |\n| `-isIpGroupNameAddRandomSuff` | IP 分组名称是否增加随机后缀（`1` 开启 / `0` 关闭；默认开启） |\n\n### 运行模式 (`-r`)\n\n| 模式 | 说明 | 使用场景 |\n| :--- | :--- | :--- |\n| `cron` | 定时运行 | **最常用**，执行依次更新然后切换到任务计划模式等待定时再次触发 |\n| `cronAft` | 定时运行 | 暂时不执行，直接进入计划任务模式 |\n| `once` | 只运行一次 | 测试配置、手动更新 |\n| `clean` | 清理规则 | 删掉所有规则和分组，或指定的名字/备注适配的规则（新备注为 `IkuaiBypass`，兼容旧备注 `joyanhui/ikuai-bypass` / `IKUAI_BYPASS`） |\n| `exportDomainSteamToTxt` | 导出域名分流 TXT | 下载 `stream-domain` 的域名列表并导出到 `-exportPath` 目录 |\n### 分流模式 (`-m`)\n\n一般使用默认的 `ispdomain` 即可，特殊情况才需要改：\n\n| 模式 | 说明 |\n| :--- | :--- |\n| `ispdomain` | 运营商+域名分流（默认，推荐） |\n| `ipgroup` | IPv4分组模式 |\n| `ipv6group` | IPv6分组模式 |\n| `ii` | 运销商和域名分流+IPv4分组混合模式 |\n| `ip` | IPv4 + IPv6 分组 |\n| `iip` | 完整混合模式 ips+domian+ipv4+ipv6 |\n\n---\n\n## 部署方案\n\n### 手机和电脑桌面用户（推荐新手）\n只要选对正确格式的包就可以，过于简单，教程掠过\n### 服务器 / 命令行版本\n\n下载 CLI 版本，用命令行运行。建议配置成系统服务，开机自启动。\n\n**OpenWrt 用户**：可以参考这个[服务脚本](https://github.com/joyanhui/ikuai-bypass/blob/main/golang_archive/example/script/AddOpenwrtService.sh)\n\n### Docker 用户\n\n适合 NAS、群晖、或者喜欢用容器的用户，详见下方 Docker 章节。 注意：docker镜像为 `joyanhui/ikuai-bypass` 其他docker可能是本项目的fork或者网友自治版。\n\n```bash\n# 运行（会自动创建配置文件）\ndocker run -itd --name ikuai-bypass --restart=always \\\n  -e APP_RUN_MODE=ispdomain \\\n  -p 19001:19001 -v ./data:/etc/ikuai-bypass \\\n  joyanhui/ikuai-bypass:latest\n```\n\n`APP_RUN_MODE` 用来映射 CLI 的 `-m` 分流模式参数；默认值是 `ispdomain`。可选值：`ispdomain`、`ipgroup`、`ipv6group`、`ii`、`ip`、`iip`。\n\n如果你同时传了容器环境变量 `APP_RUN_MODE` 和命令行 `-m`，则以命令行 `-m` 为准。\n\n启动后：\n1. 用浏览器打开 `http://你的IP:19001`\n2. 在网页界面里配置爱快地址和登录信息\n3. 点击\"运行一次\"测试，成功后开启定时任务\n\n### iKuai v4 应用市场 / ipkg\n\n如果你打算直接在爱快 `高级应用 -\u003e 应用市场 -\u003e 本地安装` 中上传 `.ipkg` 包，安装流程、参数填写和界面截图请直接参考 [PR #118 使用说明](https://github.com/joyanhui/ikuai-bypass/pull/118)。\n\n应用市场安装时也可以通过环境变量 `APP_RUN_MODE` 配置分流模式，界面字段名为“运行模式”，默认值同样是 `ispdomain`。\n\n### Unraid / 群晖 / 爱快内docker 等部署\n\n在群晖的 Docker 套件里：\n1. 搜索 `joyanhui/ikuai-bypass` 并下载\n2. 创建容器，映射端口 `19001`\n3. 映射一个文件夹到 `/etc/ikuai-bypass` 存放配置\n4. 启动后访问网页界面配置\n\n---\n\n## 注意事项\n\n- 配置项中的规则名称/分组名不要太长（建议不超过 11 个汉字或字母），新版爱快不支持太长的名字，系统会自动加前缀。\n- 与旧版ikuai-bypass不同，新版清理规则时必须指定 `-tag` 参数，避免误删\n- 网页界面端口默认是 `19001`，可以在配置里改\n\n\n---\n\n## 赞助支持\n\n虽世道艰难也一直在坚持维护这个项目，您的一份心意能让我更有动力继续完善这个工具，非常感谢您的支持！\n\n- TRX (Tron TRC20) 钱包地址：`TLiv9F6i38uZEGdp8VoB5qLxJx43aV9XSZ`\n\n当然，您也可以通过在 GitHub 上给项目点一个 Star 来支持我，这对我也是莫大的支持！\n\n---\n## Star History\n\n\u003ca href=\"https://www.star-history.com/?repos=joyanhui%2Fikuai-bypass\u0026type=date\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/image?repos=joyanhui/ikuai-bypass\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/image?repos=joyanhui/ikuai-bypass\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/image?repos=joyanhui/ikuai-bypass\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n## 交流与反馈\n\n- 交流讨论：[GitHub Discussions](https://github.com/joyanhui/ikuai-bypass/discussions) 或 恩山无线论坛 或 [Telegram 电报群](https://t.me/+cosAS1HgFOtlMTc1)\n- Bug 反馈：[GitHub Issues](https://github.com/joyanhui/ikuai-bypass/issues)\n- 致谢：感谢 [ztc1997](https://github.com/ztc1997/ikuai-bypass/) 的初始版本思路，以及所有提供 PR 的开发者。\n- 欢迎 PR（含文档与体验优化），但 Rust/TS 代码须严格遵循零 Clone、零隐式 Panic 及零 Any、零类型错误原则。不得有clippy警告.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoyanhui%2Fikuai-bypass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoyanhui%2Fikuai-bypass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoyanhui%2Fikuai-bypass/lists"}