Skip to content

Home

Jump to bottom
CHEF-KOCH edited this page Jul 28, 2015 · 105 revisions

Welcome to the AFWall+ Wiki!

AFWall+ is an Android open source firewall client, focused on making it easier to work with iptables. It keeps track of your mobile broadband usage and can block internet access to selected apps to avoid exceeding your data usage.

❗ Before you ask anything please take a look first into our official FAQ. A general discussion platform can be found here on XDA-Developers. Use our GitHub platform only for issue reports, see here how-to do this - or pull requests. ❗

⚠️ We are not responsible for any external content mentioned here in this Wiki! Due the mass of Chrome/Chromium security complications read also this and this, our Wiki is focused on browsing with Firefox (mobile), please do not ask anything how to secure/harden Chrome/Chromium or any mod of this Browser which use the same engine. Thanks! ⚠️

Index

Contribution

Your contributions and suggestions are heartily♥ welcome. (✿◕‿◕)

Additional thanks goes out to our top contributors & developers, listed over here.

Enjoy and profit. Contribute to the project with pull requests!

Requirements

AFWall+ need this to run at his best:

  • No Windows or iOS. 😆
  • The Android OS device with at least a 4.0 (ICS/API level 14, NDK 10) or a higher version.
  • Your device must be rooted.
  • BusyBox and IPtables (also included as binary in AFWall+ for Kernel/ROM's without it!)
  • The Kernel/ROM must have init.d support (for external custom script and data leakage fix)!
  • The Kernel must have NETFILTER/CONFIG_NETFILTER enabled (adb pull /proc/config.gz - Once you unzip it, you can search for e.g. NETFILTER). AFWall+ normally check's it automatically if your Kernel does have support for it or not.

Installation

  • If you've not installed AFWall+ from the official stores like F-Droid or Google Play Store you may need to temporarily enable "Unknown sources" in your settings if that's disabled.
  • Make a current settings backup (optional) - it will be saved under /sdcard0/afwall/
  • Download the latest release from Google Play Store, GitHub or F-Droid.
  • Delete any previous version of the AFWall+ app, an upgrade from an existent installation is also possible.
  • Delete/Restore any remnant application/setting(s) directory from /sdcard0/afwall/ or similar.
  • Install the latest available version.
  • Restore your settings backup.

Important Information

Before you submit any issue report via the integrated AFWall+ option - or here on our GitHub page, you maybe first read the following stuff which may solve already solve your problems or questions.

  • Our official FAQ helps to solve the most known problems and questions.
  • Our official issue tracker here on GitHub, please always make a search before you open another ticket.
  • Changelog describes changes in each new version of AFWall+.
  • CustomScripts for advanced users only. Some questions about working with iptables scripts might be answered over there, it also contains some predefined scripts templates and examples you can use.
  • Apps leak user privacy data during boot contains background information about how to solve the 'Data leakage' during boot problem.
  • Android kernel traffic contains background information about the Android OS & Kernel generated traffic.

Got an error message?

  • Error codes may help you to understand the error messages.

Found a bug?

Want compile AFWall+ yourself?

Some useful tricks:

(Optional and not only AFWall+ specific)

TCP security under Linux:

  • TCP security may help to protect you against some known attacks.

Kernel Security under Linux:

Phone code "cheats":

Similar firewall solutions

A quick overview of other Android firewalls and a short explanation how they're working is explained over our Similar Firewall solutions page.

Making Donations

Donations are optional and we don't want you to feel pressured to send money! But everything may helps to improve the product - and of course it's always a good motivation! It can be done directly on Google Play Store or just look at F-Droid repository for more donations options.

Wiki cloning

Feel free to fork/clone our Wiki, but remember to give proper credits where it belongs.

Via: git clone https://github.com/ukanth/afwall.wiki.git.

To stay on sync, here is an example how to do this. An API reference can be found over here or on the official Docs.

Feeds

It's now very easy to stay up-to-date by subscribing latest changes via Browser live feeds, via:

# The available feeds are:
https://github.com/ukanth/afwall/commits/beta.atom (latest)
https://github.com/ukanth/afwall/commits/HEAD.atom
https://github.com/ukanth/afwall/commits/donate.atom
https://github.com/ukanth/afwall/commits/master.atom

or 
https://github.com/ukanth/afwall/commits/<TAG or BRANCHES>.atom

License

Creative Commons License.

AFWall+ and all of this work such as source, wiki, icons,[...] is licensed under a GNU General Public License v3.

Footer

Clone this wiki locally