К содержимому
Linux22 мин чтения0 просм.

Свой сервер синхронизации Obsidian: LiveSync, CouchDB и ИИ через MCP - со всеми граблями

Часть 1 из 2Сервер: CouchDB, nginx и бэкап

Заметки я держу в Obsidian на ПК и на iPhone, и отдавать их в чужое облако не хотел. Поднял свой сервер: CouchDB за nginx с TLS, плагин Self-hosted LiveSync на устройствах и рядом MCP-сервер, через который ИИ-ассистент читает и пишет те же заметки. Работает, но завелось не с первого раза: большая часть текста ниже про грабли, которых в готовых инструкциях нет.

Проверено на Obsidian 1.13.7 (Windows и iOS 18), плагине Self-hosted LiveSync 1.0.30, CouchDB 3.5.2.1, obsidian-sync-mcp v0.6.2, nginx 1.26, Debian, Docker из репозитория дистрибутива (docker.io), compose v5. Домен в примерах obsidian.example.com, хранилище "Моё хранилище", паролей нигде нет.

Что получается

ПК (Obsidian) ─────┐
iPhone (Obsidian) ─┼─HTTPS─▶ nginx :443 obsidian.example.com ─▶ 127.0.0.1:5984 CouchDB
                   │                                                  ▲
Claude Code ───────┴──────────────────────▶ 127.0.0.1:8787 MCP ────────┘
(на сервере)                                (наружу не публикуется)

CouchDB хранит заметки, которые туда складывает плагин Self-hosted LiveSync, причём в зашифрованном виде. Наружу база смотрит только через nginx с TLS. MCP-сервер obsidian-sync-mcp читает ту же базу, расшифровывает и отдаёт заметки ИИ, слушает он только loopback. На nginx TLS и фильтр служебных адресов CouchDB.

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

Поэтому кто-то один делает первую загрузку, дальше ПК можно выключать: телефон и ИИ берут всё с сервера. Каждое устройство держит полную копию, так что Obsidian работает и без интернета.

Почему не готовые скрипты в две команды

Я нашёл инструкцию вида wget ... && sudo bash script.sh. Скрипты скачал и прочитал. Запускать их было нельзя.

Первый скрипт, про безопасность сервера, делает ufw --force reset и сносит все правила файрвола, меняет порт SSH и перезапускает sshd, отчего легко потерять доступ, включает PasswordAuthentication yes, перезаписывает /etc/fail2ban/jail.local, так что остальные jail'ы исчезают, и ставит Docker из Ubuntu-репозитория через lsb_release -cs: на Debian это ломает apt update, а docker-ce конфликтует с docker.io.

Второй скрипт, сам Obsidian-стек, открывает порты 5984 и 8787 в интернет по голому HTTP, выдаёт клиенту Obsidian админские учётные данные CouchDB, не создаёт том для данных MCP, из-за чего индекс и OAuth-клиенты теряются при рестарте, использует тег :latest и называет MCP_AUTH_TOKEN токеном, хотя это пароль для формы OAuth.

Сам проект obsidian-sync-mcp хороший: OAuth 2.1 с PKCE, ротация refresh-токенов, защита от DNS-rebinding, timing-safe сравнение паролей. Плохи были только обёртки. Если инструкция предлагает запустить скрипт от root и не показывает, что внутри, открой и посмотри. Обычно там ничего страшного. Иногда там ufw --force reset.

Сервер

Что нужно заранее

Сервер с Debian или Ubuntu и Docker, nginx, поддомен с A-записью на сервер, certbot и свободные на loopback порты 5984 и 8787:

ss -tlnp | grep -E ':(5984|8787)\b' || echo "оба свободны"

Памяти связка ест около 400-600 МБ.

Плагин docker compose, не ломая системный Docker

Если Docker стоит из пакета docker.io, команды docker compose нет. Ставить docker-compose-plugin из репозитория Docker нельзя: он тянет docker-ce, который конфликтует с docker.io, и apt может снести работающий Docker. Правильно положить один бинарник:

VER=$(curl -s https://api.github.com/repos/docker/compose/releases/latest \
      | grep -oP '"tag_name":\s*"\K[^"]+')
mkdir -p /usr/local/lib/docker/cli-plugins
curl -fsSL "https://github.com/docker/compose/releases/download/${VER}/docker-compose-linux-$(uname -m)" \
     -o /usr/local/lib/docker/cli-plugins/docker-compose
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
docker compose version

Каталог и секреты

mkdir -p /opt/obsidian-sync-mcp && chmod 750 /opt/obsidian-sync-mcp
cd /opt/obsidian-sync-mcp

gen() { tr -dc 'A-Za-z0-9' < /dev/urandom 2>/dev/null | head -c "$1"; }
{
  echo "# Obsidian Sync MCP"
  echo "COUCHDB_USER=admin"
  echo "COUCHDB_PASSWORD=$(gen 32)"
  echo "COUCHDB_DATABASE=obsidian"
  echo "LIVESYNC_USER=livesync"
  echo "LIVESYNC_PASSWORD=$(gen 32)"
  echo "COUCHDB_PASSPHRASE=$(gen 40)"
  echo 'VAULT_NAME="Моё хранилище"'
} > .env
chmod 600 .env
Переменная Кому нужна
COUCHDB_USER / COUCHDB_PASSWORD администратор базы, знает только сервер и MCP
LIVESYNC_USER / LIVESYNC_PASSWORD ограниченный пользователь, вводится в Obsidian на устройствах
COUCHDB_PASSPHRASE ключ E2E-шифрования, одинаковый на всех устройствах и в MCP
VAULT_NAME имя хранилища для ссылок obsidian://, должно точно совпадать с именем в Obsidian

Пароли только из букв и цифр: спецсимволы ничего не добавляют к длине 32, зато ломают экранирование в URL и в .env. Конструкция tr ... | head -c под set -o pipefail валит скрипт: tr получает SIGPIPE, код 141. А VAULT_NAME с пробелами обязательно в кавычках, иначе set -a; . ./.env в bash ломается на пробеле, docker compose кавычки читает правильно.

Конфиг CouchDB

Монтируется каталог, а не одиночный файл, и на запись (почему, смотри в граблях ниже):

mkdir -p /opt/obsidian-sync-mcp/couchdb-local.d

Файл couchdb-local.d/livesync.ini:

[couchdb]
single_node = true
max_document_size = 50000000

[chttpd]
require_valid_user = true
max_http_request_size = 4294967296
enable_cors = true
bind_address = 0.0.0.0

[chttpd_auth]
require_valid_user = true

[httpd]
WWW-Authenticate = Basic realm="couchdb"
enable_cors = true
bind_address = 0.0.0.0

[cors]
; Origin'ы клиентов Obsidian: десктоп и мобильный (capacitor).
origins = app://obsidian.md,capacitor://localhost,http://localhost
credentials = true
methods = GET, PUT, POST, HEAD, DELETE
headers = accept, authorization, content-type, origin, referer, cache-control
max_age = 3600

Адрес bind_address = 0.0.0.0 действует внутри контейнера, наружу его ограничивает compose. Строка capacitor://localhost обязательна для iOS и Android, без неё мобильный Obsidian не подключится. Проверить CORS так, как это делает iPhone:

curl -s -o /dev/null -D - -X OPTIONS -H 'Origin: capacitor://localhost' \
  -H 'Access-Control-Request-Method: GET' https://obsidian.example.com/obsidian \
  | grep -i access-control-allow-origin

docker-compose.yml

name: obsidian-sync-mcp

services:
  couchdb:
    image: couchdb:3.5.2.1
    container_name: obsidian-couchdb
    restart: unless-stopped
    ports:
      - "127.0.0.1:5984:5984"
    environment:
      COUCHDB_USER: ${COUCHDB_USER}
      COUCHDB_PASSWORD: ${COUCHDB_PASSWORD:?COUCHDB_PASSWORD не задан в .env}
    volumes:
      - couchdb_data:/opt/couchdb/data
      - ./couchdb-local.d:/opt/couchdb/etc/local.d
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-u", "${COUCHDB_USER}:${COUCHDB_PASSWORD}", "http://127.0.0.1:5984/_up"]
      interval: 10s
      timeout: 5s
      retries: 12
      start_period: 20s
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }

  mcp:
    image: ghcr.io/es617/obsidian-sync-mcp:v0.6.2
    container_name: obsidian-mcp
    restart: unless-stopped
    ports:
      - "127.0.0.1:8787:8787"
    environment:
      COUCHDB_URL: http://couchdb:5984
      COUCHDB_USER: ${COUCHDB_USER}
      COUCHDB_PASSWORD: ${COUCHDB_PASSWORD}
      COUCHDB_DATABASE: ${COUCHDB_DATABASE}
      COUCHDB_PASSPHRASE: ${COUCHDB_PASSPHRASE}
      VAULT_NAME: ${VAULT_NAME}
      BASE_URL: http://127.0.0.1:8787
      DATA_DIR: /data
    volumes:
      - mcp_data:/data
    depends_on:
      couchdb:
        condition: service_healthy
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }

volumes:
  couchdb_data:
  mcp_data:

Три принципиальных момента: 127.0.0.1: перед каждым портом, закреплённые версии вместо :latest, том mcp_data вместе с DATA_DIR, иначе индекс и OAuth-клиенты теряются при рестарте.

docker compose config --quiet && echo "конфиг валиден"
docker compose up -d && docker compose ps

База и ограниченный пользователь

Клиентам Obsidian админа не давать: логин лежит на телефоне и ноутбуке, это самое вероятное место утечки.

cd /opt/obsidian-sync-mcp && set -a; . ./.env; set +a
A="http://${COUCHDB_USER}:${COUCHDB_PASSWORD}@127.0.0.1:5984"

for db in _users _replicator "$COUCHDB_DATABASE"; do
  curl -s -o /dev/null -w "$db → %{http_code}\n" -X PUT "$A/$db"   # 412 = уже есть
done

curl -s -X PUT "$A/_users/org.couchdb.user:${LIVESYNC_USER}" -H 'Content-Type: application/json' \
  -d "{\"name\":\"${LIVESYNC_USER}\",\"password\":\"${LIVESYNC_PASSWORD}\",\"roles\":[],\"type\":\"user\"}"

curl -s -X PUT "$A/${COUCHDB_DATABASE}/_security" -H 'Content-Type: application/json' \
  -d "{\"admins\":{\"names\":[],\"roles\":[\"_admin\"]},\"members\":{\"names\":[\"${LIVESYNC_USER}\"],\"roles\":[]}}"

Права livesync проверяются так: своя база даёт 200, _all_dbs даёт 401 или 403, создание базы тоже 401 или 403, аноним получает 401.

Запомнить. Документ _security хранится внутри базы. Если базу удалить и создать заново, а плагин именно так делает при первой загрузке, права сбросятся к "только админы". Сохрани _security заранее и верни потом.

Переменная LIVESYNC_USER в docker-compose.yml проекта не обрабатывается, она живёт только в entrypoint для Fly.io, поэтому пользователя создаём руками.

nginx и TLS

Порядок важен: сначала HTTP-vhost, reload, потом certbot. Если в nginx есть default_server с return 444, запрос к новому домену обрывается, и ACME-проверка падает с загадочным "HTTP 000".

Сначала временный vhost, в котором открыт только /.well-known/acme-challenge/ из /var/www/html, остальное отдаёт 404. Проверка:

echo acme-ok > /var/www/html/.well-known/acme-challenge/probe
curl -s http://obsidian.example.com/.well-known/acme-challenge/probe

Сертификат через --webroot, чтобы certbot не правил конфиги nginx:

certbot certonly --webroot -w /var/www/html -d obsidian.example.com \
  --non-interactive --agree-tos --keep-until-expiring

Боевой vhost:

server {
    listen 80;
    listen [::]:80;
    server_name obsidian.example.com;
    location /.well-known/acme-challenge/ { root /var/www/html; }
    location / { return 301 https://$host$request_uri; }
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name obsidian.example.com;

    ssl_certificate     /etc/letsencrypt/live/obsidian.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/obsidian.example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_session_tickets off;
    add_header Strict-Transport-Security "max-age=31536000" always;

    # LiveSync шлёт документы пачками; лимит документа CouchDB 50 МБ.
    client_max_body_size 128M;

    access_log /var/log/nginx/obsidian.access.log;
    error_log  /var/log/nginx/obsidian.error.log;

    # Админка и служебные адреса наружу не нужны.
    location /_utils         { deny all; }
    location = /_all_dbs     { deny all; }
    location /_users         { deny all; }
    location /_node          { deny all; }
    location /_cluster_setup { deny all; }

    location / {
        proxy_pass http://127.0.0.1:5984;
        proxy_http_version 1.1;
        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;
        # /_changes висит долгоживущими запросами.
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
        proxy_buffering off;
        proxy_request_buffering off;
    }
}

У строки location /_node { deny all; } есть важное следствие: проверка сервера в мастере плагина читает /_node/_local/_config и всегда будет падать. Это нормально, подробности ниже. Отдельные логи для сайта удобны, по ним потом и шла вся диагностика клиентов.

Дальше nginx -t && systemctl reload nginx каждый раз. Если конфиг сломан, работающий nginx держит старую конфигурацию, но при следующем рестарте не поднимется и утянет все сайты на сервере.

Deploy-хук /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh, чтобы nginx перечитывал продлённый сертификат:

#!/bin/sh
set -e
if ! nginx -t 2>/dev/null; then
    echo "reload-nginx: конфиг не проходит проверку, reload пропущен" >&2
    exit 0
fi
systemctl reload nginx

И потом certbot renew --dry-run.

Проверки сервера

HTTPS с логином livesync даёт 200, без пароля 401, /_utils/ 403, HTTP редиректит 301. Порты 5984 и 8787 снаружи закрыты:

for p in 5984 8787; do timeout 6 bash -c "</dev/tcp/ВНЕШНИЙ_IP/$p" 2>/dev/null \
  && echo "$p ОТКРЫТ" || echo "$p закрыт"; done

MCP отвечает на initialize, а с подменённым Host: evil.example.com даёт 403. И в базе нет открытого текста заметок.

Грабли сервера

CouchDB молча падает, если ini смонтирован в режиме :ro. Контейнер перезапускается, код 1, docker logs пустой. Entrypoint делает chown по /opt/couchdb под set -e, а на read-only он не проходит.

CouchDB пишет в свой конфиг: дописывает uuid, secret и создаёт docker.ini с хешем пароля админа. Каталог конфигов содержит секреты, в git его нельзя. Если монтировать одиночный файл, хеш пропишется прямо в него.

Docker публикует порты мимо UFW. Если iptables -S DOCKER-USER показывает только -j RETURN, то ports: "5984:5984" открывает базу всему интернету, а ufw status будет показывать "закрыто". Отсюда 127.0.0.1: в каждой публикации.

Без тома DATA_DIR у MCP при каждом up теряются индекс и OAuth-регистрации, ИИ-клиент получает "Unknown client". И ещё: MCP_AUTH_TOKEN это пароль, а не bearer-токен, он вводится один раз в браузере в форме OAuth.

Бэкап и проверка восстановления

Всё это сделано до подключения устройств.

Скрипт /usr/local/bin/obsidian-backup.sh с правами 700:

#!/bin/bash
set -euo pipefail
umask 077

cd /opt/obsidian-sync-mcp
set -a; . ./.env; set +a

DEST=/var/backups/obsidian
DAY=$(date +%F)
mkdir -p "$DEST"; chmod 700 "$DEST"

# Логин передаём curl через stdin (-K -), чтобы он не светился в списке процессов.
couch() {
  printf 'user = "%s:%s"\n' "$COUCHDB_USER" "$COUCHDB_PASSWORD" \
    | docker exec -i obsidian-couchdb curl -fsS -K - "http://127.0.0.1:5984/$1"
}

fail() { logger -t obsidian-backup -p user.err "FAILED: $*"; echo "obsidian-backup: $*" >&2; exit 1; }
trap 'fail "line $LINENO"' ERR

TMP=$(mktemp "$DEST/.tmp-XXXXXX")
trap 'rm -f "$TMP"' EXIT

couch "${COUCHDB_DATABASE}/_all_docs?include_docs=true" | gzip > "$TMP"
ROWS=$(zcat "$TMP" | jq -e '.rows | length') || fail "dump is not valid JSON"
[ "$ROWS" -gt 0 ] || fail "dump has no rows"
mv "$TMP" "$DEST/obsidian-$DAY.json.gz"

# Права базы и пользователь livesync: без них восстановленная база не примет клиентов.
couch "${COUCHDB_DATABASE}/_security" > "$DEST/security-$DAY.json"
couch "_users/org.couchdb.user:${LIVESYNC_USER}" > "$DEST/livesync-user-$DAY.json"

find "$DEST" -maxdepth 1 -type f \( -name 'obsidian-*.json.gz' -o -name 'security-*.json' \
  -o -name 'livesync-user-*.json' \) -mtime +30 -delete

logger -t obsidian-backup "OK: $ROWS docs -> $DEST/obsidian-$DAY.json.gz"

Чем он отличается от наивного curl | gzip. Связка curl -fsS и pipefail роняет скрипт при ошибке CouchDB, вместо того чтобы сохранить пустой файл. Временный файл и проверка rows > 0 не дают битому дампу затереть последний хороший. Рядом сохраняются _security и пользователь livesync с хешем, а не паролем, и это пригодилось уже через час, когда база пересоздалась. Логин уезжает в curl -K -, а не в URL, поэтому его не видно в ps. Результат идёт в syslog, читается через journalctl -t obsidian-backup.

Cron /etc/cron.d/obsidian-backup гоняет скрипт раз в сутки ночью от root. Внеплановый бэкап это просто запуск скрипта, и делать его стоит перед каждым рискованным действием.

Бэкап, который ни разу не разворачивали, это не бэкап. Восстанавливаем в тестовую базу:

set -a; . ./.env; set +a
c() { printf 'user = "%s:%s"\n' "$COUCHDB_USER" "$COUCHDB_PASSWORD" \
      | docker exec -i obsidian-couchdb curl -sS -K - "$@"; }
T=obsidian_restore_test; U=http://127.0.0.1:5984
c -X PUT "$U/$T"
zcat /var/backups/obsidian/obsidian-YYYY-MM-DD.json.gz \
  | jq -c '{docs: [.rows[].doc], new_edits: false}' \
  | docker exec -i obsidian-couchdb sh -c 'cat > /tmp/restore.json'
c -X POST -H 'Content-Type: application/json' --data-binary @/tmp/restore.json "$U/$T/_bulk_docs"
docker exec obsidian-couchdb rm -f /tmp/restore.json
c "$U/$T" | jq .doc_count     # должен совпасть с боевой базой
c -X DELETE "$U/$T"

Мелочи по ходу: _bulk_docs с new_edits:false при успехе отвечает []; stdin у curl занят конфигом -K -, поэтому тело кладём файлом внутрь контейнера; _all_docs не отдаёт _local-документы, это нормально. Полная проверка будет после первого устройства, когда станет видно, что заметки расшифровываются той же passphrase.

Главное про бэкап: дамп зашифрован passphrase. Passphrase хранить отдельно от сервера, в менеджере паролей, можно ещё бумажную копию. Бэкап рядом с .env на одном диске это единая точка отказа, копия за пределы сервера остаётся отдельным шагом.

Как перенести сложные пароли на телефон

Пароли по 32-40 случайных символов вручную на iPhone не набрать. Сохранять их надо в менеджер паролей. На iPhone есть встроенное приложение "Пароли" (iOS 18 и новее): бесплатно, синхронизация через iCloud Keychain со сквозным шифрованием, есть на Mac и Windows. Если основной компьютер на Windows или Linux, подойдёт Bitwarden. Сохранить стоит COUCHDB_PASSPHRASE (самое важное, не восстанавливается), пару LIVESYNC_USER и LIVESYNC_PASSWORD для входа с устройств и COUCHDB_PASSWORD для восстановления сервера.

Переношу я их QR-кодами. Маленький скрипт на сервере читает .env и рисует по картинке на ключ. Отдельное окружение Python лежит в каталоге проекта (tools/.venv), а не в системе: там segno для QR и Pillow для подписи, зависимости в tools/requirements.txt. В QR кладётся только значение, чтобы при сканировании копировался чистый пароль без имени, а имя переменной идёт подписью над кодом; для варианта KEY=value есть опция --with-name. Картинки лежат в каталоге с правами 700, файлы 600, ключ --clean удаляет их после сканирования. Скрипт печатает только пути к картинкам, значения никуда не выводит. Дальше камера iPhone, жёлтая подпись, "Скопировать" и вставка в запись "Паролей".

Если работаешь с ИИ-ассистентом в редакторе. В VS Code с расширением Claude выделение текста автоматически уходит ассистенту в контекст. Выделил строку в .env, чтобы скопировать, и секрет уже в переписке. Копируй без выделения мышью: курсор после =, Shift+End, Ctrl+C, и сразу снять выделение. А самому ассистенту закрыть чтение .env в настройках прав.

Комментарии

Пока никто не написал. Будьте первым.