SilverBullet セルフホストノート構築ガイド｜ハック可能なノート

SilverBullet とは：ハック可能なノートアプリの新たな潮流

近年、デジタルノートの世界において「所有権」と「拡張性」を重視する動きが顕著になってきています。その中心に位置するのが、TypeScript と Deno を基盤として開発された SilverBullet です。SilverBullet は単なるメモ帳やテキストエディタではなく、ユーザー自身がコードを通じて機能を拡張できる「ハック可能なノートアプリ」として設計されています。バージョン 0.10 以降では、特にセルフホスト環境での運用が強化され、ローカルサーバー上で完結する完全なプライベートノートを構築することが可能になりました。これは、クラウドサービスに依存しないため、データのプライバシーを完全に保証しつつ、かつ高度な自動化を可能にするという画期的なアプローチです。

従来のノートアプリは、特定のベンダーのクラウド上にデータが保存されるケースが多く、サービス終了や価格改定によって運用が脅かされるリスクがありました。SilverBullet はこれに対し、Docker コンテナや Deno ランタイムを使用してユーザー自身がサーバーを管理するモデルを採用しています。これにより、サーバーリソースの最適化、ネットワーク設定のカスタマイズ、セキュリティポリシーの厳格な適用などが、利用者の裁量で行えます。また、Markdown ベースであるため、テキストファイルとして保存されるデータは将来的にも可読性を保ちます。これはデータエクスポートを容易にし、ベンダーロックインからの解放を意味します。

SilverBullet の最大の特徴は、その「ハック可能性」にあります。標準的な機能に加え、Space Script という独自のスクリプト言語（JavaScript/TypeScript 互換）を使用して、アプリの動作や UI を変更できる点が挙げられます。例えば、特定のタグがついたページには自動的に付与される装飾を定義したり、タスク管理機能を強化したりすることが可能です。また、ブラウザアプリケーションとして PWA（Progressive Web App）に対応しているため、オフライン環境でもノートにアクセスでき、インストール型アプリのような使い勝手を提供します。これにより、クラウド依存の不安定さや通信制限を気にすることなく、生産性の高いノート環境を構築することが可能になります。

セルフホストで得られるメリットとデータセキュリティ

セルフホスト型のノートアプリを導入する最大の理由は、データの完全な所有権と管理権限をユーザーが持つことができる点にあります。SilverBullet を自社のサーバーや VPS（Virtual Private Server）、あるいは自宅の NAS 上で運用することで、外部サービスプロバイダーに依存することなくデータを保持できます。クラウドベースのノートアプリでは、利用規約の変更やサービス停止のリスクが常に付きまといますが、セルフホストであればこれらの懸念を完全に排除できます。さらに、サーバー設定次第で、ローカルネットワーク内のみでのアクセス制限や、特定の IP アドレスからの接続許可など、きめ細やかなセキュリティ制御が可能になります。

データセキュリティの観点においても、SilverBullet のセルフホスト環境は極めて堅牢です。標準的な Docker コンテナ化により、アプリの依存関係が隔離され、システム全体への影響を最小限に抑えることができます。また、リバースプロキシ（Caddy や Traefik など）を導入することで、SSL/TLS 暗号通信を容易に設定可能です。これにより、インターネット経由でノートにアクセスする場合でも、通信経路の盗聴や改ざんを防ぐことができます。さらに、Basic Auth による簡易認証から OAuth（Google や GitHub 連携など）による高度な認証まで幅広くサポートしており、セキュリティレベルに応じて選択できます。

パフォーマンスとリソース効率についても、SilverBullet は軽量設計となっています。Deno ランタイムを採用しているため、Node.js に比べて起動が高速で、メモリ使用量が抑えられる傾向にあります。一般的な VPS（例：1GB RAM, 1CPU コア）でも十分に動作し、複数のユーザーや高負荷なノートを処理するケースでも安定した動作を維持します。ただし、同期機能として Git や Syncthing を利用する場合、リポジトリのサイズが膨大になる可能性があるため、定期的なメンテナンスやバックアップ戦略が重要となります。セルフホスト環境では、これらの運用コストと引き換えに、完全なカスタマイズ性とセキュリティを手に入れることができるのです。

構築環境の準備：Docker Compose の基本設定

SilverBullet を導入する際、最も一般的で推奨される方法は Docker Compose を使用したデプロイです。Docker はアプリケーションとその依存関係をパッケージ化して実行できるプラットフォームであり、OS やハードウェアの違いに影響されない環境構築を可能にします。まず、準備すべき環境として、Docker Engine と Docker Compose プラグインがインストールされた Linux サーバー（Ubuntu 20.04/Debian 11 以降推奨）が必要です。サーバーの OS が古すぎるとセキュリティアップデートが適用されなくなるため、最新 LTS バージョンを使用することが望ましいです。また、サーバーに Caddy または Traefik のリバースプロキシを別途用意するか、SilverBullet コンテナ内で動作させるかを選択する必要がありますが、セキュリティ上の理由から外部リバースプロキシの推奨が高まっています。

Docker Compose を使用することで、複数のコンテナ（アプリ本体、データベース、ストレージ等）を一つの YAML ファイルで定義し、ワンストップで立ち上げることができます。設定ファイルは docker-compose.yml として保存され、環境変数を用いてポート番号や認証情報を柔軟に管理できます。例えば、SilverBullet のポートをホスト側の 8080 から外部アクセス用に変更する場合、コンテナの設定を変更するだけで済みます。また、データの永続化のために Docker Volume を使用し、コンテナを再起動または削除してもノートデータが消失しないように設定します。これにより、サーバーの再構築時でもデータを引き継ぎやすくなります。

準備段階では、サーバー側のファイアウォール設定も重要です。通常、SilverBullet は HTTP 80 または HTTPS 443 ポートで動作しますが、Docker コンテナ内部でのポート公開（Port Mapping）によってホスト側と通信します。例えば、コンテナ内の 8080 ポートをホストの 8080 にマッピングする場合、ファイアウォールでこのポートへの入力を許可する必要があります。ただし、リバースプロキシを使用する場合は外部からのアクセスをリバースプロキシに集約し、SilverBullet コンテナ内部にはローカルループバックのみで接続させる設定が推奨されます。これにより、直接インターネットからコンテナ内部へアクセスするリスクを回避できます。また、Docker のバージョンは 24.0 以降を使用し、セキュリティパッチの適用状況を確認しておくことが推奨されます。

SilverBullet のインストール手順：Deno と Docker の選択

SilverBullet のインストールには、主に Docker イメージを利用する方法と、Deno ランタイムを直接利用する方法があります。初心者から中級者レベルの方には、圧倒的に Docker によるデプロイが推奨されます。これは環境構築の手間が省け、バージョン管理やロールバックが容易であるためです。まず、公式の GitHub リポジトリまたは Docker Hub から SilverBullet のイメージをプルします。最新の安定版はバージョン 0.10 以上であり、特に 0.12 以降では PWA 機能と同期機能が強化されています。Docker Compose を使用する場合は、以下の基本構成を持つ YAML ファイルを作成し、docker compose up -d コマンドで起動します。

version: '3.8'
services:
  silverbullet:
    image: silverbulletmd/silverbullet:latest
    container_name: silverbullet
    restart: always
    ports:
      - "8080:80"
    volumes:
      - ./data:/root/notes
    environment:
      - PUBLIC_URL=http://localhost:8080

この設定では、ホスト側の ./data ディレクトリをコンテナ内の /root/notes にマッピングしています。これにより、ノートデータはホスト上のファイルとして保存され、バックアップやエクスポートが容易になります。また、PUBLIC_URL 環境変数は、サーバーの URL をアプリに認識させるために必須です。もし Docker イメージの直接実行ではなく、Deno をインストールして実行する場合は、deno run --allow-net --allow-read --allow-write=https://silverbullet.md https://silverbullet.md/silver_bullet.ts のようなコマンドを使用します。しかし、この方法は環境依存が多く、サーバー管理の経験が浅い方には Docker 方式の方が安定しています。

インストール後の初期設定では、認証機能の有効化と同期先の設定を行います。SilverBullet はデフォルトでオープンアクセス可能ですが、セルフホスト運用においてこれは危険です。config.md ファイルを作成し、認証ポリシーを定義します。例えば auth: basic とすることでパスワード認証が有効化され、ブラウザからノートにアクセスする際にログイン画面が表示されます。また、初期のデータ構造として、ページ名とファイル名のマッピングルールを確認しておきます。SilverBullet は Markdown ファイルを直接読み込むため、フォルダ構成がそのまま URL パスに変換される仕組みになっています。この挙動を理解しておくことで、後のファイル管理で混乱を防げます。

Space Script で自在に拡張する仕組みと開発

Space Script は SilverBullet の核となる機能であり、JavaScript や TypeScript を使用してアプリの動作をカスタマイズするためのスクリプト言語です。これにより、ユーザーは既存の機能を超えて、独自のワークフローや UI 要素を追加できます。例えば、「特定のタグを持つページを表示するリスト」を作成したり、タスクの完了状態を自動で更新したりすることが可能です。開発環境は特に用意せず、ブラウザ上のエディタ内で直接コードを書いて保存するだけで即時反映されます。これは、従来のプラグインシステムのようにビルドやインストール手順を必要としないため、非常にアクセシビリティが高いと言えます。

Space Script の主要な機能には、Page Decorations（ページ装飾）、Slash Commands（スラッシュコマンド）、Template Engine（テンプレートエンジン）などがあります。Page Decorations を使用すると、Markdown ファイル内の特定の記述に基づいて、そのページの表示スタイルを動的に変更できます。例えば、重要なタスクには赤い背景色をつけるといった装飾が可能です。また、Slash Commands により、テキスト入力時に / キーを押すとメニューが表示され、そこからコマンドを実行できるインターフェースを提供します。これらを組み合わせることで、Obsidian のプラグインや Logseq のブロック機能に近い、あるいはそれ以上の柔軟性を SilverBullet で実現できます。

開発の効率化を図るため、Space Script には豊富な API が用意されています。例えば、page.get() を使用して現在のページ情報を取得したり、db.query() を使ってデータベース検索を実行したりすることが可能です。また、外部 API と連携してデータを同期することも可能で、Todoist や Notion のデータを SilverBullet 上に表示させるなどの活用も考えられます。ただし、Space Script はブラウザ上で実行される JavaScript であるため、セキュリティの観点から制限が設けられています。ファイルシステムへのアクセスは明示的な権限許可が必要であり、無限ループやリソース枯渇を防ぐための制限もあります。開発時には、これらの制約を理解した上で安全なスクリプト設計を行うことが重要です。

主要機能の徹底解説：Markdown、Live Preview、Slash Commands

SilverBullet は Markdown ベースのノートアプリとして設計されており、標準的なマークアップ記法をフルサポートしています。これにより、見出し、リスト、リンク、テーブルなどの基本的なドキュメント作成がスムーズに行えます。また、MathJax や Mermaid 図などの拡張機能もネイティブでサポートしており、数式やフローチャートの記述が可能です。これは、技術文書や構造化されたメモを作成する際に非常に有用です。特に SilverBullet は Live Preview（ライブプレビュー）機能を強力に実装しており、エディタ上で Markdown を編集すると同時に、レンダリングされた結果をリアルタイムで確認できます。これにより、コードとプレビューの切り替えによるストレスが大幅に軽減されます。

Slash Commands は、テキスト入力時の生産性を向上させる重要な機能です。ユーザーは / キーを入力すると、利用可能なコマンドの一覧が表示され、そこからタスク作成、リンク挿入、タグ付けなどの操作を即座に行えます。例えば、/task [ ] 明日のタスク と入力することで、完了状態付きのチェックボックス付きリストアイテムが即座に生成されます。また、ユーザー自身が Space Script でカスタムコマンドを作成することも可能であり、自分の作業フローに最適化されたショートカットを実装できます。これにより、標準的なテキストエディタの機能を凌駕する、注釈やメタデータを入力する体験を提供します。

PWA（Progressive Web App）としての機能も SilverBullet の大きな特徴です。ブラウザの「インストール」ボタンを押すことで、デスクトップアプリのように起動し、タブバーに固定できます。オフライン環境下でも動作可能であり、キャッシュされたデータをローカルで処理して後ほど同期するという仕組みを持っています。これにより、飛行機内や通信状況の悪い場所でもノートを作成・閲覧することが可能です。ただし、完全なオフライン動作を保証するためには、ブラウザのストレージ容量を考慮する必要があります。また、PWA としてインストールすることで、通知機能を活用し、タスクの期限をアラートとして受け取ることも可能になります。

セキュリティと同期戦略：リバースプロキシ、認証、Git/Syncthing

セルフホスト環境におけるセキュリティ強化には、リバースプロキシの使用が不可欠です。SilverBullet 自体は HTTP サーバーですが、直接インターネットに公開すると SSL/TLS 設定やドメイン管理をユーザーが行う必要があります。しかし、Caddy や Traefik などのリバースプロキシを使用することで、自動的な SSL証明書発行（Let's Encrypt）と HTTPS 化が容易に行えます。例えば、Caddy を使用すれば Caddyfile にドメイン名を記述するだけで、TLS 設定が自動的に完了します。これにより、通信経路の暗号化が保証され、中間者攻撃からの防御が可能になります。また、リバースプロキシ側でレート制限や IP 制限を設定することで、DDoS 攻撃への耐性を高めることも可能です。

認証機能については、Basic Auth から OAuth まで幅広く対応しています。基本的には config.md でパスワード設定を行うだけで Basic Auth が有効化されますが、より高度な管理を行う場合は OAuth プロバイダー（Google, GitHub, GitLab など）との連携が可能です。OAuth を使用すると、SSO（シングルサインオン）環境でノートのアクセス権限を一元管理できます。例えば、企業内で G Suite 管理者として運用している場合、社員のアカウントで SilverBullet にログインさせることで、ユーザー追加や削除を一元化できます。また、認証情報の保存場所についても、サーバー側で暗号化して保存する設定が可能であり、パスワード漏洩のリスクを低減します。

データ同期については、Git と Syncthing の 2 つが主要な選択肢です。Git を使用する場合、ノートディレクトリを Git リポジトリとして管理し、リモートリポジトリ（GitHub, GitLab, Gitea など）とプッシュ・プルを行う形式になります。これにより、変更履歴の追跡やバージョン管理が可能であり、万が一のトラブル時に過去のバージョンにロールバックできます。一方、Syncthing は P2P 同期ツールとして機能し、複数のデバイス間でリアルタイムにファイル同期を行います。Git に比べて設定が簡易で、大容量データの同期にも向いていますが、衝突解決には注意が必要です。用途に応じて使い分けるか、両者を併用することで、バージョン管理と多環境同期のメリットを享受できます。

競合アプリとの比較：Obsidian、Logseq、Trilium Next との違い

SilverBullet を導入する際、比較検討すべき主要な競合アプリとして Obsidian、Logseq、Trilium Next、Outline が挙げられます。これらはいずれも優れたノートアプリですが、アーキテクチャや設計思想に明確な違いがあります。Obsidian はローカルベースでプラグイン生態系が非常に豊富ですが、コア機能の拡張には Community Plugins への依存度が高いです。一方、SilverBullet は最初から Docker と Space Script を組み合わせたネイティブな拡張性を備えており、環境構築からカスタマイズまで一貫した体験を提供します。以下に主要な機能を比較します。

Obsidian はプラグインの数が圧倒的に多く、ユーザーが作った機能を利用できます。しかし、プラグインごとの依存関係管理や更新頻度によっては動作不安定になるリスクがあります。SilverBullet は Space Script の一貫性により、アプリ内部で完結した拡張が可能です。Logseq はブロックベースのアウトラインノートとして優れていますが、Markdown ファイルとしての扱いに慣れが必要です。Trilium Next は階層構造とデータベース機能が強力ですが、学習コストが高くなります。Outline はチームコラボレーションに適していますが、セルフホスト設定がやや複雑です。各アプリの特性を理解し、自分のワークフローに最も適合するものを選ぶことが重要です。

実運用での活用事例とテンプレート活用法

SilverBullet の実運用では、テンプレート機能を活用して業務効率を劇的に向上させることができます。例えば、プロジェクト管理用のテンプレートを作成しておき、新しいタスク作成時に呼び出すことで、標準的な書式を自動で生成できます。これには Space Script を使用し、テンプレートのプレースホルダー（{{date}}, {{task_title}} など）を動的に置換するロジックを実装します。また、ページ装飾機能を用いて、重要なプロジェクトのページには目印となるバッジを表示させることも可能です。これにより、多数のノートの中から優先度の高いタスクを視覚的に判別しやすくなります。

タスク管理においては、Slash Commands と Space Script を組み合わせてカスタムワークフローを作成できます。例えば、「今朝の朝礼メモ」を作成する際 /morning_meeting コマンドを実行すると、日付、参加者リスト、アジェンダ項目が自動で挿入されます。さらに、期限が近いタスクのみを強調表示するルールを Page Decorations で定義することで、優先順位の管理も支援できます。このような運用により、手動でのフォーマット記述時間が削減され、思考に集中できる環境が整います。

データエクスポートとバックアップ戦略も実運用では重要です。SilverBullet のデータは純粋な Markdown ファイルとして保存されるため、Git を利用してリモートリポジトリへプッシュするだけでなく、ZIP アーカイブや PDF エクスポートも可能です。定期的なスクリプト実行により、特定のフォルダ内のすべてのページを HTML 形式でパッケージ化する自動化が可能です。また、Syncthing を使用すれば、PC やモバイルデバイス上でリアルタイムにファイル同期が完結するため、複数の端末から一貫した環境で作業できます。これらの運用事例を通じて、SilverBullet が単なるツールではなく、ユーザーのワークフローそのものを最適化するためのプラットフォームとして機能していることがわかります。

データエクスポートと将来性：ベンダーロックインからの解放

データの長期的な保存と可読性を保証することは、セルフホストノートの重要な意義です。SilverBullet はデータを標準的な Markdown フォーマットで保存するため、アプリが終了したりサービスが変更されたりしても、テキストファイルとして引き続き閲覧・編集可能です。これは、他のクローズドシステム（特定のクラウドプロバイダのみで使用可能な形式など）とは対照的な強みです。データエクスポート機能も充実しており、必要なフォルダやページを選択して CSV や JSON 形式で出力することが可能です。これにより、分析ツールや別のアプリへデータを移行する際にもスムーズに処理できます。

将来性という観点では、SilverBullet が TypeScript と Deno という現代的な技術スタックを採用している点が優位です。これらの言語はエコシステムが拡大しており、将来的なライブラリの互換性も期待できます。また、Space Script の拡張性は無限大に近く、ユーザーコミュニティが開発するプラグインやテンプレートが増えることで、機能の進化が続きます。ベンダーロックインからの解放とは、単にデータ形式の問題だけでなく、利用者が自身のシステムをコントロールし続ける自由を指します。SilverBullet を使用することで、デジタルノートの運用主体性を完全に維持することが可能になります。

よくある質問（FAQ）

Q1. SilverBullet は初心者でも導入できますか？

結論：はい、Docker Compose を使えば比較的容易に導入可能です。ただし、サーバー操作の基礎知識は必要です。SilverBullet の公式ドキュメントには Docker によるデプロイ手順が詳しく記載されており、環境変数の設定だけで起動します。ただし、リバースプロキシや認証の設定を行う場合は、ネットワーク知識が必要になるため、中級者向けのステップと言えます。

Q2. Obsidian との主な違いは何ですか？

結論：SilverBullet は Docker 上で動作しブラウザベースですが、Obsidian はローカルの Electron アプリです。SilverBullet の利点はセルフホストが標準で、拡張性を Space Script で制御できる点にあります。一方、Obsidian はプラグイン生态系が巨大でオフラインでのネイティブアプリとしての操作性が高いです。

Q3. Git 同期を使うとファイルが競合しますか？

結論：競合は発生しますが、SilverBullet は Markdown ベースのため解決が容易です。Git を使用する際は、.gitignore で設定ファイルを除外し、ノートデータのみを管理することをお勧めします。また、Syncthing を併用することで、ローカル同期の負荷を分散させる運用も可能です。

Q4. Space Script の学習コストはどれくらいですか？

結論：JavaScript/TypeScript の基礎知識があればすぐに習得できます。公式ドキュメントに API リファレンスがあり、サンプルコードも豊富です。ただし、複雑な独自機能を実装する場合は、スクリプトのデバッグスキルが必要になります。

Q5. PWA としてインストールできますか？

結論：はい、ブラウザから「アプリをインストール」することで可能です。オフラインでも動作し、デスクトップアイコンから起動できます。ただし、ブラウザのストレージ制限によりキャッシュ容量に上限があるため、大量データの場合はクラウド同期と併用が推奨されます。

Q6. セキュリティ設定は複雑ですか？

結論：初期設定では Basic Auth だけですぐに使えます。高度な設定にはリバースプロキシが必要ですが、Caddy を使えば自動 SSL 化が可能です。認証情報はサーバー側で暗号化して保存できるため、セキュリティリスクは管理次第で低減できます。

Q7. データのバックアップ方法は？

結論：Docker Volume のマッピング先をバックアップするのが基本です。Git リポジトリとして管理すれば履歴も残せます。また、定期的に ZIP アーカイブを作成し、外部ストレージに保存する運用が最も安全です。

Q8. 複数のサーバーで同期できますか？

結論：Syncthing を使用することで複数環境でのリアルタイム同期が可能です。Git を使えばリモートリポジトリ経由で複数台と連携できます。ただし、同時編集には注意が必要で、ロック機能などを活用する必要があります。

まとめ

SilverBullet セルフホストノートの構築ガイドについて詳しく解説しました。本記事の要点を以下にまとめます。

• SilverBullet の特徴: Docker/Deno ベースで、Space Script による高拡張性を備えたハック可能なノートアプリです。
• セルフホストの利点: データ所有権の確立、完全なプライバシー保護、ベンダーロックインからの解放が可能です。
• 導入方法: Docker Compose を使用したデプロイが最も推奨され、環境構築の手間を最小限に抑えられます。
• 拡張機能: Space Script により、ページ装飾やタスク管理のカスタマイズが可能で、ワークフローの最適化が実現します。
• セキュリティ: リバースプロキシ（Caddy/Traefik）と認証設定を適切に行うことで、安全にインターネット公開が可能です。
• 競合比較: Obsidian などの既存アプリと比較して、より柔軟なサーバー制御と拡張性を提供しますが、学習コストがやや高くなります。
• 運用戦略: Git や Syncthing を活用した同期戦略と、定期的なデータエクスポートにより、長期的な可用性を確保できます。

SilverBullet は、単なるツールとしてではなく、ユーザー自身のデジタル資産を管理するための基盤としての役割を果たします。本ガイドが、より安全で拡張性豊かなノート運用を実現する一助となれば幸いです。