Question 1

wipeCollectorStorage에서 "TypeError: files is not iterable" 오류와 함께 발생하는 AnythingLLM collector 시작 충돌을 어떻게 수정하나요?

Accepted Answer

충돌은 collector/hotdir 또는 collector/storage/tmp가 없거나 읽을 수 없을 때 발생합니다. 예를 들어 해당 디렉터리를 삭제한 뒤이거나, 해당 폴더들이 없는 사용자 지정 볼륨을 마운트한 경우입니다. 즉시 사용 가능한 임시 해결 방법: 필요한 디렉터리를 다시 만들고 collector를 재시작하세요:

mkdir -p collector/hotdir collector/storage/tmp
touch collector/hotdir/__HOTDIR__.md collector/storage/tmp/.placeholder

Docker의 경우, 컨테이너를 시작하기 전에 마운트된 볼륨 안에 두 디렉터리가 모두 존재하는지 확인한 다음, 컨테이너를 다시 빌드/재생성하세요.

영구적인 코드 수정: collector/utils/files/index.js에서 wipeCollectorStorage의 모든 가드를 resolve();에서 return resolve();로 변경하세요. 여기에는 누락된 디렉터리 확인과 두 readdir 오류 콜백이 포함됩니다. 이렇게 하면 files가 undefined일 때 실행이 for (const file of files)로 계속되는 것을 방지합니다.

선택 사항: 중첩된 임시 디렉터리도 제거해야 한다면 fs.rmSync(file, { recursive: true, force: true })를 사용하세요.

Question 2

왜 Math.round를 사용한 후에 toFixed(decimals)가 뒷자리 0만 표시하는지, 그리고 decimals 매개변수를 무시하는 percentage 함수를 어떻게 수정할 수 있을까요?

Accepted Answer

이 버그는 포맷팅 전에 반올림을 수행하기 때문에 발생합니다: `Math.round(input * 100)`이 값을 정수로 절단하므로, `toFixed(decimals)`는 의미 없는 0만 덧붙일 수 있습니다(예: `toPercentString(0.8567, 2)`는 "85.67%" 대신 "86.00%"를 반환합니다). 포맷팅 시점까지 전체 정밀도를 유지하도록 수정하세요: `const percentage = input * 100; return (decimals > 0 ? percentage.toFixed(decimals) : Math.round(percentage).toString()) + "%";`. 이렇게 하면 기본 `decimals = 0` 경로와 `null`/`NaN` 입력(여전히 빈 문자열을 반환함)에 대한 기존 동작이 유지되면서, `decimals > 0`도 올바르게 작동합니다.

Question 3

AnythingLLM이 시스템 프롬프트 변수를 확장할 때 왜 $$와 $&가 손상되나요?

Accepted Answer

JavaScript의 String.prototype.replace()는 문자열 치환에서 $$, $&, $`, $'를 특수 패턴으로 취급합니다. server/models/systemPromptVariables.js에서

result = result.replace(match, value);

를 다음과 같이 치환 함수로 바꾸세요. 그러면 저장된 값이 문자 그대로 삽입됩니다:

result = result.replace(match, () => value);

그런 다음 Node/dev 서버를 재시작하세요. 이는 {workspace.name} 및 {user.bio}와 같은 정적 변수, 워크스페이스 변수, 사용자 변수 문제를 해결합니다. 이 버그는 master 커밋 3c7e73b8에서 재현되었습니다. fix(server): keep $$ and $& intact when expanding prompt variables PR이 포함된 릴리스로 업그레이드하거나 위 패치를 적용하세요.

Question 4

Node.js 20에서 AnythingLLM 채팅 및 DeepSeek 모델 목록의 'Premature close' 오류를 해결하는 방법

Accepted Answer

이 오류는 OpenAI SDK v4가 `node-fetch@2`를 번들링하기 때문에 발생하며, 최근 Node.js 보안 업데이트(예: Node v20.19.2) 이후 gzip으로 인코딩된 응답에서 충돌이 발생합니다. 이로 인해 채팅 요청(`Invalid response body... Premature close`)과 `/v1/models` 가져오기가 실패하여, 구형 모델로 폴백되고 이후 400 오류가 발생합니다. SDK가 네이티브 fetch를 사용하도록 강제하여 수정하세요: 1) `require('openai/shims/web');`을 포함하는 `server/fix-node-fetch.cjs`를 생성합니다. 2) `NODE_OPTIONS='--require=./fix-node-fetch.cjs'`로 서버를 시작합니다. shim 적용 후 DeepSeek 모델 목록(예: deepseek-flash, deepseek-v4-pro)이 올바르게 로드되고 채팅이 작동합니다. 영구적인 해결 방법: 네이티브 fetch를 사용하는 v6으로 `openai` 종속성을 업그레이드하세요.

Question 5

macOS에서 AnythingLLM Desktop의 "Document Processor Unavailable" 오류를 해결하는 방법

Accepted Answer

이 오류는 macOS 네트워크 필터나 VPN(예: LuLu 방화벽)이 목적지가 `0.0.0.0`인 연결을 차단할 때 발생합니다. AnythingLLM의 서버는 `http://0.0.0.0:${COLLECTOR_PORT}`로 문서 수집기(document collector)에 연결하는데, 필터가 쓰기를 끊어버리므로(EPIPE/broken pipe) 수집기가 정상임에도 `/api/system/document-processing-status`가 503을 반환합니다.

**해결 방법(한 줄 코드 수정):** `server/utils/collectorApi/index.js`에서 `0.0.0.0` 대신 루프백에 명시적으로 연결하세요:
```diff
- this.endpoint = `http://0.0.0.0:${CollectorApi.getCollectorPort()}`;
+ this.endpoint = `http://127.0.0.1:${CollectorApi.getCollectorPort()}`;
```
`0.0.0.0`은 유효한 목적지가 아니라 바인드 주소입니다. `127.0.0.1`은 수집기가 `127.0.0.1`에 바인드되든 `0.0.0.0`에 바인드되든 작동하며, Docker에서는 서버와 수집기가 컨테이너 루프백을 공유합니다. `parseNvidiaNimBasePath`에 있는 동일한 `localhost → 0.0.0.0` 재작성 패턴도 함께 수정해야 합니다.

**우회 방법(코드 변경 없음):** LuLu(또는 `0.0.0.0`을 차단하는 VPN/필터)를 일시적으로 비활성화하세요. 참고: `0.0.0.0`에 대한 LuLu 허용 규칙을 추가하는 것은—전역 `* → 0.0.0.0:*` 허용 규칙조차도—효과가 없습니다. LuLu를 비활성화해야만 해결됩니다. `curl http://0.0.0.0:8888/`(broken pipe = 차단됨)와 `curl http://127.0.0.1:8888/`(정상)로 확인하세요.

AnythingLLM

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트