Skip to content

Latest commit

 

History

History
118 lines (86 loc) · 4.39 KB

README.md

File metadata and controls

118 lines (86 loc) · 4.39 KB
Raw

Docker container stack: hostap + dhcp server

Designed to work on Raspberry Pi (arm) using as base image alpine linux (very little size).

Forked from https://github.com/sdelrio/rpi-hostap, difference is that device which need Internet connection and don't have WiFi can be connected to Ethernet port of RPi too. Feature can be enabled by setting ETHERNET_IP variable (static IP address which will be applied to RPi Ethernet port)

Idea

Since my last change on ISP, they put a cable modem with a horrible Wireless, it drops lots of packets, and I didn't want to put an extra AP or wireless router.

Most of the time use wireless devices on same room so I decided to try to convert my current Pi on a small Access Point using a small USB dongle.

Requirements

On the host system, the ralink firmware (in my case) should be installed so you can use it on AP mode. On debian/raspbian:

apt-get install firmware-ralink

Make sure your USB support AP mode:

# iw list
...
        Supported interface modes:
                 * IBSS
                 * managed
                 * AP
                 * AP/VLAN
                 * WDS
                 * monitor
                 * mesh point
...

Set country regulations, for example, to Spain set:

# iw reg set ES
country ES: DFS-ETSI
        (2400 - 2483 @ 40), (N/A, 20), (N/A)
        (5150 - 5250 @ 80), (N/A, 23), (N/A), NO-OUTDOOR
        (5250 - 5350 @ 80), (N/A, 20), (0 ms), NO-OUTDOOR, DFS
        (5470 - 5725 @ 160), (N/A, 26), (0 ms), DFS
        (57000 - 66000 @ 2160), (N/A, 40), (N/A)

Build / run

Minimal setup, from docker hub:

docker run -d -t --privileged --net host --name rpi-hostap --restart=always -e INTERFACE=wlan0 -e ETHERNET_IP=192.168.255.3 -e OUTGOINGS=eth1,tun0 pavelsr/rpi-hostap2

If everything works fine, you can run same with --restart=always option

For modification, testings, etc.. there is already a Makefile. So you can make run to start a sample ssid with a simple password.

I've already uploaded the image to docker hub, so you can run it from ther like this:

docker run -d -t \
  -e INTERFACE=wlan0 \
  -e CHANNEL=6 \
  -e SSID=runssid \
  -e AP_ADDR=192.168.254.1 \
  -e SUBNET=192.168.254.0 \
  -e WPA_PASSPHRASE=passw0rd \
  -e OUTGOINGS=eth0 \
  -e ETHERNET_IP=192.168.255.3 \
  --privileged \
  --net host \
  pavelsr/rpi-hostap2:latest

But before this, hostap usually requires that wlan0 interface to be already up, so before docker run take the interface up:

/sbin/ifconfig wlan0 192.168.254.1/24 up

Also you should have a driver to enable hostap on your USB wifi (if you are using Pi 3 integrated WiFI you won't need this).

apt-get install firmware-ralink

Make sure you are not runing wpa_supplicant on your host machine or docker container will tell messages like wlan0: Could not connect to kernel driver.

# ps uaxf |grep wpa_supplicant
root     22619  0.0  0.4   6616  3700 ?        Ss   22:04   0:00 /sbin/wpa_supplicant -s -B -P /run/wpa_supplicant.wlan0.pid -i wlan0 -D nl80211,wext -C /run/wpa_supplicant

Environment Variables

Name Required Description Default Value
INTERFACE true The wireless interface
CHANNEL false WiFi Channel to use 11
SSID false WiFi Name raspberry
AP_ADDR false Access Point IP Address 192.168.254.1
SUBNET false WiFi network subnet 192.168.254.0
WPA_PASSPHRASE false WiFi Password passw0rd
OUTGOINGS false Interfaces to external traffic
HW_MODE false Hardware protocol g
ETHERNET_IP false Static IP address of RPi hardware Ethernet port
ETHERNET false Interface of hardware Ethernet port eth0
MODEM_INTERFACE false Interface of USB modem eth1

Todo

Improve README.md