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

[!NOTE] 除涉及对 hosts/data/StevenBlack/hosts 更改的 issue 和 PR 外，所有其他关于生成的 hosts 文件内容的 issue 都应向提供相关内容的相应数据源提出。所有数据源的联系信息可在 hosts/data/ 目录中找到。

带基础扩展的统一 hosts 文件

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

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

• 最后更新：2026 年 9 月 14 日。
• 这是原始 hosts 文件 带基础扩展的统一 hosts 文件，包含 78,140 条条目。

所有 hosts 文件变体列表

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

非 GitHub 镜像链接适用于某些 hosts 文件管理器，例如 Hostsman for Windows，这些管理器无法使用 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

如果你想添加自定义 hosts 或白名单，请按照[说明](#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" \

你可以稍后重新运行此确切命令，以基于最新可用的 hosts 进行更新（例如，将其添加到每周的 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 标志来包含你想要的扩展。
• 除非包含 --replace 标志，否则你的活动 hosts 文件 不会 被替换。

--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：跳过从 hosts 数据源获取更新。

--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 的个人数据文件，并提交 pull request

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

然后，提交一个 pull request。

警告：这不如选项 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 并指定确切的 commit。

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` 会自动重启。
- **其他系统**：请参阅
[这篇 Wikipedia 文章](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 是一个简单的 GUI，允许你轻松地将 /etc/hosts 文件更新为 StevenBlack/hosts 提供的四个 合并 hosts 文件之一。它以 deb 包形式提供，并预装在 UbuntuCE 上。
• Maza ad blocking 是一个 bash 脚本，可自动更新 host 文件。你也可以更新一份新的副本。 并且每次都会生成一个兼容 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 是一个网络范围的 DHCP 服务器和广告拦截器， 运行在 Raspberry Pi 上。 Pi-hole 使用此仓库作为其来源之一。
• 通过本地 BIND9 DNS 服务器拦截广告和恶意软件 （适用于 Debian、Raspbian 和 Ubuntu）：使用来自此处的 /etc/bind/named.conf.blocked 文件设置本地 DNS 服务器。
• 通过本地 DualServer DNS/DHCP 服务器拦截广告、恶意软件并部署家长控制 （适用于 BSD、Windows 和 Linux）：使用为 DualServer 重新格式化的统一 hosts 的强大功能， 为网络上的每个人设置黑名单。如果你 使用 Windows，此项目还维护一个更新脚本，使更新 DualServer 的黑名单更加容易。
• 使用 unbound 拦截广告和恶意软件 – Unbound 是一个验证型、递归型、缓存型 DNS 解析器。
• dnsmasq 转换脚本 这个 GitHub gist 包含一个简短的 shell 脚本（bash，可在任何 'nix 上运行）， 使用大多数发行版中都存在的 wget 和 awk，获取指定的 hosts 文件 并将其转换为 dnsmasq 所需的格式。支持 IPv4 和 IPv6。 设计为既可作为 shell 脚本使用，也可以放入 /etc/cron.weekly（或任何合适的位置）。该脚本简短且易于编辑， 还附有一份关于 dnsmasq 设置的简短说明文档。
• BlackHosts - 命令行安装程序/更新程序 这是一个跨平台命令行实用程序，用于帮助安装/更新此仓库中的 hosts 文件。
• Hosts 压缩脚本 这些是各种用于帮助压缩 hosts 文件的脚本（由 BlackHosts 的作者编写）。
• Hosts Compress - Windows 这是一个 C++ Windows 命令行工具，用于帮助压缩 hosts 文件（由 BlackHosts 和 Hosts Compression Scripts 的作者编写）。强烈推荐使用它而不是脚本，因为它快得多。
• dnscrypt-proxy 提供了一个工具，可从常见格式的本地和远程列表构建阻止列表。
• Control D 提供了统一（广告软件 + 恶意软件）阻止列表的公共任播网络托管镜像：
  • 传统 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 设计，谢谢！