You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Robin Thoni 99aef78c40 README 7 years ago
README.md README 7 years ago
ap.py init 8 years ago
default.conf default config 8 years ago

README.md

ap.py

ap.py is a wrapper for create_ap.py. It allows you to run a simple access point using a predefined configuration in different environments easily.

Installation

Copy default.conf to /etc/create_ap/default.conf You can edit default.conf to match your needs. For a basic setup, just edit SSID and PASSPHRASE. SHARE_METHOD, WIFI_IFACE and INTERNET_IFACE fields will be overwritten at runtime with ap.py arguments.

Additionally, you can copy ap.py to your path (/usr/local/bin/ap, for example)

Usage

  • Share your ethernet (eth0) network by forwarding requests (aka bridge) from your wireless interface (wlan0): ap bridge wlan0 eth0 All requests done by a wireless device connected on wlan0 will be forwarded to your ethernet network. No need for local DHCP server.

  • Share your ethernet (eth0) network by rewriting requests (aka NAT) from your wireless interface (wlan0): ap nat wlan0 eth0 All requests done by a wireless device connected on wlan0 will be rewritten and sent as if your computer sent them. A local DHCP server is needed but will be setup by create_ap.py.

  • Share your wireless network (wlan0) to another wireless interface (wlan1) (useful if your wireless network does not allow clients communication): ap nat wlan1 wlan0 All requests done by a wireless device connected on wlan0 will be rewritten and sent as if your computer sent them. A local DHCP server is needed but will be setup by create_ap.py. Please note that two wireless interfaces can not be bridged.

  • Create an ‘empty’ wireless (wlan0) network without internet access (allow devices to comunicate to each other): ap none wlan0 A local DHCP server is needed but will be setup by create_ap.py.