Skip to content

Latest commit

 

History

History
executable file
·
150 lines (116 loc) · 9.18 KB

index_id.md

File metadata and controls

executable file
·
150 lines (116 loc) · 9.18 KB
Raw

PERINGATAN

Proyek ini tidak bertanggung jawab atas: perangkat yang rusak, kartu SD yang rusak, atau SoC yang terbakar.

Harap pastikan file konfigurasi Anda tidak menyebabkan loop lalu lintas, jika tidak maka dapat menyebabkan ponsel Anda restart tanpa batas.

Jika Anda benar-benar tidak tahu cara mengonfigurasi modul ini, Anda mungkin memerlukan aplikasi seperti ClashForAndroid, ClashMetaForAndroid, v2rayNG, Surfboard, SagerNet, AnXray, NekoBox, SFA, dll.

Install

  • Unduh paket zip modul dari RELEASE dan instal melalui Magisk/KernelSU. Saat menginstal, Anda akan ditanya apakah akan mengunduh paket lengkap, Anda dapat memilih unduhan lengkap atau unduhan terpisah nanti, lalu mulai ulang perangkat.
  • Mod ini mendukung pembaruan mod langsung berikutnya di Magisk/KernelSU Manager (mod yang diperbarui akan berlaku tanpa me-reboot perangkat).

Pembaruan Kernel

Modul ini mencakup kernel berikut:

Konfigurasi yang sesuai dengan kernel adalah ${bin_name}, yang dapat diatur ke ( clash | xray | v2ray | sing-box).

Setiap core bekerja di direktori /data/adb/box/bin/${bin_name}, nama core ditentukan oleh bin_name di file /data/adb/box/settings.ini.

Pastikan Anda terhubung ke internet dan jalankan perintah berikut untuk memperbarui file kernel:

# perbarui kernel yang dipilih, sesuai dengan `bin_name`
su -c /data/adb/box/scripts/box.tool upkernel

Jika Anda menggunakan clash/sing-box sebagai kernel yang dipilih, Anda mungkin juga perlu menjalankan perintah berikut untuk dapat menggunakan panel kontro(dashboard):

# Perbarui panel admin clash/sing-box
su -c /data/adb/box/scripts/box.tool upyacd

Alternatifnya, Anda dapat melakukannya sekaligus (yang mungkin menghabiskan ruang penyimpanan secara tidak perlu):

# Perbarui semua file (termasuk berbagai jenis kernel dan GeoX)
su -c /data/adb/box/scripts/box.tool all

Konfigurasi

Layanan inti berikut disebut sebagai BFM

  • Layanan inti berikut secara kolektif disebut sebagai BFM
  • Anda dapat mengaktifkan atau menonaktifkan modul untuk memulai atau menghentikan layanan BFM secara real time melalui aplikasi Magisk/KernelSU Manager tanpa harus me-reboot perangkat. Memulai layanan mungkin memerlukan waktu beberapa detik, penghentian layanan akan segera berlaku.

konfigurasi inti

  • Untuk konfigurasi inti bin_name, silakan lihat bagian Pembaruan Kernel untuk konfigurasi
  • Setiap file konfigurasi inti perlu dikustomisasi oleh pengguna, dan skrip akan memeriksa validitas konfigurasi, dan hasil pemeriksaan akan disimpan di file /data/adb/box/run/runs.log.
  • Tip: Baik clash dan sing-box datang dengan pra-konfigurasi dengan skrip proxy transparan. Untuk konfigurasi lebih lanjut, silakan merujuk ke dokumentasi resmi. Alamat: dokumen resmi Clash delete, dokumen resmi sing-box

Menerapkan pemfilteran (blacklist/whitelist)

  • BFM menyediakan proxy untuk semua aplikasi (APP) dari semua pengguna Android secara default.
  • Jika Anda ingin BFM mem-proxy semua aplikasi (APP), kecuali beberapa aplikasi, silakan buka file /data/adb/box/settings.ini, ubah nilai proxy_mode menjadi blacklist (default), tambahkan aplikasi yang akan dikecualikan ke packages_list , misalnya: packages_list=("com.termux" "org.telegram.messenger")
  • Jika Anda hanya ingin mem-proxy aplikasi (APP) tertentu, gunakan whitelist, dan tambahkan (APP) yang hanya ingin di proxy, misalnya: packages_list=("com.termux" "org.telegram.messenger").
  • Ketika nilai proxy_mode adalah TUN, proxy transparan tidak akan berfungsi, dan hanya kernel yang sesuai yang akan mulai mendukung TUN. Saat ini, hanya clash dan sing-box yang tersedia.

Notes: Jika Clash digunakan, blacklist dan whitelist tidak akan berlaku dalam mode fake-ip.

Proxy Transparan untuk Proses Tertentu

  • BFM secara default melakukan proxy transparan untuk semua proses.
  • Jika Anda ingin BFM melakukan proxy untuk semua proses kecuali beberapa proses tertentu, buka berkas /data/adb/box/settings.ini, ubah nilai proxy_mode menjadi blacklist (nilai default), lalu tambahkan elemen GID ke dalam array gid_list, dengan GID dipisahkan oleh spasi. Ini akan mengakibatkan proses dengan GID yang sesuai tidak diproksikan.
  • Jika Anda ingin hanya melakukan proxy transparan untuk proses tertentu, buka berkas /data/adb/box/settings.ini, ubah nilai proxy_mode menjadi whitelist, lalu tambahkan elemen GID ke dalam array gid_list, dengan GID dipisahkan oleh spasi. Ini akan mengakibatkan hanya proses dengan GID yang sesuai yang akan diproksikan.

Tip: Karena iptables Android tidak mendukung pencocokan ekstensi PID, pencocokan proses oleh Box dilakukan melalui pencocokan GID secara tidak langsung. Di Android dapat menggunakan perintah setuidgid busybox untuk memulai proses tertentu dengan UID tertentu, GID apa pun.

mengubah mode proxy

  • BFM menggunakan TPROXY untuk mem-proxy TCP+UDP secara transparan (default). Jika terdeteksi bahwa perangkat tidak mendukung TPROXY, buka /data/adb/box/settings.ini dan ubah network_mode="redirect" menjadi redirect yang hanya menggunakan proxy TCP.
  • Buka file /data/adb/box/settings.ini dan ubah nilai network_mode menjadi redirect, tproxy atau mixed.
  • redirect：redirect(TCP) + Direct(UDP).
  • tproxy：tproxy(TCP + UDP).
  • mixed：redirect(TCP) + tun(UDP).

Lewati proxy transparan saat menghubungkan ke Wi-Fi atau hotspot

  • BFM secara transparan memproksi localhost dan hotspot (termasuk tethering USB) secara default.
  • Buka file /data/adb/box/settings.ini, ubah ignore_out_list dan tambahkan wlan+, sehingga proxy transparan akan mem-bypass wlan dan hotspot tidak akan terhubung ke proxy.
  • Buka file /data/adb/box/settings.ini, ubah ap_list dan tambahkan wlan+. BFM akan mem-proxy hotspot (mungkin ap+ / wlan+ untuk perangkat Mediatek).
  • Gunakan perintah ifconfig di Terminal untuk mengetahui nama AP.

Aktifkan Cron Job untuk memperbarui Geo dan Subs sesuai jadwal secara otomatis

  • Buka file /data/adb/box/settings.ini, ubah nilai run_crontab=true, dan atur interva_update="@daily" (default), sesuaikan dengan yang anda inginkan.
  # jalankan perintah
  su -c /data/adb/box/scripts/box.service cron
  • Maka secara otomatis Geox dan Subs akan diperbarui sesuai jadwal interva_update.

Mulai dan Berhenti

Masuk ke mode manual

  • Jika Anda ingin memiliki kontrol penuh atas BFM dengan menjalankan perintah, buat saja file baru bernama /data/adb/box/manual. Dalam hal ini, layanan BFM tidak akan dimulai secara otomatis saat perangkat Anda dihidupkan), Anda juga tidak dapat mengatur mulai atau berhentinya layanan melalui aplikasi Magisk/KernelSU Manager.

Memulai dan menghentikan layanan manajemen

  • Skrip layanan BFM adalah /data/adb/box/scripts/box.service
  • skrip Iptables BFM adalah /data/adb/box/scripts/box.iptables
# Mulai BFM
  su -c /data/adb/box/scripts/box.service start &&  su -c /data/adb/box/scripts/box.iptables enable

# Hentikan BFM
  su -c /data/adb/box/scripts/box.iptables disable && su -c /data/adb/box/scripts/box.service stop
  • Terminal akan mencetak log pada saat yang sama dan mengeluarkannya ke file log.

Langganan dan pembaruan basis data Geo

Anda dapat memperbarui langganan dan basis data Geo secara bersamaan menggunakan perintah berikut:

  su -c /data/adb/box/scripts/box.tool geosub

Atau Anda dapat memperbaruinya satu per satu.

perbarui langganan

  su -c /data/adb/box/scripts/box.tool subs

Perbarui basis data Geo

  su -c /data/adb/box/scripts/box.tool geox

instruksi lainnya

  • Saat memodifikasi salah satu file konfigurasi inti, pastikan konfigurasi terkait tproxy cocok dengan definisi di file /data/adb/box/settings.ini.
  • Jika perangkat memiliki alamat IP publik, tambahkan IP tersebut ke jaringan internal di file /data/adb/box/scripts/box.iptables untuk mencegah pengulangan lalu lintas.
  • Log untuk layanan BFM dapat ditemukan di direktori /data/adb/box/run.

Anda dapat menjalankan perintah berikut untuk mendapatkan instruksi operasi terkait lainnya:

  su -c /data/adb/box/scripts/box.tool
  # usage: {check|bond0|bond1|memcg|cpuset|blkio|geosub|geox|subs|upkernel|upyacd|upyq|upcurl|port|reload|all}
  su -c /data/adb/box/scripts/box.service
  # usage: $0 {start|stop|restart|status|cron|kcron}
  su -c /data/adb/box/scripts/box.iptables
  # usage: $0 {enable|disable|renew}

uninstall

  • Instalasi yang menghapus modul ini dari Magisk/KernelSU Manager, akan menghapus file /data/adb/service.d/box_service.sh dan direktori data BFM di /data/adb/box.
  • Anda dapat menghapus data BFM dengan perintah berikut:
  su -c rm -rf /data/adb/box
  su -c rm -rf /data/adb/service.d/box_service.sh
  su -c rm -rf /data/adb/modules/box_for_root