https://github.com/rcaught/hosts-override
Override hosts file entries for the lifetime of the process
https://github.com/rcaught/hosts-override
Last synced: 11 months ago
JSON representation
Override hosts file entries for the lifetime of the process
- Host: GitHub
- URL: https://github.com/rcaught/hosts-override
- Owner: rcaught
- Created: 2019-09-15T01:47:21.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-03-23T02:50:28.000Z (about 5 years ago)
- Last Synced: 2023-03-25T22:34:06.837Z (about 3 years ago)
- Language: Go
- Homepage:
- Size: 48.8 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# hosts-override [](https://travis-ci.org/rcaught/hosts-override)
Override `hosts` file entries for the lifetime of the process
## Installation
##### MacOS (Homebrew via own tap)
```
$ brew install rcaught/hosts-override/hosts-override
```
##### MacOS (manually)
```
$ curl -Ls https://github.com/rcaught/hosts-override/releases/latest/download/macos.zip > /tmp/hosts-override.zip
$ unzip /tmp/hosts-override.zip -d /usr/local/bin
```
##### Linux
```
$ curl -Ls https://github.com/rcaught/hosts-override/releases/latest/download/linux.zip > /tmp/hosts-override.zip
$ unzip /tmp/hosts-override.zip -d /usr/local/bin
```
##### Windows
- Download https://github.com/rcaught/hosts-override/releases/latest/download/windows.zip
- Unzip the file and run the exe as Administrator
## Usage
### Mac / Linux
- Override myhost.com to resolve to 127.0.0.1
```
$ sudo hosts-override myhost.com,127.0.0.1
```
- google.com will be resolved into an IP / set of IPs
```
$ sudo hosts-override myhost.com,google.com
```
- Multiple hosts and values are supported
```
$ sudo hosts-override myhost.com,127.0.0.1 anotherhost.com,127.0.0.1
```
- Refresh of unresolved hosts (with custom interval)
```
$ sudo hosts-override -r -i=1m myhost.com,127.0.0.1
```
### Windows
- Run Command Prompt as Administrator and navigate to the directory containing hosts-override.exe
- ```
hosts-override.exe myhost.com,127.0.0.1
```
### Notes
- `sudo` or running as Administrator is required as the hosts file is owned by `root`
- On exiting the program with an interupt (CTRL-c), the hosts file is cleaned of appended records
- In the case of an unclean shutdown, the next invocation of `hosts-override` will clear the previous sessions records
- IPv4 and IPv6 addresses supported