공유 파일을 손상시키지 않고 Synapse 미디어 디스크 공간을 확보하세요

Synapse의 미디어 저장소가 디스크 공간을 가득 채우는 경우, 먼저 어떤 디렉터리 또는 볼륨에서 용량이 증가하고 있는지 확인한 다음 Synapse에서 지원하는 보존 설정이나 관리자 API를 사용하여 미디어를 삭제하십시오. 파일을 직접 삭제하지 마십시오 media_store. Synapse는 데이터베이스에 미디어 메타데이터를 저장하므로 Synapse에서 파일을 삭제하면 참조가 깨지거나 정리 작업 감사가 어려워질 수 있습니다. 가장 안전한 정책은 해당 공간이 로컬 업로드, 다른 홈서버의 캐시된 미디어, 썸네일 또는 동일한 디스크를 공유하는 다른 서비스에서 사용되는지에 따라 달라집니다.

그 공간을 차지하는 것은 무엇일까요?

Synapse의 미디어 저장소는 로컬에 업로드된 아바타, 첨부 파일 및 썸네일을 저장합니다. 또한 원격 Matrix 서버에서 가져온 미디어와 URL 미리보기에 사용되는 리소스도 캐시합니다. 이러한 저장소는 Synapse 데이터베이스, 컨테이너 로그 및 외부 미디어 저장소와는 별개입니다. 루트 파일 시스템이 완전히 삭제되었다고 해서 그것이 media_store원인이라고 단정할 수는 없습니다.

마운트된 데이터를 소유하는 호스트 또는 컨테이너 내부에서 파일 시스템 사용량을 Synapse 데이터 디렉터리와 비교하십시오. 예시 경로를 배포 환경에 맞는 값으로 바꾸십시오.

df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store

Synapse의 media_store_path기본 경로는 media_store일반적으로 데이터 디렉터리 아래에 있지만, 설치 환경에 따라 재정의할 수 있습니다. 컨테이너는 실제 스토리지가 호스트에 있는 마운트된 볼륨에 쓸 수 있습니다. homeserver.yaml호스트 경로를 변경해도 안전한지 확인하기 전에 컨테이너 볼륨 매핑 또는 오케스트레이터의 영구 볼륨 구성을 확인하십시오. 미디어 디렉터리가 가장 많은 리소스를 소비하지 않는 경우, 대신 표시되는 구성 요소를 조사하십시오 du.

미디어에 맞는 정화 정책을 선택하세요

확인된 동작: Synapse media_retention설정에 따라 일정 기간 동안 접근이 없는 로컬 미디어와 캐시된 원격 미디어가 만료될 수 있습니다. 접근에는 미디어를 회의실에 로드하거나 다운로드하는 행위가 포함됩니다. 한 번도 접근되지 않은 항목의 경우 Synapse는 생성 시간을 기준으로 만료 시간을 설정합니다. 이 경우 원본 미디어와 해당 썸네일이 모두 삭제됩니다. 정리 작업은 미디어 저장소 워커 프로세스(Synapse의 메인 프로세스일 수 있음)에서 실행됩니다.

어떤 방식을 선택할지는 사용 사례에 따라 다릅니다. 원격 캐시 파일은 일반적으로 삭제 후 요청 시 원래 서버에서 다시 가져올 수 있습니다. 로컬에 업로드된 파일은 서버에 저장되므로 삭제하면 이전 첨부 파일이나 아바타를 사용할 수 없게 될 수 있습니다. 로컬 보존은 사용자가 이러한 결과를 감수할 수 있는 경우에만 선택하세요. 이전 첨부 파일을 보관용으로 사용하는 사용자 커뮤니티의 경우, 로컬 보존 기간을 더 길게 설정하거나 자동 로컬 정리를 하지 않는 것이 더 적합할 수 있습니다.

보존의 의미는 다음과 같습니다. 미디어 격리는 접근을 차단하지만 파일이나 썸네일을 삭제하지는 않습니다. 따라서 필요한 디스크 공간을 확보해 주지도 않습니다. 다른 데이터를 삭제하면서 격리된 항목을 보존해야 하는 경우, 격리는 관리 제어이고 보존 및 삭제는 저장 제어라는 점을 명확히 구분해야 합니다.

Synapse에서 자동 보존 기능을 활성화합니다.

설정을 편집하기 전에 활성 구성을 백업하십시오. 최상위 media_retention섹션을 추가하거나 기존 섹션을 업데이트할 수 있습니다. 예를 들어, 이 정책은 로컬 미디어에 180일 동안 접근이 없으면 만료시키고 원격 캐시 항목은 30일 후에 만료시킵니다.

media_retention:
  local_media_lifetime: 180d
  remote_media_lifetime: 30d

이 값들은 예시일 뿐이며, 일반적인 권장 사항은 아닙니다. 오래된 콘텐츠에 대한 보존 의무 및 기대치에 따라 로컬 보존 기간을 설정하십시오. 원격 미디어에 대한 캐시만 제어하려면 해당 기간만 설정하십시오. remote_media_lifetime보존 기간이 설정되지 않았거나 null인 경우 해당 유형은 자동으로 삭제되지 않습니다. Synapse 문서에 따르면 격리된 미디어와 격리로부터 보호되는 로컬 미디어는 보존 정리에서 제외됩니다.

배포의 일반적인 재시작 또는 재로드 프로세스를 사용하여 구성을 적용하고 미디어 저장소 워커가 실행 중인지 확인하십시오 enable_media_repo: true. Synapse에서 별도의 미디어 워커를 사용하는 경우 미디어 저장소 서비스가 활성화되도록 정책을 구성하십시오. 유효한 YAML 편집을 수행해도 모든 공간이 즉시 회수되지는 않습니다. 워커가 정리 작업을 실행해야 하며, 선택한 액세스 차단 시간보다 오래된 미디어만 회수됩니다.

관리자 API를 사용하여 더 빠르게 공간을 확보하세요

디스크 상태가 이미 심각한 경우, Synapse는 정리 작업을 위한 관리자 엔드포인트를 제공합니다. 이러한 작업은 미디어를 영구적으로 삭제합니다. 사용하기 전에 데이터베이스와 미디어 데이터를 백업하고, URL이 본인의 홈서버를 가리키는지 확인하고, HTTPS를 통해 서버 관리자 액세스 토큰을 사용하십시오. 토큰은 셸 기록 및 공유 로그에 기록되지 않도록 하십시오.

오래된 캐시된 원격 미디어를 삭제하려면 유닉스 에포크 이후 경과된 밀리초 단위의 타임스탬프를 지정하여 문서화된 엔드포인트를 호출하십시오.

POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>

예를 들어, 셸은 GNU를 사용하여 30일 전의 마감 시간을 계산할 수 있습니다 date.

cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
  -H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"

응답에는 캐시된 항목 중 삭제된 항목 수가 보고됩니다. 사용자가 해당 원격 파일을 다시 요청하면 Synapse는 원본 서버에서 파일을 다시 가져옵니다. 이렇게 하면 인기 있는 미디어 파일의 디스크 사용량을 복원할 수 있습니다.

로컬 미디어 삭제 API는 마지막 접근 시간을 기준으로 로컬 미디어를 삭제할 수 있으며, 선택적으로 최소 크기를 지정할 수도 있습니다. 현재 엔드포인트는 이며, POST /_synapse/admin/v1/media/delete?before_ts=…이전 엔드포인트(포함)는 <server_name>Synapse 1.78.0 버전부터 더 이상 사용되지 않습니다. 삭제 기준은 업로드 날짜가 아닌 마지막 접근 시간이며, 최소 크기 keep_profiles옵션은 기본값으로 설정되어 있습니다. 이 삭제 기능은 사용자가 계속 사용할 것으로 예상하는 파일을 삭제할 수 있으므로, 적절한 삭제 기준일을 설정하고 그 영향을 감수할 수 있는 경우가 아니라면 보존 설정을 사용하는 것이 좋습니다. 매개변수 및 설치된 Synapse 버전에 대한 자세한 내용은 공식 API 참조를 확인하십시오.

흔히 잘못 알려진 사실들을 피해야 합니다

  • "회의실을 삭제하면 미디어도 모두 삭제됩니다." 이는 잘못된 정보입니다. 회의실 기록, 미디어 파일 및 캐시된 사본은 서로 다른 작업을 통해 관리됩니다. 미디어를 구체적으로 관리하려면 미디어 관리자 API 또는 보존 정책을 사용하십시오.
  • "격리하면 디스크 공간이 확보됩니다." 이는 사실이 아닙니다. 격리된 미디어와 썸네일은 디스크에 그대로 남아 있습니다. 저장 공간 확보가 목적이라면 삭제 또는 보존 작업을 사용하십시오.
  • "저장소에 있는 모든 미디어는 사용자들이 업로드한 파일입니다." 저장소에는 원격 캐시 및 URL 미리보기 데이터도 포함되어 있습니다. 삭제 작업을 선택하기 전에 저장소 하위 디렉터리와 Synapse의 저장소 구성을 비교해 보세요.
  • "파일을 수동으로 삭제하는 것은 Synapse 정리와 동일한 효과를 냅니다." 이는 Synapse에서 지원하는 대체 방법이 아닙니다. Synapse의 보존 프로세스 또는 관리자 API를 통해 메타데이터를 업데이트하십시오.

디스크 사용량이 감소하고 있는지 확인하십시오.

정리 작업자가 실행된 후 df -h미디어 디렉터리 크기를 다시 확인하십시오. API 삭제의 경우, 응답에서 삭제된 파일 수를 확인하고 삭제 전후의 관련 디렉터리 크기를 비교하십시오. Synapse 로그에서 구성 오류 또는 작업자 오류를 확인하십시오. 디렉터리 크기가 여전히 큰 경우, 배포 환경에서 미디어를 구성된 공급자 또는 별도의 볼륨에 저장하는지 확인하십시오. Synapse 로컬 미디어 삭제 API는 외부 미디어 저장소에 저장된 미디어에는 영향을 미치지 않습니다. 파일이 다른 위치에 있는 경우 API 응답이 성공하더라도 호스트 파일 시스템의 크기가 줄어들 것이라고 가정하지 마십시오.

공식 참조

댓글 남기기

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.

요소에 "복호화 실패" 오류가 표시되나요? 누락된 룸 키를 복구하세요.

요소에 "복호화 실패" 오류가 표시되나요? 누락된 룸 키를 복구하세요.

오류가 특정 브라우저 또는 특정 이벤트에만 국한되는지 확인한 다음, Element의 복구 키 또는 신뢰할 수 있는 장치를 사용하여 암호화된 나머지 기록을 손상시키지 않고 복구할 수 있습니다.

데이터 손실 없이 오래된 Synapse 메시지와 미디어를 정리하세요

Synapse의 기록 및 미디어 삭제 API 또는 보존 설정을 사용하여 오래된 데이터를 안전하게 제거한 다음 완료 여부와 디스크 공간 복구를 확인하십시오.

Simple-Matrix-Bot-Lib을 사용하여 Python으로 Matrix Echo Bot을 구축하세요.

Simple-Matrix-Bot-Lib을 사용하여 Python으로 Matrix Echo Bot을 구축하세요.

최신 라이브러리를 설치하고, 전용 Matrix 계정을 연결한 다음, 더욱 안전한 자격 증명 처리와 명확한 테스트를 포함하는 간단한 !echo 봇을 실행하세요.

Matrix를 WhatsApp, Telegram, Discord에 각각 별도의 브리지로 연결하세요.

Matrix를 WhatsApp, Telegram, Discord에 각각 별도의 브리지로 연결하세요.

등록, 로그인 및 테스트가 각각 다른 세 개의 Mautrix 브리지를 설정하여 Docker 네트워킹, 계정 정책 및 동기화 관련 예상치 못한 문제를 방지하세요.

공유 파일을 손상시키지 않고 Synapse 미디어 디스크 공간을 확보하세요

Synapse 저장소를 채우는 항목을 찾고, 안전한 미디어 보존 설정을 지정하고, 디스크에서 파일을 직접 삭제하지 않고 원격 캐시를 정리하세요.

회의실 기록을 삭제하지 않고 비활성 Matrix 사용자 비활성화

회의실 기록을 삭제하지 않고 비활성 Matrix 사용자 비활성화

기기 활동을 검토하고, 관리자 API를 통해 비활성으로 확인된 Synapse 계정을 비활성화하고, 선택적 삭제 플래그가 실제로 무엇을 제거하는지 알아보세요.

Matrix Synapse에서 PostgreSQL 메모리 사용량 줄이기

PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.

Matrix Synapse 룸 접속이 느린 이유와 확인 사항

Matrix Synapse 룸 접속이 느린 이유와 확인 사항

Synapse 설정을 변경하기 전에 Matrix 룸이 원격 홈서버에 느리게 참여하는 원인, 페더레이션 백오프, 로컬 데이터베이스 부하 또는 아웃바운드 발신자 대기열 등을 추적해 보세요.

Synapse에서 Matrix 가입을 종료하거나 초대 토큰을 요구하세요.

자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.