Question 1

latest를 pull한 후 MongoDB Docker 실패: "Invalid feature compatibility version value '8.2'"를 어떻게 수정하나요?

Accepted Answer

latest MongoDB 이미지는 featureCompatibilityVersion: "8.2"로 시작할 수 없는 더 새로운 메이저 버전으로 이동했습니다. 먼저 MongoDB 8.3을 거쳐 업그레이드하세요.

즉시 사용할 수 있는 우회 방법: compose.yaml에서 이미지를 고정하세요.
image: docker.io/mongo:8.2
그런 다음 실행하세요.
docker compose up -d

마이그레이션을 완료하려면:
1. 이미지를 8.3으로 변경하세요.
image: docker.io/mongo:8.3
2. MongoDB를 시작하세요.
docker compose pull
docker compose up -d
3. mongosh를 여세요.
docker compose exec database mongosh
4. 기능 호환성 버전을 업데이트하세요.
db.adminCommand({ setFeatureCompatibilityVersion: "8.3", confirm: true })
5. 이미지를 docker.io/mongo:latest 또는 프로젝트에서 고정한 MongoDB 8 이미지로 다시 전환한 다음 재시작하세요.
docker compose pull
docker compose up -d
마이그레이션을 수행하기 전에 데이터베이스를 백업하세요. 영향을 받은 프로젝트는 MongoDB를 메이저 버전 8로 고정하는 임시 수정 사항도 병합했습니다.

Question 2

Linux kernel 6.19에서 MongoDB 8.x가 충돌하는 문제를 어떻게 해결하나요?

Accepted Answer

MongoDB 8.0+는 Linux 커널 6.19의 rseq ABI 변경과 호환되지 않는 벤더링된 TCMalloc 버전을 사용하므로 데이터베이스 충돌을 일으킵니다. 다음 해결 방법 중 하나를 사용하십시오:

1. MongoDB를 7.0으로 고정 (가장 안전한 즉각적인 해결책):
image: mongo:7.0
또는 Docker의 경우:
docker run -d --name mongo mongo:7.0

2. 호스트를 더 오래된 커널로 부팅하십시오. 이상적으로는 6.19보다 이전 버전입니다. 실행 중인 커널을 확인하려면:
uname -r
배포판에서 지원하는 이전 커널을 설치하고, GRUB/systemd-boot에서 선택한 다음 재부팅하십시오.

6.17, 그리고 아마도 6.6과 같은 초기 커널 버전도 근본적인 TCMalloc 문제의 영향을 받을 수 있지만, MongoDB의 공식 공지에서는 6.19를 언급합니다. 수정된 릴리스가 제공되면 MongoDB 또는 TCMalloc을 업그레이드하십시오.

Question 3

migration 51 NamespaceExists: audit_logs collection already exists 오류와 함께 발생하는 Stoat API crash loop을 어떻게 수정하나요?

Accepted Answer

API 이미지를 v0.15.1에서 v0.15.5 이상으로 업그레이드하세요. 업데이트 후 마이그레이션 실패가 해결된 것으로 확인되었습니다. 이미지 참조를 업데이트하세요. 예: ghcr.io/stoatchat/api:v0.15.5, 그런 다음 API 컨테이너를 다시 생성하세요. v0.15.1을 일시적으로 시작해야 하는 경우, 먼저 MongoDB를 백업하고 기존 컬렉션을 삭제하여 마이그레이션 51이 이를 다시 생성할 수 있도록 하세요: docker exec -it <mongo-container> mongosh (또는 MongoDB 4.4에서는 mongo), 그런 다음 use revolt; db.audit_logs.drop();. 이후 즉시 API를 재시작하세요. 이는 임시 해결 방법일 뿐이며 업그레이드할 때까지 다시 발생할 수 있습니다. 컬렉션을 삭제하면 기존 감사 로그 데이터도 제거됩니다.

Question 4

자체 호스팅 Stoat 인스턴스에서 hCaptcha가 로드되지 않고 등록이 api.stoat.chat을 호출하는 문제를 어떻게 수정하나요?

Accepted Answer

VITE_API_URL 변수가 잘못된 서비스에 적용되고 있습니다. web 컨테이너가 env 파일을 통해 이 변수를 받도록 해야 프런트엔드가 https://api.stoat.chat 대신 자체 호스팅 API를 사용합니다.

1. Compose 프로젝트 디렉터리에 .env.web을 만드세요:
VITE_API_URL=https://stoat.kebel.space/api

2. docker-compose.yml의 web 서비스에 env_file을 추가하세요:
web:
  image: ghcr.io/stoatchat/for-web:0c31cf0
  env_file:
    - .env.web
  networks:
    vpn_net:
      ipv4_address: 172.30.0.65
  restart: always

3. 컨테이너를 다시 생성하세요:
docker compose stop
docker compose rm
docker compose up -d --force-recreate

4. 브라우저를 강력 새로고침하거나 시크릿 모드를 사용하세요. 이제 등록 요청은 https://stoat.kebel.space/api로 가야 하며, api.stoat.chat에서 발생한 CaptchaFailed 400 오류는 해결되어야 합니다. Revolt.toml에서 hcaptcha_key와 hcaptcha_sitekey도 올바르게 구성되었는지 확인하세요.

Question 5

Docker에서 실행 중인 셀프 호스팅 Stoat/Revolt의 파일 업로드 제한을 늘리려면 어떻게 해야 하나요?

Accepted Answer

설정 기반 업로드 제한 수정이 포함된 릴리스로 업그레이드한 다음, `Revolt.toml`에서 제한을 구성하세요. 새 계정은 72시간 동안 `new_user` 제한을 사용하므로 두 섹션을 모두 업데이트하세요:

```toml
[features.limits.default.file_upload_size_limit]
attachments = 20_000_000_000

[features.limits.new_user.file_upload_size_limit]
attachments = 20_000_000_000

[features.limits.global]
body_limit_size = 25_000_000_000
```

`docker-compose.yml`에서 Autumn에 대한 동일하거나 더 큰 폴백 상한을 설정하세요:

```yaml
services:
  autumn:
    environment:
      MAX_FILE_SIZE: "25000000000"
```

값은 바이트 단위이며, `body_limit_size`/`MAX_FILE_SIZE`는 허용되는 가장 큰 첨부 파일보다 커야 합니다. 다음 명령으로 적용하세요:

```bash
docker compose pull
docker compose up -d --force-recreate delta autumn
```

`docker exec ... /bin/bash`에 의존하지 마세요: 최소 이미지에는 Bash가 포함되어 있지 않을 수 있으며, 컨테이너 내부에서 변경한 내용은 유지되지 않습니다. 대신 호스트에 마운트된 구성이나 환경 변수를 사용하세요.

Stoat Self-Hosted

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트