0.7.1b readme
This commit is contained in:
garywill
parent
0c85f00297
commit
5dcfacc418
62
README.md
62
README.md
|
|
@ -66,13 +66,13 @@ Internet----(eth0/wlan0)-Linux-(virtual interface)-----VM/container
|
||||||
|
|
||||||
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.
|
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:
|
> 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 | |
|
| Linux distro | |
|
||||||
| ------------ | ---------------------------------------------------------------------------------------------------------- |
|
| ------------ | ---------------------------------------------------------------------------------------------------------- |
|
||||||
| Any | download [1-file-script](https://raw.githubusercontent.com/garywill/linux-router/master/lnxrouter) and run without installation |
|
| Any | download [1-file-script](https://raw.githubusercontent.com/garywill/linux-router/master/lnxrouter) and run without installation |
|
||||||
|
|
||||||
## Dependencies
|
### Dependencies
|
||||||
|
|
||||||
- bash
|
- bash
|
||||||
- procps or procps-ng
|
- procps or procps-ng
|
||||||
|
|
@ -368,7 +368,7 @@ Options:
|
||||||
Using this you can't use same wlan interface
|
Using this you can't use same wlan interface
|
||||||
for both Internet and AP
|
for both Internet and AP
|
||||||
--virt-name <name> Set name of virtual interface
|
--virt-name <name> Set name of virtual interface
|
||||||
-c <channel> Specify channel (default: use current one, or 1 / 36)
|
-c <channel> Specify channel (default: use current, or 1 / 36)
|
||||||
--country <code> Set two-letter country code for regularity
|
--country <code> Set two-letter country code for regularity
|
||||||
(example: US)
|
(example: US)
|
||||||
--freq-band <GHz> Set frequency band: 2.4 or 5 (default: 2.4)
|
--freq-band <GHz> Set frequency band: 2.4 or 5 (default: 2.4)
|
||||||
|
|
@ -383,31 +383,27 @@ Options:
|
||||||
--hostapd-debug <level> 1 or 2. Passes -d or -dd to hostapd
|
--hostapd-debug <level> 1 or 2. Passes -d or -dd to hostapd
|
||||||
--isolate-clients Disable wifi communication between clients
|
--isolate-clients Disable wifi communication between clients
|
||||||
--no-haveged Do not run haveged automatically when needed
|
--no-haveged Do not run haveged automatically when needed
|
||||||
--hs20 Enable Hotspot 2.0 (Make sure your hostapd build supports it)
|
--hs20 Enable Hotspot 2.0
|
||||||
|
|
||||||
WiFi 4 (802.11n) configs:
|
WiFi 4 (802.11n) configs:
|
||||||
--ieee80211n Enable IEEE 802.11n (HT)
|
--wifi4 Enable IEEE 802.11n (HT)
|
||||||
--require-ht Require station HT (High Throughput) mode
|
--req-ht Require station HT (High Throughput) mode
|
||||||
--ht-capab <HT> HT capabilities (default: [HT40+])
|
--ht-capab <HT caps> HT capabilities (default: [HT40+])
|
||||||
|
|
||||||
WiFi 5 (802.11ac) configs:
|
WiFi 5 (802.11ac) configs:
|
||||||
--ieee80211ac Enable IEEE 802.11ac (VHT)
|
--wifi5 Enable IEEE 802.11ac (VHT)
|
||||||
--require-vht Require station VHT (Very High Thoughtput) mode
|
--req-vht Require station VHT (Very High Thoughtput) mode
|
||||||
--vht-capab <VHT> VHT capabilities
|
--vht-capab <VHT caps> VHT capabilities
|
||||||
|
|
||||||
--vht-channel-width <index>
|
--vht-ch-width <index> Index of VHT channel width:
|
||||||
Index of VHT channel width:
|
|
||||||
0 for 20MHz or 40MHz (default)
|
0 for 20MHz or 40MHz (default)
|
||||||
1 for 80MHz
|
1 for 80MHz
|
||||||
2 for 160MHz
|
2 for 160MHz
|
||||||
3 for 80+80MHz (Non-contigous 160MHz)
|
3 for 80+80MHz (Non-contigous 160MHz)
|
||||||
--vht-seg0-channel <channel>
|
--vht-seg0-ch <channel> Channel index of VHT center frequency for primary
|
||||||
Channel index of VHT center frequency for primary
|
segment. Use with '--vht-ch-width'
|
||||||
segment, use with --vht-channel-width
|
--vht-seg1-ch <channel> Channel index of VHT center frequency for secondary
|
||||||
--vht-seg1-channel <channel>
|
(second 80MHz) segment. Use with '--vht-ch-width 3'
|
||||||
Channel index of VHT center frequency for secondary
|
|
||||||
(second 80MHz) segment,
|
|
||||||
use with '--vht-channel-width 3' .
|
|
||||||
|
|
||||||
Instance managing:
|
Instance managing:
|
||||||
--daemon Run in background
|
--daemon Run in background
|
||||||
|
|
@ -429,20 +425,6 @@ Options:
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
## Notice
|
|
||||||
|
|
||||||
<details>
|
|
||||||
|
|
||||||
```
|
|
||||||
Notice 1: This script assume your host's default policy won't forward
|
|
||||||
packets, so the script won't explictly ban forwarding in any
|
|
||||||
mode. In some unexpected case (eg. mistaken configurations) may
|
|
||||||
cause unwanted packets leakage between 2 networks, which you
|
|
||||||
should be aware of if you want isolated network
|
|
||||||
```
|
|
||||||
|
|
||||||
</details>
|
|
||||||
|
|
||||||
## What changes are done to Linux system
|
## What changes are done to Linux system
|
||||||
|
|
||||||
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:
|
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:
|
||||||
|
|
@ -470,6 +452,20 @@ Visit [**my homepage** 🏡](https://garywill.github.io) to see **more tools and
|
||||||
- 🍃 Also some [unfulfilled enhancements in the Issues](https://github.com/garywill/linux-router/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
|
- 🍃 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
|
- 🙋♂️ 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
|
||||||
|
|
||||||
|
## Notice
|
||||||
|
|
||||||
|
<details>
|
||||||
|
|
||||||
|
```
|
||||||
|
Notice 1: This script assume your host's default policy won't forward
|
||||||
|
packets, so the script won't explictly ban forwarding in any
|
||||||
|
mode. In some unexpected case (eg. mistaken configurations) may
|
||||||
|
cause unwanted packets leakage between 2 networks, which you
|
||||||
|
should be aware of if you want isolated network
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
## TODO
|
## TODO
|
||||||
|
|
||||||
Sooner is better:
|
Sooner is better:
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue