mirror of
https://github.com/garywill/linux-router.git
synced 2025-11-08 23:34:04 +01:00
Compare commits
34 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b4cbcbdbbb | ||
|
|
205814a2ea | ||
|
|
b6fe527472 | ||
|
|
94949ba40b | ||
|
|
9df05cd81a | ||
|
|
01c99f8e4c | ||
|
|
3900871977 | ||
|
|
cfeadeb3bd | ||
|
|
702c4f28f5 | ||
|
|
3e23e0bd0c | ||
|
|
fe2348a725 | ||
|
|
7b374d1ee1 | ||
|
|
e7ecf8707d | ||
|
|
fbad56f05c | ||
|
|
c376609896 | ||
|
|
a8ae765f03 | ||
|
|
d39b438161 | ||
|
|
6aabef278b | ||
|
|
8b57dcef1a | ||
|
|
1def3deb96 | ||
|
|
04f473dc64 | ||
|
|
c1bb2668dd | ||
|
|
a4e3089e69 | ||
|
|
8c9e16dd17 | ||
|
|
40872ebb9e | ||
|
|
97b1ef5bd0 | ||
|
|
9fc74d4bdb | ||
|
|
8759ee43f1 | ||
|
|
5f24246e85 | ||
|
|
508fefa48f | ||
|
|
791f6c314b | ||
|
|
4db9dcbdb0 | ||
|
|
97269da898 | ||
|
|
9c9b3afde6 |
50
README.md
50
README.md
@ -25,6 +25,7 @@ Basic features:
|
||||
- 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.
|
||||
|
||||
**For many other features, see below [CLI usage](#cli-usage-and-other-features)**
|
||||
@ -81,9 +82,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)
|
||||
|
||||
|
||||
|
||||
@ -120,8 +121,6 @@ sudo lnxrouter -i eth1 -o isp5 --no-dns --dhcp-dns 1.1.1.1 -6 --dhcp-dns6 [26
|
||||
> 1. Stop serving local DNS
|
||||
> 2. Tell clients which DNS to use (ISP5's DNS. Or, a safe public DNS, like above example)
|
||||
|
||||
> Also, read *Notice 1*
|
||||
|
||||
</details>
|
||||
|
||||
### Create LAN without providing Internet
|
||||
@ -136,8 +135,6 @@ sudo lnxrouter -n -i eth1
|
||||
sudo lnxrouter -n --ap wlan0 MyAccessPoint -p MyPassPhrase
|
||||
```
|
||||
|
||||
> Read _Notice 1_
|
||||
|
||||
</details>
|
||||
|
||||
### Internet for LXC
|
||||
@ -312,17 +309,16 @@ Options:
|
||||
and to provide Internet to
|
||||
(To create WiFi hotspot use '--ap' instead)
|
||||
-o <interface> Specify an inteface to provide Internet from.
|
||||
(See Notice 1)
|
||||
(Note using this with default DNS option may leak
|
||||
queries to other interfaces)
|
||||
-n Do not provide Internet (See Notice 1)
|
||||
-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)
|
||||
(See Notice 1). Usually used with '-6'
|
||||
--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)
|
||||
@ -331,7 +327,7 @@ Options:
|
||||
--dns <ip>|<port>|<ip:port>
|
||||
DNS server's upstream DNS.
|
||||
Use ',' to seperate multiple servers
|
||||
(default: use /etc/resolve.conf)
|
||||
(default: use /etc/resolv.conf)
|
||||
(Note IPv6 addresses need '[]' around)
|
||||
--no-dns Do not serve DNS
|
||||
--no-dnsmasq Disable dnsmasq server (DHCP, DNS, RA)
|
||||
@ -418,12 +414,11 @@ Options:
|
||||
--stop <id> Stop a running instance
|
||||
For <id> you can use PID or subnet interface name.
|
||||
You can get them with '--list-running'
|
||||
|
||||
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
|
||||
|
||||
Examples:
|
||||
lnxrouter -i eth1
|
||||
lnxrouter --ap wlan0 MyAccessPoint -p MyPassPhrase
|
||||
lnxrouter -i eth1 --tp <transparent-proxy> --dns <dns-proxy>
|
||||
```
|
||||
|
||||
</details>
|
||||
@ -455,30 +450,9 @@ 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)
|
||||
- 🙋♂️ 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
|
||||
|
||||
Sooner is better:
|
||||
- Detect firewalld and make sure it won't interfere our interface
|
||||
|
||||
Future:
|
||||
- WPA3
|
||||
- Global IPv6
|
||||
- Explictly ban forwarding if not needed
|
||||
- Bring bridging method back
|
||||
|
||||
## License
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user