Ошибки и коды · Инструкция
WSL Read-only file system: как восстановить запись в ext4.vhdx
WSL Read-only file system: как восстановить запись в ext4.vhdx. Microsoft описывает такой режим как защитную реакцию после ошибки монтирования VHD, например при внезапном отключении.
Короткий ответ
Если WSL смонтировал диск дистрибутива read-only после ошибки VHD, Microsoft рекомендует остановить WSL, подключить ext4.vhdx как bare VHD, определить block device и выполнить e2fsck. Простое remount,rw дает лишь временное состояние и не заменяет ремонт.
Почему WSL переводит VHD в read-only
Microsoft описывает сценарий, когда после внезапного отключения или ошибки монтирования VHD дистрибутив запускается только для чтения. Официальная процедура использует wsl --shutdown, wsl --mount <path> --vhd --bare, определение устройства через wsl.exe lsblk и e2fsck -f. Microsoft предупреждает, что remount,rw может сделать файловую систему записываемой только временно; изменения могут потеряться после перезапуска. В случае «WSL Read-only file system: как восстановить запись в ext4.vhdx» сначала зафиксируйте текущую версию WSL и рабочую конфигурацию, затем применяйте документированный шаг и проверяйте его эффект.
Совет: Перед `e2fsck` перепроверьте путь VHDX и имя block device: ошибка выбора диска может повредить не тот файловый раздел.
Пошаговое решение
- Сделайте резервную копию доступных важных данных, если дистрибутив еще читается, и закройте Docker Desktop и другие программы, использующие WSL-диски.
- В PowerShell от администратора выполните wsl.exe --shutdown и найдите точный путь ext4.vhdx нужного дистрибутива.
- Подключите диск командой wsl.exe --mount <path-to-ext4.vhdx> --vhd --bare.
- Через wsl.exe lsblk определите именно устройство поврежденного VHD и только затем выполните sudo e2fsck -f /dev/<device> по инструкции Microsoft.
- После успешной проверки выполните wsl.exe --unmount, запустите дистрибутив и проверьте запись созданием обычного тестового файла.
Предупреждение: Если данные читаются, сначала сохраните самое важное или сделайте копию/экспорт, насколько это возможно.
Проверка на одном изменении
Контроль для «WSL Read-only file system: как восстановить запись в ext4.vhdx»: подтвердите «важные данные сохранены при возможности», затем выполните первый шаг — сделайте резервную копию доступных важных данных, если дистрибутив еще читается, и закройте Docker Desktop и другие программы, использующие WSL-диски.
Чек-лист перед выводом
- Важные данные сохранены при возможности
- Точно определен путь нужного VHDX
- Точно определено block device
- E2fsck запущен не на случайном диске
Когда нужен следующий шаг
Ошибка в выборе block device при файловой проверке может повредить данные, поэтому этот шаг нельзя выполнять наугад. Если VHD занят, Microsoft отмечает возможный конфликт с Docker Desktop; при сложной ошибке сначала сохраните копию VHDX и работайте осторожно.
Важно: Microsoft предупреждает, что `mount -o remount,rw /` дает временную запись в памяти и изменения могут исчезнуть после перезапуска.
Где искать ограничение
- важные данные сохранены при возможности. Проверка «важные данные сохранены при возможности» подтверждает исходное состояние перед изменением WSL.
- точно определен путь нужного VHDX. Пункт «точно определен путь нужного vhdx» локализует проблему и не дает менять несколько причин одновременно.
- точно определено block device. Условие «точно определено block device» позволяет проверить команду или настройку на конкретном уровне.
- e2fsck запущен не на случайном диске. Если выполнено «e2fsck запущен не на случайном диске», следующий шаг можно оценивать без догадок о предыдущем.
Что учитывать
Microsoft описывает сценарий, когда после внезапного отключения или ошибки монтирования VHD дистрибутив запускается только для чтения. Официальная процедура использует wsl --shutdown, wsl --mount <path> --vhd --bare, определение устройства через wsl.exe lsblk и e2fsck -f. Microsoft предупреждает, что remount,rw может сделать файловую систему записываемой только временно; изменения могут потеряться после перезапуска. В случае «WSL Read-only file system: как восстановить запись в ext4.vhdx»…
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. How to manage WSL disk space). Пример и формулировки — редакция N1RO на 2026-09-22.