Obsidian через свой VPS: LiveSync, CouchDB и спокойная работа с заметками

MAATRIX · 17 октября 2026 · 8 мин чтения

Заметка началась на компьютере, продолжилась в телефоне и закончилась конфликтной копией с загадочным суффиксом. Для человека это один текст. Для двух устройств, которые некоторое время не видели друг друга, — две независимые версии событий. Собственная синхронизация Obsidian должна не только быстро передавать файлы, но и понятно вести себя в такой ситуации.

Self-hosted LiveSync — плагин сообщества. Он не является официальным Obsidian Sync и не синхронизируется с его сервисом. В варианте с CouchDB данные передаются через ваш сервер, а заметки остаются доступными в локальных хранилищах Obsidian. Такой подход подходит тем, кто готов сопровождать сервер и проверять обновления плагина.

Сначала спасаем исходное хранилище от эксперимента

Закройте Obsidian на остальных устройствах и сделайте независимую копию всего хранилища. Включите заметки, вложения и скрытые настройки, если они нужны для восстановления. Проверьте копию открытием нескольких файлов. Не считайте синхронизируемую папку резервной копией самой себя.

Для первого запуска создайте тестовое хранилище с несколькими заметками, изображением и PDF. Добавьте внутреннюю ссылку, переименуйте одну заметку и подготовьте файл с кириллицей. Такой набор поможет проверить реальные операции до подключения большого архива.

Отключите другие механизмы синхронизации для этого же хранилища. В репозитории LiveSync отдельно указана несовместимость одновременной работы с другими решениями синхронизации. Два инструмента могут одинаково старательно исправлять изменения друг друга, создавая совершенно непредусмотренную коллективную деятельность.

Определите основное устройство для первоначальной загрузки. Оно должно содержать проверенную актуальную копию. Остальные подключайте последовательно, начиная с пустого тестового хранилища, чтобы не объединять сразу несколько расходящихся архивов.

Серверная сторона: CouchDB с понятной границей доступа

На VPS установите CouchDB способом из руководства LiveSync для своего сервера. Сохраните версию образа, постоянный каталог данных и конфигурацию. Официальный пример нужно адаптировать к вашим путям, паролям и прокси; значения из примера не становятся безопасными от того, что приложение личное.

Подготовьте отдельную базу для хранилища и подходящего пользователя. Административные учётные данные используйте только там, где они действительно требуются для настройки. Проверяйте права так, чтобы обычное подключение не давало ненужного доступа к другим базам.

Разместите CouchDB за HTTPS и ограничьте прямой доступ к внутреннему порту. Административный интерфейс не должен случайно оказаться доступным с простым паролем всему интернету. Сертификат должен быть доверенным для всех устройств, включая телефон.

Настройте CORS и методы запросов согласно требованиям плагина и используемых клиентов. Десктопное и мобильное приложение могут обращаться с разными origin. Не заменяйте конкретную ошибку разрешением любых источников без понимания последствий. После настройки выполните встроенную проверку соединения в плагине и разберите каждое предупреждение.

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

Подключаем первый Obsidian

Установите Self-hosted LiveSync из каталога плагинов сообщества и откройте мастер настройки. Выберите вариант CouchDB, укажите HTTPS-адрес, базу и учётные данные. Имена полей и последовательность мастера сверяйте с установленной версией: плагин развивается, а старые скриншоты не всегда совпадают с текущим интерфейсом.

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

Начните с обычной синхронизации заметок. Синхронизацию тем, настроек и плагинов подключайте позже, когда основной обмен уже понятен. Настройки рабочего стола не всегда уместны на телефоне, а некоторые плагины зависят от платформы.

Создайте заметку на первом устройстве, дождитесь завершения обмена и посмотрите журнал. Затем измените заголовок, добавьте вложение и переименуйте файл. На этом этапе важно увидеть предсказуемую последовательность операций, а не максимальную скорость передачи всего архива.

Второе устройство должно получить, а не изобрести свою версию

Создайте пустое тестовое хранилище на втором устройстве и установите тот же плагин совместимой версии. Используйте предусмотренный проектом способ переноса настроек, например Setup URI. Такой адрес может содержать чувствительные данные, поэтому не отправляйте его в публичный чат и не храните в открытой заметке.

Дождитесь получения заметок и вложений. Проверьте внутреннюю ссылку и переименованный файл. После этого создайте отдельную заметку на втором устройстве и убедитесь, что она появилась на первом. Односторонний успех ещё не подтверждает двустороннюю синхронизацию.

На телефоне проверьте работу при выключенном экране и после возвращения в приложение. Мобильная система может ограничивать фоновые процессы. Не обещайте себе мгновенную передачу каждого изменения, пока не проверили поведение конкретного устройства.

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

Учебный конфликт, который лучше настоящего

Создайте заметку «Проверка конфликта» с двумя абзацами. Отключите сеть на телефоне. Измените первый абзац на компьютере и второй на телефоне, затем восстановите соединение. Посмотрите, как плагин объединяет изменения или предлагает разрешить конфликт.

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

Теперь проверьте переименование и удаление тестового файла. Эти операции особенно чувствительны к задержкам между устройствами. Убедитесь, что ссылка на переименованную заметку ведёт туда, куда вы ожидаете, и что удаление не вызывает бесконечное повторное появление файла.

Если поведение странное, остановите синхронизацию и сохраните локальные копии обоих устройств. Массовое нажатие кнопок пересоздания базы без понимания направления передачи способно заменить хороший архив плохим. Сначала определите, какая копия является правильной, затем выполняйте восстановление по инструкции плагина.

Перенос основного архива

Когда тесты пройдены, сделайте свежую независимую копию рабочего хранилища. Выберите одно основное устройство и перенесите данные в настроенную схему. Дождитесь завершения первоначальной загрузки, затем подключайте остальные устройства по очереди.

Сравните число заметок и вложений, откройте старые и новые документы, проверьте несколько внутренних ссылок. Не ограничивайтесь главной заметкой-оглавлением: она может открываться даже при отсутствующих файлах, на которые ссылается.

Проверьте поиск и плагины, от которых зависит работа. Если синхронизируете настройки, убедитесь, что мобильное устройство не получило неподходящую конфигурацию. Сохраняйте раздельные параметры там, где это предусмотрено плагином и действительно нужно.

Старый механизм синхронизации отключайте осознанно и не включайте одновременно «на всякий случай». Для резерва используйте независимый архив или систему копирования, которая не редактирует рабочее хранилище параллельно с LiveSync.

Что требуется от VPS и владельца

Отдельно устройте репетицию замены телефона. На чистом тестовом устройстве восстановите доступ только по своей памятке, без подсматривания в настройки рабочего компьютера. Получите хранилище, откройте старую заметку с картинкой и проверьте поиск по редкому слову. Такая проверка быстро обнаруживает секрет, который хранился исключительно в памяти владельца, или вложения, которые всё это время существовали только на одном ноутбуке.

После проверки отключите тестовое устройство, если больше не собираетесь им пользоваться. Запишите, где находятся установочные настройки, пароль шифрования и независимая копия заметок. Сами пароли в памятку не вставляйте: достаточно понятного указания на защищённое хранилище. При реальной потере устройства времени на археологию конфигурационных файлов обычно меньше, чем при спокойной настройке дома. Именно поэтому восстановление стоит проверить до первого неприятного события.

Для пилота личного хранилища с CouchDB можно рассматривать MAATRIX Ba Lite с 1 vCPU и 2 ГБ памяти. При большом количестве вложений и других приложениях на том же сервере оцените Uab Start с 2 vCPU и 4 ГБ. Диск рассчитывайте по архиву, данным базы, служебному росту и запасу для обслуживания.

Выберите совместимую Ubuntu или Debian. Настройте копирование данных CouchDB и сохранение конфигурации, а также отдельный читаемый архив самого хранилища Obsidian. Это разные уровни восстановления: один возвращает сервер, другой позволяет получить заметки без сложной диагностики базы.

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

VPS MAATRIX даёт постоянный узел для вашей синхронизации. Хорошая настройка LiveSync проявляется незаметно: мысль, записанная в дороге, оказывается на рабочем компьютере, а конфликт остаётся понятной технической ситуацией, а не причиной переписывать потерянный текст по памяти.