【2026年】Shiori セルフホストブックマーク｜軽量Goで書かれた決定版

この記事を書いた人

非公式データベースバックエンドの設定と拡張

SQLite は軽量さにおいて優れていますが、データ量が膨大になった場合や、複数のユーザーによる同時編集を頻繁に行う必要がある場合は、外部データベースへの切り替えを検討すべきです。Shiori は環境変数の設定を通じて、PostgreSQL や MySQL/MariaDB などのバックエンドデータベースを使用することが可能です。これにより、トランザクション処理の能力が向上し、大規模なデータセットでも安定した動作を実現できます。設定の変更は、docker-compose.yml の environment セクションを追加することで行います。例えば、PostgreSQL を使用する場合、接続情報を含む変数を指定する必要があります。

外部データベースを使用する際の手順を具体的に説明します。まず、Shiori と別コンテナとして PostgreSQL サーバーを起動し、専用のデータベースとユーザーを作成します。その上で、Shiori の Docker コンテナ設定に DB_TYPE: postgres、DB_HOST: db_host_ip、DB_PORT: 5432、DB_USER: shiori_user、DB_PASS: strong_password、DB_NAME: shiori_db といった環境変数を追加します。これにより、Shiori アプリケーションは外部の PostgreSQL インスタンスに接続し、データを保存するようになります。PostgreSQL を使用することで、データベースの整合性を保つためのトランザクション機能が強化され、システム全体の信頼性が向上します。ただし、設定が複雑になるため、運用コストには注意が必要です。

environment:
  - DB_TYPE=postgres
  - DB_HOST=db_host_ip
  - DB_PORT=5432
  - DB_USER=shiori_user
  - DB_PASS=strong_password
  - DB_NAME=shiori_db

MySQL または MariaDB を使用する場合は、パラメータ名が若干異なります。DB_TYPE: mysql と設定し、接続情報を指定します。この場合も、外部データベースサーバーを別途起動・設定する必要があります。外部データベースを導入するメリットとして、バックアップの効率化や、既存のデータベース管理ツールの利用が挙げられます。例えば、pgAdmin や phpMyAdmin などの GUI ツールを使用してデータベースの状態を確認したり、クエリを実行したりすることが可能になります。また、データベースのスケーラビリティも向上し、Shiori のデータ量が増加しても、ハードウェアのアップグレードだけで対応可能なケースがあります。ただし、設定ミスによる接続エラーや権限問題が発生した際のトラブルシューティングが SQLite 以上に必要となるため、ある程度の Linux 運用知識が求められます。

CLI と REST API の活用方法

Shiori は Web UI だけでなく、コマンドラインツール（CLI）も提供しており、これを活用することでバッチ処理や自動化が可能になります。CLI ツールは Docker コンテナ内でも直接使用できますし、Go バイナリを直接ダウンロードしてローカルで実行することも可能です。最も基本的なコマンドとして、Shiori のブックマークを追加する shiori add コマンドがあります。例えば、ターミナルから docker exec -it shiori shiori add https://example.com "Example Title" と入力することで、指定した URL を Shiori に追加することができます。この機能は、スクリプト内で他のツールと連携して自動的にブックマークを取得する際に非常に役立ちます。

REST API の利用も、開発者にとっては重要な要素です。Shiori には公式にドキュメントが用意されており、HTTP リクエストを送信することでプログラムから Shiori を制御できます。API エンドポイントは /api/bookmarks や /api/search などがあり、GET メソッドでデータ取得、POST メソッドで追加、DELETE メソッドで削除が可能です。認証には API キーが必要であり、これは Web UI の設定画面から発行されます。例えば、Python スクリプトを使用して requests ライブラリを呼び出し、Shiori の API に接続することで、特定のタグが付いたブックマークを自動的に抽出し、外部ファイルにエクスポートする処理を実装できます。これにより、データ分析や定期的なレポート作成などが自動化可能です。

# CLI での検索実行例
docker exec -it shiori shiori search --query "gaming"

# CLI でのタグ一覧表示
docker exec -it shiori shiori list-tags

CLI と API を組み合わせることで、Shiori の運用範囲が大幅に広がります。例えば、毎朝の定時タスクで、過去 24 時間以内に追加されたブックマークをスクリプトで取得し、Slack や Discord に通知を送るような自動化が可能です。また、バックアップのスクリプトも CLI を活用して作成できます。shiori export コマンドを使用することで、データの JSON エクスポートや HTML エクスポートが可能であり、これを Cron job で定期実行することで、自動的なデータ保全を実現できます。CLI の利用は、上級者向けの機能ですが、一度設定を覚えてしまえばサーバー管理の効率化に大きく寄与します。特に API キーの管理には注意が必要で、公開リポジトリなどに誤ってコミットしないよう、環境変数として安全に扱うことが推奨されます。

ブラウザ拡張とオフラインアーカイブ機能

Shiori の Web UI だけで完結するのではなく、ブラウザ拡張機能を使用することで、よりシームレスなブックマーク保存が可能になります。現在、公式の Chrome または Firefox 拡張機能は提供されていませんが、コミュニティによって開発された非公式拡張機能が利用可能です。これらは Shiori の REST API を呼び出して、現在のタブ URL とタイトルを自動で送信する機能を提供します。インストール方法としては、ブラウザの拡張ストアから Shiore や Bookmark to Shiori などのキーワードで検索し、信頼できる開発者による拡張機能を追加します。設定画面では、自サーバーの URL（例：https://shiori.mydomain.com）と API キーを入力して接続を確立します。

オフラインアーカイブ機能は、Shiori の非常に強力な特徴の一つです。Web ページを保存する際、単に URL を保存するだけでなく、ページの内容をローカルに保存することができます。これは「Offline Archiving」と呼ばれる機能で、Shiori が自動的に Web ページの HTML 構造とリソース（画像や CSS）をダウンロードし、ローカルのファイルシステムに蓄積します。これにより、将来的に元のサイトが削除されても、Shiori 内でその内容を閲覧することが可能になります。設定では、拡張機能側で「ページをアーカイブする」オプションを有効にしておくことで、保存時に自動的にこの処理が行われます。ただし、これはデータ容量を消費するため、画像の多いページや動画を含むページの保存には注意が必要です。

// 拡張機能の設定例（概念）
{
  "url": "https://shiori.example.com",
  "apiKey": "your-secret-key",
  "archivePage": true,
  "includeAssets": true
}

アーカイブされたページは、Shiori の詳細表示画面から閲覧できます。ただし、元のサイトが JavaScript を多用して動的にレンダリングしている場合、完全なアーカイブができない場合があります。その場合は、Selenium や Puppeteer などのヘッドレスブラウザツールを使用して Shiori のスクリプトを拡張し、JavaScript レンダリング後の状態をキャプチャする高度なカスタマイズも可能です。また、オフラインアーカイブは保存先のディスク容量に直結するため、定期的な整理が重要です。不要なページや重複したアーカイブファイルを削除し、ストレージの使用量を最適化しましょう。Shiori の設定画面からアーカイブの保存先パスを変更することも可能で、大容量 HDD を使用してアーカイブを管理するなどの運用も可能です。

セキュリティ強化とリバースプロキシ設定

セルフホストサービスにおいてセキュリティは最重要事項です。Shiori は初期状態では HTTP プロトコルを使用しますが、外部からのアクセスを想定する場合は必ず HTTPS 化を行う必要があります。そのための手段として、Nginx や Caddy、Traefik などのリバースプロキシを用いることが一般的です。Caddy を使用する場合、設定が非常に簡潔で、自動的な SSL 証明書発行（Let's Encrypt）が可能です。Caddyfile にドメイン名を指定するだけで、HTTPS 化と証明書の更新が自動化されます。これにより、ブラウザ拡張機能や外部ツールからの接続が暗号化され、中間者攻撃からユーザーデータを保護できます。

# Caddyfile 例
shiori.yourdomain.com {
    reverse_proxy localhost:8080
    tls [email protected]
}

Nginx を使用する場合は、やや設定が複雑になりますが、より細かな制御が可能です。SSL 証明書のパスを指定し、プロキシヘッダーを設定することで、Shiori が正しい IP アドレスを取得できるようになります。また、Basic 認証や OAuth プロトコル（Keycloak や Authelia など）による認証強化も可能です。Shiori の設定ファイルで AUTH_TYPE: basic を指定すれば、ブラウザのプロンプトが現れる単純な認証が可能ですが、より高度なセキュリティが必要な場合は、外部の ID プロバイダと連携させることを検討してください。これにより、パスワード管理や多要素認証（MFA）を一元化できます。

ファイアウォール設定も合わせて行う必要があります。Linux サーバーであれば ufw や iptables を使用して、Web ポート（80, 443）のみ許可し、Shiori の直接ポート（8080）への外部アクセスをブロックします。これは、リバースプロキシ経由でのみ Shiori にアクセスできるようにするため、直接的な攻撃リスクを軽減します。さらに、Brute Force Attack 対策として、Fail2Ban を導入して認証失敗の記録を監視し、IP アドレスを一時的にブラックリスト化することも有効です。SSH 接続についても、ポート変更や鍵ベース認証のみに制限し、パスワード認証を無効化するなどの対策を講じることが推奨されます。

他ツールとの比較分析

Shiori を選ぶ際、他のセルフホストブックマーク管理ツールと比較するのは重要なプロセスです。代表的な競合ツールには、Linkwarden、Hoarder、Shaarli、Wallabag などがあります。それぞれのツールは異なる哲学と機能を提供しており、ユーザーのニーズによって最適解が異なります。ここでは主要な機能を比較し、Shiori の立ち位置を明確にします。特に重要なのがリソース消費量、UX（ユーザ体験）、および拡張性の違いです。軽量さを重視するユーザーには Shiori が、データ分析やコラボレーション機能に重きを置くユーザーには他ツールが適しています。

Shiori の強みは、Go 言語による軽量性と SQLite デフォルトの構成です。Linkwarden は Elasticsearch を使用するため、検索性能と大規模データ処理に優れていますが、その分メモリ要件が高く、リソースの制約が厳しいサーバーでは過剰となります。Hoarder は Rust で書かれており非常に高速ですが、アーカイブ機能や Web UI の拡張性が Shiori に比べて劣る場合があります。Shaarli は PHP 製で軽量ですが、UI が古く、モダンなブラウザ拡張との連携が難しいです。Wallabag はリーディングリスト（全文保存）に特化しており、ブックマークというよりも「Web 読書管理」ツールに近い性質を持っています。

また、Shiori は Go バイナリであるため、コンテナ以外でのデプロイも容易です。Linkwarden や Wallabag はランタイム環境の依存が複雑な場合があり、バージョンアップ時の互換性問題が発生しやすい傾向があります。一方で Shiori はバイナリ一つで完結するため、更新時にシステム全体を再起動するだけで済むなど、メンテナンス性の面で優位性があります。ただし、共同編集やチームでの利用においては、Lock 機構や権限管理が Linkwarden の方が充実しているため、複数ユーザーによる同時アクセスが多い場合は Shiori よりも Linkwarden が適している場合があります。

データのインポートと移行ガイド

既存のブックマーク管理サービスから Shiori へデータを移行することも可能です。Shiori は主要なサービスからのインポート機能を標準でサポートしています。例えば、Pocket、Raindrop.io、または他社の Shiori サーバーからデータを移すことができます。これにより、新しい環境への移行に伴うデータロスや手作業による再登録を回避できます。インポートプロセスは、Web UI の設定画面から実行できる場合と、CLI ツールを使用する場合がありますが、CLI を使用した方が大規模なデータ量でも処理が安定しています。

Pocket から Shiori へ移行する場合、まず Pocket アプリからデータをエクスポートする必要があります。Pocket は CSV または JSON 形式での出力をサポートしており、これを Shiori のインポートツールに読み込ませます。Shiori の CLI ツールでは shiori import コマンドを使用し、ソースファイルのパスを指定します。これにより、URL、タイトル、タグ、アーカイブ状態などがすべて転送されます。ただし、Pocket のアカウント認証が必要な場合は、OAuth トークンの取得手順が必要になる場合があり、その点には注意が必要です。

Raindrop.io や他のツールからのインポートも同様のアプローチで行えます。CSV 形式のデータであれば、Shiori の標準フォーマットに変換するスクリプトを自作して適用することも可能です。特に Raindrop.io は API を使用したエクスポートが容易で、大量のデータを処理する場合でも安定しています。移行後の検証としては、インポートされたブックマークの数やタグ付けの状態を確認し、アーカイブファイルが正しく保存されているかをチェックします。エラーが発生した場合でも、ログを参照することでどのデータで問題が起きたか特定可能です。

バックアップ戦略と運用 Tips

Shiori の運用において最も重要な要素の一つがデータのバックアップです。SQLite データベースは単一ファイルですが、そのファイルが破損すると全てのブックマーク情報を失う可能性があります。そのため、定期的なスナップショット取得と、外部ストレージへの転送を行うことが必須です。バックアップ戦略としては、毎日または毎週の cron job でデータベースファイルをコピーし、別のディレクトリやクラウドストレージ（AWS S3 など）に保存することが推奨されます。また、Shiori の設定ファイル自体もバックアップ対象に含まれるべきです。これにより、システムを復元する際に必要な情報がすべて揃います。

#!/bin/bash
# バックアップスクリプト例
BACKUP_DIR="/var/backups/shiori"
DATE=$(date +%F)
docker exec shiori shiori export --output $BACKUP_DIR/bookmarks_$DATE.json
cp /home/user/shiori/data/shiori.db $BACKUP_DIR/db_$DATE.sqlite
tar -czf $BACKUP_DIR/config_$DATE.tar.gz ./config/

運用上の Tips として、ディスク容量の監視が挙げられます。オフラインアーカイブ機能を使用している場合、画像やリソースファイルの保存によりストレージが急速に消費される可能性があります。定期的なディスク使用量の確認と、不要なアーカイブの削除ルールを設けることをお勧めします。また、ログファイルのローテーションも忘れずに行い、ログが無限に蓄積されないように注意してください。Shiori の Web UI にはリソース監視機能が含まれていないため、外部ツール（Netdata や Prometheus）を使用してメモリ使用量や CPU リソースを可視化すると良いでしょう。

パフォーマンスチューニングについても考慮すべき点があります。SQLite を使用している場合、データベースファイルのアクセス頻度が高いとロック競合が発生する可能性があります。その場合は、PostgreSQL への移行を検討するか、shiori config でキャッシュ設定を変更することで改善が見込めます。また、高負荷な検索クエリを頻繁に行う場合は、インデックスの最適化や検索アルゴリズムの見直しが必要になる場合があります。これらは上級者向けの設定ですが、運用の安定性を高めるために重要な要素です。

よくある質問（FAQ）

Q1: Shiori は Raspberry Pi 0 で動作しますか？ A1: お勧めしません。Raspberry Pi 0 のメモリ容量（512MB）では Shiori の起動に十分ではなく、SQLite のオーバーヘッドでシステムが不安定化します。Pi 4 または Pi 5 を使用し、メモリを少なくとも 2GB 確保してください。

Q2: Docker 以外でのインストール方法はありますか？ A2: はい、可能です。Go バイナリを直接ダウンロードして実行できますが、依存関係の管理や環境設定を自己責任で行う必要があります。Docker が標準で推奨されます。

Q3: ブラウザ拡張は公式ではありませんか？ A3: 現在、Chrome および Firefox の公式拡張機能はありません。コミュニティ製の非公式拡張機能を使用するか、Web UI を手動で利用する必要があります。

Q4: SQLite から PostgreSQL への移行方法は？ A4: docker-compose.yml で DB 設定を変更し、既存のデータをエクスポートして再インポートするスクリプトを準備してください。Shiori の CLI ツールが移行をサポートしています。

Q5: SSL 証明書は自動で発行されますか？ A5: Shiori 単体ではできません。Caddy や Traefik をリバースプロキシとして使用し、ACME プロトコルで自動取得する必要があります。

Q6: API キーの管理はどのように行うべきですか？ A6: 環境変数または設定ファイルに保存し、ソースコードリポジトリに埋め込まないよう注意してください。定期的なローテーションが推奨されます。

Q7: アーカイブしたページはいつまで保存されますか？ A7: ユーザーの判断です。設定で期限を設ける機能はありませんが、手動削除またはスクリプトによる定期クリーンアップが必要です。

Q8: 複数ユーザーでの同時編集は可能ですか？ A8: SQLite の場合、ロック機構により同時書き込みには制限があります。PostgreSQL を使用し、権限管理機能を有効化することで改善されます。

Q9: データを JSON 形式でエクスポートできますか？ A9: はい、Shiori の CLI ツール shiori export コマンドを使用すれば、JSON または HTML 形式でのエクスポートが可能です。

Q10: Shiori は更新頻度はどの程度ですか？ A10: オープンソースプロジェクトとして、バグ修正や機能追加が行われています。GitHub リポジトリで最新情報を確認し、定期的にアップデートすることをお勧めします。

まとめ

本記事では、軽量 Go 言語で書かれたセルフホストブックマーク管理ツール「Shiori」について、その特長から実運用に至るまでを詳細に解説しました。Shiori の最大の特徴は、Go 言語による極めて軽量なアーキテクチャと、SQLite デフォルトの自己完結性です。これにより、Raspberry Pi 5 や旧式の PC といったリソースが限られた環境でも安定して動作し、プライバシーとデータ主権を確保することができます。また、[Docker Compose を用いた標準的な導入方法から、[PostgreSQL などの外部データベースを使用した高負荷環境向け構成まで、ユーザーのニーズに合わせて柔軟に設定変更が可能です。

セキュリティ面においては、リバースプロキシを通じた HTTPS 化や OAuth 認証による強化が重要であり、Caddy や Nginx との連携方法を詳しく説明しました。さらに、ブラウザ拡張機能を活用したシームレスな保存や、オフラインアーカイブ機能による Web ページ保存の実践的な使い方についても触れ、Shiori が単なるブックマーク管理を超えた「データ保全ツール」としての価値を示すことができました。他ツールとの比較分析を通じて、Shiori の立ち位置を明確にし、ユーザーにとって最適なツールの選択ができるよう支援しています。

運用においては、データのバックアップ戦略とディスク容量管理が重要であり、CLI や [REST API](/glossary/api) を活用した自動化も提案しました。これらを組み合わせておくことで、長期的かつ安全に Shiori を運用することが可能になります。初心者から中級者までのサーバー管理者向けの内容として、具体的な手順やコード例を豊富に記載し、再現性の高いガイドラインを提供することを心がけました。Shiori の導入を検討している場合は、ぜひ本記事を参考に環境構築を進めてください。

Wallabag を使った後で読むサービスのセルフホスト構築を解説。Docker導入、モバイルアプリ、Kindle 送信、Pocket との比較、実運用Tipsを詳しく紹介。

AirTagインソール GPSが隠せるポケット付きインソール 歩数と靴を追跡 AirTag固定エアタグケース 位置情報確認用 認知症 迷子対策 徘徊 子供用 高齢者 障害者 取り付け簡単 (235-250mm)