mirror of https://github.com/coredns/coredns.git synced 2026-10-24 11:15:43 -04:00

Files

ump45nose 52056e5e8a plugin/quic: fix the documented worker_pool_size default (#8658 )

The README states the worker pool defaults to 512, but the server sizes it
from DefaultQUICStreamWorkers, which is 1024. Update the documented default
and the example that repeats it.

man/coredns-quic.7 is generated from this README by Makefile.doc at release
time, so it still carries the stale number.

Signed-off-by: yuwk <1729065730@qq.com>

2026-10-20 18:11:46 -07:00

README.md

plugin/quic: fix the documented worker_pool_size default (#8658 )

2026-10-20 18:11:46 -07:00

setup_test.go

plugin/quic: add max_connections directive (#8610 )

2026-10-08 05:24:25 -07:00

setup.go

plugin/quic: add max_connections directive (#8610 )

2026-10-08 05:24:25 -07:00

README.md

quic

Name

quic - configures DNS-over-QUIC (DoQ) server options.

Description

The quic plugin allows you to configure parameters for the DNS-over-QUIC (DoQ) server to fine-tune the security posture and performance of the server.

This plugin can only be used once per quic Server Block.

Syntax

quic {
    max_streams POSITIVE_INTEGER
    max_connections NON_NEGATIVE_INTEGER
    worker_pool_size POSITIVE_INTEGER
}

max_streams limits the number of concurrent QUIC streams per connection. This helps prevent DoS attacks where an attacker could open many streams on a single connection, exhausting server resources. The default value is 256 if not specified.
max_connections limits the number of concurrent QUIC connections accepted by the server. The default value is 200 if not specified. Connections above the configured limit are rejected. Set to 0 to disable the CoreDNS connection limit.
worker_pool_size defines the size of the worker pool for processing QUIC streams across all connections. The default value is 1024 if not specified. This limits the total number of concurrent streams that can be processed across all connections.

Examples

Enable DNS-over-QUIC with default settings (256 concurrent streams per connection, 200 concurrent connections, 1024 worker pool size):

quic://.:8853 {
    tls cert.pem key.pem
    quic
    whoami
}

Set custom limits for maximum QUIC streams per connection, maximum connections, and worker pool size:

quic://.:8853 {
    tls cert.pem key.pem
    quic {
        max_streams 16
        max_connections 50
        worker_pool_size 65536
    }
    whoami
}