Compare commits

..

57 Commits

Author SHA1 Message Date
garywill a56a7cc5f4 0.5.4 2018-08-31 18:41:06 +08:00
garywill e5e1c96a53 transparent DNS proxy 2018-08-31 18:41:06 +08:00
garywill 0f498e043d random IP
firejail
2018-08-31 18:41:06 +08:00
garywill e551d6e412 disable IPv6 if not enabled 2018-08-31 18:41:06 +08:00
garywill 4c10adf3ce support specify Internet iface 2018-08-31 18:41:06 +08:00
garywill 2b103e3838 Setting this host's name replied by DNS 2018-08-31 18:41:06 +08:00
garywill 5532b4d1a9 support setting upstream DNS server 2018-08-31 18:41:06 +08:00
garywill 21a386aba2 serve inner DNS for no-Internet LAN
add 'domain-needed' to dnsmasq
2018-08-31 18:41:06 +08:00
garywill b4d60dd3aa drop TKIP 2018-08-31 18:41:06 +08:00
garywill 4f0ea10e43 0.5.3 2018-08-31 18:41:06 +08:00
garywill 3a55f526c2 DNS proxy: use dnsmasq forward 2018-08-31 18:41:06 +08:00
garywill c75ca0ce81 support IPv6
nat method sets global forwarding and don't restore when exit

use <<-
2018-08-31 18:41:06 +08:00
garywill 8970ba2607 run hostapd before setting ip 2018-08-31 18:41:06 +08:00
garywill 258181055c version 0.5.2
add lxd
2018-08-31 18:41:06 +08:00
garywill 749b82a137 fix TMPDIR
better cleanup

dump support for old dnsmasq and networkmanager
2018-08-31 18:41:06 +08:00
garywill c69d7daa89 simply use nmcli to handle networkmanager
only support NM >= 0.9.9
2018-08-31 18:41:06 +08:00
garywill 650d78d456 version 0.5.1 2018-08-31 18:41:06 +08:00
garywill 251c0aec40 when interface and NetworkManager in different namespace
https://github.com/oblique/create_ap/pull/317
2018-08-31 18:41:06 +08:00
garywill 1e80edff82 delete uneeded code 2018-08-31 18:41:06 +08:00
garywill 0370cc1895 better cleanup and watchdog
delete lock

better exit

conf readable for users
2018-08-31 18:41:06 +08:00
garywill eebe767a19 hostapd foreground 2018-08-31 18:41:06 +08:00
garywill 47844d7049 change signal trap
fix waiting for pid file loop
2018-08-31 18:41:06 +08:00
garywill f816160fc1 use memory as temporary dir if available 2018-08-31 18:41:06 +08:00
garywill ddb59d3237 fix dnsmasq and hostapd pid 2018-08-31 18:41:06 +08:00
garywill 7815bce574 iptables NAT rule: do not masquerade client to client connections 2018-08-31 18:41:06 +08:00
garywill 4022d798b0 License LGPL 2.1 , upstream copyright notice 2018-08-31 18:41:06 +08:00
garywill 887d6059d8 iptables rules with comment 2018-08-31 18:41:06 +08:00
garywill 0338291599 now it works not creating wifi ap 2018-08-31 18:41:06 +08:00
garywill 9cc0f40aa4 cleanup echo
able to list clients via dns lease file

del bridge-nf-call-iptables
2018-08-31 18:41:06 +08:00
garywill 7f03b321f0 rename wifi_iface to subn_iface 2018-08-31 18:41:06 +08:00
garywill b905ea86f1 disable dnsmasq DNS if no Internet sharing
change inner name from create_ap to lnxrouter
2018-08-31 18:41:06 +08:00
garywill 3039b9a497 transparent proxy 2018-08-31 18:41:06 +08:00
garywill b7d4a70c24 fix dns log repeated 2018-08-31 18:41:06 +08:00
garywill d2f659117e change virtual interface name 2018-08-31 18:41:06 +08:00
garywill 7ec3f4bd18 parameters 2018-08-31 18:41:06 +08:00
garywill 0740e16da0 update iptables rules 2018-08-31 18:41:06 +08:00
garywill 49413b62ea differ dns and dhcp-dns 2018-08-31 18:41:06 +08:00
garywill 9fb6099bca enhance dnsmasq 2018-08-31 18:41:06 +08:00
garywill d13778d47f dns listen 53 2018-08-31 18:41:06 +08:00
garywill ee18930c84 rename to lnxrouter 2018-08-31 18:41:06 +08:00
garywill ad1b0e473f --ap and --password 2018-08-31 18:41:06 +08:00
garywill 9cd59d3975 put code into function 2018-08-31 18:41:06 +08:00
garywill 90dc5fdd8d fix _cleanup() didn't judge NO_DNSMASQ 2018-08-31 18:41:06 +08:00
garywill f31006f401 add var 2018-08-31 18:41:06 +08:00
garywill 47e8e80618 warn if no password 2018-08-31 18:41:06 +08:00
garywill c75dde77d8 delete piping ssid and password 2018-08-31 18:41:06 +08:00
garywill 10513edb17 not specify internet interface
cancel internet_iface parameter. now internet is shared via any interface
2018-08-31 18:41:06 +08:00
garywill d31d161842 show iptables change when applying network sharing rules 2018-08-31 18:41:06 +08:00
garywill c97c3c3b30 change default gateway ip to 18 2018-08-31 18:41:06 +08:00
garywill 052bf9d59f delete dns hijack 2018-08-31 18:41:06 +08:00
garywill d0c1451995 delete .conf 2018-08-31 18:41:06 +08:00
garywill 5a27e96851 delete uneeded 2018-08-31 18:41:06 +08:00
garywill 8d75d7324e delete bridge method 2018-08-31 18:41:06 +08:00
garywill 6fbd865345 dnsmasq run in frontground 2018-08-31 18:41:06 +08:00
garywill b8d82dd6c2 fix possible incomplete cleaning up 2018-08-31 18:41:06 +08:00
garywill a0146ce877 fix port 67 & 5353 accept any interface connection 2018-08-31 18:41:06 +08:00
garywill 517a2ea695 create_ap 2018-08-31 18:41:06 +08:00
3 changed files with 1061 additions and 1916 deletions
+42
View File
@@ -0,0 +1,42 @@
Copyright (c) 2013, oblique
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
================================================================================
linux-router
Copyright (C) 2018 garywill
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+110 -307
View File
@@ -1,11 +1,10 @@
# Linux-router
Set Linux as router in one command. Able to provide Internet, or create WiFi hotspot. Support transparent proxy (redsocks). Also useful for routing VM/containers.
Set Linux as router in one command. Able to Provide Internet, or create Wifi hotspot. Support transparent proxy (redsocks). Also useful for routing VM/containers.
It wraps `iptables`, `dnsmasq` etc. stuff. Use in one command, restore in one command or by `control-c` (or even by closing terminal window).
[Linux-Router News & Developer Notes 📰](https://github.com/garywill/linux-router/issues/28) | [More tools and projects 🛠️](https://garywill.github.io) | [🍻 Buy me a coffee ❤️](https://github.com/garywill/receiving/blob/master/receiving_methods.md)
It wraps `iptables`, `dnsmasq` etc. stuff. Use in one command, restore in one command or by `control-c`.
[Buy me a coffee](https://github.com/garywill/receiving/blob/master/receiving_methods.md)
## Features
@@ -13,20 +12,17 @@ Basic features:
- Create a NATed sub-network
- Provide Internet
- DHCP server (and RA)
- Specify what DNS the DHCP server assigns to clients
- DHCP server and RA
- DNS server
- Specify upstream DNS (kind of a plain DNS proxy)
- IPv6 (behind NATed LAN, like IPv4)
- Creating WiFi hotspot:
- IPv6 (NAT only for now)
- Creating Wifi hotspot:
- Channel selecting
- Choose encryptions: WPA2/WPA, WPA2, WPA, No encryption
- Create AP on the same interface you are getting Internet (usually require same channel)
- Hidden SSID
- Create AP on the same interface you are getting Internet (require same channel)
- Transparent proxy (redsocks)
- Transparent DNS proxy (hijack port 53 packets)
- Detect NetworkManager and make sure it won't interfere (handle interface (un)managed status)
- Detect firewalld and make sure it won't interfere our (by using `trusted` zone)
- You can run many instances, to create many different networks. Has instances managing feature.
- DNS proxy
- Compatible with NetworkManager (automatically set interface as unmanaged)
**For many other features, see below [CLI usage](#cli-usage-and-other-features)**
@@ -40,7 +36,7 @@ Internet----(eth0/wlan0)-Linux-(wlanX)AP
```
Internet
WiFi AP(no DHCP) |
Wifi AP(no DHCP) |
|----(wlan1)-Linux-(eth0/wlan0)------
| (DHCP)
|--client
@@ -63,88 +59,54 @@ Internet----(eth0/wlan0)-Linux-(eth1)------Another PC
Internet----(eth0/wlan0)-Linux-(virtual interface)-----VM/container
```
## Install
1-file-script. Release on [Linux-router repo on Github](https://github.com/garywill/linux-router). Just download and run the bash script (meet the dependencies). In this case use without installation.
I'm currently not packaging for any distro. If you do, open a PR and add the link (can be with a version badge) to list here
| Linux distro | |
| ------------ | ---------------------------------------------------------------------------------------------------------- |
| Any | download [1-file-script](https://raw.githubusercontent.com/garywill/linux-router/master/lnxrouter) and run without installation |
### Dependencies
- bash
- procps or procps-ng
- iproute2
- dnsmasq
- iptables (or nftables with `iptables-nft` translation linked)
- WiFi hotspot dependencies
- hostapd
- iw
- iwconfig (you only need this if 'iw' can not recognize your adapter)
- haveged (optional)
## Usage
### Provide Internet to an interface
```bash
sudo lnxrouter -i eth1
```
no matter which interface (other than `eth1`) you're getting Internet from.
### Create WiFi hotspot
```bash
sudo lnxrouter --ap wlan0 MyAccessPoint -p MyPassPhrase
# lnxrouter -i eth1
```
no matter which interface you're getting Internet from (even from `wlan0`). Will create virtual Interface `x0wlan0` for hotspot.
### Provide an interface's Internet to another interface
Clients access Internet through only `isp5`
<details>
```bash
sudo lnxrouter -i eth1 -o isp5 --no-dns --dhcp-dns 1.1.1.1 -6 --dhcp-dns6 [2606:4700:4700::1111]
```
# lnxrouter -i eth1 -o vpn0 --dhcp-dns 1.1.1.1
```
> In this case of usage, it's recommended to:
>
> 1. Stop serving local DNS
> 2. Tell clients which DNS to use (ISP5's DNS. Or, a safe public DNS, like above example)
### Create Wifi hotspot
</details>
### Create LAN without providing Internet
<details>
```bash
sudo lnxrouter -n -i eth1
```
# lnxrouter --ap wlan0 MyAccessPoint --password MyPassPhrase
```
```bash
sudo lnxrouter -n --ap wlan0 MyAccessPoint -p MyPassPhrase
### LAN without Internet
```
# lnxrouter -n -i eth1
# lnxrouter -n --ap wlan0 MyAccessPoint --password MyPassPhrase
```
</details>
### Transparent proxy with Tor
```
# lnxrouter -i eth1 --tp 9040 --dns 9053
```
In `torrc`
```
TransPort 0.0.0.0:9040
DNSPort 0.0.0.0:9053
TransPort [::]:9040
DNSPort [::]:9053
```
### Internet for LXC
<details>
Create a bridge
```bash
sudo brctl addbr lxcbr5
```
# brctl addbr lxcbr5
```
In LXC container `config`
@@ -156,70 +118,23 @@ lxc.network.link = lxcbr5
lxc.network.hwaddr = xx:xx:xx:xx:xx:xx
```
```bash
sudo lnxrouter -i lxcbr5
```
</details>
### Transparent proxy
All clients' Internet traffic go through, for example, Tor (notice this example is NOT an anonymity use)
<details>
```bash
sudo lnxrouter -i eth1 --tp 9040 --dns 9053 -g 192.168.55.1 -6 --p6 fd00:5:6:7::
# lnxrouter -i lxcbr5
```
In `torrc`
```
TransPort 192.168.55.1:9040
DNSPort 192.168.55.1:9053
TransPort [fd00:5:6:7::1]:9040
DNSPort [fd00:5:6:7::1]:9053
```
> **Warn**: Tor's anonymity relies on a purpose-made browser. Using Tor like this (sharing Tor's network to LAN clients) will NOT ensure anonymity.
>
> Although we use Tor as example here, Linux-router does NOT ensure nor is NOT aiming at anonymity.
</details>
### Clients-in-sandbox network
To not give our infomation to clients. Clients can still access Internet.
<details>
```bash
sudo lnxrouter -i eth1 \
--tp 9040 --dns 9053 \
--random-mac \
--ban-priv \
--catch-dns --log-dns # optional
```
</details>
> Linux-router comes with no warranty. Use on your own risk
### Use as transparent proxy for LXD
<details>
Create a bridge
```bash
sudo brctl addbr lxdbr5
```
# brctl addbr lxdbr5
```
Create and add a new LXD profile overriding container's `eth0`
Create and add LXD profile
```bash
lxc profile create profile5
lxc profile edit profile5
```
$ lxc profile create profile5
$ lxc profile edit profile5
### profile content ###
config: {}
@@ -232,72 +147,58 @@ devices:
type: nic
name: profile5
lxc profile add <container> profile5
$ lxc profile add <container> profile5
```
```bash
sudo lnxrouter -i lxdbr5 --tp 9040 --dns 9053
That should make one container have 2 profiles. `profile5` will override `eth0`.
```
# lnxrouter -i lxdbr5 --tp 9040 --dns 9053
```
To remove that new profile from container
```bash
lxc profile remove <container> profile5
```
$ lxc profile remove <container> profile5
```
#### To not use profile
Add new `eth0` to container overriding default `eth0`
Add device `eth0` to container overriding default `eth0`
```bash
lxc config device add <container> eth0 nic name=eth0 nictype=bridged parent=lxdbr5
```
$ lxc config device add <container> eth0 nic name=eth0 nictype=bridged parent=lxdbr5
```
To remove the customized `eth0` to restore default `eth0`
```bash
lxc config device remove <container> eth0
```
</details>
$ lxc config device remove <container> eth0
```
### Use as transparent proxy for VirtualBox
<details>
On VirtualBox's global settings, create a host-only network `vboxnet5` with DHCP disabled.
In VirtualBox's global settings, create a host-only network `vboxnet5` with DHCP disabled.
```bash
sudo lnxrouter -i vboxnet5 --tp 9040 --dns 9053
```
</details>
# lnxrouter -i vboxnet5 --tp 9040 --dns 9053
```
### Use as transparent proxy for firejail
<details>
Create a bridge
```bash
sudo brctl addbr firejail5
```
# brctl addbr firejail5
```
```bash
sudo lnxrouter -i firejail5 -g 192.168.55.1 --tp 9040 --dns 9053
firejail --net=firejail5 --dns=192.168.55.1 --blacklist=/var/run/nscd
```
Firejail's `/etc/resolv.conf` doesn't obtain DNS from DHCP, so we need to assign.
nscd is domain name cache service, which shouldn't be accessed from in jail here.
</details>
# lnxrouter -i firejail5 -g 192.168.55.1 --tp 9040 --dns 9053
$ firejail --net=firejail5 --dns=192.168.55.1
```
### CLI usage and other features
<details>
```
Usage: lnxrouter <options>
@@ -307,210 +208,112 @@ Options:
-i <interface> Interface to make NATed sub-network,
and to provide Internet to
(To create WiFi hotspot use '--ap' instead)
(To create Wifi hotspot use '--ap' instead)
-o <interface> Specify an inteface to provide Internet from.
(Note using this with default DNS option may leak
queries to other interfaces)
-n Do not provide Internet
--ban-priv Disallow clients to access my private network
-g <ip> This host's IPv4 address in subnet (mask is /24)
(example: '192.168.5.1' or '5' shortly)
-g <ip> Set this host's IPv4 address, netmask is 24
-6 Enable IPv6 (NAT)
--no4 Disable IPv4 Internet (not forwarding IPv4).
Usually used with '-6'
--p6 <prefix> Set IPv6 LAN address prefix (length 64)
(example: 'fd00:0:0:5::' or '5' shortly)
Using this enables '-6'
--p6 <prefix> Set IPv6 prefix (length 64) (example: fd00:1:2:3::)
--dns <ip>|<port>|<ip:port>
DNS server's upstream DNS.
Use ',' to seperate multiple servers
(default: use /etc/resolv.conf)
(default: use /etc/resolve.conf)
(Note IPv6 addresses need '[]' around)
--no-dns Do not serve DNS
--no-dnsmasq Disable dnsmasq server (DHCP, DNS, RA)
--catch-dns Transparent DNS proxy, redirect packets(TCP/UDP)
whose destination port is 53 to this host
--log-dns Show DNS query log (dnsmasq)
that destination port is 53 to this host
--log-dns Show DNS query log
--dhcp-dns <IP1[,IP2]>|no
Set IPv4 DNS offered by DHCP (default: this host).
Set IPv4 DNS offered by DHCP (default: this host)
--dhcp-dns6 <IP1[,IP2]>|no
Set IPv6 DNS offered by DHCP (RA)
(default: this host)
(Note IPv6 addresses need '[]' around)
Using both above two will enable '--no-dns'
--hostname <name> DNS server associate this name with this host.
Use '-' to read name from /etc/hostname
-d DNS server will take into account /etc/hosts
-e <hosts_file> DNS server will take into account additional
hosts file
--dns-nocache DNS server no cache
--mac <MAC> Set MAC address
--random-mac Use random MAC address
--tp <port> Transparent proxy,
redirect non-LAN TCP and UDP(not tested) traffic to
port. (usually used with '--dns')
redirect non-LAN TCP and UDP traffic to port.
Usually used with '--dns'
WiFi hotspot options:
Wifi hotspot options:
--ap <wifi interface> <SSID>
Create WiFi access point
-p, --password <password>
WiFi password
--qr Show WiFi QR code in terminal (need qrencode)
Create Wifi access point
--password <password> Wifi password
--hidden Hide access point (not broadcast SSID)
--no-virt Do not create virtual interface
Using this you can't use same wlan interface
for both Internet and AP
--virt-name <name> Set name of virtual interface
-c <channel> Specify channel (default: use current, or 1 / 36)
-c <channel> Channel number (default: 1)
--country <code> Set two-letter country code for regularity
(example: US)
--freq-band <GHz> Set frequency band: 2.4 or 5 (default: 2.4)
--driver Choose your WiFi adapter driver (default: nl80211)
-w <WPA version> '2' for WPA2, '1' for WPA, '1+2' for both
(default: 2)
-w <WPA version> Use 1 for WPA, use 2 for WPA2, use 1+2 for both
(default: 1+2)
--psk Use 64 hex digits pre-shared-key instead of
passphrase
--mac-filter Enable WiFi hotspot MAC address filtering
--mac-filter-accept Location of WiFi hotspot MAC address filter list
--mac-filter Enable Wifi hotspot MAC address filtering
--mac-filter-accept Location of Wifi hotspot MAC address filter list
(defaults to /etc/hostapd/hostapd.accept)
--hostapd-debug <level> 1 or 2. Passes -d or -dd to hostapd
--isolate-clients Disable wifi communication between clients
--ieee80211n Enable IEEE 802.11n (HT)
--ieee80211ac Enable IEEE 802.11ac (VHT)
--ht_capab <HT> HT capabilities (default: [HT40+])
--vht_capab <VHT> VHT capabilities
--no-haveged Do not run haveged automatically when needed
--hs20 Enable Hotspot 2.0
WiFi 4 (802.11n) configs:
--wifi4 Enable IEEE 802.11n (HT)
--req-ht Require station HT (High Throughput) mode
--ht-capab <HT caps> HT capabilities (default: [HT40+])
WiFi 5 (802.11ac) configs:
--wifi5 Enable IEEE 802.11ac (VHT)
--req-vht Require station VHT (Very High Thoughtput) mode
--vht-capab <VHT caps> VHT capabilities
--vht-ch-width <index> Index of VHT channel width:
0 for 20MHz or 40MHz (default)
1 for 80MHz
2 for 160MHz
3 for 80+80MHz (Non-contigous 160MHz)
--vht-seg0-ch <channel> Channel index of VHT center frequency for primary
segment. Use with '--vht-ch-width'
--vht-seg1-ch <channel> Channel index of VHT center frequency for secondary
(second 80MHz) segment. Use with '--vht-ch-width 3'
Instance managing:
--daemon Run in background
-l, --list-running Show running instances
--lc, --list-clients <id|interface>
List clients of an instance. Or list neighbors of
an interface, even if it isn't handled by us.
(passive mode)
--list-running Show running instances
--list-clients <id> List clients of an instance
--stop <id> Stop a running instance
For <id> you can use PID or subnet interface name.
You can get them with '--list-running'
Examples:
lnxrouter -i eth1
lnxrouter --ap wlan0 MyAccessPoint -p MyPassPhrase
lnxrouter -i eth1 --tp <transparent-proxy> --dns <dns-proxy>
```
</details>
> These changes to system will not be restored by script's cleanup:
> 1. `/proc/sys/net/ipv4/ip_forward = 1` and `/proc/sys/net/ipv6/conf/all/forwarding = 1`, needed by NAT Internet sharing.
> 2. dnsmasq in Apparmor complain mode
## What changes are done to Linux system
## Dependencies
On exit of a linux-router instance, script **will do cleanup**, i.e. undo most changes to system. Though, **some** changes (if needed) will **not** be undone, which are:
- bash
- procps or procps-ng
- iproute2
- dnsmasq
- iptables
1. `/proc/sys/net/ipv4/ip_forward = 1` and `/proc/sys/net/ipv6/conf/all/forwarding = 1`
2. dnsmasq in Apparmor complain mode
3. hostapd in Apparmor complain mode
4. Kernel module `nf_nat_pptp` loaded
5. The wifi device which is used to create hotspot is `rfkill unblock`ed
6. WiFi country code, if user assigns
Wifi hotspot:
## Meet contributor(s) and become one of them
Visit [**my homepage** 🏡](https://garywill.github.io) to see **more tools and projects** 🛠️.
> [❤️ Buy me a coffee](https://github.com/garywill/receiving/blob/master/receiving_methods.md) , this project took me lots of time! ([❤️ 扫码领红包并打赏一个!](https://github.com/garywill/receiving/blob/master/receiving_methods.md))
>
> 🥂 ( ^\_^) o自自o (^_^ ) 🍻
🤝 Bisides, thank [create_ap](https://github.com/oblique/create_ap) by [oblique](https://github.com/oblique). This script was forked from create\_ap. Now they are quite different. (See `history` branch for how I modified create_ap). 🤝 Also thank those who contributed to that project.
👨‍💻 You can be contributor, too!
- 🍃 There're some TO-DOs listed, in both [readme TODO](#todo) and [in the code file](https://github.com/garywill/linux-router/search?q=TODO&type=code)
- 🍃 Also some [unfulfilled enhancements in the Issues](https://github.com/garywill/linux-router/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
- 🙋‍♂️ Contributions are not limited to coding. There're [some posts and questions](https://github.com/garywill/linux-router/issues) that need more people to answer
- hostapd
- iw
- iwconfig (you only need this if 'iw' can not recognize your adapter)
- haveged (optional)
## TODO
- WPA3
- Global IPv6
## License
- Option to ban private network access
- Option to randomize MAC
linux-router is LGPL licensed
## Donate
<details>
```
linux-router
Copyright (C) 2018 garywill
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
```
</details>
Upstream create_ap was BSD licensed
<details>
```
Copyright (c) 2013, oblique
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
```
</details>
[Buy me a coffee](https://github.com/garywill/receiving/blob/master/receiving_methods.md)
## Thanks
Many thanks to project [create_ap](https://github.com/oblique/create_ap).
+628 -1328
View File
File diff suppressed because it is too large Load Diff