Skip to content

Latest commit

 

History

History
195 lines (131 loc) · 8.52 KB

README_CN.md

File metadata and controls

195 lines (131 loc) · 8.52 KB

Surfing

CLASHMETA
CLASHMETA

Magisk or Kernelsu

English | 简体中文

本项目为 Clash、sing-box、v2ray、xray 的 Magisk 与 Kernelsu 模块。支持 REDIRECT（仅 TCP）、TPROXY（TCP + UDP）透明代理，支持 TUN（TCP + UDP），亦可 REDIRECT（TCP） + TUN（UDP） 混合模式代理。

基于上游为集成式一体服务、即刷即用
此适用以下人群：

  • 懒癌
  • 小白

项目主题及配置仅围绕 Clash.Meta

本模块需在 Magisk/Kernelsu 环境进行使用，如果你不知道如何配置所需环境，你可能需要像 ClashForAndroid、v2rayNG、surfboard、SagerNet、AnXray 等应用程序。

Surfing用户声明及免责

欢迎使用 在使用本项目前，请您仔细阅读并理解以下声明及免责条款。通过使用本项目，即表示您同意接受以下条款和条件。以下简称 Surfing

免责声明

  1. 本项目是一个开源项目，仅供学习和研究之用，不提供任何形式的担保。使用者必须对使用本项目的风险和后果负全部责任。

  2. 本项目仅为简化 Surfing 对 Clash 服务在 Android Magisk 环境中的安装和配置提供便利，并不对 Surfing 的功能和性能做出任何保证。如有任何问题或损失，本项目开发者概不负责。

  3. 本项目 Surfing 模块的使用可能会违反您所在地区的法律法规或服务提供商的使用条款。您需要自行承担使用本项目所带来的风险。本项目开发者不对您的行为或使用后果负责。

  4. 本项目开发者不对使用本项目产生的任何直接或间接损失或损害负责，包括但不限于数据丢失、设备损坏、服务中断、个人隐私泄露等。

使用须知

  1. 在使用本项目 Surfing 模块前，请确保您已经仔细阅读并理解 Clash 和 Magisk 的使用说明和相关文档，并遵守其规定和条款。

  2. 在使用本项目之前，请先备份您的设备数据和相关设置，以防发生意外情况。本项目开发者不对您的数据丢失或损坏负责。

  3. 请在使用本项目时遵守当地的法律法规，并尊重其他用户的合法权益。禁止使用本项目进行任何违法、滥用或侵权的行为。

  4. 如果您在使用本项目时遇到任何问题或有任何建议，欢迎您向本项目开发者反馈，但开发者对于解决问题和回应反馈没有义务和责任。

请您在明确理解并接受上述声明及免责条款后，再决定是否使用 Surfing 模块。如果您不同意或无法接受上述条款，请立即停止使用本项目。

法律适用

在使用本项目的过程中，您须遵守您所在地区的法律法规。如有任何争议，应依照当地法律法规进行解释和处理。

安装

  • 从 Release 页下载模块压缩包，然后通过 Magisk Manager 或 KernelSU Manager 安装
  • 各版本变化 📲日志.log

卸载

  • 从 Magisk Manager 或 Kernelsu Manager 应用卸载本模块即可

Wiki

1. 首次使用
  • 订阅地址添加成功后重启手机，可能因网络原因不会自动下载完全部规则，请手动至 Web App 在代理页的最下方，手动点击至规则页右下方刷新图标更新/下载规则文件，如网络原因无法使用 App 请至浏览器复制并打开
    • 127.0.0.1:9090/ui
    • 如上述失败，请多次尝试模块开关，并确保你的网络环境正常
  • Web App official：Download | 查看源码
    • 仅为图形辅助工具，用于便携浏览及管理后台路由数据，并无其它多余用途

模块已内置 Gui 可通过浏览器本地访问使用，亦或者使用 App 在线访问使用，两者本质上并无差异

2. 控制运行
  • 可通过模块开关进行 关闭/开启 控制运行服务实时生效

3. 脚本更新
  • UpdateGeo.sh 此脚本用于一键更新 Geo 数据库文件，需要 curl 命令，请确保在运行脚本之前已经安装了 curl 命令，完成后脚本文件并以root权限执行
    • 可以使用以下命令在 Termux App 中安装
    • 终端依次执行以下命令
      pkg update
      pkg install curl
  • 安装过程如有选择性提示都是选择 Y 回车即可.
  • Termux App official：Download

关于 Geo 数据库：
GitHub Actions 北京时间每天早上 6 点自动构建，保证规则最新 Wiki
用于路由规则匹配，实现精准分流，脚本中的更新将永久指向最新版本，因此只需每个月执行一次更新即可

4. 后续更新

  • 支持在 Magisk Manager 中在线更新模块

  • 更新后无须重启，但模块开关控制 启用/关闭 会临时失效，仍需重启

  • 更新时 Clash.Meta config.yaml 配置文件会备份至

    • /data/adb/box_bll/clash/config.yaml.bak

  • 更新时会备份旧文件用户配置，至

    • /data/adb/box_bll/scripts/box.config.bak

  • 更新模块并不会覆盖数据库文件

    • geoip.dat、geosite.dat、country.mmdb

  • 更新模块不再包含数据库文件更新，至 Web 面板-配置选项页，进行手动更新即可，亦或者脚本

Ps：主要跟随上游更新，及下发一些配置

5. 使用问题

一、代理特定应用程序(黑白名单)

  • 代理所有应用程序，除了某些特定的应用外，那么请打开 /data/adb/box_bll/scripts/box.config 文件，修改 proxy_mode 的值为 blacklist（默认值），在 user_packages_list 数组中添加元素，数组元素格式为id标识:应用包名，元素之间用空格隔开。即可不代理相应安卓用户应用。例如 user_packages_list=("id标识:应用包名" "id标识:应用包名")

  • 只代理特定的应用程序，那么请打开 /data/adb/box_bll/scripts/box.config 文件，修改 proxy_mode 的值为 whitelist，在 user_packages_list 数组中添加元素，数组元素格式为id标识:应用包名，元素之间用空格隔开。即可仅代理相应安卓用户应用。例如 user_packages_list=("id标识:应用包名" "id标识:应用包名")

安卓用户组id标识：

标准用户 ID
机主 0
手机分身 10
应用多开 999

通常你可以在/data/user/找到本机所有用户组id及应用包名，使用黑白名单请勿使用fake-ip模式

二、Tun模式

  • 默认禁用

不推荐使用如非特殊需要，使用该模式前请勿使用黑白名单

三、路由规则

  • 为大陆饶行
  • 规则由本人亲自维护的，基本能满足大多数使用需求

如非特别严格的要求，黑白名单意义不大，使用模块自带配置即可

四、局域网共享

  • 开启热点让其它设备连接即可

其它设备若访问控制台后端，只需 http://当前WiFi网关:9090/ui

License

致谢

CHIZI-0618
CHIZI-0618

> 感谢为本项目的实现提供了宝贵的基础 <