GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → f1linux → pi-ap

f1linux / pi-ap

Licence: GPL-3.0 License
Raspberry Pi Access Point: This repo automates the configuration of hostapd, dnsmasq, dhcpcd & wpa_supplicant to transform a Pi into a wireless AP. Requirements: a Pi, an Ethernet cable and a DHCP-enabled port on a router with a 'net connection or a switch connected to this router.

Programming Languages

shell
77523 projects

Labels

linuxraspberry-pirouterdhcpdnsmasqraspbianaccess-pointhostapdwpa-supplicantdhcpcdpi-ap

Projects that are alternatives of or similar to pi-ap

Glider
glider is a forward proxy with multiple protocols support, and also a dns/dhcp server with ipset management features(like dnsmasq).
Stars: ✭ 1,710 (+2378.26%)
Mutual labels:  dhcp, dnsmasq
Blacklist
Blacklist and Adware Blocking for the Ubiquiti EdgeMax Router
Stars: ✭ 393 (+469.57%)
Mutual labels:  router, dnsmasq
Dnsmasqweb
基于DNSmasq的DNS解析、以及DHCP地址分配系统
Stars: ✭ 166 (+140.58%)
Mutual labels:  dhcp, dnsmasq
Create ap
[NOT MAINTAINED] This script creates a NATed or Bridged WiFi Access Point.
Stars: ✭ 4,142 (+5902.9%)
Mutual labels:  access-point, hostapd
lokole
Source code for the Lokole project. Lokole enables communities in the Congo DRC to pool resources to access efficient communication via email at an affordable price.
Stars: ✭ 37 (-46.38%)
Mutual labels:  dnsmasq, hostapd
Pi Hole
A black hole for Internet advertisements
Stars: ✭ 34,076 (+49285.51%)
Mutual labels:  dhcp, dnsmasq
Sower
Sower is a cross-platform intelligent transparent proxy solution.
Stars: ✭ 391 (+466.67%)
Mutual labels:  router, dhcp
Raspap Webgui
Simple wireless AP setup & management for Debian-based devices
Stars: ✭ 3,383 (+4802.9%)
Mutual labels:  dnsmasq, hostapd
anyfesto
Low cost Raspberry Pi /Linux based access point with audio, education and communications local content server. Inspired by the ideas of sharing with others. Anyfesto - a platform from which to speak.
Stars: ✭ 66 (-4.35%)
Mutual labels:  access-point, hostapd
ceil
Helmut Hoffer von Ankershoffen experimenting with auto-provisioned RPi cluster running K8S on bare-metal
Stars: ✭ 42 (-39.13%)
Mutual labels:  dnsmasq, dhcpcd
Asuswrt Merlin Transparent Proxy
transparent proxy base on ss, v2ray, ipset, iptables, chinadns on asuswrt merlin.
Stars: ✭ 367 (+431.88%)
Mutual labels:  router, dnsmasq
RaspberryPi-Packet-Sniffer
An HTTP and HTTPS sniffing tool created using a Raspberry Pi
Stars: ✭ 79 (+14.49%)
Mutual labels:  dnsmasq, hostapd
Dowse
The Awareness Hub for the Internet of Things
Stars: ✭ 139 (+101.45%)
Mutual labels:  router, dhcp
ConsolePi
Raspberry Pi Based Serial Console Server, with PushBullet Notification of IP changes, Automatic VPN termination, custom menu, Power Outlet Control, and a lot more
Stars: ✭ 109 (+57.97%)
Mutual labels:  hostapd, wpa-supplicant
noddos
Noddos client
Stars: ✭ 78 (+13.04%)
Mutual labels:  router, dhcp
TutoAsus
Tutorial on how to setup a nginx reverse proxy on Asus router with Merlin firmware, and get Let's Encrypt certificate with acme.sh.
Stars: ✭ 35 (-49.28%)
Mutual labels:  router
TG799VAC-XTREME-17.2-MINT
My personal unique wiki for hacking the router firmware used by (Telia)TG799vac Xtream v17.2-MINT delivered from Technicolor
Stars: ✭ 71 (+2.9%)
Mutual labels:  router
nuxt-interpolation
Nuxt.js module as directive for binding every link to catch the click event, and if it's a relative link router will push.
Stars: ✭ 38 (-44.93%)
Mutual labels:  router
whip
Simple fast http server for nim based on httpbeast and nest for high performance routing
Stars: ✭ 55 (-20.29%)
Mutual labels:  router
8821au-20210708
Linux Driver for USB WiFi Adapters that are based on the RTL8811AU and RTL8821AU Chipsets - v5.12.5.2
Stars: ✭ 40 (-42.03%)
Mutual labels:  hostapd
View All Similar Projects ➔

#

# pi-ap: These scripts configure a Raspberry Pi into a wireless Access Point

# Source: https://github.com/f1linux/pi-ap

Version: 01.10.02

# License: GPL 3.0

# Script Author: Terrence Houlahan Linux & Network Engineer

# Contact: [email protected]

# Linkedin: www.linkedin.com/in/terrencehoulahan

README CONTENTS:

  1. ABOUT "pi-ap"
  2. USE-CASES
  3. COMPATIBILITY
  4. FEATURES
  5. LICENSE
  6. HARDWARE REQUIREMENTS
  7. INSTALLATION
  8. CONNECTING TO AP
  9. TROUBLESHOOTING
  10. USEFUL LINKS: Wiki & YouTube Channel

1. ABOUT "pi-ap":

"pi-ap" is a series of bash scripts that automates configuration of below standardized packages to transform a PI into a wireless Access Point ("AP"):

  • hostapd: Probably the most widely used package for creating an AP in Linux and a standard

  • wpa_supplicant: Client Authentication

  • dhcpcd: Interface management

  • dnsmasq: DHCP for connecting AP clients: Assigns IPs and the DNS servers clients should use

Other host configuration is performed, but the foregoing are the key packages related to delivering the AP functionality

2. USE-CASES

pi-ap is NOT meant to replace enterprise class AP systems which offer beefier hardware and joined-up management interfaces for building or campus deployments. The obvious use cases for these scripts is:

  • Dead-Spot Coverage: Individuals and small businesses with a few dead-spots in their WiFi coverage can use this solution

  • Event Coverage: Connect a pi-ap to a long Ethernet cable out of a window into your back yard for hammock surfing :-)

  • Network Training: An AP is a networking microcosm offering wide opportunities for teaching networking configuration & troubleshooting on inexpensive commodity hardware

3. COMPATIBILITY

These scripts have been tested on the following Pi models & OSs and found to work correctly:

  • Pi 3B+: Raspbian Stretch (2019-04-08) and Buster (2019-07-10)

  • Pi 4: Raspbian Buster (2019-07-10)

4. FEATURES

  • No Subnetting Required: DHCP IP pool for connecting clients is automatically calculated from a single IP and mask you specify

  • Auto Config of WiFi Regulatory Zone: This is derived from the Public IP you are NATing out from and ensures you cannot make an error setting it

  • MAC Address Restriction: In addition to restricting by password you also have the ability to restrict by hardware address of connecting devices

  • Centralized Package Management: Customize the package list by editing the list in "packages-list-install.txt"

  • Modular Design: Configuration is broken down into scripts organized by taxonomy: ie FW, packages, Kernel, AP stuff, etc...

  • Crypto uses Hardware Random Number Generator ("RNG"): Entropy generated via hardware RNG using rng-tools

5. LICENSE

Terrence Houlahan developed "pi-ap" and opensources it under the terms of the GPL 3.0 License that is distributed with my repo source files

6. HARDWARE REQUIREMENTS

Pi Case:

AVOID METAL CASES!!! If you wrap a metal case around your Pi it is going to cause Layer 1 problems by impeding the signal.

Probably worth trying a few different cases of differing materials to see which gives you the best result in respect to signal performance.

NON-POE:

A long Ethernet cable, a Pi and a power supply are minimum requirements.

HOWEVER: Using an AP implies covering an area the antenna(s) of the router cannot itself reach. At such a distance- probably greater than 40 feet- or any distance their is not a mains outlet to power the Pi, using a single Ethernet cable for both Data + Power becomes more interesting.

POE:

POE gear I have had success with- YMMV- with my Pi applications is:

  • Ethernet Cable: A Tripp Lite Cat6 24 AWG Ethernet Cable is suggested (for most use cases). Amazon sells them in various lengths & colours

  • POE Switch: ZyXEL 8-Port GS1900-8HP-GB0102F switch. Also found on Amazon. Lots of features for a reasonable price

  • POE Hat or POE Splitter: Although most Pi vendors sell the POE Hat, POE Splitters will be found on Amazon.

I discuss POE gear and perform a cost vs. benefit analysis at below link for those considering a POE implementation for their pi-ap:

choosing-a-pi4-power-supply

7. INSTALLATION & CONFIGURATION:

Hardware Configuration:

  • Connect the Pi's eth0 port to a DHCP-enabled port in a router configured with Internet connection or a switch connected to this router.

NOTE: You can connect a "*pi-ap" to some intermediate router but you will of course have to configure the routing so the Pi can reach the router with the Internet connection.

Software Configuration:

All the complex configuration is abstracted into a centralized variables file named "variables.sh". This file is sourced by all repo scripts. Edit this file in nano to modify default values and execute install.sh. All the other scripts are chained off of install.sh That it to achieve a working Pi AP

Either using a local or SSH connection to the Pi execute the following commands:

  • a) git clone https://github.com/f1linux/pi-ap

  • b) Change Default Pi Password! Open a terminal and execute sudo su - and passwd pi

  • c) cd pi-ap

  • d) nano variables.sh # Modify default variable values. Most default values can be kept but change "APWPA2PASSWD" and if default WiFi subnet in "IPV4IPWLAN0='192.168.0.1/28' exists on your LAN set to a different subnet"

  • e) nano hostapd.accept # If variable "MACADDRACL" set to "1" then add MAC addresses of clients allowed to connect to pi-ap before executing script

  • f) sudo ./install.sh # Execute the install script which will call all the other scripts in the repo.

  • g) cd ..;rm -rf pi-ap # Optionally delete the repo after "install.sh" completes.

8. CONNECTING TO AP:

After setup completes, to connect to your new Pi Access Point:

  • a) Find its SSID inWireless Networks and connect with the password you set in variable "APWPA2PASSWD" when modifying variables.sh

  • ssh [email protected] # This is the default IP variable "IPV4IPWLAN0"

You're in.

9. TROUBLESHOOTING

A suggested non-exhausitive list of things to investigate if pi-ap broken:

  • sudo ufw status: Check FW not disabled. Needs to be up or masquerading in NAT table breaks

  • Non-Metallic: If using a case for your Pi, only use a NON-METALLIC one to avoid Layer 1 connectivity problems

  • Physical Positioning: Is there anything that will impede or interfere with the radio?

  • FW In Front of Pi Not Blocking: Look for restrictive rules on any FW's in front of the pi-ap

  • ip addr list: Check interfaces are all up. wlan0 must be up to connect to AP. eth0 must be up for AP traffic to reach Internet

  • sudo systemctl status hostapd.service: When hostapd is not happy, your AP will be down.

  • sudo systemctl status wpa_supplicant.service: When wpa_supplicant is not happy, clients cannot connect to AP.

  • cat /proc/sys/kernel/random/entropy_avail: Use this command to investigate insufficient entropy errors when checking wpa_supplicant status

  • tail -fn 100 /var/log/syslog: Review syslog for any interesting errors to investigate

  • No Clashing Subnets: Variable "IPV4IPWLAN0" in variables.sh is used to setup the AP interface & create IP pool to assign addresses to connecting clients. Ensure "IPV4IPWLAN0" does not clash with any existing subnets

10. USEFUL LINKS:

Pi-AP YouTube Channel: F1Linux

Pi-AP Wiki: Github

I think that about covers it. Not a lot really to do to configure a Pi into a working Access Point with this pile of scripts...

Terrence Houlahan, Linux & Network Engineer F1Linux.com

Linkedin: Terrence Houlahan

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].