create_ap

create a nat-ed wifi ap
git clone git@git.2f30.org/create_ap.git
Log | Files | Refs | README | LICENSE

README.md (2482B)


      1 ## Features
      2 * Create an AP (Access Point) at any channel.
      3 * Choose one of the following encryptions: WPA, WPA2, WPA/WPA2, Open (no encryption).
      4 * Hide your SSID.
      5 * Disable communication between clients (client isolation).
      6 * IEEE 802.11n support
      7 * Internet sharing methods: NATed or Bridged or None (no Internet sharing).
      8 * Choose the AP Gateway IP (only for 'NATed' and 'None' Internet sharing methods).
      9 * You can create an AP with the same interface you are getting your Internet connection.
     10 * You can pass your SSID and password through pipe or through arguments (see examples).
     11 
     12 
     13 ## Dependencies
     14 ### General
     15 * bash (to run this script)
     16 * util-linux (for getopt)
     17 * procps or procps-ng
     18 * hostapd
     19 * iproute2
     20 * iw
     21 * iwconfig (you only need this if 'iw' can not recognize your adapter)
     22 * haveged (optional)
     23 
     24 ### For 'NATed' or 'None' Internet sharing method
     25 * dnsmasq
     26 * iptables
     27 
     28 
     29 ## Installation
     30 ### Generic
     31     git clone https://github.com/oblique/create_ap
     32     cd create_ap
     33     make install
     34 
     35 ### ArchLinux (AUR)
     36     yaourt -S create_ap
     37 
     38 ### Gentoo
     39     emerge layman
     40     layman -f -a jorgicio
     41     emerge net-wireless/create_ap
     42 
     43 ## Examples
     44 ### No passphrase (open network):
     45     create_ap wlan0 eth0 MyAccessPoint
     46 
     47 ### WPA + WPA2 passphrase:
     48     create_ap wlan0 eth0 MyAccessPoint MyPassPhrase
     49 
     50 ### AP without Internet sharing:
     51     create_ap -n wlan0 MyAccessPoint MyPassPhrase
     52 
     53 ### Bridged Internet sharing:
     54     create_ap -m bridge wlan0 eth0 MyAccessPoint MyPassPhrase
     55 
     56 ### Bridged Internet sharing (pre-configured bridge interface):
     57     create_ap -m bridge wlan0 br0 MyAccessPoint MyPassPhrase
     58 
     59 ### Internet sharing from the same WiFi interface:
     60     create_ap wlan0 wlan0 MyAccessPoint MyPassPhrase
     61 
     62 ### Choose a different WiFi adapter driver
     63     create_ap --driver rtl871xdrv wlan0 eth0 MyAccessPoint MyPassPhrase
     64 
     65 ### No passphrase (open network) using pipe:
     66     echo -e "MyAccessPoint" | create_ap wlan0 eth0
     67 
     68 ### WPA + WPA2 passphrase using pipe:
     69     echo -e "MyAccessPoint\nMyPassPhrase" | create_ap wlan0 eth0
     70 
     71 ### Enable IEEE 802.11n
     72     create_ap --ieee80211n --ht_capab '[HT40+]' wlan0 eth0 MyAccessPoint MyPassPhrase
     73 
     74 ### Client Isolation:
     75     create_ap --isolate-clients wlan0 eth0 MyAccessPoint MyPassPhrase
     76 
     77 ## Systemd service
     78 Using the persistent [systemd](https://wiki.archlinux.org/index.php/systemd#Basic_systemctl_usage) service
     79 ### Start service immediately:
     80     systemctl start create_ap
     81 
     82 ### Start on boot:
     83     systemctl enable create_ap
     84 
     85 
     86 ## License
     87 FreeBSD