Skip to content

README.md

Latest commit

 

History

History
51 lines (32 loc) · 1.86 KB

README.md

File metadata and controls

51 lines (32 loc) · 1.86 KB

doh-server

This repository contains a Dockerized DNS-over-HTTPS (DoH) server, built using dnscrypt/doh-server. It provides a simple way to run your own DoH resolver.

Table of Contents

Getting Started

To run this DoH server, you will need Docker installed on your system.

Building the Docker Image

You can build the Docker image locally using the provided Dockerfile:

docker build -t doh-server:latest .

This command will create a Docker image named doh-server with the tag latest.

Running the Docker Container

Once the image is built, you can run the DoH server in a Docker container:

docker run -d -p 8053:8053 --name doh-server doh-server:latest
  • -d: Runs the container in detached mode (in the background).
  • -p 8053:8053: Maps port 8053 on your host machine to port 8053 inside the container. The doh-server listens on port 8053 by default.
  • --name doh-server: Assigns a name to your container for easier management.

Usage

After the container is running, the DoH server will be accessible on http://localhost:8053. You can test it using curl:

curl -H 'accept: application/dns-json' 'http://localhost:8053/dns-query?dns=q80BAAABAAAAAAAAA3d3dwdleGFtcGxlA2NvbQAAAQAB'

This command queries for www.example.com using the DoH server.

GitHub Actions CI/CD

This repository includes a GitHub Actions workflow (.github/workflows/docker-build.yml) that automatically builds the Docker image whenever changes are pushed to the main branch. This ensures that your Docker image is always up-to-date with the latest code.