[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70847":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},70847,"docker-pi-hole","pi-hole\u002Fdocker-pi-hole","pi-hole","The official Pi-hole Docker image from pi-hole.net","https:\u002F\u002Fpi-hole.net",null,"Shell",11182,1237,110,7,0,10,26,104,30,112.28,"Other",false,"master",[26,27,28,7,29],"ad-blocker","dns","docker-container","web-app","2026-06-12 04:00:57","# Docker Pi-hole\n\n[![Build Status](https:\u002F\u002Fgithub.com\u002Fpi-hole\u002Fdocker-pi-hole\u002Fworkflows\u002FBuild%20Image%20and%20Test\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fpi-hole\u002Fdocker-pi-hole\u002Factions?query=workflow%3A%22Build+Image+and+Test%22) [![Docker Stars](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fstars\u002Fpihole\u002Fpihole.svg?maxAge=604800)](https:\u002F\u002Fstore.docker.com\u002Fcommunity\u002Fimages\u002Fpihole\u002Fpihole) [![Docker Pulls](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fpihole\u002Fpihole.svg?maxAge=604800)](https:\u002F\u002Fstore.docker.com\u002Fcommunity\u002Fimages\u002Fpihole\u002Fpihole)\n\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fpi-hole.net\u002F\">\n    \u003Cimg src=\"https:\u002F\u002Fpi-hole.github.io\u002Fgraphics\u002FVortex\u002Fvortex_with_text.svg\" width=\"144\" height=\"256\" alt=\"Pi-hole website\">\n  \u003C\u002Fa>\n  \u003Cbr>\n  \u003Cstrong>Network-wide ad blocking via your own Linux hardware\u003C\u002Fstrong>\n  \u003Cbr>\n  \u003Cbr>\n  \u003Cdiv align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fpi-hole.net\u002F\">Pi-hole website\u003C\u002Fa> |\n    \u003Ca href=\"https:\u002F\u002Fdocs.pi-hole.net\u002F\">Documentation\u003C\u002Fa> |\n    \u003Ca href=\"https:\u002F\u002Fdiscourse.pi-hole.net\u002F\">Discourse Forum\u003C\u002Fa> |\n    \u003Ca href=\"https:\u002F\u002Fpi-hole.net\u002Fdonate\">Donate\u003C\u002Fa>\n  \u003C\u002Fdiv>\n  \u003Cbr>\n  \u003Cbr>\n\u003C\u002Fdiv>\n\u003C!-- Delete above HTML and insert markdown for dockerhub : ![Pi-hole](https:\u002F\u002Fpi-hole.github.io\u002Fgraphics\u002FVortex\u002FVortex_with_text.png) -->\n\n## Upgrade Notes\n\n> [!NOTE]\n> **Using Watchtower?\\\n> See the [Note on Watchtower](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002Ftips-and-tricks\u002F#note-on-watchtower) in our documentation**.\n\n> [!TIP]\n> Some users [have reported issues](https:\u002F\u002Fgithub.com\u002Fpi-hole\u002Fdocker-pi-hole\u002Fissues\u002F963#issuecomment-1095602502) with using the `--privileged` flag on `2022.04` and above.\\\n> TL;DR, don't use that mode, and be [explicit with the permitted caps](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002Fconfiguration\u002F#note-on-capabilities) (if needed) instead.\n\n## Quick Start\n\nUsing [Docker-compose](https:\u002F\u002Fdocs.docker.com\u002Fcompose\u002Finstall\u002F):\n\n1. Copy the below docker compose example and update as needed:\n\n```yml\n# More info at https:\u002F\u002Fgithub.com\u002Fpi-hole\u002Fdocker-pi-hole\u002F and https:\u002F\u002Fdocs.pi-hole.net\u002F\nservices:\n  pihole:\n    container_name: pihole\n    image: pihole\u002Fpihole:latest\n    ports:\n      # DNS Ports\n      - \"53:53\u002Ftcp\"\n      - \"53:53\u002Fudp\"\n      # Default HTTP Port\n      - \"80:80\u002Ftcp\"\n      # Default HTTPs Port. FTL will generate a self-signed certificate\n      - \"443:443\u002Ftcp\"\n      # Uncomment the line below if you are using Pi-hole as your DHCP server\n      #- \"67:67\u002Fudp\"\n      # Uncomment the line below if you are using Pi-hole as your NTP server\n      #- \"123:123\u002Fudp\"\n    environment:\n      # Set the appropriate timezone for your location (https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FList_of_tz_database_time_zones), e.g:\n      TZ: 'Europe\u002FLondon'\n      # Set a password to access the web interface. Not setting one will result in a random password being assigned\n      FTLCONF_webserver_api_password: 'correct horse battery staple'\n      # If using Docker's default `bridge` network setting the dns listening mode should be set to 'ALL'\n      FTLCONF_dns_listeningMode: 'ALL'\n    # Volumes store your data between container upgrades\n    volumes:\n      # For persisting Pi-hole's databases and common configuration file\n      - '.\u002Fetc-pihole:\u002Fetc\u002Fpihole'\n      # Uncomment the below if you have custom dnsmasq config files that you want to persist. Not needed for most starting fresh with Pi-hole v6. If you're upgrading from v5 you and have used this directory before, you should keep it enabled for the first v6 container start to allow for a complete migration. It can be removed afterwards. Needs environment variable FTLCONF_misc_etc_dnsmasq_d: 'true'\n      #- '.\u002Fetc-dnsmasq.d:\u002Fetc\u002Fdnsmasq.d'\n    cap_add:\n      # See https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002F#note-on-capabilities\n      # Required if you are using Pi-hole as your DHCP server, else not needed\n      - NET_ADMIN\n      # Required if you are using Pi-hole as your NTP client to be able to set the host's system time\n      - SYS_TIME\n      # Optional, if Pi-hole should get some more processing time\n      - SYS_NICE\n    restart: unless-stopped\n```\n\n2. Run `docker compose up -d` to build and start pi-hole (Syntax may be `docker-compose` on older systems).\n\n> [!NOTE]\n> Volumes are recommended for persisting data across container re-creations for updating images.\n\n### Automatic Ad List Updates\n\n`cron` is baked into the container and will grab the newest versions of your lists and flush your logs. This happens once per week in the small hours of Sunday morning.\n\n## Documentation\n\nFor more detailed information, please refer to our documentation:\n\n- [Running DHCP from Docker Pi-Hole](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002FDHCP\u002F)\n- [Configuration](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002Fconfiguration\u002F)\n- [Tips and Tricks](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002Ftips-and-tricks\u002F)\n- [Docker tags and versioning](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002F#docker-tags-and-versioning)\n- [Upgrading, Persistence, and Customizations](https:\u002F\u002Fdocs.pi-hole.net\u002Fdocker\u002Fupgrading\u002F)\n\n## Docker tags and versioning\n\nThe primary docker tags are explained in the following table.  [Click here to see the full list of tags](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fpihole\u002Fpihole\u002Ftags). See [GitHub Release notes](https:\u002F\u002Fgithub.com\u002Fpi-hole\u002Fdocker-pi-hole\u002Freleases) to see the specific version of Pi-hole Core, Web, and FTL included in the release.\n\nThe Date-based (including incremented \"Patch\" versions) do not relate to any kind of semantic version number, rather a date is used to differentiate between the new version and the old version, nothing more.\n\nRelease notes will always contain full details of changes in the container, including changes to core Pi-hole components.\n\n| tag | description |\n| :--- | :--- |\n| `latest` | Always the latest release |\n| `2022.04.0` | Date-based release |\n| `nightly` | Built and pushed whenever there are changes on the `development` branch and additionally produced by the scheduled nightly job. These are the most experimental development images and may change frequently |\n\n## User Feedback\n\nPlease report issues on the [GitHub project](https:\u002F\u002Fgithub.com\u002Fpi-hole\u002Fdocker-pi-hole) when you suspect something docker related.  Pi-hole or general docker questions are best answered on our [user forums](https:\u002F\u002Fdiscourse.pi-hole.net\u002Fc\u002Fbugs-problems-issues\u002Fdocker\u002F30)\n","该项目提供了一个官方的Pi-hole Docker镜像，用于在网络层面通过自有的Linux设备实现广告拦截。它结合了DNS和Docker容器技术，能够有效阻止网络请求中的广告内容，并支持Web界面管理，允许用户轻松配置和监控整个过程。此外，该解决方案还具备DHCP服务器功能以及NTP时间同步服务选项，增强了其在网络环境中的实用性。适合于希望提高网络浏览体验、减少带宽消耗或加强网络安全的家庭用户及小型企业使用。",2,"2026-06-11 03:34:30","high_star"]