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

準備段階では、サーバー側のファイアウォール設定も重要です。通常、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 は、単なるツールとしてではなく、ユーザー自身のデジタル資産を管理するための基盤としての役割を果たします。本ガイドが、より安全で拡張性豊かなノート運用を実現する一助となれば幸いです。