Q: v0.7.3でWeb UIのPullボタンとCLIに対してArchiveBoxのデフォルトエクストラクターをグローバルに変更するにはどうすればよいですか？

ArchiveBox v0.7.x では、古い ` _ENABLED` という名前ではなく、`SAVE_ ` 設定オプションを使用してください。`WGET_ENABLED` は認識されないため、「These options failed to set (check for typos)」というエラーが発生します。 Docker コンテナ内で実行します: ```bash docker compose exec archivebox archivebox config --set SAVE_WGET=False ``` コンテナが起動していないために `exec` が機能しない場合は、次を実行します: ```bash docker compose run --rm archivebox config --set SAVE_WGET=False ``` 主なエクストラクター設定には以下があります: ```bash SAVE_TITLE SAVE_FAVICON SAVE_WGET SAVE_WARC SAVE_SINGLEFILE SAVE_READABILITY SAVE_MERCURY SAVE_GIT SAVE_MEDIA SAVE_ARCHIVE_DOT_ORG ``` それぞれを `True` または `False` に設定します。例: ```bash docker compose exec archivebox archivebox config --set SAVE_WGET=False SAVE_MERCURY=False SAVE_ARCHIVE_DOT_ORG=False ``` 確認するには次を実行します: ```bash docker compose exec archivebox archivebox config | grep SAVE_ ``` これらの値は `ArchiveBox.conf` に保存され、CLI でのアーカイブや Web UI の Pull ボタンのデフォルトとなるため、毎回 `--extract` を渡す必要はありません。`dev` ブランチでは、エクストラクター設定は個々のプラグインが管理しており、管理 UI の `Default` persona を編集して変更することもできます。

Question 1

ArchiveBox の開発環境セットアップ中に './bin/lock_pkgs.sh' が "your project's requirements are unsatisfiable" というエラーで失敗する場合、どのように修正すればよいですか？

Accepted Answer

古い `lock_pkgs.sh` ワークフローは廃止されました。代わりに新しい ArchiveBox monorepo セットアップを使用してください:

```bash
git clone https://github.com/ArchiveBox/monorepo.git
cd monorepo
./bin/setup.sh
uv sync --all-extras --dev
source .venv/bin/activate
```

仮想環境は `archivebox/` サブディレクトリ内ではなく、monorepo のルートに作成されます。ArchiveBox で作業するには、ルートの環境をアクティブに保ったまま、サブディレクトリに移動してください:

```bash
cd archivebox
```

次のコマンドでエディタブルインストールを確認してください:

```bash
uv run archivebox version
```

`./bin/lock_pkgs.sh` は実行しないでください。monorepo ではもう使用されていません。

Question 2

v0.7.3でWeb UIのPullボタンとCLIに対してArchiveBoxのデフォルトエクストラクターをグローバルに変更するにはどうすればよいですか？

Accepted Answer

ArchiveBox v0.7.x では、古い `_ENABLED` という名前ではなく、`SAVE_` 設定オプションを使用してください。`WGET_ENABLED` は認識されないため、「These options failed to set (check for typos)」というエラーが発生します。 Docker コンテナ内で実行します: ```bash docker compose exec archivebox archivebox config --set SAVE_WGET=False ``` コンテナが起動していないために `exec` が機能しない場合は、次を実行します: ```bash docker compose run --rm archivebox config --set SAVE_WGET=False ``` 主なエクストラクター設定には以下があります: ```bash SAVE_TITLE SAVE_FAVICON SAVE_WGET SAVE_WARC SAVE_SINGLEFILE SAVE_READABILITY SAVE_MERCURY SAVE_GIT SAVE_MEDIA SAVE_ARCHIVE_DOT_ORG ``` それぞれを `True` または `False` に設定します。例: ```bash docker compose exec archivebox archivebox config --set SAVE_WGET=False SAVE_MERCURY=False SAVE_ARCHIVE_DOT_ORG=False ``` 確認するには次を実行します: ```bash docker compose exec archivebox archivebox config | grep SAVE_ ``` これらの値は `ArchiveBox.conf` に保存され、CLI でのアーカイブや Web UI の Pull ボタンのデフォルトとなるため、毎回 `--extract` を渡す必要はありません。`dev` ブランチでは、エクストラクター設定は個々のプラグインが管理しており、管理 UI の `Default` persona を編集して変更することもできます。

Question 3

K3sでArchiveBoxを実行した際に「getpwuid(): uid not found: 999」というエラーが発生する場合、どうすれば修正できますか？

Accepted Answer

これは、K3s がコンテナを UID 999 として実行しているにもかかわらず、その UID に対応するユーザーエントリが `/etc/passwd` に存在しない場合に発生します。ArchiveBox の設定ローダーがユーザー名の解決中に失敗しました。コミット `19aefc85e6c3801ac6c77246c1534fc9758739df` を含む修正済みの `dev` イメージ、またはそれを含む以降のリリースにアップグレードしてください：

```bash
kubectl set image deployment/archive archivebox=archivebox/archivebox:dev -n archive
kubectl rollout restart deployment/archive -n archive
```

その後、確認します：

```bash
kubectl rollout status deployment/archive -n archive
kubectl logs -n archive deployment/archive
```

`dev` を使用できない場合は、一時的に動作していた古いイメージに固定してください：

```yaml
image: archivebox/archivebox:sha-4950cee
```

`PUID=999` を設定しても、この特定の起動エラーは解決しません。本番データに対して `dev` イメージを実行する前に、バックアップを取るか、空のコレクションでテストしてください。

Question 4

ArchiveBoxのエラー「setup_services() got an unexpected keyword argument 'derived_config_overrides'」および「KeyError: 'PLUGINS'」を修正する方法

Accepted Answer

これらのエラーは、ArchiveBox の dev ブランチが互換性のない `abx-dl` リリース（例: `abx-dl v1.10.21`）に対してビルドされた場合に発生します。`archivebox/services/runner.py` 内の呼び出し側と `abx-dl/orchestrator.py` 内の `setup_services()` 定義の同期が取れておらず、その結果、期待される `PLUGINS` 実行状態キーも欠落したままになります。

一致する ArchiveBox と `abx-dl` のコミットに更新し、キャッシュなしで再ビルドすることで修正できます:

```bash
git checkout dev
git pull origin dev
git submodule update --init --recursive
podman build --no-cache . -t archivebox --format docker
```

無関係な `abx-dl` バージョンをピン留めしたり、個別にインストールしたりしないでください。ビルド対象の ArchiveBox コミットによって解決される依存バージョンを使用してください。

分割リポジトリのセットアップでバージョン不一致が引き続き発生する場合は、関連プロジェクトを相互にリンクする公式の [ArchiveBox モノレポセットアップ](https://github.com/ArchiveBox/monorepo) を使用してください。Node.js 24 の Dockerfile 変更は、これらの Python API 不一致エラーとは無関係です。

Question 5

Wallabag の Atom フィードを ArchiveBox にインポートする際に発生する 'No such file or directory' エラーを修正するにはどうすればよいですか？

Accepted Answer

これは、コミット `a676767` 以降の ArchiveBox 0.6.3/dev ビルドに影響します。Wallabag Atom パーサーが生の XML や空白で分割されたフィードコンテンツを `add()` に渡す可能性があり、その結果、それらの文字列をファイルパスとして開こうとします。PR #1787 を含むビルドにアップグレードするか、`ArchiveBox/abx-plugins` から Wallabag パーサープラグインを更新してください。ソースからインストールしている場合は、以下の方法で修正をテストできます。

```bash
git fetch origin pull/1787/head:pr-1787
git checkout pr-1787
```

その後、再試行してください。

```bash
curl 'https://app.wallabag.it/feed/.../archive' | archivebox add --parser=wallabag_atom
```

修正を手動で適用する場合は、Atom パーサーが実際の `http://` または `https://` の URL エントリのみを抽出し、生の XML や URL 以外のテキストトークンを `add()`/`Path` に決して渡さないことを確認してください。

ArchiveBox

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト