Initial commit: local_machine docs and scripts

docs/security/KODACHI_UTM_INSTALLATION.md

@@ -0,0 +1,317 @@
+# Установка 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
+
+После установки вы можете использовать следующие команды в терминале:
+
+```bash
+# Проверка статуса VPN
+sudo systemctl status vpn
+
+# Проверка статуса Tor
+sudo systemctl status tor
+
+# Проверка IP-адреса
+curl ifconfig.me
+
+# Обновление системы
+sudo apt update && sudo apt upgrade
+
+# Перезапуск сетевых служб
+sudo systemctl restart networking
+```
+
+---
+
+## Дополнительные ресурсы
+
+- **Официальный сайт Kodachi:** https://www.digi77.com/linux-kodachi/
+- **Документация UTM:** https://docs.getutm.app/
+- **Форум поддержки UTM:** https://github.com/utmapp/UTM/discussions
+
+---
+
+## Быстрая справка
+
+| Действие | Где найти |
+|----------|-----------|
+| Создать новую 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 |
+
+---
+
+**Успешной установки! 🚀**
+