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
...
Три вывода:
- Это работает. Контейнер получил 172.30.0.77 — адрес, который вернула наша программа, а при удалении контейнера пришёл
DEL, на котором адрес можно освободить. - Имени контейнера в вызове нет. nerdctl передаёт идентификатор (
CNI_CONTAINERID), сетевой отсек (CNI_NETNS) иCNI_ARGS=IgnoreUnknown=1— и всё. Но к моментуADDконтейнер уже записан в containerd, и у него есть меткаnerdctl/nameс именем. Её можно спросить у containerd по идентификатору:ctr containers info <id>. 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
По шагам:
CoreDNS — архив с GitHub в
C:\coredns, с проверкой контрольной суммы.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пишет ошибки в журнал.Брандмауэр — два правила, UDP и TCP на порт 53 (DNS работает по обоим), только к адресу 172.30.0.1 и только из подсети контейнеров.
Задача планировщика
CoreDNS— запускаетcoredns.exe -conf C:\coredns\Corefileот имени SYSTEM. Триггера у неё нет: её запускаетname-ipam. CoreDNS не умеет сам работать службой Windows, поэтому задача, а не служба.dnsTaskв настройкахname-ipam— имя этой задачи.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 отвечает на имена сервисов. Здесь мы собрали то же самое для одной машины из двух небольших программ.
Источники
- CNI specification — спецификация CNI: плагины, делегирование IPAM, формат ответа и ошибок.
- microsoft/windows-container-networking — исходники плагина
nat, в том числе вызов внешнего IPAM. - Native AOT deployment — Microsoft Learn: Native AOT и его требования.
- How to use source generation in System.Text.Json — Microsoft Learn: генерация кода для JSON.
- CoreDNS — документация CoreDNS, плагины hosts, bind и forward.
- Service — документация Kubernetes: постоянное имя и адрес для группы подов.
Дальше — заглянем внутрь работающего контейнера: где containerd хранит слои образа, как из них собирается диск контейнера, что такое sandbox.vhdx, как фильтры wcifs и bindflt склеивают слои и подключают папки хоста, и как выглядит server silo в пространстве объектов ядра.
Оставить комментарий могут только зарегистрированные пользователи.
Войдите на сайт или зарегистрируйтесь, чтобы оставить комментарий.