Cyberes a7396a23e4 | ||
---|---|---|
bridge | ||
config | ||
go | ||
.gitignore | ||
LICENSE | ||
README.md |
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
toconfig/nat-config.sh
- For the ARP proxy, copy
config/arp-config.sh.example
toconfig/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.