Files
local_machine/docs/apps/joplin/README.md

85 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Joplin — локальный синк Mac ↔ телефон (WebDAV, без Docker)
Синхронизация через **rclone WebDAV** только в локальной сети. Данные на Mac в `~/JoplinSync`. Облака Joplin/Dropbox не используются.
---
## Быстрый старт (Mac)
```bash
brew install rclone # если ещё нет
chmod +x ./docs/apps/joplin/scripts/joplin-webdav-*.sh
./docs/apps/joplin/scripts/joplin-webdav-install.sh
```
Показать URL и статус:
```bash
./docs/apps/joplin/scripts/joplin-webdav-status.sh
```
Учётка: `~/.config/joplin-webdav/env` (права `600`, **не коммитить**).
Остановка / запуск:
```bash
./docs/apps/joplin/scripts/joplin-webdav-stop.sh
./docs/apps/joplin/scripts/joplin-webdav-serve.sh
```
**После смены пароля в `~/.config/joplin-webdav/env`** — обязательно перезапуск (иначе rclone держит старый пароль → **401**):
```bash
./docs/apps/joplin/scripts/joplin-webdav-reload.sh
```
Пароль в Joplin на телефоне и Mac должен **совпадать с `JOPLIN_WEBDAV_PASS` в env**, не со старым из установки.
Автозапуск при входе: LaunchAgent `com.eternal.joplin-webdav` (ставится install-скриптом).
---
## Настройка Joplin (Mac и телефон)
1. **Настройки → Синхронизация**
2. Внизу: **Self-hosting → Click here to select one**
3. **WebDAV**
4. Заполнить:
| Поле | Значение |
|------|----------|
| WebDAV URL | **Mac:** `http://127.0.0.1:8080` · **Телефон:** `http://10.219.227.100:8080` (статический IP на Mac — [STABLE_SETUP](../../connectivity/apps/joplin/STABLE_SETUP.md)) |
| Логин | `joplin` |
| Пароль | из `~/.config/joplin-webdav/env``JOPLIN_WEBDAV_PASS` |
5. **Проверить конфигурацию синхронизации** → OK → синхронизировать.
**Важно:** Mac и телефон в **одной сети** (хотспот телефона). URL с `http://`, не `https://`. Без слэша в конце URL.
Опционально: **Настройки → Шифрование** — E2EE (мастер-пароль), на сервере только шифротекст.
---
## Приватность
- Заметки на телефоне — в песочнице **Joplin**, не «доступ ко всем файлам».
- WebDAV слушает `0.0.0.0:8080` только пока запущен rclone; не открывайте порт в интернет.
- При включённом фаерволе macOS разрешите вход для **rclone** или порта **8080** в локальной сети.
---
## Если не коннектится с телефона
1. `./docs/apps/joplin/scripts/joplin-webdav-status.sh` — процесс и IP.
2. На телефоне в браузере: `http://IP_MAC:8080` (может запросить логин — значит сеть доходит).
3. Синк сломался — [RUNBOOK](../../connectivity/apps/joplin/RUNBOOK.md); стабильная схема без смены URL — [STABLE_SETUP](../../connectivity/apps/joplin/STABLE_SETUP.md).
4. Логи: `~/Library/Logs/joplin-webdav/`
---
## Связанное
- **[Runbook: синк сломался (хотспот, логи, ETIMEDOUT)](../../connectivity/apps/joplin/RUNBOOK.md)**
- [Anytype (P2P, без WebDAV)](../anytype/README.md)
- [diagnose-phone-usb-mac.sh](../anytype/scripts/diagnose-phone-usb-mac.sh) — если понадобится USB