Свой сервер синхронизации 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в настройках прав.
Комментарии
Пока никто не написал. Будьте первым.