aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: e95ec9b30d3e95925cfd9526f6edd6861af2b8aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# captive-netns-helper

This is a program for Linux that helps you bypass VPN rules in routing table and
custom system DNS resolver and access internet directly via physical interface.
It was written for accessing Wi-Fi captive portals. It comes with a wrapper script
to be easier to use.

Read more [here](https://ch1p.io/gentoo-wireguard-custom-resolver-captive-portal/).

## Installation

```
git clone https://github.com/gch1p/captive-netns-helper
cd captive-netns-helper
mkdir build
cd build
cmake ..
make -j4
sudo make install
```

## Usage
```
captive-portal.sh PROGRAM [ARGUMENTS]
```

For example:
```
captive-portal.sh curl -v https://captive.apple.com
```

## License

MIT