hostsctl

Один YAML-конфиг. Всё остальное в /etc/hosts остаётся ровно там, где вы это оставили.

Тридцать секунд

Поставить и создать конфиг:
Terminal window
```
brew install jtprogru/tap/hostsctl
hostsctl init
```
Добавить запись — она попадает в конфиг, а не сразу в /etc/hosts:
Terminal window
```
hostsctl add 127.0.0.1 k8s.orb.local --comment orbstack
```
Посмотреть перед записью. diff не требует root и ничего не меняет:
Terminal window
```
hostsctl diff
```
Применить:
Terminal window
```
sudo hostsctl apply
```

Результат в /etc/hosts:

127.0.0.1  localhost          ← системные строки, не тронуты
255.255.255.255  broadcasthost

# >>> hostsctl begin >>>
# generated by hostsctl 2026-08-11 17:15
# source: /Users/you/.config/hostsctl/config.yaml — edit that, not this block

# --- local — Local development ---
127.0.0.1      k8s.orb.local  # orbstack
# <<< hostsctl end <<<

Почему так

Файл остаётся вашим

Записи рендерятся в блок между маркерами. Системные строки, блоки других утилит и ручные правки переносятся байт в байт — это проверено тестами на копии настоящего /etc/hosts.

Группы, которые выключаются

Группа включается и выключается целиком. Выключил блоклист на день, включил обратно — и ничего в конфиге за это время не потерялось.

Конфиг по файлам

Можно держать всё в одном config.yaml, а можно разложить по зонам — в обычном hosts-синтаксисе или в YAML. Правки через CLI уходят обратно в тот файл, откуда группа пришла.

Честность про отказы

Атомарная запись с fsync и rename, снимок перед каждой записью, отказ отдать файл без 127.0.0.1 localhost и отдельный код выхода на каждый способ упасть.

Куда идти дальше

Впервые здесь? Прочитайте две страницы из раздела Начало, а потом возвращайтесь за тем руководством, которое отвечает на вашу задачу.

НачалоОт пустого конфига до отрендеренного /etc/hosts за пять команд и три способа откатиться.

УстановкаHomebrew, crates.io, скрипт установки, релизный архив и как проверить скачанное.

Руководства — по одной задаче на страницу

КонфигурацияЧто лежит в config.yaml, как записи связывают адреса с именами, где ищется файл.

ГруппыНаборы записей, которые включаются и выключаются целиком, и как переносить их между файлами.

Файлы-зоныКак разложить конфиг по файлам — в YAML или в обычном hosts-синтаксисе.

Удалённые блоклистыПодключение hosts-списка по URL, кеш с ETag и почему apply не ходит в сеть.

БэкапыСнимок перед каждой записью, как откатиться и чем снимок не является.

Права и sudoКаким командам нужен root и почему sudo не оставляет root-овых файлов в домашнем каталоге.

Справочник — генерируется из кода

Справочник CLIВсе команды и флаги, которые печатает сам бинарь. CI падает, если справочник разошёлся.

Справочник конфигаКаждый ключ config.yaml и файла-зоны, со значением по умолчанию и смыслом.

Правила проверкиВсё, о чём сообщает hostsctl check, и останавливает ли это запись.

Коды выходаЧто означает каждый статус, чтобы скрипт отличил сломанный конфиг от забытого sudo.

Проект

Как это работаетУправляемый блок, шесть шагов записи и почему отметка времени не меняется сама.

Миграция с hosts-syncДва пути со старого shell-скрипта и что происходит с его блоком.

Как участвоватьКак собрать, протестировать и предложить изменение — включая сайт документации.

Чем это не является

hostsctl не резолвит имена — это делает /etc/hosts со всеми своими ограничениями. Wildcards, порты и пути в имени хоста там не работают, поэтому hostsctl check отвергает их, а не даёт системе молча проигнорировать. Для wildcard-доменов нужен dnsmasq или /etc/resolver/.