{"id":13582299,"url":"https://github.com/kevinjqiu/coredns-dockerdiscovery","last_synced_at":"2026-01-26T02:11:53.846Z","repository":{"id":33074622,"uuid":"130439518","full_name":"kevinjqiu/coredns-dockerdiscovery","owner":"kevinjqiu","description":"Docker Discovery Plugin for CoreDNS","archived":false,"fork":false,"pushed_at":"2024-03-25T13:47:31.000Z","size":74,"stargazers_count":56,"open_issues_count":10,"forks_count":29,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-17T19:24:23.734Z","etag":null,"topics":["coredns","coredns-plugin","discovery","docker"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevinjqiu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-21T04:22:29.000Z","updated_at":"2024-06-18T22:49:09.802Z","dependencies_parsed_at":"2024-01-13T03:01:27.875Z","dependency_job_id":"7f4e9f08-fc89-4fad-8cba-a00a0a73f40a","html_url":"https://github.com/kevinjqiu/coredns-dockerdiscovery","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kevinjqiu/coredns-dockerdiscovery","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjqiu%2Fcoredns-dockerdiscovery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjqiu%2Fcoredns-dockerdiscovery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjqiu%2Fcoredns-dockerdiscovery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjqiu%2Fcoredns-dockerdiscovery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinjqiu","download_url":"https://codeload.github.com/kevinjqiu/coredns-dockerdiscovery/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjqiu%2Fcoredns-dockerdiscovery/sbom","scorecard":{"id":557135,"data":{"date":"2025-08-11","repo":{"name":"github.com/kevinjqiu/coredns-dockerdiscovery","commit":"2f65ec48a254d16e37dce9237b7dee24a3231cfd"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.6,"checks":[{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":8,"reason":"Found 20/23 approved changesets -- score normalized to 8","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: containerImage not pinned by hash: Dockerfile:4","Warn: containerImage not pinned by hash: Dockerfile:21","Info:   0 out of   2 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.md:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE.md:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 27 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"21 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2023-2412 / GHSA-7ww5-4wqc-m92c","Warn: Project is vulnerable to: GO-2025-3528 / GHSA-265r-hfxg-fhmg","Warn: Project is vulnerable to: GO-2024-3130 / GHSA-hfmw-7g3m-gj6q","Warn: Project is vulnerable to: GO-2024-3134 / GHSA-h92q-fgpp-qhrq","Warn: Project is vulnerable to: GO-2024-2785 / GHSA-m9w6-wp3h-vq8g","Warn: Project is vulnerable to: GO-2025-3743 / GHSA-cvx7-x8pj-x2gw","Warn: Project is vulnerable to: GHSA-jq35-85cj-fj4p","Warn: Project is vulnerable to: GHSA-mq39-4gv4-mvpx","Warn: Project is vulnerable to: GO-2024-3005 / GHSA-v23v-6jw2-98fq","Warn: Project is vulnerable to: GO-2024-2512 / GHSA-xw73-rw38-6vjc","Warn: Project is vulnerable to: GO-2025-3829 / GHSA-4vq8-7jfc-9cvp","Warn: Project is vulnerable to: GO-2024-2491 / GHSA-xr7r-f8xq-vfvv","Warn: Project is vulnerable to: GO-2024-3110 / GHSA-jfvp-7x6p-h2pv","Warn: Project is vulnerable to: GO-2023-1988 / GHSA-2wrh-6pvc-2jm9","Warn: Project is vulnerable to: GO-2023-2102 / GHSA-4374-p667-p6c8","Warn: Project is vulnerable to: GO-2023-2153 / GHSA-m425-mq94-257g / GHSA-qppj-fm5r-hxr3","Warn: Project is vulnerable to: GO-2024-2687 / GHSA-4v7x-pqxf-cx7m","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2024-2611 / GHSA-8r3f-844c-mc37"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T12:40:12.266Z","repository_id":33074622,"created_at":"2025-08-20T12:40:12.266Z","updated_at":"2025-08-20T12:40:12.266Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28764848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T00:37:26.264Z","status":"online","status_checked_at":"2026-01-26T02:00:08.215Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coredns","coredns-plugin","discovery","docker"],"created_at":"2024-08-01T15:02:34.958Z","updated_at":"2026-01-26T02:11:53.831Z","avatar_url":"https://github.com/kevinjqiu.png","language":"Go","funding_links":[],"categories":["Go","External Plguins"],"sub_categories":[],"readme":"coredns-dockerdiscovery\n===================================\n\nDocker discovery plugin for coredns\n\nName\n----\n\ndockerdiscovery - add/remove DNS records for docker containers.\n\nSyntax\n------\n\n    docker [DOCKER_ENDPOINT] {\n        domain DOMAIN_NAME\n        hostname_domain HOSTNAME_DOMAIN_NAME\n        network_aliases DOCKER_NETWORK\n        label LABEL\n        compose_domain COMPOSE_DOMAIN_NAME\n    }\n\n* `DOCKER_ENDPOINT`: the path to the docker socket. If unspecified, defaults to `unix:///var/run/docker.sock`. It can also be TCP socket, such as `tcp://127.0.0.1:999`.\n* `DOMAIN_NAME`: the name of the domain for [container name](https://docs.docker.com/engine/reference/run/#name---name), e.g. when `DOMAIN_NAME` is `docker.loc`, your container with `my-nginx` (as subdomain) [name](https://docs.docker.com/engine/reference/run/#name---name) will be assigned the domain name: `my-nginx.docker.loc`\n* `HOSTNAME_DOMAIN_NAME`: the name of the domain for [hostname](https://docs.docker.com/config/containers/container-networking/#ip-address-and-hostname). Work same as `DOMAIN_NAME` for hostname.\n* `COMPOSE_DOMAIN_NAME`: the name of the domain when it is determined the\n    container is managed by docker-compose.  e.g. for a compose project of\n    \"internal\" and service of \"nginx\", if `COMPOSE_DOMAIN_NAME` is\n    `compose.loc` the fqdn will be `nginx.internal.compose.loc`\n* `DOCKER_NETWORK`: the name of the docker network. Resolve directly by [network aliases](https://docs.docker.com/v17.09/engine/userguide/networking/configure-dns) (like internal docker dns resolve host by aliases whole network)\n* `LABEL`: container label of resolving host (by default enable and equals ```coredns.dockerdiscovery.host```)\n\nHow To Build\n------------\n\n    GO111MODULE=on go get -u github.com/coredns/coredns\n    GO111MODULE=on go get github.com/kevinjqiu/coredns-dockerdiscovery\n    cd ~/go/src/github.com/coredns/coredns\n    echo \"docker:github.com/kevinjqiu/coredns-dockerdiscovery\" \u003e\u003e plugin.cfg\n    cat plugin.cfg | uniq \u003e plugin.cfg.tmp\n    mv plugin.cfg.tmp plugin.cfg\n    make all\n    ~/go/src/github.com/coredns/coredns/coredns --version\n\nAlternatively, you can use the following manual steps:\n\n1. Checkout coredns:  `go get github.com/coredns/coredns`.\n2. `cd $GOPATH/src/github.com/coredns/coredns`\n3. `echo \"docker:github.com/kevinjqiu/coredns-dockerdiscovery\" \u003e\u003e plugin.cfg`\n4. `go generate`\n5. `make`\n\nAlternatively, run insider docker container\n\n    docker build -t coredns-dockerdiscovery .\n    docker run --rm -v ${PWD}/Corefile:/etc/Corefile -v /var/run/docker.sock:/var/run/docker.sock -p 15353:15353/udp coredns-dockerdiscovery -conf /etc/Corefile\n\nRun tests\n\n    go test -v\n\nExample\n-------\n\n`Corefile`:\n\n    .:15353 {\n        docker unix:///var/run/docker.sock {\n            domain docker.loc\n            hostname_domain docker-host.loc\n        }\n        log\n    }\n\nStart CoreDNS:\n\n    $ ./coredns\n\n    .:15353\n    2018/04/26 22:36:32 [docker] start\n    2018/04/26 22:36:32 [INFO] CoreDNS-1.1.1\n    2018/04/26 22:36:32 [INFO] linux/amd64, go1.10.1,\n    CoreDNS-1.1.1\n\nStart a docker container:\n\n    $ docker run -d --name my-alpine --hostname alpine alpine sleep 1000\n    78c2a06ef2a9b63df857b7985468f7310bba0d9ea4d0d2629343aff4fd171861\n\nUse CoreDNS as your resolver to resolve the `my-alpine.docker.loc` or `alpine.docker-host.loc`:\n\n    $ dig @localhost -p 15353 my-alpine.docker.loc\n\n    ; \u003c\u003c\u003e\u003e DiG 9.10.3-P4-Ubuntu \u003c\u003c\u003e\u003e @localhost -p 15353 my-alpine.docker.loc\n    ; (1 server found)\n    ;; global options: +cmd\n    ;; Got answer:\n    ;; -\u003e\u003eHEADER\u003c\u003c- opcode: QUERY, status: NOERROR, id: 61786\n    ;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1\n\n    ;; OPT PSEUDOSECTION:\n    ; EDNS: version: 0, flags:; udp: 4096\n    ;; QUESTION SECTION:\n    ;my-alpine.docker.loc.            IN      A\n\n    ;; ANSWER SECTION:\n    my-alpine.docker.loc.     3600    IN      A       172.17.0.2\n\n    ;; Query time: 0 msec\n    ;; SERVER: 127.0.0.1#15353(127.0.0.1)\n    ;; WHEN: Thu Apr 26 22:39:55 EDT 2018\n    ;; MSG SIZE  rcvd: 63\n\nStop the docker container will remove the corresponded DNS entries:\n\n    $ docker stop my-alpine\n    78c2a\n\n    $ dig @localhost -p 15353 my-alpine.docker.loc\n\n    ;; QUESTION SECTION:\n    ;my-alpine.docker.loc.            IN      A\n\nContainer will be resolved by label as ```nginx.loc```\n\n    docker run --label=coredns.dockerdiscovery.host=nginx.loc nginx\n\n\n See receipt [how install for local development](setup.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjqiu%2Fcoredns-dockerdiscovery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinjqiu%2Fcoredns-dockerdiscovery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjqiu%2Fcoredns-dockerdiscovery/lists"}