{"id":13484415,"url":"https://github.com/taamarin/box_for_magisk","last_synced_at":"2025-05-14T11:08:54.004Z","repository":{"id":65225386,"uuid":"561890229","full_name":"taamarin/box_for_magisk","owner":"taamarin","description":"Transparent Proxy for Android(root) ","archived":false,"fork":false,"pushed_at":"2025-03-15T10:59:16.000Z","size":18175,"stargazers_count":1535,"open_issues_count":63,"forks_count":150,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-11T20:43:43.393Z","etag":null,"topics":["android","clash","magisk-module","shell-scripts","sing-box","v2ray","xray"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taamarin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["taamarin"],"custom":["https://paypal.me/MJuwanda02"]}},"created_at":"2022-11-04T18:17:34.000Z","updated_at":"2025-04-11T16:52:48.000Z","dependencies_parsed_at":"2023-12-24T12:33:28.190Z","dependency_job_id":"e9b8cda8-8957-4d44-9595-6abbd7a94833","html_url":"https://github.com/taamarin/box_for_magisk","commit_stats":{"total_commits":251,"total_committers":32,"mean_commits":7.84375,"dds":0.6334661354581673,"last_synced_commit":"ad87f5d322949e66c7da190c6d5d46eadf6f844d"},"previous_names":[],"tags_count":55,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taamarin%2Fbox_for_magisk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taamarin%2Fbox_for_magisk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taamarin%2Fbox_for_magisk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taamarin%2Fbox_for_magisk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taamarin","download_url":"https://codeload.github.com/taamarin/box_for_magisk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254129484,"owners_count":22019628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["android","clash","magisk-module","shell-scripts","sing-box","v2ray","xray"],"created_at":"2024-07-31T17:01:24.011Z","updated_at":"2025-05-14T11:08:53.977Z","avatar_url":"https://github.com/taamarin.png","language":"Shell","funding_links":["https://github.com/sponsors/taamarin","https://paypal.me/MJuwanda02"],"categories":["Shell","🌐 Network and Connectivity"],"sub_categories":["Proxy Tools"],"readme":"# Box for Root\n\n[![ID](https://img.shields.io/badge/id-blue.svg?style=for-the-badge)](docs/index_id.md) [![EN](https://img.shields.io/badge/en-blue.svg?style=for-the-badge)](docs/index_en.md) [![CN](https://img.shields.io/badge/cn-blue.svg?style=for-the-badge)](docs/index_cn.md)\n\n\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/taamarin/box_for_magisk/blob/master/docs/box.svg\" alt=\"BOX\" width=\"200\"\u003e\n  \u003cbr\u003eBOX\u003cbr\u003e\n\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eTransparent Proxy for Android (Root)\u003c/h4\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/taamarin/box_for_magisk/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/taamarin/box_for_magisk/total.svg?style=for-the-badge\" alt=\"Releases\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"#\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Android-3DDC84?style=for-the-badge\u0026logo=android\u0026logoColor=white\" alt=\"Android\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## Introduction\n\n`Box for Root` (BFR) is a [Magisk](https://github.com/topjohnwu/Magisk), [KernelSU](https://github.com/tiann/KernelSU), [APatch](https://github.com/bmax121/APatch), module that provides a suite of proxy tools, including `clash`, `sing-box`, `v2ray`, `hysteria` and `xray`. It allows you to configure a transparent proxy on Android devices with root access.\n\n## Features\n\n- Support for multiple proxy tools: `clash`, `sing-box`, `v2ray`, `hysteria`, and `xray`.\n- Transparent proxy for Android with root access.\n- Seamless integration with Magisk, KernelSU, and APatch.\n- Manage proxy services with ease.\n\n## Apk Manager\n\nYou can use the **BFR Manager** app (optional) to manage Box for Root on your device.\n\n[Download BFR Manager](https://github.com/taamarin/box.manager)\n\n\u003e **Note**: If you receive continuous notifications, open Magisk Manager, navigate to SuperUser, search for `BoxForRoot`, and disable logs and notifications.\n\n## Module Directory\n\nThe core files of the module are stored in the following directories:\n\n- `MODDIR=/data/adb/box`\n- `MODLOG=/data/adb/box/run`\n- `SETTINGS=/data/adb/box/settings.ini`\n\n\u003e **Note**: Before editing the `settings.ini` file located at `/data/adb/box/settings.ini`, ensure that BFR is turned off to avoid configuration issues.\n\n## Manage Service Start/Stop\n\nThe following core services are collectively referred to as **BFR**. By default, the BFR service auto-starts after a system boot. You can manage the service through Magisk/KernelSU Manager App, with the service start taking a few seconds, and stopping it taking effect immediately.\n\n### To start the service:\n```bash\nsu -c /data/adb/box/scripts/box.service start \u0026\u0026 su -c /data/adb/box/scripts/box.iptables enable\n```\n### To stop the service:\n```bash\nsu -c /data/adb/box/scripts/box.iptables disable \u0026\u0026 su -c /data/adb/box/scripts/box.service stop\n```\n\n## Here are some additional instructions:\n- When modifying any of the core configuration files, ensure that the tproxy-related configurations match the definitions in the **/data/adb/box/settings.ini** file.\n- If your device has a public IP address, you can add that IP address to the internal network in the **/data/adb/box/scripts/box.iptables** file to prevent loopback traffic.\n- The logs for the BFM service can be found in the directory **/data/adb/box/run**.\n- Please note that modifying these files requires appropriate permissions. Make sure to carefully follow the instructions and validate any changes made to the configuration files.\n\nYou can run the following command to get other related operating instructions:\n```bash\n  su -c /data/adb/box/scripts/box.tool\n  # usage: {check|geosub|geox|subs|upkernel|upxui|upyq|upcurl|reload|all}\n  su -c /data/adb/box/scripts/box.service\n  # usage: $0 {start|stop|restart|status|cron|kcron}\n  su -c /data/adb/box/scripts/box.iptables\n  # usage: $0 {enable|disable|renew}\n```\n\n## Uninstall\nRemove the module from `Magisk/KernelSU/APatch Manager` and run the following command to wipe the data:\n```bash\nsu -c rm -rf /data/adb/box\nsu -c rm -rf /data/adb/service.d/box_service.sh\nsu -c rm -rf /data/adb/modules/box_for_root\n```\n\n## Credits\n- [CHIZI-0618/box4magisk](https://github.com/CHIZI-0618/box4magisk) for the original Box for Magisk module.\n\n## License\nThis project is licensed under the GPL-3.0 license - see the [LICENSE](https://github.com/taamarin/box_for_magisk/blob/master/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaamarin%2Fbox_for_magisk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaamarin%2Fbox_for_magisk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaamarin%2Fbox_for_magisk/lists"}