Files
local_machine/docs/security/KODACHI_UTM_INSTALLATION.md
2026-03-14 20:03:57 +03:00

14 KiB
Raw Blame History

Установка Kodachi Linux в UTM на macOS

Подробное руководство по установке Kodachi в существующую виртуальную машину UTM.


Предварительные требования

  • macOS (Intel или Apple Silicon)
  • UTM установлен и запущен
  • Минимум 4 ГБ свободной оперативной памяти
  • 30+ ГБ свободного места на диске
  • ISO-образ Kodachi Linux

Шаг 1: Загрузка ISO-образа Kodachi

⚠️ ВАЖНО: Выбор версии Kodachi

Текущая ситуация с версиями (ноябрь 2025):

  1. Kodachi 9.0.1 (октябрь 2025) - СЕРВЕРНАЯ версия БЕЗ GUI

    • Актуальная версия
    • Только командная строка (CLI)
    • Нет графического интерфейса
    • Подходит для серверных задач
  2. Kodachi 8.27 (февраль 2023) - ДЕСКТОПНАЯ версия С GUI

    • Полноценный графический интерфейс XFCE
    • Все инструменты для приватности и анонимности
    • ⚠️ Устаревшая база (Ubuntu 18.04.6 LTS)
    • ⚠️ Нет обновлений безопасности с февраля 2023
    • ⚠️ Потенциальные уязвимости
  3. Kodachi 9 Desktop - В РАЗРАБОТКЕ

    • Графическая версия Kodachi 9 еще не выпущена
    • Дата выхода неизвестна

Рекомендации по выбору версии:

Для работы с GUI (графическим интерфейсом):

  • Используйте Kodachi 8.27 (если GUI критичен)
  • ⚠️ Понимайте риски использования устаревшей версии
  • Рассмотрите альтернативы: Tails, Qubes OS, Whonix

Для серверных задач:

  • Используйте Kodachi 9.0.1 (актуальная, но только CLI)

Для максимальной приватности и стабильности:

  • Дождитесь выхода Kodachi 9 Desktop
  • Или используйте альтернативные системы с актуальными обновлениями

Загрузка ISO-образа:

  1. Перейдите на официальный сайт Kodachi: https://www.digi77.com/linux-kodachi/
  2. Выберите нужную версию:
    • Для GUI: Kodachi 8.27 Desktop ISO
    • Для сервера: Kodachi 9.0.1 Server ISO
  3. Скачайте ISO-образ
  4. Сохраните файл в удобном месте (например, ~/Downloads/kodachi-*.iso)

Важно:

  • Проверьте целостность образа, если доступны checksums (SHA256)
  • Убедитесь, что скачиваете версию с GUI, если нужен графический интерфейс

Шаг 2: Создание новой виртуальной машины в UTM

2.1. Запуск мастера создания VM

  1. Откройте UTM
  2. Нажмите кнопку "+" или "Create a New Virtual Machine"
  3. Выберите "Virtualize" (не Emulate)

2.2. Выбор операционной системы

  1. В разделе "Operating System" выберите "Linux"
  2. UTM автоматически определит тип системы

2.3. Настройка образа диска

  1. В разделе "Linux" выберите "Use an existing disk image"
  2. Нажмите "Browse" и выберите скачанный ISO-образ Kodachi
  3. Убедитесь, что образ отображается в списке

2.4. Настройка ресурсов

Память (RAM):

  • Минимум: 2 ГБ
  • Рекомендуется: 4 ГБ
  • Для комфортной работы: 6-8 ГБ

Процессор:

  • Ядра: 2-4 ядра (в зависимости от вашего Mac)
  • Архитектура:
    • Intel Mac: x86_64
    • Apple Silicon (M1/M2/M3): ARM64 (если доступно) или x86_64 (через эмуляцию)

Диск:

  • Размер: Минимум 30 ГБ, рекомендуется 40-50 ГБ
  • Тип: QCOW2 (рекомендуется) или RAW

2.5. Дополнительные настройки

Сеть (Network):

  • Режим: Shared Network (NAT) - для базовой работы
  • Для VPN/Tor: Может потребоваться Bridged режим (требует дополнительных прав)

Другие настройки:

  • Enable Clipboard Sharing - для копирования текста
  • Enable Directory Sharing (опционально) - для обмена файлами
  • ⚠️ Enable SPICE Agent - для улучшенной интеграции

Шаг 3: Запуск и установка Kodachi

3.1. Первый запуск

  1. Нажмите кнопку "Play" (▶️) для запуска виртуальной машины
  2. Дождитесь загрузки Kodachi в Live режиме
  3. Выберите язык и раскладку клавиатуры

3.2. Установка на диск (рекомендуется)

Важно:

  • Kodachi можно использовать в Live режиме, но для сохранения данных и настроек рекомендуется установка на виртуальный диск
  • ⚠️ Если вы используете Kodachi 9.0.1 (серверную версию), графического установщика нет - используйте командную строку для установки

Для Kodachi 8.27 (с GUI):

  1. На рабочем столе найдите иконку "Install Kodachi"

  2. Запустите установщик

  3. Следуйте инструкциям:

    Шаги установки:

    • Выберите язык
    • Выберите раскладку клавиатуры
    • Выберите часовой пояс
    • Разметка диска:
      • Выберите виртуальный диск UTM
      • Рекомендуется: "Erase disk and install Kodachi" (для виртуальной машины это безопасно)
      • Или выберите "Something else" для ручной разметки
    • Создайте пользователя и пароль
    • Дождитесь завершения установки
  4. После установки перезагрузите виртуальную машину

  5. Извлеките ISO-образ из настроек VM (чтобы загружаться с диска, а не с образа)


Шаг 4: Настройка сетевых функций (VPN/Tor)

4.1. Проверка сетевого подключения

  1. Убедитесь, что виртуальная машина имеет доступ к интернету
  2. Проверьте статус VPN и Tor в панели мониторинга Kodachi

4.2. Настройка VPN (если требуется)

  1. Откройте настройки VPN в Kodachi
  2. Добавьте конфигурацию VPN (если не предустановлена)
  3. Убедитесь, что VPN активирован

4.3. Настройка Tor

  1. Tor должен быть предустановлен и настроен
  2. Проверьте статус в индикаторах Kodachi
  3. Весь трафик должен автоматически проходить через Tor

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


Шаг 5: Оптимизация производительности

5.1. Настройки UTM для лучшей производительности

  1. В настройках VM включите:
    • Hardware Acceleration (если доступно)
    • Enable Hypervisor Framework (для Apple Silicon)
    • Enable JIT (для Apple Silicon)

5.2. Настройки Kodachi

  1. Закройте ненужные приложения
  2. Используйте легковесные альтернативы приложений
  3. Настройте автозагрузку программ

Шаг 6: Создание снимков (Snapshots)

Рекомендуется: Создайте снимок виртуальной машины после успешной установки.

  1. В UTM остановите виртуальную машину
  2. Выберите VM в списке
  3. Нажмите "Take Snapshot" или используйте меню
  4. Дайте снимку понятное имя (например, "Fresh Install")

Это позволит быстро вернуться к рабочему состоянию в случае проблем.


Решение проблем

Проблема: Виртуальная машина не загружается

Решения:

  • Проверьте, что ISO-образ не поврежден
  • Убедитесь, что выбрана правильная архитектура (x86_64 или ARM64)
  • Попробуйте пересоздать виртуальную машину

Проблема: Медленная работа

Решения:

  • Увеличьте объем выделенной RAM (минимум 4 ГБ)
  • Увеличьте количество ядер процессора
  • Убедитесь, что включена аппаратная виртуализация
  • Закройте другие приложения на Mac

Проблема: Не работает сеть / VPN / Tor

Решения:

  • Проверьте настройки сети в UTM (Shared Network должен работать)
  • Убедитесь, что хост-система (macOS) имеет доступ к интернету
  • Попробуйте перезапустить сетевые службы в Kodachi
  • Проверьте настройки VPN/Tor в Kodachi

Проблема: Не работает общий буфер обмена

Решения:

  • Убедитесь, что включен "Enable Clipboard Sharing" в настройках UTM
  • Установите SPICE Guest Tools в Kodachi (если доступны)
  • Перезапустите виртуальную машину

Проблема: На Apple Silicon Mac низкая производительность

Решения:

  • Используйте ARM64 версию Kodachi (если доступна)
  • Или используйте VMware Fusion вместо UTM для лучшей производительности
  • Увеличьте выделенные ресурсы

Важные замечания

Безопасность в виртуальной машине

⚠️ Важно понимать:

  • Виртуализация добавляет дополнительный слой, который может влиять на безопасность
  • Некоторые функции Kodachi (например, затирание RAM) могут работать иначе в VM
  • Для максимальной безопасности рекомендуется использовать Kodachi на физическом оборудовании или в Live режиме с USB

Сохранение данных

  • Данные в виртуальной машине хранятся в файле образа диска UTM
  • Регулярно создавайте резервные копии файла VM
  • Используйте снимки (snapshots) для защиты от потери данных

Производительность

  • UTM на Apple Silicon работает быстрее, чем на Intel Mac
  • Для лучшей производительности используйте VMware Fusion
  • Выделяйте достаточно ресурсов для комфортной работы

Полезные команды в Kodachi

После установки вы можете использовать следующие команды в терминале:

# Проверка статуса VPN
sudo systemctl status vpn

# Проверка статуса Tor
sudo systemctl status tor

# Проверка IP-адреса
curl ifconfig.me

# Обновление системы
sudo apt update && sudo apt upgrade

# Перезапуск сетевых служб
sudo systemctl restart networking

Дополнительные ресурсы


Быстрая справка

Действие Где найти
Создать новую VM Кнопка "+" в UTM
Добавить ISO Settings → Drives → CD/DVD
Изменить RAM Settings → System → Memory
Изменить CPU Settings → System → CPU Cores
Создать снимок VM → Take Snapshot
Настройки сети Settings → Network
Общий буфер Settings → Input/Output → Clipboard Sharing

Успешной установки! 🚀