最終更新日: 2025年12月04日
テンプレート説明
ArchiveBoxは、Webページを複数の形式で永続的に保存するオープンソースのセルフホスト型アーカイブソリューションです。ブックマーク、RSSフィード、ブラウザ履歴から自動的にコンテンツを収集し、HTML、PDF、スクリーンショット、WARCなどの多様な形式で保存することで、Webコンテンツの長期保存を実現します。
本テンプレートは、Docker Composeを使用してArchiveBoxを自動的にセットアップし、Nginxリバースプロキシと自己署名SSL証明書による安全なHTTPSアクセスを提供します。インストール完了後は、管理者による初期設定を行うため、サービスは停止状態となっています。
スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。
メモ
ArchiveBoxは、自己署名SSL証明書を使用してインストールされます。ブラウザで証明書警告が表示されますが、「詳細」→「続行」を選択することでアクセス可能です。本番環境では、Let’s Encrypt証明書への切り替えを推奨します。
仕様
対応OSイメージ
Ubuntu 24.04 LTS
主要ソフトウェア
| ソフトウェア名 | バージョン | ライセンス | 用途 |
|---|---|---|---|
| ArchiveBox | Latest | MIT | セルフホスト型Webアーカイブシステム |
| Docker | Latest | Apache 2.0 | コンテナランタイム環境 |
| Docker Compose | Latest | Apache 2.0 | マルチコンテナ管理ツール |
| Nginx | Latest | BSD-2-Clause | リバースプロキシ・Webサーバー |
| Chromium | Latest | BSD-3-Clause | ヘッドレスブラウザ（アーカイブ用） |
| yt-dlp | Latest | Unlicense | メディアダウンローダー |
| wget | Latest | GPL-3.0+ | 静的コンテンツ取得ツール |
| Let’s Encrypt (Certbot) | Latest | MPL 2.0 | SSL/TLS証明書管理（オプション） |
スタートアップスクリプト情報
| 項目 | 説明 |
|---|---|
| アプリケーション利用ポート | 80/tcp (HTTP), 443/tcp (HTTPS), 8000/tcp (内部通信) |
| インストールディレクトリ | /opt/archivebox |
| データディレクトリ | /opt/archivebox/data |
| SSL証明書ディレクトリ | /etc/archivebox/ssl |
| 管理スクリプト | /root/archivebox-*.sh |
| 初期状態 | サービス停止中（管理者による初期設定が必要） |
その他
最小システム要件
- CPU: 1コア以上
- メモリ: 最小500MB、推奨2GB以上
- ディスク容量: 10GB以上（アーカイブデータにより増加、1000記事あたり約5GB）
- ネットワーク: パブリックIPアドレス
メモ
ディスク容量は、アーカイブするコンテンツの種類と量により大きく変動します。メディアファイル（音声・動画）を含む場合、より多くのストレージが必要になります。
利用手順
メモ
スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。
インストール完了後、rootディレクトリに「archivebox-info.txt」というファイルが作成されますのでご確認ください。
ファイルが存在しない場合、作成されるまでしばらくお待ちください。
スタートアップスクリプトの実行状況は、SSH接続後に以下のコマンドで確認できます：
# tail -f /var/log/archivebox-setup.log
重要
テンプレート作成直後は、ArchiveBoxサービスが停止状態です。以下の手順に従ってサービスを起動し、管理者アカウントを作成してください。
Step 1: VPSへの接続
SSHクライアントを使用してVPSに接続します。
# ssh root@<VPSのIPアドレス>
Step 2: サービスの起動
管理スクリプトを使用してArchiveBoxコンテナを起動します。
# ArchiveBoxサービスを起動
# /root/archivebox-manage.sh start
起動完了後、以下のURLが表示されます：
Started: https://your-domainStep 3: 管理者アカウントの作成
Web UIにログインするための管理者アカウントを作成します。
# インストールディレクトリに移動
cd /opt/archivebox
# スーパーユーザーを作成
# docker compose run archivebox manage createsuperuser
プロンプトに従って、ユーザー名・メールアドレス・パスワードを入力してください。
Step 4: 初回アクセス
ブラウザで以下のURLにアクセスします：
https://your-domainメモ
自己署名証明書を使用しているため、ブラウザで証明書警告が表示されます。「詳細設定」→「安全でないサイトへ進む」などを選択してアクセスしてください。
作成した管理者アカウントでログインし、ArchiveBox Web UIにアクセスできることを確認します。
Step 5: HTTPS設定（推奨）
本番環境では、Let’s Encrypt証明書の使用を強く推奨します。下記コマンドの「[email protected]」は自身のメールアドレスに置き換えてください。
# Let's Encrypt証明書を取得
# /root/archivebox-letsencrypt.sh -e [email protected]
重要
Let’s Encrypt証明書を取得するには、ドメイン名がサーバーのパブリックIPアドレスに正しく解決される必要があります。DNSレコードが適切に設定されていることを確認してください。
Step 6: ドメイン設定（オプション）
インストール後にドメインを変更する場合は、以下のスクリプトを使用します。下記コマンドの「new-domain.com」は自身の独自ドメインに置き換えてください。
# ドメインを変更
# /root/archivebox-change-domain.sh -d new-domain.com
このスクリプトは、ホスト名の更新、SSL証明書の再生成、Nginx設定の更新、コンテナの再起動を自動的に実行します。
Step 7: システム診断
システムの動作状態を確認します。
# 診断スクリプトを実行
# /root/archivebox-diagnose.sh
Docker、Nginx、SSL証明書、ファイアウォール、ポート状態などの情報が表示されます。
管理スクリプト一覧
| スクリプト名 | 機能 | 使用例 |
|---|---|---|
| archivebox-manage.sh | サービスの起動・停止・再起動 | # /root/archivebox-manage.sh start |
| archivebox-letsencrypt.sh | Let’s Encrypt証明書の取得 | # /root/archivebox-letsencrypt.sh -e [email protected] |
| archivebox-change-domain.sh | ドメイン変更 | # /root/archivebox-change-domain.sh -d new.domain.com |
| archivebox-diagnose.sh | システム診断情報の表示 | # /root/archivebox-diagnose.sh |
ArchiveBoxの基本的な使い方
URLの追加（コマンドライン）
# 単一URLを追加
cd /opt/archivebox
# docker compose run archivebox add 'https://example.com'
# ファイルからURLを一括追加
# docker compose run archivebox add < urls.txt
# RSSフィードから追加
# docker compose run archivebox add 'https://example.com/feed.rss'
Web UIからの追加
ブラウザでArchiveBox Web UIにアクセスし、「Add」ボタンからURLを追加できます。
アーカイブの確認
アーカイブされたコンテンツは、以下のディレクトリに保存されます：
/opt/archivebox/data/archive/セキュリティグループ設定
以下のポートを開放する必要があります：
| ポート番号 | プロトコル | 用途 | 必須/オプション |
|---|---|---|---|
| 22 | TCP | SSH接続 | 必須 |
| 80 | TCP | HTTP（HTTPSへのリダイレクト） | 必須 |
| 443 | TCP | HTTPS | 必須 |
メモ
ポート8000は、Docker内部通信用であり、外部に公開する必要はありません。Nginxリバースプロキシがポート443経由で内部のArchiveBoxコンテナにリクエストを転送します。
アプリケーションの具体的な利用方法につきましては、サービス開発元やサービス提供元の公式サイト、Wikiなどで最新情報をご確認ください。
外部リンク
| サイト名 | URL | 説明 |
|---|---|---|
| ArchiveBox公式サイト | https://archivebox.io | プロジェクト概要・最新情報 |
| ArchiveBox公式ドキュメント | https://docs.archivebox.io | 技術ドキュメント・設定ガイド |
| ArchiveBox GitHub Wiki | https://github.com/ArchiveBox/ArchiveBox/wiki | コミュニティWiki・詳細ガイド |
| ArchiveBox GitHubリポジトリ | https://github.com/ArchiveBox/ArchiveBox | ソースコード・イシュートラッカー |
| ArchiveBox Demo | https://demo.archivebox.io | デモサイト |
