Windows контейнеры вручную. Часть 2: Даём контейнерам имена и адреса

Все части серии «Windows контейнеры вручную»

В первой части мы поставили containerd и разобрались, что можно сделать с одним контейнером: сеть, порты, папки и файлы хоста, лимиты, уровни изоляции. Сегодня контейнеров станет два, и одному понадобится обратиться к другому по имени. Посмотрим, какие для этого есть способы, и будем пробовать их по очереди, пока не найдём тот, что работает при любом порядке запуска.

Всё, что понадобится, лежит в папке 02-names репозитория.


Два контейнера в одной сети

Запустим два контейнера: web с примером ASP.NET от Microsoft, который слушает порт 8080, и client — Nano Server, который ничего не делает, пока мы заходим в него через exec:

nerdctl run -d --name web -p 8080:8080 mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
nerdctl run -d --name client mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost

ping -t бесконечно пингует сам контейнер — это просто способ держать его запущенным. Чтобы обратиться к web, нужен его адрес. nerdctl inspect web на Windows адреса не показывает — поле NetworkSettings.IPAddress пустое, — поэтому спросим у самих контейнеров:

function Get-ContainerIp($name) { ((nerdctl exec $name cmd /c "ipconfig | findstr IPv4") -split ':')[-1].Trim() }
$webIp = Get-ContainerIp web
$clientIp = Get-ContainerIp client
"web=$webIp client=$clientIp"
nerdctl exec client ping -n 3 $webIp
nerdctl exec client curl.exe -sS -o NUL -w "%{http_code}`n" "http://${webIp}:8080/"
nerdctl exec web cmd /c ping -n 2 $clientIp
web=172.30.252.180 client=172.30.133.157

Pinging 172.30.252.180 with 32 bytes of data:
Reply from 172.30.252.180: bytes=32 time<1ms TTL=128
Reply from 172.30.252.180: bytes=32 time<1ms TTL=128
Reply from 172.30.252.180: bytes=32 time<1ms TTL=128

Ping statistics for 172.30.252.180:
    Packets: Sent = 3, Received = 3, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 0ms, Maximum = 0ms, Average = 0ms
200

Pinging 172.30.133.157 with 32 bytes of data:
Reply from 172.30.133.157: bytes=32 time<1ms TTL=128
Reply from 172.30.133.157: bytes=32 time<1ms TTL=128

Ping statistics for 172.30.133.157:
    Packets: Sent = 2, Received = 2, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 0ms, Maximum = 0ms, Average = 0ms

Контейнеры видят друг друга напрямую: ping идёт в обе стороны, веб-запрос (HTTP — протокол, которым браузер забирает страницы) к web на порт 8080 вернул код 200. TTL — счётчик, который уменьшает каждый маршрутизатор на пути пакета, — пришёл нетронутым (128, начальное значение Windows): между контейнерами нет маршрутизатора, они в одной подсети за одним виртуальным коммутатором. Публиковать порт для этого не нужно — -p нужен только для доступа снаружи хоста.

А теперь по имени:

nerdctl exec client curl.exe -sS -m 5 -o NUL http://web:8080/
curl: (6) Could not resolve host: web
time="2026-11-08T11:41:46+03:00" level=fatal msg="exec failed with exit code 6"

Имя web контейнер не знает. На Linux nerdctl и Docker отвечают на имена контейнеров своим DNS-сервером, а у nerdctl на Windows такого нет: контейнер спрашивает DNS-сервер хоста, полученный от CNI-плагина в первой части, а тот о контейнерах ничего не знает. Адреса к тому же каждый раз новые — плагин nat раздаёт их из подсети как придётся, — так что прописать их в приложение заранее тоже не выйдет.


Что предлагает nerdctl

На Linux у nerdctl, как и у Docker, для этого есть три флага: --ip задаёт адрес контейнера, --dns — его DNS-сервер, --add-host дописывает имя в его файл hosts. Попробуем:

nerdctl run --rm --ip 172.30.0.50 mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c ver
nerdctl run --rm --dns 172.30.0.1 mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c ver
nerdctl run --rm --add-host "web:$webIp" mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c ver
time="2026-11-08T11:41:48+03:00" level=fatal msg="failed to verify networking settings: the following networking arguments are not supported on Windows: [--ip-address]"
time="2026-11-08T11:41:48+03:00" level=fatal msg="failed to verify networking settings: the following networking arguments are not supported on Windows: [--dns-servers]"
time="2026-11-08T11:41:48+03:00" level=fatal msg="failed to verify networking settings: the following networking arguments are not supported on Windows: [--add-host]"

На Windows все три отклоняются. Значит, решать придётся самим.

Заодно о собственном имени контейнера. --name — имя контейнера для nerdctl, внутрь оно не передаётся, а задать имя компьютера nerdctl на Windows не позволяет:

nerdctl run --rm --name foo mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c "hostname & echo %COMPUTERNAME%"
nerdctl run --rm --name foo --hostname foo mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c hostname
nerdctl run --rm --name foo -e COMPUTERNAME=foo mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c "hostname & echo %COMPUTERNAME%"
minwinpc
MINWINPC
time="2026-11-08T16:07:08+03:00" level=fatal msg="failed to verify networking settings: the following networking arguments are not supported on Windows: [--hostname]"
minwinpc
foo

Все контейнеры называются minwinpc. Ключ -e меняет только переменную окружения: программы, которые читают %COMPUTERNAME%, увидят foo, а настоящее имя компьютера останется прежним. Его можно задать, только обращаясь к HCS напрямую, — это будет в пятой части.


Общий файл hosts

Файл C:\Windows\System32\drivers\etc\hosts — самый старый способ сопоставить имена адресам: DNS-клиент Windows смотрит в него раньше, чем спрашивает DNS-сервер. --add-host дописал бы строку в такой файл контейнера. Раз флага нет, сделаем то же сами: в первой части мы выяснили, что containerd умеет подключать в контейнер отдельный файл хоста. Заведём один hosts на хосте и подключим его во все контейнеры вместо их собственного.

Начнём заново: удалим оба контейнера, создадим файл с одной строкой и запустим web с подключённым файлом:

nerdctl rm -f web client
New-Item -ItemType Directory C:\lab\dns -Force | Out-Null
'127.0.0.1 localhost' | Set-Content C:\lab\dns\hosts -Encoding ascii
$m = '-v', 'C:\lab\dns\hosts:C:\Windows\System32\drivers\etc\hosts:ro'
nerdctl run -d --name web -p 8080:8080 @m mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025

Адрес web теперь известен — допишем его в файл и запустим client с тем же файлом:

"$(Get-ContainerIp web) web" | Add-Content C:\lab\dns\hosts -Encoding ascii
nerdctl run -d --name client @m mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
nerdctl exec client cmd /c "type C:\Windows\System32\drivers\etc\hosts & ping -n 1 web & curl.exe -sS -o NUL -w %{http_code} http://web:8080/"
127.0.0.1 localhost
172.30.151.129 web

Pinging web [172.30.151.129] with 32 bytes of data:
Reply from 172.30.151.129: bytes=32 time<1ms TTL=128

Ping statistics for 172.30.151.129:
    Packets: Sent = 1, Received = 1, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 0ms, Maximum = 0ms, Average = 0ms
200

Работает: client видит файл с хоста, ping web берёт адрес из него, веб-запрос по имени дошёл.

Другой порядок запуска

Но мы запускали контейнеры в удобном порядке: сначала web, потом строка в файле, потом client. В жизни порядок бывает любым — например, клиент стартует раньше сервиса и сразу пытается к нему подключиться. Повторим в обратном порядке:

nerdctl rm -f web client
'127.0.0.1 localhost' | Set-Content C:\lab\dns\hosts -Encoding ascii
nerdctl run -d --name client @m mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
nerdctl exec client cmd /c "ping -n 1 -w 500 web"
Ping request could not find host web. Please check the name and try again.
time="2026-11-08T11:45:36+03:00" level=fatal msg="exec failed with exit code 1"

Пока web нет, имя не находится — это ожидаемо. Теперь запускаем web и дописываем его адрес:

nerdctl run -d --name web -p 8080:8080 @m mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
"$(Get-ContainerIp web) web" | Add-Content C:\lab\dns\hosts -Encoding ascii
nerdctl exec client cmd /c "type C:\Windows\System32\drivers\etc\hosts & ping -n 1 -w 500 web"
127.0.0.1 localhost
172.30.247.246 web
Ping request could not find host web. Please check the name and try again.
time="2026-11-08T11:45:39+03:00" level=fatal msg="exec failed with exit code 1"

Строка в файле есть — type её показывает, — а имя по-прежнему не находится. Может, нужно подождать? Будем спрашивать раз в несколько секунд:

$t0 = Get-Date
do {
    Start-Sleep 5
    $r = nerdctl exec client cmd /c "ping -n 1 -w 300 web" | Select-String 'Pinging web'
} until ($r -or ((Get-Date) - $t0).TotalSeconds -ge 180)
if ($r) { "resolved after $([int]((Get-Date) - $t0).TotalSeconds) s" } else { "not resolved after $([int]((Get-Date) - $t0).TotalSeconds) s" }
not resolved after 183 s

Три минуты — и ничего. Причина в DNS-клиенте контейнера: он запоминает ответы, в том числе отрицательные, и client помнит, что имени web нет. Сбросить его память можно командой ipconfig /flushdns:

nerdctl exec client cmd /c "ipconfig /flushdns"
nerdctl exec --user ContainerAdministrator client cmd /c "ipconfig /flushdns"
nerdctl exec client cmd /c "ping -n 1 web & curl.exe -sS -o NUL -w %{http_code} http://web:8080/"
The requested operation requires elevation.
time="2026-11-08T11:48:42+03:00" level=fatal msg="exec failed with exit code 1"

Windows IP Configuration

Successfully flushed the DNS Resolver Cache.

Pinging web [172.30.247.246] with 32 bytes of data:
Reply from 172.30.247.246: bytes=32 time<1ms TTL=128

Ping statistics for 172.30.247.246:
    Packets: Sent = 1, Received = 1, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 0ms, Maximum = 0ms, Average = 0ms
200

От ContainerUser, под которым по умолчанию работают процессы Nano Server, сбросить кеш нельзя — нужны права администратора. От ContainerAdministrator можно, и после сброса имя сразу находится. Подведём итог этого способа:

  • адреса известны только после запуска, и вписывать их в файл приходится нам;
  • если контейнер спросил имя раньше, чем оно появилось в файле, он его не увидит, пока кто-то с правами администратора не сбросит ему кеш;
  • имена работают только в контейнерах, в которые файл подключён.

Начнём с первого пункта: пусть адреса раздаёт и записывает в файл сама сеть, в момент создания контейнера.


Как CNI выдаёт адреса

В первой части мы разбирали, что CNI-плагин — программа, которую среда выполнения запускает с командой ADD или DEL. Внутри CNI есть ещё одно разделение: плагин сети (у нас nat) строит сеть и подключает к ней контейнер, а выбор адреса может отдать отдельному плагину IPAM (IP Address Management). Он вызывается тем же способом — с теми же переменными окружения и JSON на стандартном входе — и отвечает JSON с адресом. В Linux так работают host-local, dhcp и static.

Умеет ли так nat от Microsoft? В его исходниках (common/core/network.go) есть ответ: если в секции ipam задан type, плагин вызывает программу с этим именем из каталога CNI-плагинов и берёт адрес у неё. Проверим, что приходит такому плагину, — маленькой программой, которая записывает в журнал своё окружение и вход и возвращает один и тот же адрес. Положим её в C:\Program Files\containerd\cni\bin\ipam-debug.exe и пропишем в .conflist "ipam": {"type": "ipam-debug", ...}:

nerdctl run --rm --name iptest mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c "ipconfig | findstr IPv4"
Get-Content C:\lab\ipam-debug.log
   IPv4 Address. . . . . . . . . . . : 172.30.0.77
=== 2026-11-08T15:38:23+03:00
CNI_COMMAND=ADD
CNI_CONTAINERID=34df1ac874f57194bf5809f1f1b6228a15a46f273a18044086b0f1605f5ccf59
CNI_NETNS=e61a972e-9eee-4414-8ca9-3ac132888004
CNI_IFNAME=eth0
CNI_ARGS=IgnoreUnknown=1
CNI_PATH=C:\Program Files\containerd\cni\bin
stdin: {"cniVersion":"0.3.0","name":"nat","type":"NAT","ipam":{"type":"ipam-debug","subnet":"172.30.0.0/16","routes":[{"dst":"\u003cnil\u003e"}]},"dns":{},"optionalFlags":{"localRoutedPortMapping":false,"allowAclPortMapping":false,"forceBridgeGateway":false,"enableDualStack":false,"loopbackDSR":false,"gatewayFromAdditionalRoutes":false},"runtimeConfig":{"dns":{}},"additionalRoutes":null,"AdditionalArgs":null}
...
=== 2026-11-08T15:38:25+03:00
CNI_NETNS=e61a972e-9eee-4414-8ca9-3ac132888004
CNI_CONTAINERID=34df1ac874f57194bf5809f1f1b6228a15a46f273a18044086b0f1605f5ccf59
CNI_COMMAND=DEL
CNI_IFNAME=eth0
CNI_PATH=C:\Program Files\containerd\cni\bin
CNI_ARGS=IgnoreUnknown=1
...

Три вывода:

  1. Это работает. Контейнер получил 172.30.0.77 — адрес, который вернула наша программа, а при удалении контейнера пришёл DEL, на котором адрес можно освободить.
  2. Имени контейнера в вызове нет. nerdctl передаёт идентификатор (CNI_CONTAINERID), сетевой отсек (CNI_NETNS) и CNI_ARGS=IgnoreUnknown=1 — и всё. Но к моменту ADD контейнер уже записан в containerd, и у него есть метка nerdctl/name с именем. Её можно спросить у containerd по идентификатору: ctr containers info <id>.
  3. nat пересобирает секцию ipam по-своему. До нашей программы доходят только поля, которые знает сам nat (type, subnet, routes и ещё несколько), а всё остальное он отбрасывает. Даже шлюз потерялся: в .conflist он записан как "gateway", а в стандартной структуре маршрута CNI поле называется gw, — отсюда "dst":"<nil>". Поэтому свои настройки IPAM-плагину придётся хранить в отдельном файле.

Свой IPAM: name-ipam

Задача плагина:

  • при ADD узнать у containerd имя контейнера и выдать ему первый свободный адрес из диапазона;
  • запомнить, кому что выдано, и освободить адрес при DEL;
  • вести тот самый файл hosts, который мы подключаем в контейнеры, — теперь строки в нём пишет плагин;
  • выбросить записи контейнеров, которых containerd уже не знает: после перезагрузки хоста DEL для них не придёт.

Напишем его на C# и соберём через Native AOT — компиляцию в обычный исполняемый файл без установленного .NET. Для CNI-плагина это важно: он запускается отдельным процессом на каждый ADD и DEL, и рантайм на сервере ему не нужен. Проект — name-ipam.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <AssemblyName>name-ipam</AssemblyName>
    <PublishAot>true</PublishAot>
    <InvariantGlobalization>true</InvariantGlobalization>
    <JsonSerializerIsReflectionEnabledByDefault>false</JsonSerializerIsReflectionEnabledByDefault>
  </PropertyGroup>
</Project>

PublishAot включает компиляцию в машинный код. При ней System.Text.Json не может разбирать JSON через рефлексию, поэтому типы для JSON описываются генератором исходного кода, а JsonSerializerIsReflectionEnabledByDefault превращает случайное обращение к рефлексии в ошибку сборки, а не в падение плагина в момент запуска контейнера.

Код целиком — в Program.cs, здесь главное. Настройки, аренды и контекст для JSON:

public sealed class IpamConfig
{
    public string Subnet { get; set; } = "";
    public string Gateway { get; set; } = "";
    public string RangeStart { get; set; } = "";
    public string RangeEnd { get; set; } = "";
    public Dictionary<string, string> Addresses { get; set; } = new();
    public string? DnsTask { get; set; }
}

public sealed class Lease
{
    public string Name { get; set; } = "";
    public string Ip { get; set; } = "";
}

[JsonSourceGenerationOptions(PropertyNamingPolicy = JsonKnownNamingPolicy.CamelCase, WriteIndented = true)]
[JsonSerializable(typeof(IpamConfig))]
[JsonSerializable(typeof(NetConfig))]
[JsonSerializable(typeof(Dictionary<string, Lease>))]
internal partial class CamelCaseContext : JsonSerializerContext;

Addresses и DnsTask пока пустые — до них дойдём ниже. Обработка команд. Два экземпляра плагина могут работать одновременно — при запуске нескольких контейнеров сразу, — поэтому файл с арендами читается и пишется под блокировкой:

using var _ = Lock(Path.Combine(dataDir, "lock"));

switch (command)
{
    case "ADD":
        Prune(leases, id);
        if (!leases.TryGetValue(id, out var lease))
        {
            var name = ContainerName(id);
            lease = new Lease { Name = name, Ip = Pick(config, name, leases) };
            leases[id] = lease;
        }
        Save(statePath, hostsPath, leases, config);
        EnsureTask(config.DnsTask);
        PrintResult(net.CniVersion ?? "0.3.0", config, lease.Ip);
        return 0;
    case "DEL":
        leases.Remove(id);
        Save(statePath, hostsPath, leases, config);
        return 0;
    // ...
}

Блокировка — файл, открытый монопольно: второй экземпляр ждёт, пока первый его закроет, а если первый упадёт, Windows закроет файл сама, и блокировка не повиснет:

static FileStream Lock(string path)
{
    for (var i = 0; ; i++)
    {
        try
        {
            return new FileStream(path, FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None);
        }
        catch (IOException) when (i < 100)
        {
            Thread.Sleep(100);
        }
    }
}

Имя контейнера — из метки nerdctl/name; у контейнеров, запущенных через ctr, такой метки нет, и они получают имя из первых 12 знаков идентификатора:

static string ContainerName(string id)
{
    var output = Exec("ctr", "-n", "default", "containers", "info", id);
    if (output != null)
    {
        var info = JsonSerializer.Deserialize(output, PascalCaseContext.Default.ContainerInfo);
        if (info?.Labels?.TryGetValue("nerdctl/name", out var name) == true && name != "") return name;
    }
    return id.Length > 12 ? id[..12] : id;
}

Адрес Pick выбирает первый свободный из диапазона rangeStart–rangeEnd; целиком посмотрим на него ниже, когда он понадобится. Save записывает аренды в nat.json и заново собирает hosts из них. Файл перезаписывается на месте, а не заменяется новым: так его видят контейнеры, в которые он подключён. Ответ в формате CNI — адрес с длиной префикса, шлюз и маршрут по умолчанию. Ошибку плагин тоже возвращает в формате CNI — JSON с полями code и msg, — и nerdctl показывает msg пользователю.

Сборка и установка

Собирать удобнее на рабочей машине: кроме .NET SDK 10 Native AOT нужен компоновщик из Visual Studio или Build Tools с компонентом C++. Сборщик ищет его утилитой vswhere.exe, которой может не оказаться в PATH:

$env:Path += ";${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer"
dotnet publish -c Release -o out
Get-ChildItem out | Format-Table Name, Length
Name            Length
----            ------
name-ipam.exe  2715648
name-ipam.pdb 13479936

2,7 МБ, никаких зависимостей. На сервер нужен только name-ipam.exe — он ложится к остальным CNI-плагинам. В .conflist вместо адресов остаются тип плагина, подсеть и маршрут, по которым nat при необходимости создаст сеть:

"ipam": {
    "type": "name-ipam",
    "subnet": "172.30.0.0/16",
    "routes": [
        { "gateway": "172.30.0.1" }
    ]
}

Настройки плагина — в C:\ProgramData\name-ipam\config.json. Пока в них только подсеть, шлюз и диапазон адресов:

Copy-Item .\name-ipam.exe "$env:ProgramFiles\containerd\cni\bin\"
New-Item -ItemType Directory C:\ProgramData\name-ipam -Force | Out-Null
@'
{
    "subnet": "172.30.0.0/16",
    "gateway": "172.30.0.1",
    "rangeStart": "172.30.1.1",
    "rangeEnd": "172.30.1.254"
}
'@ | Set-Content C:\ProgramData\name-ipam\config.json -Encoding ascii
Copy-Item .\0-containerd-nat.conflist "$env:ProgramFiles\containerd\cni\conf\" -Force
'127.0.0.1       localhost' | Set-Content C:\ProgramData\name-ipam\hosts -Encoding ascii

Последняя строка важна. Файл hosts плагин создаёт при первом ADD, а подключать его в контейнер nerdctl будет раньше. Если файла ещё нет, nerdctl создаёт на его месте пустую папку, и плагин падает с отказом в доступе:

time="2026-11-08T11:48:58+03:00" level=fatal msg="plugin type=\"nat\" failed (add): UnauthorizedAccess_IODenied_Path, C:\\ProgramData\\name-ipam\\hosts"

Поэтому файл создаём заранее.

Проверка

Подключаем во все контейнеры теперь файл плагина:

$m = '-v', 'C:\ProgramData\name-ipam\hosts:C:\Windows\System32\drivers\etc\hosts:ro'
nerdctl run -d --name web -p 8080:8080 @m mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
nerdctl run -d --name client @m mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
Get-Content C:\ProgramData\name-ipam\nat.json
Get-Content C:\ProgramData\name-ipam\hosts
nerdctl exec client cmd /c "ping -n 1 web & curl.exe -sS -o NUL -w %{http_code} http://web:8080/"
{
  "90689bb7d9aa6f71b36e5c044923f72c4f3959fa73540749ca28391524446df3": {
    "name": "web",
    "ip": "172.30.1.1"
  },
  "6f176a736843e52d0da64c1b64408930cd0fa7ac88a361862b7264ca74e53235": {
    "name": "client",
    "ip": "172.30.1.2"
  }
}
# generated by name-ipam, do not edit
127.0.0.1       localhost
172.30.1.1      web
172.30.1.2      client

Pinging web [172.30.1.1] with 32 bytes of data:
Reply from 172.30.1.1: bytes=32 time<1ms TTL=128

Ping statistics for 172.30.1.1:
    Packets: Sent = 1, Received = 1, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 0ms, Maximum = 0ms, Average = 0ms
200

Руками мы больше ничего не вписываем: адреса раздал плагин, он же записал их в hosts. Теперь обратный порядок — на нём сломался общий файл:

nerdctl rm -f web client
nerdctl run -d --name client @m mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
nerdctl exec client cmd /c "ping -n 1 -w 500 web"
nerdctl run -d --name web -p 8080:8080 @m mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
nerdctl exec client cmd /c "type C:\Windows\System32\drivers\etc\hosts & ping -n 1 -w 500 web"
Ping request could not find host web. Please check the name and try again.
time="2026-11-08T11:51:45+03:00" level=fatal msg="exec failed with exit code 1"
# generated by name-ipam, do not edit
127.0.0.1       localhost
172.30.1.1      client
172.30.1.2      web
Ping request could not find host web. Please check the name and try again.
time="2026-11-08T11:51:47+03:00" level=fatal msg="exec failed with exit code 1"

Тот же цикл ожидания, что и выше, сдаётся через три минуты: not resolved after 183 s. Строка с web появилась в файле сразу, как только он запустился, но client уже спросил это имя раньше, и его DNS-клиент помнит отказ. Плагин избавил нас от ручной работы, но кеш никуда не делся. Заметно и другое: адреса раздаются по порядку запуска, и web в этот раз получил 172.30.1.2 вместо 172.30.1.1. Адрес контейнера меняется при каждом пересоздании.


Резервация адресов

Оба недостатка снимаются, если адрес сервиса известен заранее, ещё до запуска его контейнера. Так работает резервация в DHCP: администратор закрепляет адрес за MAC-адресом машины, и машина получает его при каждом подключении. У нас вместо MAC-адреса будет имя контейнера. Если web всегда получает 172.30.0.10, строку 172.30.0.10 web можно держать в hosts постоянно — и тогда client, спросив имя до запуска web, получит не отказ, а адрес.

Резервации задаются в настройках плагина полем addresses — config.json:

{
    "subnet": "172.30.0.0/16",
    "gateway": "172.30.0.1",
    "rangeStart": "172.30.1.1",
    "rangeEnd": "172.30.1.254",
    "addresses": {
        "web": "172.30.0.10",
        "db": "172.30.0.11"
    }
}

Зарезервированные адреса лежат ниже диапазона, чтобы не пересекаться с ним. Pick теперь сначала смотрит в резервации, а из диапазона выдаёт адреса, пропуская зарезервированные:

static string Pick(IpamConfig config, string name, Dictionary<string, Lease> leases)
{
    var used = leases.Values.ToDictionary(l => l.Ip, l => l.Name);
    if (config.Addresses.TryGetValue(name, out var fixedIp))
    {
        if (used.TryGetValue(fixedIp, out var other))
            throw new InvalidOperationException($"address {fixedIp} of {name} is used by {other}");
        return fixedIp;
    }
    var reserved = config.Addresses.Values.ToHashSet();
    uint start = ToUInt(config.RangeStart), end = ToUInt(config.RangeEnd);
    for (var n = start; n <= end; n++)
    {
        var ip = ToIp(n);
        if (!used.ContainsKey(ip) && !reserved.Contains(ip)) return ip;
    }
    throw new InvalidOperationException($"no free address in {config.RangeStart}-{config.RangeEnd}");
}

А Save пишет в hosts все зарезервированные имена, запущены их контейнеры или нет, и к ним — работающие контейнеры без резервации:

var names = new Dictionary<string, string>(config.Addresses);
foreach (var l in leases.Values) names.TryAdd(l.Name, l.Ip);
var hosts = new StringBuilder("# generated by name-ipam, do not edit\r\n127.0.0.1       localhost\r\n");
foreach (var line in names.Select(n => $"{n.Value,-15} {n.Key}").Order(StringComparer.Ordinal))
    hosts.Append(line).Append("\r\n");
WriteFile(hostsPath, hosts.ToString());

Кладём новые настройки и сразу проверяем трудный порядок — client первым:

nerdctl rm -f web client
Copy-Item .\config.json C:\ProgramData\name-ipam\ -Force
nerdctl run -d --name client @m mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
Get-Content C:\ProgramData\name-ipam\hosts
nerdctl exec client cmd /c "ping -n 1 -w 500 web"
# generated by name-ipam, do not edit
127.0.0.1       localhost
172.30.0.10     web
172.30.0.11     db
172.30.1.1      client

Pinging web [172.30.0.10] with 32 bytes of data:
Request timed out.

Ping statistics for 172.30.0.10:
    Packets: Sent = 1, Received = 0, Lost = 1 (100% loss),
time="2026-11-08T11:54:07+03:00" level=fatal msg="exec failed with exit code 1"

web ещё не запущен, но client уже знает его адрес: ping ушёл на 172.30.0.10 и не получил ответа — отвечать пока некому. Запускаем web:

nerdctl run -d --name web -p 8080:8080 @m mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
nerdctl exec client cmd /c "ping -n 1 web & curl.exe -sS -o NUL -w %{http_code} http://web:8080/"
Pinging web [172.30.0.10] with 32 bytes of data:
Reply from 172.30.0.10: bytes=32 time=324ms TTL=128

Ping statistics for 172.30.0.10:
    Packets: Sent = 1, Received = 1, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 324ms, Maximum = 324ms, Average = 324ms
200

Сразу, без ожидания и без сброса кеша. Отказа в кеше нет, а адрес, который client запомнил, верен. Он останется верным и после пересоздания web:

nerdctl rm -f web
nerdctl run -d --name web -p 8080:8080 @m mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
nerdctl exec web cmd /c "ipconfig | findstr IPv4"
nerdctl exec client curl.exe -sS -o NUL -w "%{http_code}`n" http://web:8080/
   IPv4 Address. . . . . . . . . . . : 172.30.0.10
200

Это та же идея, что у Service в Kubernetes: у сервиса есть постоянное имя и постоянный адрес, которые существуют независимо от того, запущены ли сейчас его поды и сколько раз их пересоздавали. Клиенту не важно, какой именно экземпляр ему ответит, — он всегда идёт по одному адресу. Но у Service за этим адресом может стоять несколько подов, и Kubernetes распределяет между ними соединения. Наша резервация так не умеет: адрес закреплён за одним контейнером с этим именем. Второй контейнер с именем web nerdctl не создаст, а под другим именем, например web-2, он получит обычный адрес из диапазона, и имя web на него не укажет. Один сервис — один контейнер.

Что ещё мешает

Для сервисов, адреса которых мы зарезервировали, задача решена. Но не все контейнеры — сервисы. Запустим worker без резервации, спросив о нём заранее:

nerdctl exec client cmd /c "ping -n 1 -w 300 worker"
nerdctl run -d --name worker @m mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
Get-Content C:\ProgramData\name-ipam\hosts
Ping request could not find host worker. Please check the name and try again.
time="2026-11-08T11:54:14+03:00" level=fatal msg="exec failed with exit code 1"
# generated by name-ipam, do not edit
127.0.0.1       localhost
172.30.0.10     web
172.30.0.11     db
172.30.1.1      client
172.30.1.2      worker

Строка появилась, а цикл ожидания снова сдаётся через три минуты: not resolved after 183 s. Для контейнеров без резервации кеш по-прежнему мешает. И второе: всё это работает только в контейнерах, в которые подключён наш hosts. Контейнер, запущенный без -v, не знает ни одного имени:

nerdctl run --rm mcr.microsoft.com/windows/nanoserver:ltsc2025 cmd /c "ping -n 1 -w 300 web"
Ping request could not find host web. Please check the name and try again.

Оба недостатка — следствие того, что каждый контейнер сам читает файл и сам решает, сколько помнить ответ. Нужен посредник, который отвечает на имена по запросу и сам задаёт, сколько ответ живёт в кеше, — DNS-сервер.


CoreDNS

DNS-сервер — служба, которая отвечает на запросы «какой адрес у этого имени». Если контейнеры будут спрашивать наш сервер, а не читать файл сами, отпадут оба недостатка: файл подключать не нужно, а ответ живёт в кеше контейнера столько, сколько скажет сервер. CoreDNS — DNS-сервер, который собирается из плагинов (тот самый, что разрешает имена сервисов в Kubernetes). У него есть сборка для Windows и плагин hosts, который отвечает именами из файла в формате hosts и сам замечает его изменения. Файл у нас уже есть — его ведёт name-ipam.

Где его слушать

Контейнерам нужен адрес, до которого они точно достают, — шлюз сети nat, 172.30.0.1. Слушать на всех адресах хоста незачем: DNS-сервер для контейнеров не должен отвечать в сети хоста. Но у адреса шлюза есть особенность — он появляется только вместе с сетью nat, а сеть HNS, которую создаёт плагин nat, не переживает перезагрузку хоста. После загрузки её нет, пока не запустится первый контейнер, — это мы увидим ниже, при проверке. Пока адреса нет, CoreDNS с директивой bind 172.30.0.1 не запускается:

& C:\coredns\coredns.exe -conf C:\coredns\Corefile
maxprocs: Leaving GOMAXPROCS=4: CPU quota undefined
Listen: listen tcp 172.30.0.1:53: bind: The requested address is not valid in its context.

Запуск задачей при старте Windows результата не гарантирует. В трёх опытах CoreDNS один раз завершился с кодом 1, а дважды успел занять порт на 172.30.0.1, хотя через полторы минуты после загрузки ни сети nat, ни этого адреса на хосте уже не было. В проверенном случае такой CoreDNS заработал, когда первый контейнер создал сеть заново, но почему исход бывает разным, я не выяснял, и полагаться на это нельзя. Надёжный момент для запуска — когда сеть уже создана, а это момент ADD у нашего плагина: nat создаёт сеть до того, как спрашивает адрес. Поэтому name-ipam умеет запускать задачу планировщика, если она ещё не работает, — для этого в его настройках поле dnsTask:

static void EnsureTask(string? task)
{
    if (string.IsNullOrEmpty(task)) return;
    var state = Exec("schtasks", "/Query", "/TN", task, "/FO", "CSV", "/NH");
    if (state != null && state.Contains("\"Running\"")) return;
    Exec("schtasks", "/Run", "/TN", task);
}

Ошибки здесь сознательно не прерывают ADD: контейнер без DNS лучше, чем незапущенный контейнер.

Установка

Всё собрано в install-coredns.ps1:

.\install-coredns.ps1
CoreDNS
  coredns_1.15.0_windows_amd64.zip  sha256 ok
Corefile
Firewall
Scheduled task
name-ipam config
nat network config

По шагам:

  1. CoreDNS — архив с GitHub в C:\coredns, с проверкой контрольной суммы.

  2. Corefile — конфигурация CoreDNS:

    . {
        bind 172.30.0.1
        hosts C:\ProgramData\name-ipam\hosts {
            ttl 5
            reload 1s
            fallthrough
        }
        forward . 192.168.10.1
        errors
    }
    

    bind — слушать только адрес шлюза. hosts — отвечать именами из файла, который ведёт name-ipam, перечитывать его раз в секунду (reload) и отдавать ответы со временем жизни 5 секунд (ttl): столько DNS-клиент контейнера будет их помнить. fallthrough передаёт имена, которых нет в файле, следующему плагину — forward, а тот пересылает их DNS-серверу хоста: так контейнеры по-прежнему разрешают mcr.microsoft.com. errors пишет ошибки в журнал.

  3. Брандмауэр — два правила, UDP и TCP на порт 53 (DNS работает по обоим), только к адресу 172.30.0.1 и только из подсети контейнеров.

  4. Задача планировщика CoreDNS — запускает coredns.exe -conf C:\coredns\Corefile от имени SYSTEM. Триггера у неё нет: её запускает name-ipam. CoreDNS не умеет сам работать службой Windows, поэтому задача, а не служба.

  5. dnsTask в настройках name-ipam — имя этой задачи.

  6. DNS-сервер в .conflist — плагину nat добавляется "dns": {"nameservers": ["172.30.0.1"]}, и новые контейнеры получают этот сервер вместо DNS-сервера хоста.

Подключать hosts в контейнеры больше не нужно: дальше все контейнеры запускаются без -v.

Проверка

Контейнеры client и worker больше не нужны. Удалим их и перезагрузим хост, оставив контейнер web созданным, чтобы посмотреть на всю цепочку с нуля:

nerdctl rm -f client worker
Restart-Computer
# после перезагрузки
Get-HnsNetwork
[bool](Get-Process coredns -ErrorAction SilentlyContinue)
nerdctl start web
False
time="2026-11-08T14:56:55+03:00" level=fatal msg="1 errors:\nfailed to create shim task: hcs::CreateComputeSystem 61ef4b0b5f255ce273d2ce1b02c39068495bd65cd40b9bb8d7df0e9bd310eb7b: Element not found."

Get-HnsNetwork ничего не вывел: сети nat после перезагрузки нет, а вместе с ней нет адреса шлюза и конечной точки старого контейнера, поэтому web не стартует. CoreDNS не запущен. Удалим контейнер и создадим заново, а сеть nat плагин создаст сам:

nerdctl rm -f web
nerdctl run -d --name web -p 8080:8080 mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025
nerdctl run -d --name client mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
Get-NetUDPEndpoint -LocalPort 53 | Format-Table LocalAddress, OwningProcess
Get-NetTCPConnection -LocalPort 53 -State Listen | Format-Table LocalAddress, OwningProcess
LocalAddress OwningProcess
------------ -------------
172.30.0.1            5768

LocalAddress OwningProcess
------------ -------------
172.30.0.1            5768

CoreDNS запустился вместе с первым контейнером и слушает порт 53 только на адресе шлюза. Изнутри client:

nerdctl exec client cmd /c "ipconfig | findstr IPv4 & ipconfig /all | findstr Servers"
nerdctl exec client cmd /c "ping -n 1 web" | Select-String 'Pinging|Reply'
nerdctl exec client curl.exe -sS -o NUL -w "%{http_code}`n" http://web:8080/
nerdctl exec client curl.exe -sS -o NUL -w "%{http_code}`n" https://mcr.microsoft.com/v2/
   IPv4 Address. . . . . . . . . . . : 172.30.1.1
   DNS Servers . . . . . . . . . . . : 172.30.0.1
Pinging web [172.30.0.10] with 32 bytes of data:
Reply from 172.30.0.10: bytes=32 time<1ms TTL=128
200
200

DNS-сервер контейнера — CoreDNS, имя web разрешается в зарезервированный адрес, внешние имена тоже работают, и всё это без подключённого hosts. Теперь то, что не давалось ни общему файлу, ни резервациям: контейнер без резервации, о котором client спросил заранее:

nerdctl exec client cmd /c "ping -n 1 -w 300 worker" | Select-String 'Pinging|could not find'
nerdctl run -d --name worker mcr.microsoft.com/windows/nanoserver:ltsc2025 ping -t localhost
Get-Content C:\ProgramData\name-ipam\hosts
nerdctl exec client cmd /c "ping -n 1 -w 300 worker" | Select-String 'Pinging|could not find'
Resolve-DnsName worker -Server 172.30.0.1 -DnsOnly | Format-Table Name, Type, TTL, IPAddress
nerdctl rm -f worker
$t0 = Get-Date
do { Start-Sleep 1; $r = nerdctl exec client cmd /c "ping -n 1 -w 300 worker" | Select-String 'could not find' } until ($r)
"gone after $([int]((Get-Date) - $t0).TotalSeconds) s"
Ping request could not find host worker. Please check the name and try again.
time="2026-11-08T14:57:02+03:00" level=fatal msg="exec failed with exit code 1"
71c9ac8141416722cda2ccf135d9746397763e29e2b0194519dfa4177bb0ab95
# generated by name-ipam, do not edit
127.0.0.1       localhost
172.30.0.10     web
172.30.0.11     db
172.30.1.1      client
172.30.1.2      worker
Pinging worker [172.30.1.2] with 32 bytes of data:

Name   Type TTL IPAddress
----   ---- --- ---------
worker    A   5 172.30.1.2

worker
time="2026-11-08T14:57:05+03:00" level=fatal msg="exec failed with exit code 1"
time="2026-11-08T14:57:07+03:00" level=fatal msg="exec failed with exit code 1"
time="2026-11-08T14:57:09+03:00" level=fatal msg="exec failed with exit code 1"
gone after 5 s

worker получил следующий адрес диапазона, и client, который только что не нашёл это имя, нашёл его сразу после запуска контейнера — без сброса кешей и без подключённых файлов. CoreDNS отдаёт ответ со временем жизни 5 секунд, и отказ тоже живёт недолго. После удаления контейнера имя пропало через 5 секунд — время жизни ответа из Corefile.


Убираем за собой

Контейнеры, образы и рабочая папка этой части больше не понадобятся:

nerdctl rm -f web client
nerdctl rmi mcr.microsoft.com/dotnet/samples:aspnetapp-nanoserver-ltsc2025 mcr.microsoft.com/windows/nanoserver:ltsc2025
Remove-Item C:\lab -Recurse -Force

Плагин name-ipam и задача CoreDNS остаются на сервере: в следующих частях контейнеры получают адреса и имена через них.


Что получилось

   nerdctl run --name web
          │
          ▼
   nerdctl    → CNI nat ── создаёт сеть nat, шлюз 172.30.0.1
                   │
                   ▼ ADD
              name-ipam ── имя web из containerd
                   │       адрес 172.30.0.10 из резервации
                   │       hosts, nat.json
                   │       schtasks /Run CoreDNS, если не запущен
                   ▼
   контейнер: адрес 172.30.0.10, DNS 172.30.0.1
                   │
                   ▼ запрос имени
   CoreDNS 172.30.0.1:53 ── hosts → имена контейнеров
                            forward → DNS-сервер хоста

Мы прошли путь из четырёх шагов, и каждый снимал одну проблему предыдущего:

  • Общий hosts, подключённый в контейнеры. Работает, если контейнеры запускаются в удобном порядке. Адреса приходится вписывать руками, а контейнер, спросивший имя раньше времени, не увидит его, пока ему не сбросят кеш.
  • Свой IPAM-плагин name-ipam. Плагин nat отдаёт выбор адреса внешней программе, и наша программа сама раздаёт адреса и ведёт hosts. Ручная работа ушла, кеш остался.
  • Резервации. Адрес сервиса известен заранее, строка с ним лежит в hosts до запуска контейнера, и кешу нечего испортить. Как Service в Kubernetes, но с одним контейнером на имя.
  • CoreDNS на адресе шлюза. Отвечает на имена по запросу с коротким временем жизни ответа, поэтому работает и для контейнеров без резервации, и без подключённых файлов. Запускает его тот же name-ipam, потому что адрес шлюза появляется только вместе с сетью.

В Kubernetes это делают CoreDNS и IPAM-плагин сетевого решения — у Calico из части 37 серии о Kubernetes свой IPAM с блоками адресов на узел, а CoreDNS отвечает на имена сервисов. Здесь мы собрали то же самое для одной машины из двух небольших программ.


Источники


Дальше — заглянем внутрь работающего контейнера: где containerd хранит слои образа, как из них собирается диск контейнера, что такое sandbox.vhdx, как фильтры wcifs и bindflt склеивают слои и подключают папки хоста, и как выглядит server silo в пространстве объектов ядра.

Оставить комментарий могут только зарегистрированные пользователи.

Войдите на сайт или зарегистрируйтесь, чтобы оставить комментарий.