Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cenk1cenk2/dns-proxy-server
https://github.com/cenk1cenk2/dns-proxy-server
Last synced: about 4 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/cenk1cenk2/dns-proxy-server
- Owner: cenk1cenk2
- License: apache-2.0
- Created: 2024-03-08T12:26:28.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-03-08T15:39:54.000Z (9 months ago)
- Last Synced: 2024-05-02T00:01:13.001Z (7 months ago)
- Language: Java
- Size: 13.4 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Patched fork of [mageddo/dns-proxy-server](https://github.com/mageddo/dns-proxy-server) for docker v25 compatability.
[](https://github.com/mageddo/dns-proxy-server/actions/workflows/ci.yml)
[![help me to keep DPS up to date][7]][6]
### Main features
DPS is a lightweight end user (Developers, Server Administrators) DNS server tool
which make it easy to develop in systems where one hostname can solve to different IPs based
on the configured environment, so you can:
- Solve hostnames from local configuration database
- Solve hostnames from docker containers using docker **hostname** option or **HOSTNAMES** env
- Solve hostnames from a list of configured remote DNS servers(as a proxy) if no answer of two above
- Solve hostnames using wildcards
- Graphic interface to Create/List/Update/Delete **A/CNAME** records
- Solve host machine IP using `host.docker` hostname
- Access container by its container name / service name
- Specify from which network solve container IP
Checkout the [full list of features][4] with examples
### Basic running it
You can run DPS as native binary downloading the latest [binaries releases][2]
or via docker looking at [Dockerhub images][3].
Basic running it on Linux or Mac
```bash
sudo ./dns-proxy-server
```
Then you can solve from pre-configured entries (conf/config.json):
```bash
$ ping dps-sample.dev
PING dps-sample.dev (192.168.0.254) 56(84) bytes of data.
```
Also solve Docker containers:
```bash
$ docker run --rm --hostname nginx.dev nginx
$ ping nginx.dev
PING nginx.dev (172.17.0.4) 56(84) bytes of data.
64 bytes from 172.17.0.4 (172.17.0.4): icmp_seq=1 ttl=64 time=0.043 ms
64 bytes from 172.17.0.4 (172.17.0.4): icmp_seq=2 ttl=64 time=0.022 ms
```
See [complete running it][5] documentation for running on Mac, Windows, Docker, etc.
also check the [samples][9] to learn by pratice.
### Documents
- [Full documentation](http://mageddo.github.io/dns-proxy-server/)
- [Running it documentation][5]
- [Tutorials and Examples][9]
- [Coding at the DPS](http://mageddo.github.io/dns-proxy-server/latest/en/5-developing/)
- [RFC-1035][1]
### Versioning and Releasing
Please be aware of [how DPS controls the releases][8] so you can use the most recent features and updates or
prefer to choose the more stable and old builds.
### Donation
Help me to keep DPS up to date
Via PayPal
[![][7]][6]
Or via QR code
[1]: https://www.ietf.org/rfc/rfc1035.txt
[2]: https://github.com/mageddo/dns-proxy-server/releases
[3]: https://hub.docker.com/r/defreitas/dns-proxy-server
[4]: http://mageddo.github.io/dns-proxy-server/latest/en/2-features/
[5]: http://mageddo.github.io/dns-proxy-server/latest/en/1-getting-started/running-it/
[6]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PYFAZCXL442B6&source=url
[7]: https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif
[8]: http://mageddo.github.io/dns-proxy-server/latest/en/1-getting-started/versioning
[9]: http://mageddo.github.io/dns-proxy-server/latest/en/5-tutorials/