[!IMPORTANT] 克隆此仓库可能需要很长时间！ 你可能只想从最新版本开始，而不是其自2018年以来的完整历史。 因此，你可能希望使用 git clone --depth 1 ... 来节省大量时间。

[!NOTE] 除了涉及 hosts/data/StevenBlack/hosts 更改的问题和PR外，所有其他关于生成的hosts文件内容的问题都应提交给贡献相应内容的适当数据源。所有数据源的联系信息可以在 hosts/data/ 目录中找到。

带基础扩展的统一hosts文件

此仓库整合了多个信誉良好的 hosts 文件，并将它们合并为一个去重后的统一hosts文件。提供了多种定制化的hosts文件。

因此，此仓库是一个hosts文件聚合器。

• 最后更新：2026年8月27日。
• 这里是 带基础扩展的统一hosts文件的原始hosts文件 包含79,746条条目。

所有hosts文件变体列表

此仓库提供 31种不同的hosts文件变体， 除基础变体外，还包括带或不带统一hosts的变体。

非GitHub镜像 是某些hosts文件管理器（如 适用于Windows的Hostsman）使用的链接，这些管理器无法使用GitHub下载链接。

预期：这些统一hosts文件应适用于所有设备，无论操作系统如何。

此变体中统一的数据源hosts

以下位置的更新 hosts 文件始终被统一并包含在内：

扩展

统一hosts文件是可选的扩展。扩展用于按类别包含域名。目前，我们提供以下类别：fakenews、social、gambling 和 porn。

扩展是可选的，可以与基础hosts文件以各种方式组合。组合后的产品存储在 alternates 文件夹中。

扩展数据存储在 extensions 文件夹中。你可以通过管理此文件夹树来管理扩展，其中你会找到我们维护并为你提供的 fakenews、social、gambling 和 porn 扩展数据。

生成你自己的统一hosts文件

你有三个选项来生成自己的hosts文件。你可以使用我们的容器镜像、构建自己的镜像，或者在你自己的环境中完成。如果你有安装了Docker的Linux系统，选项#1是最简单的。

选项1：使用我们的容器镜像（仅限Linux）

这将替换你的 /etc/hosts。

我们假设你的主机上已有Docker可用。只需运行以下命令。根据你的偏好设置扩展。```sh docker run --pull always --rm -it -v /etc/hosts:/etc/hosts
ghcr.io/stevenblack/hosts:latest updateHostsFile.py --auto
--replace --extensions gambling porn

如果你想添加自定义主机或白名单，请按照[说明](#how-do-i-control-which-sources-are-unified)创建其中一个或两个文件，并根据你的需求在`ghcr.io/stevenblack/hosts:latest`_之前_添加以下参数。```sh
-v "path/to/myhosts:/hosts/myhosts" \
-v "path/to/whitelist:/hosts/whitelist" \

您可以稍后重新运行此确切命令，以根据最新可用的主机列表进行更新（例如，将其添加到每周的 cron 作业中）。

选项 2：生成您自己的容器镜像

我们提供了上一步所使用的 Dockerfile， 您可以使用它来创建一个包含您所需一切的容器镜像。该容器将包含 Python 3 及其所有依赖项要求，以及此仓库最新版本的副本。

从本仓库的根目录构建 Docker 容器，操作如下：```sh docker build --no-cache . -t stevenblack-hosts

或者不进行克隆（直接从 GitHub 获取）：```sh
docker build --no-cache https://github.com/StevenBlack/hosts.git -t stevenblack-hosts

然后按如下方式运行你的命令：```sh docker run --rm -it stevenblack-hosts updateHostsFile.py

> 这将会创建 hosts 文件，并在容器完成时将其移除，
> 因此并不是很实用。你可以使用选项 #1 中的示例来添加卷，以便
> 替换你主机上的文件。

### 选项 3：在你自己的环境中生成

要生成你自己的合并 hosts 文件，你需要 Python 3.6 或更高版本。

首先，使用以下命令安装依赖项：```sh
pip3 install --user -r requirements.txt

注意 我们建议使用 --user 标志，它会在用户级别安装所需的依赖项。 关于它的更多信息可以在 pip 文档 中找到。

选项 4：在 Google Colab 中生成

启动一个免费的远程 Google Colab 环境。

无论你的开发环境如何，通用步骤

要运行单元测试，在顶层目录中运行：```sh python3 testUpdateHostsFile.py

`updateHostsFile.py` 脚本将根据本地 `data/` 子文件夹中的源生成一个统一的 hosts 文件。该脚本会提示您是否应获取更新版本（来自每个源文件夹中 `update.json` 文本文件所定义的位置）。否则，它将使用已存在的 `hosts` 文件。```sh
python3 updateHostsFile.py [--auto] [--replace] [--ip nnn.nnn.nnn.nnn] [--extensions ext1 ext2 ext3]

命令行选项

--help 或 -h：显示帮助信息。

--auto 或 -a：无需提示即可运行脚本。当调用 --auto 时，

• 主机数据源（包括扩展）会被更新。
• 默认不包含任何扩展。使用 --extensions 或 -e 标志来包含你想要的扩展。
• 你的活动 hosts 文件_不会_被替换，除非你包含 --replace 标志。

--backup 或 -b：在生成覆盖现有 hosts 文件时，为其创建备份。

--extensions <ext1> <ext2> <ext3> 或 -e <ext1> <ext2> <ext3>：extensions 文件夹下子文件夹的名称，其中包含要合并到聚合文件中的额外分类 hosts 文件。示例：--extensions porn 或 -e social porn。

--flush-dns-cache 或 -f：跳过刷新 DNS 缓存的提示。仅在 --replace 同时激活时生效。

--ip nnn.nnn.nnn.nnn 或 -i nnn.nnn.nnn.nnn：用作目标的 IP 地址。默认值为 0.0.0.0。

--keepdomaincomments 或 -k：true（默认）或 false，保留与域名出现在同一行的注释。默认值为 true。

--noupdate 或 -n：跳过从主机数据源获取更新。

--output <subfolder> 或 -o <subfolder>：将生成的源文件放置在子文件夹中。如果该子文件夹不存在，则会创建它。

--replace 或 -r：触发替换你的活动 hosts 文件。

--skipstatichosts 或 -s：false（默认）或 true，省略顶部的标准部分，其中包含类似 127.0.0.1 localhost 的行。这对于在本地网络上配置邻近 DNS 服务很有用。

--nogendata 或 -g：false（默认）或 true，跳过用于生成 readme.md 文件的 readmeData.json 文件的生成。如果你正在生成带有额外白名单或黑名单的 hosts 文件，并希望保持此仓库的本地检出不被修改，这很有用。

--nounifiedhosts：false（默认）或 true，不将统一 hosts 文件包含在最终 hosts 文件中。通常与 --extensions 一起使用。

--compress 或 -c：false（默认）或 true，压缩 hosts 文件，忽略非必要行（空行和注释），并将多个域名放在同一行。减少 hosts 文件的行数可以提高 Windows 下的性能（在启用 DNS Client 服务时）。

--minimise 或 -m：false（默认）或 true，类似于 --compress，但将每个域名放在单独的一行。这是必要的，因为许多依赖 hosts 文件的 URL 拦截器实现并不符合允许单行包含多个主机的标准。

--blacklist <blacklistfile> 或 -x <blacklistfile>：将给定的黑名单文件（以 hosts 格式）追加到生成的 hosts 文件中。

--whitelist <whitelistfile> 或 -w <whitelistfile>：使用给定的白名单文件从生成的 hosts 文件中移除主机。

如何控制哪些源被统一？

添加一个或多个_额外_源，每个源位于 data/ 文件夹的子文件夹中，并在其 update.json 文件中指定 url 键。

添加一个或多个_可选_扩展，这些扩展来自 extensions/ 文件夹的子文件夹。同样，update.json 中的 url 控制此扩展从哪里获取更新。

创建一个_可选_的 blacklist 文件。此文件的内容（包含以 hosts 文件格式列出的额外域名）会在更新过程中追加到统一 hosts 文件中。包含了一个示例 blacklist，你可以根据需要修改它。

• 注意：blacklist 不受 git 跟踪，因此你做出的任何更改都不会在将来从 origin 执行 git pull 此仓库时被覆盖。

如何包含我自己的自定义域名映射？

如果你有自定义 hosts 记录，请将它们放在 myhosts 文件中。此文件的内容会在更新过程中前置到统一 hosts 文件中。

myhosts 文件不受 git 跟踪，因此你做出的任何更改都不会在将来从 origin 执行 git pull 此仓库时被覆盖。

如何阻止域名被包含？

你在 whitelist 文件中列出的域名会从最终 hosts 文件中排除。

whitelist 使用部分匹配。因此，如果你将 google-analytics.com 加入白名单，该域名及其所有子域名都不会被合并到最终 hosts 文件中。

whitelist 不受 git 跟踪，因此你做出的任何更改都不会在将来从 origin 执行 git pull 此仓库时被覆盖。

如何贡献 hosts 记录？

如果你发现你认为应包含在此处的可疑域名，以下是一些贡献它们的方法。

选项 1：联系我们的 hosts 数据源之一

让新域名被包含的最佳方式是向任何数据提供商提交 issue，其主页 列在此处。 这是最佳方式，因为一旦你提交新域名，维护这些源的专职人员会对它们进行整理和更新。

选项 2：Fork 此仓库，将你的域名添加到 Steven Black 的个人数据文件中，并提交拉取请求

Fork 此 hosts 仓库，并将你的链接添加到 https://github.com/StevenBlack/hosts/blob/master/data/StevenBlack/hosts。

然后，提交一个拉取请求。

警告：这不如选项 1 理想，因为持续的整理工作会落在我们身上。因此这会给我们带来更多工作。

选项 3：在 GitHub 上创建你自己的 hosts 列表作为仓库

如果你能够整理自己的可疑域名集合，那么请整理你自己的 hosts 列表。然后通过 新 issue 告知我们你的仓库存在，我们可能会将你的新仓库纳入我们创建新版本时拉取的源集合中。

什么是 hosts 文件？

hosts 文件，名为 hosts（无文件扩展名），是所有操作系统用来将主机名映射到 IP 地址的纯文本文件。

在大多数操作系统中，hosts 文件的优先级高于 DNS。因此，如果域名由 hosts 文件解析，请求永远不会离开你的计算机。

拥有一个智能的 hosts 文件在阻止恶意软件、广告软件和其他烦扰内容方面大有帮助。

例如，要取消对某些 doubleclick.net 服务器的请求，在 hosts 文件中添加以下行即可：```text

block doubleClick's servers

0.0.0.0 ad.ae.doubleclick.net 0.0.0.0 ad.ar.doubleclick.net 0.0.0.0 ad.at.doubleclick.net 0.0.0.0 ad.au.doubleclick.net 0.0.0.0 ad.be.doubleclick.net

etc...

## 我们建议使用 `0.0.0.0` 而不是 `127.0.0.1`

传统上，大多数 hosts 文件使用 `127.0.0.1`，即_回环地址_，用于建立到本机的 IP 连接。

我们更倾向于使用 `0.0.0.0`，它被定义为一种不可路由的元地址，用于指定无效、未知或不适用的目标。

使用 `0.0.0.0` 在经验上更快，可能是因为无需等待超时解析。它也不会干扰本地 PC 上可能正在运行的 Web 服务器。

## 为什么不使用 `0` 代替 `0.0.0.0`？

我们尝试过。使用 `0` 并不能在所有情况下通用。

## hosts 文件的位置

要修改当前的 `hosts` 文件，请在以下位置查找并使用文本编辑器进行修改。

- **macOS（直到 10.14.x macOS Mojave）、iOS、Android、Linux**：`/etc/hosts`
  文件。
- **macOS Catalina**：`/private/etc/hosts` 文件。
- **Windows**：`%SystemRoot%\system32\drivers\etc\hosts` 文件。

## Gentoo

Gentoo 用户可以在 [::pf4public](https://github.com/PF4Public/gentoo-overlay) Gentoo overlay 中找到
[`sb-hosts`](https://github.com/PF4Public/gentoo-overlay/tree/master/net-misc/sb-hosts)

## NixOS

要在您的机器上安装 hosts 文件，请将以下内容添加到您的
`configuration.nix` 中：```nix
{
  networking.extraHosts = let
    hostsPath = https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts;
    hostsFile = builtins.fetchurl hostsPath;
  in builtins.readFile "${hostsFile}";
}

• 注意：如果你需要其他版本的 hosts 文件，请更改 hostsPath。
• 注意：对 fetchurl 的调用是不纯的。如果你希望始终获得相同的结果，请使用带有确切提交哈希的 fetchFromGitHub。

Nix Flake

通过 flakes 管理的 NixOS 安装可以直接将此仓库中的 flake.nix 作为输入使用。

它包含一个 nixosModule，可用于在本地安装 hosts 文件，以及一个包含用于 Unbound DNS 服务器配置文件的软件包，这些文件可用作阻止列表。```nix { inputs = { nixpkgs.url = "github:NixOS/nixpkgs?ref=$YOUR-REF"; hosts = { url = "github:StevenBlack/hosts"; # or a fork/mirror inputs.nixpkgs.follows = "nixpkgs"; }; };

outputs = { self, nixpkgs, hosts }: { nixosConfigurations.my-hostname = { system = ""; modules = [ # nixosModule to install hosts file locally: hosts.nixosModule { networking.stevenBlackHosts = { enable = true; # optionally: # enableIPv6 = true; # blockFakenews = true; # blockGambling = true; # blockPorn = true; # blockSocial = true; }; }

    # configure unbound to use config as blocklist:
    {
      {
        services.unbound = {
          enable = true;
          settings.server.include = [
            "${hosts.packages.${system}.unbound}/hosts"
            # alternates are also available, e.g. /fakenews, /fakenews-gambling etc.
          ];
        };
      }
    }
  ];
};

}; }

## 在 Windows 上更新 hosts 文件

（注意：另请参阅下面列出的一些第三方 Hosts 管理器。）

### 适用于旧版 Windows

在 Linux 和 macOS 上，运行 Python 脚本。在 Windows 上，由于兼容性问题需要做更多工作，因此最好按如下方式运行批处理文件：```sh
updateHostsWindows.bat

此文件必须在仓库目录中以管理员权限的命令提示符运行。除了更新 hosts 文件外，它还可以替换现有的 hosts 文件，并重新加载 DNS 缓存。不言而喻，要实现这一点，你必须连接到互联网。

要在仓库目录中以管理员身份打开命令提示符，请执行以下操作：

• Windows XP：开始 → 运行 → cmd
• Windows Vista、7：开始按钮 → 输入 cmd → 右键单击命令提示符 → “以管理员身份运行”
• Windows 8：开始 → 向上滑动 → 所有应用 → Windows 系统 → 右键单击 命令提示符 → “以管理员身份运行”
• Windows 10：开始按钮 → 输入 cmd → 右键单击命令提示符 → “以管理员 身份运行”

适用于新版 Windows

在现代版本的 Windows（10 尤其是 11）上，上述批处理脚本的并非所有功能都能正常工作（特别是检查当前 shell 是否具有管理员权限），因此建议采用更现代的方法。

提供的 updateHostsWindows.ps1 是一个 Powershell 5.1 脚本，其功能与批处理脚本相同，但无需 python 脚本，且增加了选项，并仅使用内置命令（自包含）。与批处理文件一样，它必须以管理员权限运行，但如果未以管理员权限运行，它可以自行重新启动。

要运行该脚本，请键入：```Powershell .\updateHostsWindows.ps1

在任何可用的 Windows 命令行中输入，如需详细信息，请键入：```Powershell
Get-Help .\updateHostsWindows.ps1 -Full

较新版本的 Windows 会带来一些问题（这些问题是可以克服的），如需更多信息和解决方案，请访问此脚本的主页 此处。

您也可以参阅“第三方 Hosts 管理器”部分，获取第三方推荐的进一步解决方案。

警告：在 Windows 中使用此 hosts 文件可能需要禁用 DNS 缓存服务

Windows 对较大的 hosts 文件存在一些问题。Windows 10 中最近的安全变更禁止通过其他工具更改服务，除非使用注册表修改。请使用 disable-dnscache-service-win.cmd 文件对 Windows 注册表进行适当更改。完成后，您需要重新启动设备。有关更多详细信息，请参阅 cmd 文件中的注释。

禁用 DNS 缓存服务可能会导致 WSL 等服务和应用出现问题，而且可以压缩 hosts 文件，从而无需禁用 DNS 缓存服务。您可以尝试 Hosts Compress - Windows 中的 C++ Windows 命令行工具（推荐方法），或使用 PowerShell 压缩脚本，并查看 Hosts Compression Scripts 仓库中的指南。

重新加载 hosts 文件

您的操作系统会缓存 DNS 查询。您可以重新启动，也可以在新 hosts 文件就位后运行以下命令手动刷新 DNS 缓存。

Google Chrome 浏览器可能需要在 chrome://net-internals/#dns 页面上手动清理其 DNS 缓存，之后才能看到 hosts 文件中的更改。参见：https://superuser.com/questions/723703

Windows

以管理员权限打开命令提示符，然后运行此命令：```bat ipconfig /flushdns

### Linux

打开终端并以 root 权限运行：

- **Debian/Ubuntu** `sudo service network-manager restart`
- **Linux Mint** `sudo /etc/init.d/dns-clean start`
- **使用 systemd 的 Linux**：`sudo systemctl restart network.service`
- **Fedora Linux**：`sudo systemctl restart NetworkManager.service`
- **使用 Network Manager 的 Arch Linux/Manjaro**：
  `sudo systemctl restart NetworkManager.service`
- **使用 Wicd 的 Arch Linux/Manjaro**：`sudo systemctl restart wicd.service`
- **RHEL/Centos**：`sudo /etc/init.d/network restart`
- **FreeBSD**：`sudo service nscd restart`

  若要首次启用 `nscd` 守护进程，建议您运行以下命令：  ```sh
  sudo sysrc nscd_enable="YES"
  sudo service nscd start

然后修改你的 /etc/nsswitch.conf 文件中的 hosts 行，改为以下内容： ```text hosts: cache files dns

- **NixOS**：当选项 `networking.extraHosts` 被更改时，`nscd.service` 会自动重启。
- **其他系统**：请参阅
[这篇维基百科文章](https://en.wikipedia.org/wiki/Hosts_%28file%29#Location_in_the_file_system)。

### macOS

如[这篇文章](https://osxdaily.com/2022/11/21/how-clear-dns-cache-macos-ventura-monterey/)所述，
打开终端并运行：```sh
sudo dscacheutil -flushcache;sudo killall -HUP mDNSResponder

发布管理

本仓库使用 release-it，一个用于 GitHub 仓库和 npm 包的优秀 CLI 发布工具，来自动化创建 releases。这就是为什么 package.json 和 .release-it.json 文件被捆绑在一起的原因。

本统一 hosts 文件的目标

本仓库的目标是：

1. 自动合并高质量的 hosts 列表，
2. 提供适合不同场景的扩展，
3. 对合并后的列表进行去重，
4. 并保持生成的文件大小合理。

这里对高质量来源的定义是：由维护者积极持续维护的来源。hosts 来源应由其维护者频繁更新，包括添加和移除条目。hosts 文件越大，预期的维护水平就越高。

预期此统一 hosts 文件将服务于各种操作系统下的桌面和移动设备。

第三方 Hosts 管理器

• Unified Hosts AutoUpdate （适用于 Windows）：Unified Hosts AutoUpdate 包专为此统一 hosts 项目而构建，并由社区成员积极开发维护。您可以安装和卸载任何黑名单并保持其自动更新，还可以将其放置在共享网络位置并通过组策略在整个组织中部署。由于它由社区成员积极开发，我们非常欢迎您的错误报告、功能请求和其他反馈。
• ViHoMa 是一个可视化 Hosts 文件管理器，由 Christian Martínez 用 Java 编写。快来看看吧！
• SaneHosts（适用于 macOS）：一个原生 hosts 文件管理器，支持基于配置文件的拦截、Touch ID 保护，并支持 200 多个精选拦截列表。开源。

有趣的应用程序

• Hosts-BL 是一个用于处理 hosts 文件黑名单的简单工具。它可以移除注释、移除重复项、压缩为每行 9 个域名、添加 IPv6 条目。此外，它还可以将黑名单转换为与其他软件兼容的多种其他黑名单格式，例如 dnsmasq、DualServer、RPZ、Privoxy 和 Unbound 等。
• Host Minder 是一个简单的图形界面工具，可让您轻松地将 /etc/hosts 文件更新为 StevenBlack/hosts 中的四个合并 hosts 文件之一。它以 deb 包形式提供，并预装在 UbuntuCE 上。
• Maza ad blocking 是一个自动更新 hosts 文件的 bash 脚本。您也可以更新一份全新的副本。每次它都会生成一个兼容 dnsmasq 的配置文件。安装快速，兼容 MacOS、Linux 和 BSD。
• Hostile 是一个便捷的命令行工具，可轻松从您的 hosts 文件中添加或移除域名。如果我们的 hosts 文件对您来说过于激进，您可以使用 hostile 移除域名，或者您可以在 bash 脚本中使用 hostile，以便每次下载新的 hosts 版本时自动执行后续处理。
• macOS Scripting for Configuration, Backup and Restore 帮助定制、重新安装和使用 macOS。它还提供了一个 脚本 用于在 macOS 上使用此项目安装和更新 hosts 文件。结合 launchd 它每隔 x 天（默认为 4 天）更新一次 hosts 文件。要安装两者，请下载 GitHub 仓库并从上一级目录运行 安装脚本。
• Pi-hole 是一个运行在 Raspberry Pi 上的全网络 DHCP 服务器和广告拦截器。Pi-hole 使用本仓库作为其来源之一。
• Block ads and malware via local BIND9 DNS server （适用于 Debian、Raspbian 和 Ubuntu）：使用来自此处的 /etc/bind/named.conf.blocked 文件设置本地 DNS 服务器。
• Block ads, malware, and deploy parental controls via local DualServer DNS/DHCP server （适用于 BSD、Windows 和 Linux）：使用为 DualServer 重新格式化的统一 hosts 的强大功能，为网络上的每个人设置黑名单。如果您使用 Windows，此项目还维护一个更新脚本，使更新 DualServer 的黑名单更加容易。
• Blocking ads and malwares with unbound – Unbound 是一个验证、递归和缓存的 DNS 解析器。
• dnsmasq conversion script 这个 GitHub gist 包含一个简短的 shell 脚本（bash，适用于任何 'nix 系统），使用大多数发行版中自带的 wget 和 awk 来获取指定的 hosts 文件并将其转换为 dnsmasq 所需的格式。支持 IPv4 和 IPv6。设计为既可以作为 shell 脚本使用，也可以放入 /etc/cron.weekly（或任何合适的位置）。该脚本简短且易于编辑，还附带了一份关于 dnsmasq 设置的简短文档。
• BlackHosts - Command Line Installer/Updater 这是一个跨平台命令行工具，用于帮助安装/更新本仓库中的 hosts 文件。
• Hosts Compression Scripts 这些是各种帮助压缩 hosts 文件的脚本（由 BlackHosts 的作者编写）。
• Hosts Compress - Windows 这是一个 C++ Windows 命令行工具，用于帮助压缩 hosts 文件（由 BlackHosts 和 Hosts Compression Scripts 的作者编写）。强烈推荐使用此工具而非脚本，因为它速度呈指数级提升。
• dnscrypt-proxy 提供了一个工具，可以从常见格式的本地和远程列表构建拦截列表。
• Control D 提供统一（广告软件 + 恶意软件）拦截列表的公共 anycast 网络托管镜像：
  • 传统 DNS：76.76.2.35、76.76.10.35、2606:1a40::35、2606:1a40:1::35
  • DNS-over-HTTPS/TLS/DOQ：https://freedns.controld.com/x-stevenblack、x-stevenblack.freedns.controld.com

贡献

请阅读我们的 贡献指南。 其中解释了我们在本仓库中如何组织文件和文件夹。

我们始终对发现精心维护的 hosts 来源感兴趣。如果您找到了，请打开一个 issue 来引起我们的注意。

在您创建或回复任何 issue 之前，请阅读我们的 行为准则。

Logo 由 @Tobaloidee 提供，谢谢！