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
• Building the Docker Image
• Running the Docker Container
• Usage
• GitHub Actions CI/CD

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.