Q: v0.7.3에서 Web UI Pull 버튼과 CLI에 대해 ArchiveBox 기본 extractor를 전역으로 변경하려면 어떻게 해야 하나요?

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 모노레포 설정을 사용하세요:

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

가상 환경은 `archivebox/` 하위 디렉토리가 아니라 모노레포 루트에 생성됩니다. ArchiveBox 작업을 하려면 루트 환경을 활성화한 상태로 유지한 채 하위 디렉토리로 이동하세요:

```bash
cd archivebox
```

다음 명령으로 editable 설치를 확인하세요:

```bash
uv run archivebox version
```

`./bin/lock_pkgs.sh`는 실행하지 마세요. 모노레포에서는 더 이상 이를 사용하지 않습니다.

Question 2

v0.7.3에서 Web UI Pull 버튼과 CLI에 대해 ArchiveBox 기본 extractor를 전역으로 변경하려면 어떻게 해야 하나요?

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 커밋에서 결정하는 의존성 버전을 사용하세요.

split-repo 설정으로 인해 버전 불일치가 계속 발생하면, 관련 프로젝트들을 서로 연결해 주는 공식 [ArchiveBox monorepo 설정](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()`에 전달할 수 있으며, 그러면 `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

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트