コミュニティソリューション

CasaOSでObsidianのセルフホスト型LiveSyncを設定:CouchDB、HTTPS、同期の安全性

A March 2025 CasaOS post linking to an external Big Bear tutorial for Obsidian Self-hosted LiveSync. The forum body does not preserve the actual Compose configuration, so a durable page must keep the historical source while using current upstream LiveSync/CouchDB guidance.

元のフォーラム投稿は、完全なデプロイ記録ではなく、概要紹介と外部チュートリアルへのリンクです。Obsidian Self-hosted LiveSync の CasaOS への簡単なセットアップを紹介していますが、投稿自体には、元の動画で使用された CouchDB イメージ、ボリュームパス、認証情報、HTTPS 設定、クライアント設定は保存されていません。

現在のインストールでは、技術的な基準として、メンテナンスされている Self-hosted LiveSync プロジェクトを使用してください。上流のセットアップでは、引き続き CouchDB が中心となっており、Docker、永続的な CouchDB のデータと設定、HTTPS による公開、Obsidian クライアントを設定するためのセットアップ URI が明確に説明されています。

CasaOSでObsidian Self-hosted LiveSyncを実行するBig Bearチュートリアルのサムネイル
このコミュニティ投稿は、デプロイ設定をフォーラム自体に保存するのではなく、主にこの外部の2025年のチュートリアルを案内しています。

Self-hosted LiveSync は Obsidian アプリ自体ではなく、同期レイヤーです

Obsidian は引き続き、デスクトップまたはモバイルデバイスにインストールします。Self-hosted LiveSync は、コミュニティ製の同期プラグインとサーバー側データベースを追加し、Obsidian の有料 Sync サービスに依存せずに、デバイス間で保管庫の変更を同期できるようにします。

上流プロジェクトはコミュニティ製ソフトウェアであり、公式の Obsidian サービスではありません。

CouchDB が中核となるサーバーコンポーネントです

現在の上流セットアップガイドでは、主要なセルフホスト型バックエンドとして CouchDB を使用しています。Docker の例では、コンテナを起動する前に、CouchDB のデータと設定の両方について永続ディレクトリを作成します。

動画に登場する古いイメージタグをそのままコピーするのではなく、現在の Self-hosted LiveSync サーバーセットアップを使用してください。

使い捨てコンテナの外部に CouchDB データベースを永続化します

データベースには、ノートの同期された内容と関連する状態が保存されます。コンテナを作り直しても同期バックエンドが消去されないよう、CouchDB のデータディレクトリと設定ディレクトリを CasaOS の永続ストレージにマッピングしてください。

これらのフォルダーは、通常の一時的な Docker レイヤーとは分けてください。

一意の CouchDB 認証情報を使用します

チュートリアルに記載されたサンプルのユーザー名やパスワードをそのまま使用しないでください。強力で一意の CouchDB 管理者認証情報を作成し、スクリーンショット、共有 Compose ファイル、公開フォーラム投稿に含めないでください。

認証情報が漏えいした場合は、直ちに変更し、外部から到達可能な CouchDB インスタンスを確認してください。

リモート同期には HTTPS を使用します

複数のデバイスを LAN 外で同期する必要がある場合は、HTTP をインターネットに直接公開するのではなく、安全な HTTPS 経路を通じて CouchDB を公開してください。上流のドキュメントには、リバースプロキシの例とドメイン設定が含まれています。

自分のデバイスだけがアクセスする場合は、VPN やオーバーレイネットワークも選択肢になります。

CORS と Origin の設定をクライアントのワークフローに合わせます

サーバーに到達できる場合でも、CouchDB のセキュリティ設定によってブラウザーや WebView からのリクエストがブロックされることがあります。Self-hosted LiveSync のセットアップ手順では、ポート 5984 が開いた時点で汎用データベースコンテナの設定が完了したとみなすのではなく、必要な CouchDB の動作を設定します。

セットアップ URI は慎重に扱います

現在の上流ガイダンスでは、別の Obsidian デバイスが接続設定をインポートできるセットアップ URI を生成できます。この URI には、機密性の高い接続情報が含まれる場合があります。

パスワードと同様に扱い、自分が信頼できるデバイスにのみ送信してください。また、他人がアクセスできるスクリーンショットやチャット履歴に掲載しないでください。

リアルタイム同期によって編集の競合がなくなるわけではありません

ほぼ同時に 2 台のデバイスで同じノートを編集すると、競合が発生したり、調整が必要になったりする場合があります。セルフホスティングによってサーバーを管理できるようになりますが、分散編集が単一書き込みのファイルシステムになるわけではありません。

重要なノートの唯一のコピーを移行する前に、使い捨ての保管庫でワークフローをテストしてください。

同期はバックアップではありません

ノートを削除し、その削除がすべてのクライアントに同期された場合、同期システムは役割を果たしたことになります。Obsidian の保管庫と、必要に応じて CouchDB のデータについて、独立した世代管理バックアップを保持してください。

これにより、誤削除、プラグインの不具合、データベースの破損、誤った一括編集から保護できます。

元の内容は CasaOS 固有です

過去のチュートリアルは CasaOS を対象としていました。ホストが現在 ZimaOS である場合は、同じ CasaOS のパッケージレイアウトを前提にせず、現在の ZimaOS App Store/Compose ワークフローと現在のストレージパスを使用してください。

Obsidian LiveSync に関する FAQ

元のフォーラム投稿には完全な Compose 設定が含まれていますか?

いいえ。主に外部の Big Bear チュートリアルへのリンクを掲載しています。

現在の Self-hosted LiveSync が案内しているバックエンドは何ですか?

現在の上流セットアップでは CouchDB を使用し、Docker によるデプロイ手順を提供しています。

セルフホスト型同期によってバックアップは不要になりますか?

いいえ。削除や誤った編集も同期される可能性があるため、保管庫の独立したバックアップを保持してください。