wlan2eth/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.