Transparently bridge your WiFi connection to your Ethernet interface.
Go to file
Cyberes 9ad732c123 make compatable with windows. improve logging 2023-06-21 12:54:59 -06:00
bridge forgot a few things 2023-06-20 15:17:32 -06:00
config forgot a few things 2023-06-20 15:17:32 -06:00
go make compatable with windows. improve logging 2023-06-21 12:54:59 -06:00
.gitignore Merge branch 'go' 2023-06-20 12:08:03 -06:00
LICENSE Initial commit 2023-06-12 17:14:38 -06:00
README.md update readme 2023-06-20 13:56:59 -06:00

README.md

wlan2eth

Transparently bridge your WiFi connection to your Ethernet interface.

There are three bridge versions:

  • NAT in bridge/nat/

    • The bridge creates a private LAN and clones the client's MAC address to its wired interface to get an IP from the DHCP server. All ports are forwarded to the client so traffic can flow in both directions. Supports only one bridged client.
  • ARP proxy in bridge/proxyarp/

    • Rewrites the MAC addresses of traffic passing through the bridge. Supports more than one bridged client.
  • An experimental bridge written in Go in go/

    • Similar to the ARP proxy. Mostly an experiment to learn how these things work. It has its own README file.

Install

This service was developed for Ubuntu but will likely work with other Linux versions as well.

First, copy the config file:

  • For the NAT bridge, copy config/nat-config.sh.example to config/nat-config.sh
  • For the ARP proxy, copy config/arp-config.sh.example to config/arp-config.sh

Edit the config and enter your information. The file is well-commented and has instructions on what to set the values to.

Then, run the installer:

  • For the NAT bridge, run sudo ./bridge/nat/nat-install.sh
  • For the ARP proxy, run sudo ./bridge/proxyarp/arp-install.sh

Everything will be set up the way it needs to be. This should be installed on a fresh machine. The install script is safe to run as many times as you need to.

Once the install script has finished, reboot and you're good to go! The bridge service will automatically start at boot.

Use

Refer to the README.md file in the individual bridge folders.