🇰🇷 한글 설명
VoiceSentinel은 Minecraft 서버용 실시간 음성 모더레이션 시스템입니다. 2.2.1부터 3.3.1 이전 버전에서 선택적 신고 버퍼 기능의 보존 기간 정리 작업과 일반 전사 기록 쓰기 사이에 경쟁 조건(race condition)이 존재합니다. 정리 작업이 transcripts.jsonl 파일을 잠금 없이 제자리에서 다시 쓰기 때문에 데이터 손실, 중복, 손상이 발생할 수 있으며, 보존 기간에 따른 삭제가 무력화되어 디스크 사용량이 무제한으로 증가할 수 있습니다.
💡 쉬운 설명
여러 작업이 동시에 같은 기록 파일을 수정하면서 대화 기록이 꼬이거나 사라질 수 있습니다. 자동 삭제 기능이 제대로 동작하지 않아 디스크가 가득 차서 서버가 다운될 수 있습니다.
🇺🇸 원문 (English)
VoiceSentinel is a real-time voice moderation system for Minecraft servers. From 2.2.1 until 3.3.1, the optional report buffer feature has a race between retention cleanup and normal transcript writes. In `report_buffer.py`, `_maybe_cleanup()` uses an unlocked dictionary for once-per-hour cleanup throttling, allowing simultaneous `_cleanup_tenant()` operations for one tenant. Cleanup reads `transcripts.jsonl` and rewrites it in place without file locking or atomic replacement, while `report_buffer_append_async` uses `asyncio.to_thread` to append without synchronization. In `main.py`, concurrent `_processing_worker` tasks make this reachable in normal operation; `processing.worker_count` of two or more and public-pool servers sharing a `server_key` increase collisions. With `report_buffer.enabled` set to true, racing writes can lose, duplicate or corrupt transcript data and defeat `report_buffer.retention_seconds` pruning, allowing unbounded disk growth that can exhaust storage and crash the host or other services sharing it. The feature is opt-in and disabled by default. This issue is fixed in version 3.3.1.
📍 영향받는 시스템
VoiceSentinel 2.2.1 이상 3.3.1 미만 버전 중 report_buffer 기능을 활성화한 서버 (기본값은 비활성화)
⚔️ 공격 벡터
별도의 권한 없이도 정상적인 동시 처리 부하에서 발생하며, 다수 사용자가 트래픽을 유발하면 디스크 고갈 등의 서비스 장애를 유발할 수 있음
🛡️ 대응 방법
VoiceSentinel을 3.3.1 이상으로 업그레이드하거나, 해당 버전까지 report_buffer.enabled를 false로 설정
🔧 검증 코드
출력된 Version 값이 3.3.1 미만이고 config의 report_buffer.enabled가 true이면 취약하므로 업그레이드가 필요하며, 3.3.1 이상이면 수정된 버전입니다.
pip show voicesentinel 2>/dev/null | grep -i version