Trilium на VPS: встановлення, налаштування та обслуговування

Встановлення Trilium на VPS дозволяє створити потужну, самодостатню базу знань або систему керування нотатками з повним контролем над даними, забезпечуючи гнучке налаштування та високу продуктивність завдяки використанню Docker/Docker Compose, reverse proxy та регулярним резервним копіям.

Що таке Trilium Notes і чому його варто розмістити на VPS?

Trilium Notes — це багатофункціональний, ієрархічний додаток для ведення нотаток з відкритим вихідним кодом, який дозволяє користувачам організовувати інформацію у деревоподібній структурі. На відміну від багатьох хмарних рішень, Trilium розроблений для самостійного хостингу (self-hosting), що дає повний контроль над вашими даними, безпекою та продуктивністю. Розміщення Trilium на VPS (Virtual Private Server) — це ідеальне рішення для тих, хто шукає баланс між доступністю, потужністю та приватністю.

Детальніше про Trilium Notes

Trilium Notes пропонує вражаючий набір функцій, які роблять його потужним інструментом для керування інформацією:

• Ієрархічна структура: Нотатки організовані у вигляді дерева, що дозволяє створювати складні структури знань з необмеженою глибиною вкладеності.
• Розширений текстовий редактор: Підтримка Markdown, WYSIWYG-редагування, вставка зображень, файлів, таблиць, блоків коду з підсвічуванням синтаксису.
• Скриптинг та автоматизація: Вбудований JavaScript-рушій дозволяє створювати власні скрипти для автоматизації завдань, інтеграції із зовнішніми сервісами та розширення функціональності.
• Відносини між нотатками: Можливість пов'язувати нотатки, створювати клони, встановлювати атрибути для категоризації та пошуку.
• Версіонування та історія: Автоматичне збереження історії змін кожної нотатки, що дозволяє повертатися до попередніх версій.
• Шифрування: Можливість шифрування окремих нотаток або цілих піддерев для підвищення безпеки конфіденційної інформації.
• Синхронізація: Вбудована синхронізація між різними екземплярами Trilium, що зручно для роботи з різних пристроїв.

Завдяки цим можливостям, Trilium стає незамінним інструментом для розробників, дослідників, письменників та всіх, хто працює з великим обсягом інформації та потребує її структурованого зберігання та швидкого доступу.

Переваги розміщення Trilium на VPS

Коли мова йде про самостійний хостинг (self-hosting), вибір VPS для Trilium Notes надає низку значних переваг у порівнянні з локальним встановленням або використанням сторонніх хмарних сервісів:

1. Повний контроль над даними: Усі ваші нотатки, вкладення та конфігурації зберігаються на вашому власному сервері. Це виключає ризики, пов'язані з політикою конфіденційності або можливими витоками даних у сторонніх провайдерів. Ви самі вирішуєте, де і як зберігаються ваші дані.
2. Доступність 24/7 з будь-якої точки світу: Ваш сервер буде доступний в інтернеті цілодобово, дозволяючи вам отримувати доступ до своїх нотаток з будь-якого пристрою, що має підключення до мережі, будь то комп'ютер, планшет або смартфон.
3. Гнучкість у налаштуванні та масштабуванні: Ви можете налаштувати сервер під свої потреби, встановити необхідне ПЗ, оптимізувати продуктивність. У міру зростання вашої бази знань або збільшення кількості користувачів, ви легко можете масштабувати ресурси VPS (збільшити RAM, CPU, диск) без міграції даних.
4. Висока продуктивність: Сучасні VPS-сервери, особливо з NVMe-накопичувачами, забезпечують високу швидкість роботи бази даних та чуйність інтерфейсу Trilium, що критично для комфортної роботи з великим обсягом даних.
5. Приватність та безпека: Ви контролюєте доступ до сервера, можете налаштувати файрвол, використовувати VPN та інші заходи безпеки. Це значно знижує ймовірність несанкціонованого доступу порівняно з загальнодоступними хмарними рішеннями.
6. Економічна ефективність: У довгостроковій перспективі, самостійний хостинг на VPS може бути вигіднішим, ніж оплата щомісячних підписок на хмарні сервіси, особливо якщо у вас вже є VPS для інших цілей.

Оцінка системних вимог для Trilium Notes

Trilium Notes, будучи додатком на Node.js, не є надзвичайно вимогливим до ресурсів, але його апетити можуть зростати залежно від обсягу вашої бази знань, кількості вкладень (зображень, файлів), складності скриптів та кількості одночасно працюючих користувачів. Правильна оцінка системних вимог критично важлива для забезпечення стабільної та швидкої роботи.

Мінімальні вимоги для особистого використання (до 10 000 нотаток)

Для одного користувача або невеликої бази знань, Trilium цілком комфортно працюватиме на базових конфігураціях VPS:

• Процесор (CPU): 1 vCPU з тактовою частотою від 2.0 GHz. Сучасні процесори з одним ядром впораються з більшістю завдань.
• Оперативна пам'ять (RAM): 1 GB. Цього обсягу буде достатньо для запуску Trilium та операційної системи. Однак, якщо ви плануєте активно використовувати вкладення або скрипти, 2 GB буде краще.
• Дисковий простір: 10-20 GB NVMe-диска. Trilium зберігає свої дані в SQLite базі, і швидкість дискової підсистеми безпосередньо впливає на продуктивність додатка, особливо при пошуку, відкритті великих нотаток або роботі з історією. NVMe значно перевершує звичайні SSD і тим більше HDD за швидкістю.
• Операційна система: Ubuntu Server 22.04 LTS+, Debian 11+, CentOS Stream 9+. Будь-який сучасний дистрибутив Linux без графічної оболонки.
• Мережеве підключення: 100 Mbps. Для більшості сценаріїв цього більш ніж достатньо.

За таких характеристик вартість VPS може починатися від $5-7 на місяць у більшості провайдерів.

Рекомендовані конфігурації для активного використання та малих команд (до 50 000 нотаток, 2-5 користувачів)

Якщо ви плануєте використовувати Trilium у команді, зберігати велику кількість вкладень, активно застосовувати скрипти або просто хочете мати запас продуктивності, варто розглянути більш потужний VPS:

• Процесор (CPU): 2 vCPU. Це забезпечить кращу багатозадачність та продуктивність при одночасній роботі кількох користувачів або виконанні ресурсомістких операцій.
• Оперативна пам'ять (RAM): 2-4 GB. Більший обсяг RAM дозволить Trilium кешувати більше даних, що прискорить доступ до часто використовуваних нотаток та покращить загальну чуйність.
• Дисковий простір: 50+ GB NVMe-диска. Зі зростанням бази даних обсяг диска та його швидкість стають ще більш критичними. NVMe забезпечить мінімальні затримки при операціях з базою.
• Операційна система: Ubuntu Server 22.04 LTS+, Debian 11+, CentOS Stream 9+.
• Мережеве підключення: 100 Mbps або 1 Gbps. Для командної роботи або синхронізації великих обсягів даних вища швидкість мережі буде перевагою.

Вартість такого VPS може становити від $10-20 на місяць.

Важливе зауваження: Незважаючи на те, що Trilium в основному використовує один потік CPU для обробки запитів, наявність кількох ядер корисна для фонових завдань, операційної системи та інших процесів, таких як Docker, reverse proxy та моніторинг.

Підготовка VPS для встановлення Trilium: базові кроки

Перш ніж приступати до встановлення Trilium, необхідно підготувати ваш VPS. Ці кроки є стандартними для розгортання більшості веб-додатків та забезпечують стабільну та безпечну основу для вашої системи.

Вибір провайдера та підключення по SSH

Насамперед вам знадобиться активний VPS. Valebyte.com пропонує надійні та продуктивні VPS-сервери з NVMe-дисками, які ідеально підходять для таких додатків, як Trilium. Після вибору тарифного плану та розгортання сервера, ви отримаєте IP-адресу, логін (зазвичай root) та пароль (або ключ SSH). Для підключення до сервера використовуйте SSH-клієнт:

ssh root@ВАШ_IP_АДРЕС

Після першого входу рекомендується створити нового користувача з обмеженими правами та використовувати його для повсякденної роботи, а також налаштувати автентифікацію за SSH-ключами для підвищення безпеки.

Оновлення системи та встановлення необхідних пакетів

Завжди починайте з оновлення вашої операційної системи. Це гарантує, що у вас встановлені останні виправлення безпеки та версії пакетів.

sudo apt update
sudo apt upgrade -y

Також встановіть кілька корисних утиліт, якщо їх немає за замовчуванням:

sudo apt install curl wget git htop -y

Встановлення Docker та Docker Compose

Ми будемо використовувати Docker та Docker Compose для встановлення Trilium. Це дозволяє ізолювати додаток від основної системи, спрощує керування залежностями та забезпечує переносимість. Контейнеризація з Docker є сучасним стандартом для розгортання веб-додатків.

Встановлення Docker Engine

Для встановлення Docker на Ubuntu/Debian виконайте наступні команди:

# Удаляем старые версии Docker (если есть)
for pkg in docker.io docker-doc docker-compose docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin; do sudo apt remove $pkg; done

# Устанавливаем необходимые пакеты
sudo apt install ca-certificates curl gnupg -y

# Добавляем официальный GPG ключ Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Добавляем репозиторий Docker
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Обновляем список пакетов и устанавливаем Docker Engine
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Перевірка встановлення Docker

Переконайтеся, що Docker успішно встановлений та працює:

sudo docker run hello-world

Ви повинні побачити вітальне повідомлення від Docker.

Додавання користувача до групи docker (опціонально, але рекомендується)

Щоб уникнути постійного використання sudo при роботі з Docker, додайте вашого користувача до групи docker:

sudo usermod -aG docker $USER

Потім вийдіть з SSH-сесії та увійдіть знову, щоб зміни набули чинності. Тепер ви можете використовувати команди docker без sudo.

Встановлення Trilium на VPS за допомогою Docker Compose

Встановлення Trilium Notes за допомогою Docker Compose — це найбільш рекомендований та зручний спосіб розгортання додатка на вашому VPS. Він дозволяє визначити всі необхідні сервіси (Trilium, потенційно базу даних, reverse proxy) та їх конфігурацію в одному YAML-файлі, що значно спрощує керування та масштабування вашого самостійно керованого додатка.

Створення структури каталогів та файлу docker-compose.yml

Спочатку створимо каталог для нашого проєкту Trilium та перейдемо до нього:

mkdir -p ~/trilium
cd ~/trilium

Потім створіть файл docker-compose.yml у цьому каталозі. Цей файл міститиме всю конфігурацію для запуску Trilium.

nano docker-compose.yml

Вставте наступний вміст у файл docker-compose.yml:

version: '3.8'

services:
  trilium:
    image: zadam/trilium:0.62.2 # Укажите актуальную версию
    container_name: trilium
    restart: unless-stopped
    ports:
      - "8080:8080" # Порт хоста:Порт контейнера
    volumes:
      - ./data:/home/node/trilium-data # Сохраняем данные вне контейнера
    environment:
      # - TRILIUM_DATA_DIR=/home/node/trilium-data # Это путь внутри контейнера, указанный в volumes
      - TRILIUM_PORT=8080 # Порт, который слушает Trilium внутри контейнера
      # - TRILIUM_URL_PATH= # Если Trilium будет доступен по подпути, например /notes
      # - TRILIUM_PASSWORD=your_secure_password # Установите пароль для первого входа, если хотите
      # - TRILIUM_DEBUG=true # Включить отладочный режим
      - TZ=Europe/Moscow # Установите ваш часовой пояс
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/"] # Проверка работоспособности
      interval: 30s
      timeout: 10s
      retries: 3

Розберемо кожен рядок конфігурації:

• version: '3.8': Вказує версію формату файлу Docker Compose. Рекомендується використовувати актуальні версії.
• services:: Визначає сервіси, які будуть запущені. У нас поки що один сервіс — trilium.
• image: zadam/trilium:0.62.2: Вказує Docker-образ, який буде використовуватися. Завжди рекомендується використовувати конкретну версію (наприклад, 0.62.2), а не latest, щоб уникнути несподіваних оновлень. Перевірити актуальну версію можна на Docker Hub або GitHub-сторінці Trilium.
• container_name: trilium: Присвоює контейнеру зрозуміле ім'я.
• restart: unless-stopped: Контейнер буде автоматично перезапускатися, якщо він зупиниться з будь-якої причини (збій, перезавантаження сервера), якщо тільки ви не зупинили його вручну.
• ports: - "8080:8080": Прокидає порт 8080 з контейнера на порт 8080 хост-машини. Це означає, що ви зможете отримати доступ до Trilium за адресою http://ВАШ_IP_АДРЕС:8080. Пізніше ми налаштуємо reverse proxy, щоб використовувати стандартний порт 80/443 та доменне ім'я.
• volumes: - ./data:/home/node/trilium-data: Це дуже важливий рядок. Він монтує локальний каталог ./data (відносно поточного розташування docker-compose.yml) у каталог /home/node/trilium-data всередині контейнера. Усі дані Trilium (база даних, вкладення) зберігатимуться в цьому каталозі на вашому VPS, що гарантує їх збереження навіть при видаленні або оновленні контейнера.
• environment:: Дозволяє передавати змінні оточення в контейнер.
  • TRILIUM_PORT=8080: Вказує Trilium, на якому порту слухати всередині контейнера.
  • TZ=Europe/Moscow: Встановлює часовий пояс для контейнера. Замініть на свій, наприклад, Asia/Yekaterinburg або America/New_York.
  • TRILIUM_PASSWORD=your_secure_password: (Опціонально) Ви можете задати початковий пароль для користувача "admin". Якщо не вказано, Trilium запропонує створити його при першому вході. Рекомендується не використовувати цю опцію для першого запуску, а створити пароль через веб-інтерфейс.
• healthcheck:: Визначає, як Docker перевірятиме працездатність контейнера.

Запуск Trilium та перший вхід

Збережіть файл docker-compose.yml (Ctrl+O, Enter, Ctrl+X в nano). Тепер ви готові запустити Trilium.

docker compose up -d

Ця команда виконає наступні дії:

1. Завантажить Docker-образ zadam/trilium, якщо його немає локально.
2. Створить та запустить контейнер trilium у фоновому режимі (прапорець -d, від "detached").
3. Створить каталог ./data, якщо його ще немає, та змонтує його.

Ви можете перевірити статус запущеного контейнера:

docker compose ps

Вивід повинен показати, що контейнер trilium запущений (Up).

NAME                COMMAND                  SERVICE             STATUS              PORTS
trilium             "node ./src/main.js"     trilium             running (healthy)   0.0.0.0:8080->8080/tcp

Тепер відкрийте веб-браузер і перейдіть за адресою http://ВАШ_IP_АДРЕС:8080. Ви повинні побачити сторінку привітання Trilium Notes, де вам буде запропоновано створити першого користувача та пароль. Це ваш перший крок до створення власної бази знань на VPS.

Налаштування Reverse Proxy та HTTPS для Trilium (Nginx та Caddy)

Прямий доступ до Trilium за IP-адресою та портом 8080 не є оптимальним рішенням для довгострокового використання. Для забезпечення безпеки, зручності та професійного вигляду вашої бази знань необхідно налаштувати reverse proxy з підтримкою HTTPS. Reverse proxy прийматиме всі вхідні запити за стандартними портами (80 для HTTP та 443 для HTTPS), перенаправлятиме їх на ваш Trilium-контейнер та керуватиме SSL/TLS-сертифікатами.

У цьому розділі ми розглянемо налаштування двох популярних reverse proxy: Nginx та Caddy.

Попередні кроки: доменне ім'я та DNS

Перед налаштуванням reverse proxy переконайтеся, що у вас є доменне ім'я (наприклад, notes.mydomain.com) і що його DNS-запис типу A вказує на IP-адресу вашого VPS.

Налаштування Nginx як Reverse Proxy

Nginx — це потужний, високопродуктивний веб-сервер, який часто використовується як reverse proxy. Для нього знадобиться ручне налаштування SSL-сертифікатів за допомогою Certbot.

1. Встановлення Nginx

sudo apt install nginx -y

2. Створення конфігураційного файлу Nginx

Створіть новий файл конфігурації для вашого домену. Замініть notes.mydomain.com на ваше доменне ім'я.

sudo nano /etc/nginx/sites-available/trilium.conf

Вставте наступний вміст:

server {
    listen 80;
    server_name notes.mydomain.com;

    location / {
        proxy_pass http://localhost:8080; # Перенаправляем на порт Trilium-контейнера
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket поддержка для Trilium
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Збережіть та закрийте файл (Ctrl+O, Enter, Ctrl+X).

3. Активація конфігурації Nginx

Створіть символічне посилання на файл конфігурації в sites-enabled та перевірте синтаксис Nginx:

sudo ln -s /etc/nginx/sites-available/trilium.conf /etc/nginx/sites-enabled/
sudo nginx -t

Якщо синтаксис у порядку (syntax is ok, test is successful), перезавантажте Nginx:

sudo systemctl reload nginx

Тепер ви зможете отримати доступ до Trilium за адресою http://notes.mydomain.com, але поки що без HTTPS.

4. Налаштування HTTPS з Certbot (Let's Encrypt)

Certbot автоматизує отримання та встановлення безкоштовних SSL/TLS-сертифікатів від Let's Encrypt.

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d notes.mydomain.com

Дотримуйтесь інструкцій Certbot. Він автоматично змінить вашу конфігурацію Nginx, щоб увімкнути HTTPS та налаштувати автоматичне продовження сертифіката. Після успішного завершення ви зможете отримати доступ до Trilium за адресою https://notes.mydomain.com.

Налаштування Caddy як Reverse Proxy

Caddy — це сучасний веб-сервер з автоматичною підтримкою HTTPS (через Let's Encrypt або ZeroSSL), що робить його значно простішим у налаштуванні порівняно з Nginx + Certbot.

1. Встановлення Caddy

Дотримуйтесь офіційних інструкцій зі встановлення Caddy для вашого дистрибутива. Для Debian/Ubuntu:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy -y

2. Створення Caddyfile

Caddy використовує файл конфігурації під назвою Caddyfile. Відкрийте його для редагування:

sudo nano /etc/caddy/Caddyfile

Видаліть існуючий вміст та вставте наступне, замінивши notes.mydomain.com на ваш домен:

notes.mydomain.com {
    reverse_proxy localhost:8080 {
        # WebSocket поддержка для Trilium
        header_up Upgrade {http.request.header.Upgrade}
        header_up Connection {http.request.header.Connection}
    }
}

Збережіть та закрийте файл.

3. Перевірка та запуск Caddy

Перевірте синтаксис Caddyfile:

sudo caddy validate --config /etc/caddy/Caddyfile

Якщо все в порядку, перезавантажте сервіс Caddy:

sudo systemctl reload caddy

Caddy автоматично отримає та налаштує SSL-сертифікат для вашого домену. Тепер ви можете отримати доступ до Trilium за адресою https://notes.mydomain.com.

Незалежно від вибору Nginx або Caddy, тепер ваш Trilium на сервері доступний за захищеним HTTPS-з'єднанням з використанням доменного імені, що значно підвищує зручність та безпеку використання.

Забезпечення надійності: резервні копії та оновлення Trilium Notes

Надійність будь-якої системи самостійного хостингу базується на двох китах: регулярних резервних копіях та своєчасних оновленнях. Для Trilium Notes, де зберігається ваша цінна інформація, ці аспекти набувають першочергового значення.

Стратегії резервного копіювання Trilium Notes

Втрата даних — це найгірший сценарій, якого можна уникнути за допомогою добре продуманої стратегії резервного копіювання. Оскільки дані Trilium зберігаються в томі Docker (у нашому випадку, в каталозі ~/trilium/data на VPS), резервне копіювання зводиться до копіювання цього каталогу.

1. Зупинка Trilium перед резервним копіюванням

Для створення консистентної резервної копії бази даних SQLite, яка використовується Trilium, рекомендується зупинити контейнер Trilium на час копіювання даних. Це гарантує, що база даних не буде активно змінюватися в процесі резервного копіювання, запобігаючи пошкодженню даних.

cd ~/trilium
docker compose stop trilium

2. Копіювання каталогу даних

Після зупинки контейнера ви можете скопіювати каталог data в безпечне місце. Рекомендується використовувати мітку часу для кожної резервної копії.

# Создаем каталог для бэкапов, если его нет
mkdir -p ~/trilium_backups

# Создаем архив с датой
BACKUP_DATE=$(date +%Y%m%d_%H%M%S)
tar -czvf ~/trilium_backups/trilium_data_$BACKUP_DATE.tar.gz ~/trilium/data

3. Запуск Trilium після резервного копіювання

cd ~/trilium
docker compose start trilium

4. Автоматизація резервного копіювання за допомогою Cron

Ручне виконання резервних копій непрактично. Використовуйте cron для автоматизації цього процесу. Створіть скрипт backup_trilium.sh:

nano ~/trilium_backups/backup_trilium.sh

Вставте наступний вміст:

#!/bin/bash

# Каталог, где находится docker-compose.yml
TRILIUM_DIR="/root/trilium"
# Каталог для хранения бэкапов
BACKUP_DIR="/root/trilium_backups"
# Имя файла бэкапа
BACKUP_FILE="$BACKUP_DIR/trilium_data_$(date +%Y%m%d_%H%M%S).tar.gz"
# Каталог данных Trilium внутри TRILIUM_DIR
TRILIUM_DATA_PATH="$TRILIUM_DIR/data"

echo "Начинаем бэкап Trilium Notes..."

# Останавливаем контейнер Trilium
echo "Остановка контейнера Trilium..."
docker compose -f "$TRILIUM_DIR/docker-compose.yml" stop trilium

# Создаем архив данных
echo "Создание архива данных из $TRILIUM_DATA_PATH..."
tar -czvf "$BACKUP_FILE" -C "$TRILIUM_DIR" data

# Запускаем контейнер Trilium
echo "Запуск контейнера Trilium..."
docker compose -f "$TRILIUM_DIR/docker-compose.yml" start trilium

# Удаляем старые бэкапы (например, старше 7 дней)
echo "Удаление старых бэкапов (старше 7 дней)..."
find "$BACKUP_DIR" -name "trilium_data_*.tar.gz" -type f -mtime +7 -delete

echo "Бэкап завершен. Файл: $BACKUP_FILE"

Зробіть скрипт виконуваним:

chmod +x ~/trilium_backups/backup_trilium.sh

Додайте завдання до Cron. Відкрийте crontab:

crontab -e

Додайте рядок для щоденного резервного копіювання, наприклад, о 3:00 ночі:

0 3 * * * /root/trilium_backups/backup_trilium.sh >> /var/log/trilium_backup.log 2>&1

Це запускатиме скрипт щодня о 3 годині ночі та логуватиме вивід у /var/log/trilium_backup.log.

5. Зберігання резервних копій поза сервером

Вкрай важливо зберігати копії резервних копій на віддаленому сховищі (S3-сумісне сховище, Dropbox, Google Drive, інший сервер). У разі виходу з ладу VPS, резервна копія на тому ж сервері буде марною. Використовуйте rsync, sftp або хмарні утиліти для автоматичного завантаження резервних копій.

Процедура оновлення Trilium Notes

Оновлення Trilium Notes, встановленого через Docker Compose, досить просте, але вимагає обережності та попереднього резервного копіювання.

1. Перевірка нової версії

Слідкуйте за офіційними релізами Trilium на GitHub або Docker Hub, щоб дізнатися про доступні оновлення.

2. Резервне копіювання

Обов'язково створіть резервну копію перед оновленням! Використовуйте скрипт, створений вище, або виконайте команди вручну.

cd ~/trilium
docker compose stop trilium
tar -czvf ~/trilium_backups/trilium_data_pre_update_$(date +%Y%m%d_%H%M%S).tar.gz ~/trilium/data

3. Зміна версії образу в docker-compose.yml

Відредагуйте файл docker-compose.yml та змініть версію образу Trilium на нову:

nano ~/trilium/docker-compose.yml

Наприклад, з zadam/trilium:0.62.2 на zadam/trilium:0.63.1.

4. Оновлення контейнера

Перейдіть до каталогу з docker-compose.yml та виконайте команди:

cd ~/trilium
docker compose pull trilium # Скачивает новый образ
docker compose up -d # Пересоздает контейнер с новым образом, сохраняя данные

Docker Compose побачить, що образ змінився, і перестворить контейнер, при цьому зберігаючи підключений том з даними. Після завершення перевірте, що Trilium працює коректно, відкривши його в браузері.

Якщо виникли проблеми, ви завжди можете відкотитися до попередньої резервної копії та/або попередньої версії образу в docker-compose.yml.

Для моніторингу стану вашого сервера та попередження про можливі проблеми, такі як переповнення диска або високе завантаження CPU, розгляньте встановлення Netdata на VPS. Це допоможе вам своєчасно реагувати на потенційні неполадки.

Вибір оптимального VPS для Trilium під реальне навантаження

Вибір відповідного VPS для Trilium Notes безпосередньо впливає на його продуктивність, чуйність та загальну стабільність. Хоча мінімальні вимоги досить скромні, реальне навантаження може значно варіюватися залежно від кількох ключових факторів. Правильний вибір конфігурації VPS забезпечить комфортну роботу та запобіжить уповільненням у міру зростання вашої бази знань.

Фактори, що впливають на вибір VPS

1. Кількість нотаток та вкладень: Чим більше нотаток, зображень, PDF-файлів та інших вкладень ви зберігаєте, тим більше дискового простору знадобиться і тим інтенсивнішим буде навантаження на дискову підсистему при пошуку або відкритті великих нотаток.
2. Кількість активних користувачів: Trilium добре оптимізований для одного користувача, але якщо кілька людей одночасно редагують нотатки, виконують пошук або синхронізують дані, це збільшить навантаження на CPU та RAM.
3. Використання скриптів та автоматизації: Якщо ви активно використовуєте вбудований JavaScript-рушій Trilium для складних скриптів, автоматизації або інтеграцій, це може споживати додаткові ресурси CPU та RAM.
4. Частота синхронізації: Якщо ви використовуєте синхронізацію між кількома екземплярами Trilium, часті та об'ємні синхронізації будуть навантажувати мережу та CPU.
5. Тип диска: SQLite база даних Trilium дуже чутлива до швидкості диска. NVMe-накопичувачі забезпечують значно кращу продуктивність порівняно зі звичайними SSD, що критично для великих баз даних.

Таблиця порівняння VPS-конфігурацій для Trilium Notes

Нижче представлена таблиця з рекомендаціями щодо конфігурації VPS від Valebyte.com для різних сценаріїв використання Trilium Notes. Ціни наведені орієнтовно та можуть змінюватися.

Сценарій використання	vCPU	RAM (GB)	Диск (NVMe)	Трафік	Орієнтовна ціна ($/міс)
Особисте використання (1 користувач, до 10 000 нотаток, мінімум вкладень)	1-2	2	25-50 GB	500 GB - 1 TB	$7 - $15
Мала команда/Активне особисте використання (2-5 користувачів, до 50 000 нотаток, помірно вкладень)	2-4	4	50-100 GB	1 TB - 2 TB	$15 - $30
Середня команда/Велика база знань (5-15 користувачів, до 200 000 нотаток, багато вкладень, активні скрипти)	4-6	8	100-200 GB	2 TB - 4 TB	$30 - $60
Велика команда/Enterprise (15+ користувачів, понад 200 000 нотаток, інтенсивне навантаження)	6+	16+	200+ GB	4 TB+	$60+

Рекомендації щодо вибору

• Завжди обирайте NVMe-диски: Різниця в продуктивності між NVMe та звичайними SSD, особливо для баз даних, величезна. Інвестиція у швидкий диск окупиться швидкістю роботи Trilium.
• Не економте на RAM: Trilium, як Node.js додаток, може використовувати кешування в пам'яті. Більше RAM означає менше звернень до диска та швидшу роботу.
• Почніть із запасом: Якщо ви не впевнені в точному навантаженні, краще взяти тариф трохи потужніший за мінімальний. Легше "урізати" ресурси, ніж постійно відчувати проблеми з продуктивністю.
• Моніторинг: Після запуску Trilium використовуйте інструменти моніторингу (наприклад, htop, docker stats, Netdata) для відстеження фактичного споживання ресурсів. Це допоможе вам зрозуміти, чи достатньо поточної конфігурації або потрібне масштабування.
• Гнучкість VPS: Однією з ключових переваг VPS є можливість легкого масштабування ресурсів (RAM, CPU, диск) без необхідності перевстановлення або міграції. Valebyte.com пропонує таку гнучкість, дозволяючи вам адаптувати сервер під зростаючі потреби вашого Trilium Notes.

Обираючи VPS для Trilium, ви інвестуєте в надійність та продуктивність вашої особистої або командної бази знань. Правильний підхід до вибору конфігурації допоможе вам уникнути багатьох проблем у майбутньому та зосередитися на головному — створенні та керуванні вашими нотатками.

Висновки

Розгортання Trilium Notes на VPS — це оптимальне рішення для тих, хто цінує повний контроль над своїми даними, високу продуктивність та гнучкість налаштування. Використовуючи Docker Compose для встановлення та надійний reverse proxy (Nginx або Caddy) для безпечного доступу за HTTPS, ви створите потужну та приватну систему керування знаннями. Регулярні резервні копії та своєчасні оновлення забезпечать довгострокову стабільність, а правильний вибір конфігурації VPS від Valebyte.com гарантує масштабованість та ефективну роботу під будь-яке навантаження.