bart20073 / afwall

AFWall+ (Android Firewall +) - Firewall for Android

AFWall+ (Android Firewall+)

======

Index

• Description
• Features
• Changelog
• Bug Reports
• Limitations
• Compatibility
• Upgrading
• Permissions
• Frequently asked questions
• License
• Acknowledgements
• Compile AFWall+
• Contributing
• Translating

Description

Android Firewall+ is an advanced iptables editor (GUI) for Android. It provides fine-grained control over which Android apps are allowed to access the network.

The original codebase was derived from DroidWall by Rodrigo Rosauro. DroidWall was sold to AVAST in December 2011, and is no longer actively maintained.

For more information and community discussions, please visit the XDA thread or our Wiki.

Features

• Easy to install & simple to use
• Free and open source
• No advertisements
• Choose your preferred language
• Search for installed applications
• Get a notification about new installed application
• Blocked packets notification and filter
• Device Admin Support (Protect AFWall+ from uninstall)
• Easy to manage your rules with a custom script
• For any (stock) variant of Android version 2.2 - 4.4.4 (ICS, JellyBean, KitKat)
• Ipv4/Ipv6 support
• LAN-, VPN-, Tether-, Roaming-Control support
• Tasker and Locale support
• Firewall Logs service
• Multi-User (multiple-profiles) support
• Build-In Iptables/Busybox
• Export and Import rules (Import All Rules needs donate version)
• Option to prevent data leaks during boot (REQUIRES init.d support or S-OFF)
• Supports MIPS/x86/ARM

Bug Reports

Please see the issues section to report any bugs or feature requests and to see the list of known issues. Before you report a bug, take a look here.

Limitations

• A firewall cannot protect against attacks that are performed outside the operating point. For example, if there is a Point-TO-POINT to the Internet.
• The firewall cannot prevent corporate data from being copied to a memory stick or HDD and these are subtracted from the building.
• AFWall+ cannot have a precise system of SCAN for each type of virus/malware that may arise in the files that pass through it, because the Firewall is not an Antivirus solution.

Compatibility

AFWall+ has been success tested with Android version 2.2 - 4.4.4 (ICS, JellyBean, KitKat) and is reported to work with most Android variants, including stock ROMs. Android L need a little configuration change and a external Busybox app)

I do not recommend using AFWall+ in combination with any of the similar solutions because this could result in conflicts and potential data leaks (iptables could be overwritten)

Upgrading

• Make a backup (e.g. with Titanium Backup)
• Do not remove the previous version (or else your settings will maybe get lost)
• Download the new version
• Install the new version over the previous version
• Done

Permissions

AFWall+ asks for the following Android permissions:

• RECEIVE_BOOT_COMPLETED: Autostart (Bootup) AFWall+ after the system finishes booting.
• ACCESS_NETWORK_STATE: Allows AFWall+ to access information about networks (iptables).
• WRITE_EXTERNAL_STORAGE: Allows AFWall+ to write to external storage for debug log and export iptables rules.
• ACCESS_SUPERUSER: Standard to support Superuser/SuperSU (by Koushik/Chainfire).
• INTERNET : NetworkInterface.getNetworkInterfaces() needs android.permission.INTERNET. This is just being used to get the IPv4 and IPv6 addresses/subnets for each interface, so the LAN address ranges can be determined. Nothing is actually trying to access the network. Also take a look at Stackoverflow.
• ACCESS_WIFI_STATE : Added to detect tether state.

Frequently asked questions

Having problems with AFWall+? Check out the FAQ before reporting a bug or problem that may already be known.

License

AFWall+ is under the GNU General Public License v3.0 License.

Acknowledgements

This project also uses many other open source libraries such as:

Project	License	Website
ActionBarSherlock	Apache License 2.0	https://github.com/JakeWharton/ActionBarSherlock
Android Color Picker	Apache License 2.0	https://github.com/attenzione/android-ColorPickerPreference
Busybox	GNU GPLv2	http://www.busybox.net
external_klogripper	GNU General Public License 2.0	https://github.com/VanirAOSP/external_klogripper
iptables	GNU GPLv2	http://netfilter.org/projects/iptables/index.html
Libsuperuser	Apache License 2.0	https://github.com/Chainfire/libsuperuser
Locale Plugin	Apache License 2.0	http://www.twofortyfouram.com
Networklog	Mozilla Public License Version 2.0	https://github.com/pragma-/networklog
Root Tools	Apache License 2.0	https://github.com/Stericson/RootTools
Unified Preferences	Apache License 2.0	https://github.com/saik0/UnifiedPreference/

Compile AFWall+

Prerequisites:

• Android SDK in your $PATH (both platform-tools/ and tools/ directories)
• Javac 1.7 (or higher) and a recent version of Apache ant in your $PATH
• Git in your $PATH
• Use the Android SDK Manager to install API 19 (or higher)

Quick start:

git clone git://github.com/ukanth/afwall
cd afwall
git submodule init
git submodule update
android update project -p . -s
ant debug

For complete instructions, please take a look at the Wiki | HOWTO-Compile-AFWall.

Compiling native binaries

On host side you'll need to install:

• NDK r10, nominally under /opt/android-ndk-r10
• Host-side gcc 4.7, make, etc. (Red Hat "Development Tools" group or Debian build-essential)
• autoconf, automake, and libtool

This command will build the Android binaries and copy them into res/raw/:

make -C external NDK=/opt/android-ndk-r10

Contributing

Please fork this repository and contribute back using pull requests.

Any contributions, large or small, major features, bug fixes, additional language translations, unit/integration tests are welcomed and appreciated but will be thoroughly reviewed and discussed.

Translating

The res/values-* dirs are kept up to date automatically via Crowdin Translate Extension. See our translation page if you would like to contribute.

The application is available in many languages, but if yours is not included, or if it needs updating or improving, please create an account and use the translation system (powered by Crowdin Translate Extension) and make your changes.