HisterをVPSでセルフホストする方法
HisterをVPSで動かし、訪問ページと保存ファイルの全文を検索します。v0.17.0を固定したバイナリ版とDocker版、TLS、ログイン、MCP endpointの設定を解説します。
Hister とは何か、何ではないか
Hister は、自分でホストする個人用検索エンジンです。閲覧したページと保存しているファイルの全文をインデックス化し、そのコレクションを Web インターフェース、ターミナルクライアント、HTTP API、または AI(人工知能)アシスタントから検索できます。Hister が答えるのは、「あれはどこで読んだか」という問いです。
この考え方を SearXNG で知る人は多いですが、両者は同じツールではありません。以前の Searx の名前を知っている場合は、そのプロジェクトは現在メンテナンスされていません。現在の README では、読者に作者の新しいプロジェクトとして Hister を案内しています。Searx と SearXNG は別々のプロジェクトであり、SearXNG はメンテナンスされているフォークです。そのため、新しいメタ検索インスタンスを構築するなら SearXNG を使います。SearXNG はメタ検索プロキシです。検索クエリを SearXNG に送ると、SearXNG が代理で他の検索エンジンに問い合わせ、追跡情報を除去した結果を返します。インデックスを所有するのは、それらの検索エンジンです。Hister は、利用者が渡したコンテンツから独自のインデックスを構築します。対象には、ブラウザー拡張機能で取得したページ、インポートしたブラウザー履歴、クロールした URL、指定したディレクトリ内のファイルが含まれます。自分でホストする SearXNG インスタンスを使うと、公開 Web に非公開でアクセスできます。Hister を使うと、自分が読んだものを検索できます。役割が異なるため、1 台のサーバーで両方を運用するのは一般的です。両方を運用する場合は、SearXNG が実際にどこまで検索を隠すのかを把握しておくとよいでしょう。SearXNG は検索クエリ自体を隠すのではなく、検索エンジンに対して利用者の IP アドレスをサーバーの IP アドレスに置き換えます。
Hister は AGPLv3(GNU Affero General Public License, version 3)またはそれ以降のライセンスで提供されるフリーソフトウェアです。テレメトリーはなく、クラウドサービスも必要ありません。このガイドでは、2026-07-28 時点の最新リリースだった v0.17.0 を固定します。2026-10-12 時点の最新リリースは v0.20.0 でした。2026-10-29 時点の最新リリースは v0.21.0 です。以下のコマンドは v0.17.0 を前提に記述しています。ここで触れる機能のうち、後から追加されたものには、追加されたリリースを示しています。コマンドをコピーする前に releases ページで現在のタグを確認し、そこで見つけたタグを固定してください。
VPS で Hister をセルフホストする理由
インデックスは完全でなければ役に立ちません。また、読んでいる間にサーバーが稼働していて初めて完全になります。ノート PC は 1 日の半分をスリープしていることがあります。その間にスマートフォンで開いたページはノート PC に届かず、夜間のインポートも開始されません。VPS(仮想プライベートサーバー)は常時稼働するため、所有するすべてのデバイスから同じインデックスに登録でき、睡眠中もクローラーが動作します。
2 つ目の理由は分離です。app セクションで user_handling: true を設定すると、1 つのインスタンス上で各アカウントに固有の認証情報とドキュメントコレクションが割り当てられます。これにより、1 台のサーバーで家庭や小規模チームを運用しても、他の人の閲覧履歴を検索せずに済みます。
3 つ目の理由は、基盤の準備です。VPS にはすでに公開ホスト名と証明書があり、管理できないネットワークからブラウザー拡張機能がサーバーへ接続するために必要です。同じホスト名と証明書はサーバー上の別の処理にも使われます。openGym は、その時点で有効なホスト名に対して最初のパスキーを登録します。そのため、最初のアカウントを作成する前に、ホスト名と証明書を確定させる必要があります。
インストール方法 1: リリースバイナリ
Hister はプラットフォームごとに 1 つのバイナリを提供します。チェックサムファイルと一緒にダウンロードし、インストール前に検証してください。
cd /tmp
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_linux_amd64
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_checksums.txt
sha256sum --ignore-missing -c hister_0.17.0_checksums.txt正常な結果は、hister_0.17.0_linux_amd64: OK だけが 1 行表示されることです。FAILED の行が表示された場合、ダウンロードしたファイルが破損しているか改変されています。インストールせず、再度ダウンロードしてください。
バイナリをインストールし、system account と、それが使用するディレクトリを作成します。
sudo install -m 755 /tmp/hister_0.17.0_linux_amd64 /usr/local/bin/hister
sudo useradd --system --home-dir /var/lib/hister --shell /usr/sbin/nologin hister
sudo install -d -o hister -g hister -m 750 /var/lib/hister
sudo install -d -m 755 /etc/hister
sudo hister create-config /etc/hister/config.ymlcreate-config はデフォルト設定ファイルを書き込みます。また、バイナリがこのマシンで実行できることも確認できます。アーキテクチャが異なるファイルをダウンロードした場合は、ここで cannot execute binary file: Exec format error と表示されて失敗します。
必要な設定だけを編集します。生成されたファイルの残りはそのまま使用できます。
app:
directory: /var/lib/hister
access_token: 'paste-a-long-random-string-here'
server:
address: 127.0.0.1:4433
base_url: https://hister.example.comopenssl rand -hex 32 で token を生成します。ファイルには credential が保存されるため、サービスを起動する前にアクセス権を制限してください。
sudo chown root:hister /etc/hister/config.yml
sudo chmod 640 /etc/hister/config.ymlsystemd で実行する
/etc/systemd/system/hister.service を記述します。
[Unit]
Description=Hister personal search engine
After=network-online.target
Wants=network-online.target
[Service]
User=hister
Group=hister
Environment=HISTER_CONFIG=/etc/hister/config.yml
ExecStart=/usr/local/bin/hister listen
Restart=on-failure
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/var/lib/hister
[Install]
WantedBy=multi-user.targetHISTER_CONFIG は設定ファイルのパスを指定する正式な環境変数です。そのため、この unit は hister アカウントのホームディレクトリに依存しません。ProtectSystem=strict により、このサービスから見えるファイルシステム全体が読み取り専用になります。そのため、ReadWritePaths でデータディレクトリを指定する必要があります。ProtectHome=yes はサービスから /home を隠します。したがって、/home 配下の監視対象ディレクトリは indexer から空に見えます。そこにあるファイルをインデックス化する必要がある場合は、その行を削除してください。
sudo systemctl daemon-reload
sudo systemctl enable --now hister
systemctl status hister --no-pager
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4433/最後のコマンドが出力する HTTP ステータスコードは、プロセスが待ち受けていることを示します。curl: (7) Failed to connect の場合は待ち受けていません。journalctl -u hister -n 50 --no-pager で理由を確認できます。
Docker Compose によるインストール
イメージは GitHub container registry に公開されており、リリースごとに 1 つのタグがあります。
services:
hister:
image: ghcr.io/asciimoo/hister:v0.17.0
container_name: hister
user: '1000:1000'
restart: unless-stopped
environment:
- HISTER__SERVER__ADDRESS=0.0.0.0:4433
- HISTER__SERVER__BASE_URL=https://hister.example.com
- HISTER__APP__ACCESS_TOKEN=${HISTER_ACCESS_TOKEN}
volumes:
- ./data:/hister/data
ports:
- 127.0.0.1:4433:4433すべての設定キーには HISTER__<SECTION>__<KEY> という形式の環境変数による上書き方法があります。区切り文字は 2 つのアンダースコアです。そのため、コンテナのデプロイに設定ファイルをマウントする必要はありません。HISTER_ACCESS_TOKEN は compose ファイルと同じディレクトリにある .env ファイルへ記述してください。ファイルを編集したい場合は、docker run --rm ghcr.io/asciimoo/hister:v0.17.0 create-config > config.yml でデフォルト値を表示できます。
上の 2 行は間違えやすいため、両方とも意味を理解しておく必要があります。
コンテナ内のアドレスは 0.0.0.0:4433 でなければなりません。コンテナは独自の network namespace を持つため、そこで 127.0.0.1 に bind したプロセスへ接続できるのはそのコンテナ内からだけです。その場合、公開ポートの転送先がありません。
公開ポートは 127.0.0.1:4433:4433 と記述し、4433:4433 にはしません。Docker は独自の netfilter ルールを挿入してポートを公開します。これらのルールは ufw のルールより先に評価されます。そのため、ufw status でポートが閉じていると表示されるホストでも、単純な 4433:4433 はインターネットから到達可能なままです。ホスト側を 127.0.0.1 に bind すれば、reverse proxy だけが接続経路になります。同じ問題はサーバー上のすべてのコンテナに当てはまります。残りの点については VPS 上の Docker Compose で説明しています。
user: '1000:1000' 行はコンテナを UID 1000、GID 1000 で実行します。これは公式の v0.17.0 イメージにおけるデフォルトの UID 65532、GID 65532 を上書きします。そのため、./data は UID 1000 と GID 1000 で書き込み可能でなければなりません。ディレクトリが存在しない場合は mkdir -p ./data で作成します。sudo chown -R 1000:1000 ./data により、そのアカウントに所有権を付与できます。SELinux が有効なホストでは、./data:/hister/data:Z を使用して Docker に適切なラベルを割り当てさせます。これらの番号に馴染みがなければ、先に コンテナがファイルを書き込む UID と GID を読んでください。
個人用検索インデックスを公開してはいけない理由
Hister はデフォルトで 127.0.0.1:4433 をリッスンします。このデフォルト設定は意図的なものです。1 か月使用した後にインデックスに何が含まれるかを考えてください。社内 Wiki のページ、請求書、ログイン中に開いたサポートチケット、パスワードリセットのページ、その他に読んだすべての内容の全文が含まれます。プロジェクトのドキュメントにも、次のように明記されています。「Hister は、ページの内容を含む閲覧履歴全体をサーバーとの間で送受信します。」
漏えいしたパスワードデータベースは、まず解析してパスワードを破る必要があります。一方、漏えいした個人用インデックスは平文で、すでに検索可能です。そのため、見た目が小規模な self-hosted アプリケーションであっても、より慎重に扱う必要があります。
ここから 2 つの事実が分かります。Hister は初期状態で認証を必要としません。そのため、リバースプロキシを置くだけで、ホスト名を知っている誰にでも、閲覧内容の検索可能なコピーを公開することになります。MCP エンドポイントもデフォルトで /mcp から提供されます。トークンがなければ、そこへ到達できるすべてのクライアントがインデックスを検索できます。
サービスを初めて localhost の外部へ公開する前に、認証を設定してください。1 人で使用する場合は app.access_token だけで十分です。ブラウザー拡張機能、ターミナルクライアント、任意の MCP クライアントから送信する共有 Secret を 1 つ設定します。複数人で使用する場合は user_handling: true を設定して、アカウントを作成します。
sudo -u hister hister create-user alice --admin --config /etc/hister/config.ymlこのコマンドでは、8 文字以上のパスワードを入力します。各アカウントには固有のドキュメントと個人用 API トークンが割り当てられます。所有者は、プロフィールページから、または hister update-user の --regen-token フラグを使用してトークンを再生成できます。新しいトークンを生成すると、以前のトークンは直ちに無効になります。そのため、そのアカウントで使用しているすべてのデバイスを後で更新する必要があります。
意図がない限り、app.public は変更しないでください。Public mode では、認証されていない検索、プレビュー、ファイル提供、MCP 検索が許可されます。一方で、書き込み、履歴へのアクセス、管理操作は引き続きブロックされます。
リバースプロキシ、TLS、ファイアウォール
Hister は HTTPS を直接提供しないため、前段で TLS(トランスポート層セキュリティ)を終端します。Caddy が最も簡単です。ACME(自動証明書管理環境)を使用して、証明書の取得と更新を自動で行うためです。
hister.example.com {
reverse_proxy 127.0.0.1:4433
}sudo systemctl reload caddy で再読み込みします。この構成では、hister.example.com の DNS レコードがこのサーバーを指している必要があります。IPv4 の A レコード、IPv6 の AAAA レコード、またはその両方を設定します。Caddy はデフォルトで、port 80 の HTTP-01 検証と port 443 の TLS-ALPN-01 検証を有効にします。そのため、port 443 経由の検証に成功する場合、port 80 は必要ありません。Let's Encrypt は IPv4 だけでなく IPv6 でも検証し、最初に AAAA アドレスを試します。そのため、以前のホストの古い AAAA レコードが残っていると、A レコードが正しくても検証に失敗することがあります。DNS が正しくない場合、またはどちらのチャレンジにも成功しない場合、ブラウザーにはページの代わりに TLS エラーが表示され、Caddy のログには失敗したチャレンジが繰り返し記録されます。
次に、それ以外のすべてを閉じます。
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw statusport 4433 が一覧にないのは意図的です。接続経路は公開ホスト名だけではありません。同じ loopback port を指す onion service を使用すれば、DNS レコードも受信 port の公開も必要とせず、自分のデバイスから index にアクセスできます。
server.base_url には、scheme を含めてブラウザーに入力するアドレスと同じ値を設定する必要があります。base_url のパスプレフィックスが正しくないと、アセットへのリンクが壊れ、インターフェイスにスタイルのないテキストや欠落した画像が表示されます。同じ URL をブラウザー拡張機能にも設定します。
インデックスへの取り込み
ブラウザー拡張機能が主な収集手段です。Mozilla Add-ons または Chrome Web Store からインストールし、オプションページを開いて、サーバー URL に https://hister.example.com を設定し、アクセス トークンを貼り付けます。拡張機能でのトークン対応は v0.18.0 で追加されました。v0.17.0 の拡張機能では、Web インターフェースへのサインイン時に作成されたセッションを使用します。拡張機能は、アクセスした各ページのタイトル、全文、HTML、favicon を取得し、サーバーに送信します。抽出はブラウザー内のクライアント側で行われます。拡張機能が第三者に接続することはありません。外部へのリクエストは、ページの favicon を取得するためのものだけです。
クライアント側で抽出するため、プライベートなインデックスを作成できます。拡張機能は、ログイン後かつレンダリング後のページを、あなたが見ている状態と同じように認識します。そのため、社内 Wiki のページや有料記事も正しくインデックス化でき、サーバーに認証情報を渡す必要もありません。一方で、表示したすべてのページがインデックスの候補になります。そのため、追加のコンテンツを登録する前にスキップルールを設定します。
スキップルールは、単一ユーザー構成では rules.json に保存されます。複数ユーザー構成では、ユーザーごとにデータベースへ保存されます。Web インターフェースの Rules タブが、ルールを編集する最も簡単な方法です。ルールには、完全な URL に対して照合される Go の正規表現を指定します。
^https://mail\.example\.com
^https://bank\.example\.com
.*?utm_source=^mail.example.com のようなパターンは、照合対象の文字列が https:// で始まるため、一致しません。末尾の $ も、クエリ文字列を含む URL では一致しません。照合時にクエリパラメーターが保持されるためです。
既存の履歴はブラウザー自身のデータベースを読み取ってインポートします。そのため、このコマンドはブラウザープロファイルを保持するマシン、つまり VPS ではなくノート PC 上で実行します。そこに同じバイナリをインストールし、サーバーを指定します。
export HISTER_TOKEN='your-access-token'
hister import browser firefox -u https://hister.example.com -t "$HISTER_TOKEN"インポートは browser-import-YYYY-MM-DD という名前の再開可能なジョブとして実行されます。そのため、途中で中断して、後から再実行できます。ブックマークサービスも同じ方法でインポートします。v0.17.0 は Linkwarden、Karakeep、Shaarli に対応し、v0.18.0 で Linkding、Readeck、Wallabag が追加され、v0.20.0 で Raindrop.io が追加されました。Linkwarden、Karakeep、Shaarli、Linkding、Readeck、Wallabag から再度インポートする場合、前回のインポートより新しい項目だけが取得されます。
サーバー上のファイルは、設定でディレクトリを指定するとインデックス化されます。
indexer:
directories:
- path: '/var/lib/hister/documents'
filetypes: ['pdf', 'docx', 'md', 'txt']PDF、DOCX、Markdown、Org mode、正しい UTF-8 のテキストファイルは、全文として読み込まれます。写真と動画は対象外です。そのため、画像ライブラリにはテキストではなく顔、場所、日付をインデックス化するサーバーが必要です。この用途では、通常 PhotoPrism と Immich が比較対象になります。単一のページは hister index https://example.com で追加できます。サイト全体を他のツール向けのクリーンなテキストに変換する処理は別の用途です。ページをクリーンなテキストに変換するセルフホスト型クローラーが担当します。
検索はフィールド単位で行われます。そのため、クエリ言語を10分ほど読んでおくと効果的です。
"connection reset" domain:github.com added:<30d
title:(wireguard|nftables) -tutorial sort:-visitssort: フィールドは v0.18.0 で追加されました。そのため、v0.17.0 では2つ目のクエリから sort: を省いてください。
MCP を介して独自のインデックスをコーディングエージェントに利用させる
MCP(model context protocol)は、アシスタントがサーバー上のツールを呼び出すためのインターフェースです。Hister は同じベース URL で、ストリーム可能な HTTP トランスポートを使用して POST /mcp で提供し、search、get_preview、get_history を公開します。認証には、API の他のエンドポイントと同じ bearer token を使用します。ツール呼び出しに慣れていない場合は、小さなエージェントループを自分で作成すると、このようなエンドポイントが実際にアシスタントへ渡す内容を最短で確認できます。
{
"mcpServers": {
"hister": {
"url": "https://hister.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
}
}
}X-Access-Token ヘッダーは Authorization の代替として使用できます。
ここで重要なのは、エージェントが検索する対象です。公開 Web 検索では、その時点で上位に表示される結果が返されます。動きの速いソフトウェアでは、実行中のバージョンとは異なるバージョンのドキュメントが返されることがよくあります。独自のインデックスでは、すでに読んで保存すると判断したページが返されます。また、get_preview が保存済みのコピーを提供するため、元のページがオフラインになっても回答を維持できます。公開結果も必要な場合は、エージェントに両方のソースを渡してください。SearXNG をバックエンドとするブラウザー検索スキルを追加すると、公開 Web を別のツールとして利用できます。これらのエンドポイントを複数運用する場合は、VPS 上で MCP サーバーをホスティングする方法も確認してください。すべてのエンドポイントで、同じ公開範囲の問題が発生するためです。
ディスク、バックアップ、保守
ドキュメントでは、圧縮プレビューを含めて、インデックス化されたページ1件は約100 KBです。そのため、100,000ページでおよそ10 GBになります。クォータシステムはありません。2つの設定が混同されがちです。indexer.max_file_size_mb(デフォルトは1 MiB)は監視対象の単一ファイルのサイズを制限し、server.max_batch_body_size(デフォルトは40 MiB)は batch API への1回のリクエストを制限します。後者の設定は v0.17.0 の後に追加されました。v0.17.0 では、batch リクエストは固定の5 MiBに制限されています。
app.directoryで指定したディレクトリには、言語ごとのインデックスファイルを含む index.db、アカウントとジョブを含む db.sqlite3、プレビュー用の data/html/、および rules.json が格納されます。バックアップは、サービスを停止し、そのディレクトリ全体と設定ファイルをコピーして作成します。hister export backup.jsonは移行用にドキュメントを JSON として書き出すものであり、サーバーのバックアップではありません。
知っておくべき保守用コマンドは2つあります。hister reindexは検索インデックスを再構築します。インデクサーの設定を変更した後に必要です。大規模なインポート中にメモリ使用量が増える場合は、indexerセクションで detect_languages: falseを設定してから、再インデックスを実行します。hister cleanupは、削除後に残った不要なプレビューと favicon ファイルを削除します。
削除はクエリとして実行されるため、最初に dry run モードで確認します。
hister delete 'domain:example.com' --dry --verbosecollector が引き続きページを送信すると、削除したページは再び登録されます。そのため、削除する前に skip ルールを追加してください。
変更していない Hister のコピーを自分で実行するだけなら、AGPLv3 が変更されていないプログラムの実行を無制限に許可しているため、義務はありません。変更の有無にかかわらず、コピーを他者に渡す場合は、著作権表示とライセンス表示を保持し、受領者にライセンスのコピーを提供するなどの条件があります。Hister を変更し、そのバージョンをネットワーク経由で他者に使用させる場合は、変更後のソースコードを提供することもライセンスで求められます。
障害の種類と表示される文字列
サーバーが起動しない。 ポート 4433 が使用中であることや YAML の構文エラーが原因として考えられます。設定の検証に失敗した場合や、データディレクトリにアクセスできない場合も起動が停止します。0.0.0.0 に server.base_url を指定せずにバインドすると base_url must be specified when listening on が発生し、Secret key を書き込めない場合は failed to create secret key file が発生します。sudo ss -lntp | grep 4433 でポートを使用しているプロセスを確認し、journalctl -u hister -n 50 --no-pager で起動時のエラーを表示します。
インターフェースは読み込まれるが、表示が崩れている。 文字化けや画像の欠落がある場合は、server.base_url のパスプレフィックスを確認します。Hister はこの設定値の末尾にあるスラッシュを削除します。
Extension が接続しない。 Extension に設定したサーバー URL は base_url と一致している必要があります。また、サーバーが起動していて最新の状態であることも確認します。途中の firewall によってブロックされても、ページにはメッセージが表示されません。Firefox は Extension のログを通常のコンソールに出力しません。about:debugging#/runtime/this-firefox を開き、Hister extension のログを確認します。
Container が起動時に終了する。 ./data で permission error が発生する場合は、所有者、書き込み権限、SELinux labeling を確認します。この compose file は UID 1000 と GID 1000 で明示的に実行されるため、image のデフォルトである UID 65532 と GID 65532 が上書きされます。その account に ./data への書き込み権限を付与します。SELinux host では、bind mount に :Z を追加します。
管理者用 route で 403 Forbidden が返る。 user handling が有効な場合、POST /api/reindex と POST /api/cleanup は管理者専用です。そのため、通常の account からのアクセスは拒否されます。
Import 中にメモリ使用量が増え続ける。 大量の履歴に対する言語検出が、通常の原因です。detect_languages: false を設定し、その後 hister reindex を実行します。
FAQ
Hister は SearXNG とどう違いますか?
SearXNG はメタ検索プロキシです。クエリを公開検索エンジンへ転送し、追跡情報を除いた検索結果を返します。そのため、インデックスは検索エンジン側にあります。Hister は、閲覧したページと保存したファイルの全文インデックスを独自に保持します。そのため、「あれはどこで読んだか」という検索に答えます。一方、SearXNG は「Web には何が書かれているか」という検索に答えます。両者は異なる問題を解決するものであり、1 台のサーバーで併用することもできます。
閲覧履歴全体を VPS に置いても安全ですか?
事前に公開範囲を適切に制限した場合に限り、安全です。Hister は 127.0.0.1:4433 に bind し、デフォルトでは認証を必要としません。app.access_token または user_handling: true を設定し、前段に TLS 対応のリバースプロキシを置いて、ファイアウォールではポート 4433 を閉じてください。閲覧内容の全文インデックスは平文です。そのため、ポートに到達できるユーザーは、何もクラックせずにすべてを読めます。
ブラウザー拡張機能は必要ですか。それとも履歴をインポートするだけで済みますか?
インポートは 1 回だけ実行する初期取り込みです。ブラウザー自身の履歴データベースを読み込むため、サーバーではなくブラウザープロファイルを保持しているコンピューター上で実行します。その後は拡張機能がインデックスを最新に保ちます。また、ページのレンダリング後にブラウザー内で内容を抽出するため、ログインが必要なページも取得できます。一般的な構成は、最初に 1 回インポートし、その後は拡張機能を使う方法です。
コーディングエージェントで Hister のインデックスを検索できますか?
はい。Hister はベース URL 上の POST /mcp にある MCP (model context protocol) サーバーで、search、get_preview、get_history を公開します。Authorization: Bearer ヘッダーにアクセス トークンを設定し、クライアントを https://your-host/mcp に向けてください。エージェントは、現在公開検索エンジンで上位に表示される情報ではなく、実際に読んだバージョンのドキュメントを検索できます。