Compare commits
33 Commits
Author | SHA1 | Date |
---|---|---|
|
60d4b53236 | |
|
bef65d4b2b | |
|
1158b8b337 | |
|
8b3ebd8f67 | |
|
73aac55c34 | |
|
317de635d2 | |
|
cf9bc306c4 | |
|
3f8415a103 | |
|
7ffd74d4eb | |
|
3b036f4781 | |
|
c6d704e3aa | |
|
a511219b50 | |
|
7ecc846459 | |
|
bbb70b99ba | |
|
3ebbf37428 | |
|
958ebffd7f | |
|
ff15c19383 | |
|
bc8bfb5cab | |
|
d288b8f0ed | |
|
13a1654b91 | |
|
a18d4e75a4 | |
|
b4cbcbdbbb | |
|
205814a2ea | |
|
b6fe527472 | |
|
94949ba40b | |
|
9df05cd81a | |
|
01c99f8e4c | |
|
3900871977 | |
|
cfeadeb3bd | |
|
702c4f28f5 | |
|
3e23e0bd0c | |
|
fe2348a725 | |
|
7b374d1ee1 |
99
README.md
99
README.md
|
@ -4,7 +4,7 @@ Set Linux as router in one command. Able to provide Internet, or create WiFi hot
|
|||
|
||||
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)
|
||||
[More tools and projects 🛠️](https://garywill.github.io) | [🍻 Buy me a coffee ❤️](https://github.com/garywill/receiving/blob/master/receiving_methods.md)
|
||||
|
||||
|
||||
## Features
|
||||
|
@ -19,14 +19,17 @@ Basic features:
|
|||
- Specify upstream DNS (kind of a plain DNS proxy)
|
||||
- IPv6 (behind NATed LAN, like IPv4)
|
||||
- Creating WiFi hotspot:
|
||||
- Wifi 3/4/5/6
|
||||
- 2.4GHz, 5GHz
|
||||
- Channel selecting
|
||||
- Choose encryptions: WPA2/WPA, WPA2, WPA, No encryption
|
||||
- Create AP on the same interface you are getting Internet (usually require same channel)
|
||||
- Create AP on the same interface you are getting Internet (Need hardware support. Usually 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.
|
||||
- Detect and prevent interference from following Linux system daemons:
|
||||
- NetworkManager (handle interface (un)managed status)
|
||||
- firewalld (use temporary `trusted` zone)
|
||||
- Instances managing. You can run multiple instances, to create different sub-networks.
|
||||
|
||||
**For many other features, see below [CLI usage](#cli-usage-and-other-features)**
|
||||
|
||||
|
@ -82,9 +85,9 @@ I'm currently not packaging for any distro. If you do, open a PR and add the lin
|
|||
- 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)
|
||||
- iw (or iwconfig, when iw can not recognize adapter)
|
||||
- haveged (optional)
|
||||
- crda and wireless-regdb (optional)
|
||||
|
||||
|
||||
|
||||
|
@ -313,17 +316,17 @@ Options:
|
|||
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)
|
||||
-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)
|
||||
|
||||
--p6 <prefix> Set IPv6 LAN address prefix (length 64)
|
||||
(example: 'fd00:0:0:5::' or '5' shortly)
|
||||
Using this enables '-6'
|
||||
|
||||
|
||||
--dns <ip>|<port>|<ip:port>
|
||||
DNS server's upstream DNS.
|
||||
Use ',' to seperate multiple servers
|
||||
|
@ -331,37 +334,37 @@ Options:
|
|||
(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)
|
||||
--catch-dns Transparent DNS proxy, redirect packets(TCP/UDP)
|
||||
whose destination port is 53 to this host
|
||||
--log-dns Show DNS query log (dnsmasq)
|
||||
--dhcp-dns <IP1[,IP2]>|no
|
||||
Set IPv4 DNS offered by DHCP (default: this host).
|
||||
--dhcp-dns6 <IP1[,IP2]>|no
|
||||
Set IPv6 DNS offered by DHCP (RA)
|
||||
Set IPv6 DNS offered by DHCP (RA)
|
||||
(default: this host)
|
||||
(Note IPv6 addresses need '[]' around)
|
||||
Using both above two will enable '--no-dns'
|
||||
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
|
||||
-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')
|
||||
|
||||
|
||||
WiFi hotspot options:
|
||||
--ap <wifi interface> <SSID>
|
||||
Create WiFi access point
|
||||
-p, --password <password>
|
||||
-p, --password <password>
|
||||
WiFi password
|
||||
--qr Show WiFi QR code in terminal (need qrencode)
|
||||
|
||||
|
||||
--hidden Hide access point (not broadcast SSID)
|
||||
--no-virt Do not create virtual interface
|
||||
Using this you can't use same wlan interface
|
||||
|
@ -381,44 +384,62 @@ Options:
|
|||
(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
|
||||
--sta-timeout <seconds> Timeout to disconnect a no-signal client
|
||||
--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 4 (802.11n) configs (2.4G/5GHz): (default: not enable)
|
||||
--wifi4 Enable IEEE 802.11n (HT, High Throughput)
|
||||
--ht-capab <HT caps> HT capabilities (example: '[HT40+][DSSS_CCK-40]')
|
||||
(default: '[HT40+]')
|
||||
--req-wifi4 Only support Wifi>=4 clients
|
||||
|
||||
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
|
||||
|
||||
WiFi 5 (802.11ac) configs (5GHz): (default: not enable)
|
||||
--wifi5 Enable IEEE 802.11ac (VHT, Very High Thoughtput)
|
||||
--vht-capab <VHT caps> VHT capabilities (example: '[VHT160][RXLDPC]')
|
||||
--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
|
||||
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'
|
||||
--req-wifi5 Only support Wifi>=5 clients
|
||||
|
||||
WiFi 6 (802.11ax) configs (2.4G/5GHz): (default: not enable)
|
||||
--wifi6 Enable IEEE 802.11ax (HE, High Efficiency)
|
||||
--he-ch-width <index> Index of HE channel width:
|
||||
0 for 20MHz or 40MHz (default)
|
||||
1 for 80MHz
|
||||
2 for 160MHz
|
||||
3 for 80+80MHz (Non-contigous 160MHz)
|
||||
--he-seg0-ch <channel> Channel index of HE center frequency for primary
|
||||
segment. Use with '--he-ch-width'
|
||||
--he-seg1-ch <channel> Channel index of HE center frequency for secondary
|
||||
(second 80MHz) segment. Use with '--he-ch-width 3'
|
||||
--he-su-bfe HE Single User Beamformee support
|
||||
--he-su-bfr HE Single User Beamformer support
|
||||
--he-mu-bfr HE Multi User Beamformer support
|
||||
--req-wifi6 Only support Wifi>=6 clients
|
||||
--p2ptwt Peer-to-Peer Target Wake Time support
|
||||
|
||||
Note: Some cutting-edge Wifi features strongly depends on hostapd built
|
||||
with specific flags enabled and compatible hardware
|
||||
|
||||
Instance managing:
|
||||
--daemon Run in background
|
||||
--keep-confdir Don't delete the temporary config dir after exit
|
||||
|
||||
-l, --list-running Show running instances
|
||||
--lc, --list-clients <id|interface>
|
||||
--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)
|
||||
--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>
|
||||
|
@ -442,7 +463,7 @@ Visit [**my homepage** 🏡](https://garywill.github.io) to see **more tools and
|
|||
>
|
||||
> 🥂 ( ^\_^) 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.
|
||||
🤝 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. 🤝 Also thank those people who contributed to that project.
|
||||
|
||||
👨💻 You can be contributor, too!
|
||||
|
||||
|
|
Loading…
Reference in New Issue