Files
obsidian-vault/family/how-to/openmediavault-rpi5.md
T

9.2 KiB
Raw Blame History

tags, created, updated, status
tags created updated status
raspberry-pi
nas
openmediavault
how-to
2026-05-11 2026-05-12 omv-installed

OpenMediaVault на Raspberry Pi 5

Статус: OMV установлен (май 2026) Цель: NAS на RPi 5 — OS на SD-карте, хранилище на USB 3.0 HDD


Железо

  • Raspberry Pi 5 (4 или 8 GB RAM)
  • SD-карта ≥16 GB (Samsung/SanDisk A1 Class 10+)
  • USB 3.0 HDD для хранения данных
  • Проводной Ethernet (обязателен)

Шаг 1 — Флашим SD-карту

Образ: Raspberry Pi OS Lite 64-bit (Bookworm / Debian 12)

⚠️ Брать именно Bookworm, не Trixie (Debian 13) — OMV не поддерживается на Trixie!

Инструмент: Raspberry Pi Imager (https://www.raspberrypi.com/software/)

⚠️ Не Balena Etcher — только RPi Imager поддерживает OS Customisation! При выборе образа из каталога (не custom file) появляется кнопка "Edit Settings"

Настройки (Edit Settings → шестерёнка):

  • Hostname: kraken
  • Username: kraken (не admin — зарезервировано для OMV!)
  • Password: сохранён в 1Password (запись "Kraken RPi")
  • SSH: Enable → Allow public-key authentication → вставить ~/.ssh/id_rsa.pub

После флаша вставить карту в Pi и включить.


Шаг 2 — Первый запуск, обновление и настройка сети

SSH подключение (пока через WiFi/роутер):

ssh -i ~/.ssh/id_rsa kraken@kraken.local

Обновление системы:

sudo apt-get update && sudo apt-get upgrade -y

Static IP на eth0 (прямой кабель Mac ↔ Pi для установки):

sudo nmcli con add type ethernet ifname eth0 con-name eth0-static \
  ipv4.method manual \
  ipv4.addresses 192.168.100.2/24 \
  ipv4.gateway 192.168.100.1 \
  ipv4.never-default yes \
  connection.autoconnect yes
sudo nmcli con up eth0-static

⚠️ ipv4.never-default yes — обязательно! Иначе интернет пойдёт через Mac, а не WiFi, и установка зависнет.


Шаг 3 — Установка OMV

# Pre-install
wget -qO- https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/preinstall | sudo bash
sudo reboot

# После перезагрузки — основная установка (~30 мин)
wget -qO- https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install | sudo bash

Pi перезагрузится автоматически по окончании.


Шаг 4 — Первый вход в веб-интерфейс

  • URL: http://192.168.100.2 (или http://kraken.local)
  • Логин: admin
  • Пароль: openmediavault
  • Сразу сменить пароль! (System → General Settings → Web Administrator Password)

Шаг 5 — Подключить Pi к роутеру, настроить static IP, отключить WiFi

  1. Переключить ethernet-кабель: Pi → роутер (не Mac)
  2. В роутере: DHCP reservation для MAC 2c:cf:67:64:03:f3 → выбрать постоянный IP (например 192.168.1.X)
  3. Отключить WiFi на Pi:
sudo nmcli radio wifi off
  1. Убедиться что Pi доступен по новому IP, проверить OMV web UI

Шаг 6 — Подключить USB HDD, форматировать, смонтировать

  1. Подключить HDD к USB 3.0 порту Pi (синий разъём)
  2. OMV Web UI → Storage → Disks → убедиться что диск виден
  3. Storage → File Systems → Create → выбрать диск → EXT4 → Save → Mount
  4. Storage → Shared Folders → Add:
    • media — для фильмов/музыки
    • timemachine — для Time Machine бэкапов
    • docker — для данных контейнеров

Шаг 7 — omv-extras + Docker + Portainer

Установить omv-extras (даёт доступ к Docker плагину):

wget -qO- https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install | sudo bash

В OMV Web UI:

  • System → Plugins → найти openmediavault-compose → установить
  • Или через SSH: установить Docker + Portainer вручную:
curl -fsSL https://get.docker.com | sudo bash
sudo usermod -aG docker kraken

# Portainer
sudo docker volume create portainer_data
sudo docker run -d \
  --name portainer \
  --restart always \
  -p 9000:9000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest

Portainer UI: http://kraken.local:9000


Шаг 8 — Docker контейнеры

Все контейнеры управляются через Portainer или docker compose. Данные хранить на HDD в /srv/<filesystem>/docker/.

Watchtower (авто-обновление контейнеров)

watchtower:
  image: containrrr/watchtower
  restart: always
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock
  environment:
    - WATCHTOWER_CLEANUP=true
    - WATCHTOWER_SCHEDULE=0 0 4 * * *  # каждую ночь в 4:00

Home Assistant

homeassistant:
  image: ghcr.io/home-assistant/home-assistant:stable
  restart: always
  network_mode: host
  volumes:
    - /srv/.../docker/homeassistant:/config
  privileged: true

Zigbee2MQTT

zigbee2mqtt:
  image: koenkk/zigbee2mqtt
  restart: always
  volumes:
    - /srv/.../docker/zigbee2mqtt:/app/data
    - /run/udev:/run/udev:ro
  devices:
    - /dev/ttyUSB0:/dev/ttyUSB0  # Zigbee адаптер

Jellyfin

jellyfin:
  image: jellyfin/jellyfin
  restart: always
  ports:
    - 8096:8096
  volumes:
    - /srv/.../docker/jellyfin:/config
    - /srv/.../media:/media:ro

Transmission

transmission:
  image: lscr.io/linuxserver/transmission
  restart: always
  ports:
    - 9091:9091
    - 51413:51413
  volumes:
    - /srv/.../docker/transmission:/config
    - /srv/.../media/downloads:/downloads

Rclone (бэкап на облако)

rclone:
  image: rclone/rclone
  restart: unless-stopped
  volumes:
    - /srv/.../:/data:ro
    - /home/kraken/.config/rclone:/config/rclone
  command: sync /data remote:backup --progress

Шаг 9 — Time Machine share (macOS бэкапы на NAS)

В OMV Web UI:

  1. Services → SMB/CIFS → Enable
  2. Services → SMB/CIFS → Shares → Add:
    • Shared folder: timemachine
    • Enable Time Machine support:
  3. На Mac: Finder → Go → Connect to Server → smb://kraken.local/timemachine
  4. System Preferences → Time Machine → Add Disk → выбрать kraken

Шаг 10 — Перенос данных

Фильмы с Mac на NAS

rsync -avh --progress /path/to/movies/ kraken@kraken.local:/srv/.../media/movies/

Time Machine

⚠️ Старый TM-бэкап перенести нельзя напрямую — TM привязывает бэкап к конкретному диску/хосту. Начать новый бэкап на NAS, старый HDD хранить как архив или отформатировать после нескольких успешных новых бэкапов.


Шаг 11 — Hermes агент Кракен

По образу агента Тайга (TrueNAS). Установить Hermes на Pi:

# TODO: уточнить команду установки по образу Тайги
  • Конфиг: ~/.hermes/config.yaml
  • Namespace: family
  • Подключить к Discord/Zulip
  • Настроить доступ к vault через obsidian-mcp

Уроки (что пошло не так при установке)

  • Balena Etcher не поддерживает OS Customisation — использовать только RPi Imager
  • userconf.txt deprecated на Bookworm — правильный способ через RPi Imager (он пишет custom.toml)
  • systemd.run= в cmdline.txt нужно указывать /usr/lib/raspberrypi-sys-mods/firstboot, а не свой скрипт
  • ipv4.never-default yes при настройке static IP на eth0 — обязательно, иначе интернет идёт через Mac и установка зависает
  • OMV install script при зависании — скорее всего нет интернета, проверить маршруты (ip route)

Полезные ссылки