# kkkgo/PaoPaoDNS

泡泡DNS是一个能一键部署递归DNS的docker镜像

Repository: https://github.com/kkkgo/PaoPaoDNS
Canonical: https://ross.abutalabs.com/products/paopaodns
Homepage: https://blog.03k.org/post/paopaodns.html
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: dnscrypt-proxy, geoip, mosdns, unbound, paopaodns, dns, dns-server, paopao, paopaogateway, dns-leak, recursor
Last push: 2024-08-28T16:09:13+00:00

## Health v2 (maintenance only)
Score: 30/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 88
- inputs: {"age_days": 1245, "days_push": 735, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1181, forks 109 (observed 2026-08-28T04:03:54.084528+00:00)

## What it is
PaoPaoDNS is a Docker image that deploys a recursive DNS server in one command, using Unbound as the recursive resolver, Redis for caching, mosdns for split routing, and dnscrypt-proxy for encrypted queries. It includes China-specific smart routing with automatic GeoIP database updates and IPv4/IPv6 dual-stack optimizations.

## Use cases
- run my own recursive DNS server in docker
- replace 8.8.8.8 or 114.114.114.114 as an upstream DNS
- set up a LAN DNS server with China split routing
- prevent DNS leaks and DNS pollution
- deploy a DNS server with encrypted upstream queries
- self-host a recursive resolver on a home server or NAS
- DNS server optimized for IPv4/IPv6 dual stack

## When to choose
- you want an accurate recursive DNS upstream instead of public resolvers
- you need China-mainland smart split routing with auto-updating IP lists
- you want a one-command Docker deployment with built-in health tests
- you need DNS leak/pollution protection with encrypted queries

## When to avoid
- you need an authoritative DNS server for hosting your own domains
- you want a full GUI-managed DNS solution like Pi-hole or AdGuard Home
- you cannot run Docker containers on your network equipment

## Facets
- artifact type: application
- maturity: active
- function: networking, caching, proxy, self-hosted, security
- domain: networking, self-hosted, privacy, developer-tools
- platform: self-hosted, cli
- tags: dns-server, recursive-dns, unbound, mosdns, dnscrypt-proxy, dns-leak-prevention, china-split-routing, geoip, docker-image, home-lab, docker, linux

## Member repositories
- kkkgo/PaoPaoDNS (main) score 30

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:54.084528+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:25:11.806765+00:00, confidence not recorded.
  - readme: https://github.com/kkkgo/PaoPaoDNS (fetched 2026-08-28T04:03:54.084528+00:00, sha f4f7680eadcd)
  - homepage: https://blog.03k.org/post/paopaodns.html (fetched 2026-08-29T12:31:59.476930+00:00, sha 609981ca8e2f)
  - site_page: https://blog.03k.org/about.html (fetched 2026-08-29T12:31:59.480774+00:00, sha ca3740cffc74)
- Data as of 2026-08-30T08:39:29.467469+00:00.
