추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법
Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.
Matrix Synapse의 오래된 데이터를 안전하게 삭제하려면 회의실 기록과 미디어를 별도의 작업으로 처리하십시오. 오래된 회의실 이벤트는 기록 삭제 관리자 API를, 로컬 미디어는 미디어 삭제 API를, 다른 홈서버에서 다운로드한 파일은 원격 미디어 캐시 API를 사용하여 삭제합니다. 정기적인 정리를 위해서는 메시지와 미디어에 대한 보존 정책을 구성하십시오. 데이터베이스 행을 삭제해도 디스크의 데이터베이스 파일 크기가 즉시 줄어들지 않을 수 있습니다.
| 무엇이 공간을 차지하고 있나요? | 사용 | 중요한 제한 |
|---|---|---|
| 이전 메시지 및 기타 방 이벤트 | 기록 삭제 관리자 API 또는 자동 메시지 보존 | 히스토리 삭제는 방별로 적용됩니다. 방 상태는 보존되며, Synapse는 각 방에 최소 하나의 메시지를 보관합니다. |
| 홈서버에 저장된 미디어 | 로컬 미디어 API 삭제 또는 로컬 미디어 보존 | 프로필 및 방 아바타에 사용되는 미디어는 기본적으로 날짜/크기 엔드포인트를 통해 보호됩니다. |
| 다른 홈서버에서 캐시된 미디어 | 원격 미디어 API 삭제 또는 원격 미디어 보존 | 다시 요청되면 Synapse는 원래 서버에서 해당 데이터를 다시 가져옵니다. |
이러한 제어는 Synapse 자체 데이터베이스 및 미디어 저장소에 영향을 미칩니다. Matrix Media Repository와 같은 외부 미디어 저장소를 사용하는 경우 Synapse의 로컬 미디어 삭제 엔드포인트는 해당 저장소에 저장된 파일을 삭제하지 않습니다. 데이터를 삭제하기 전에 해당 저장소의 설명서 및 백업 정책을 확인하십시오.
enable_media_repo: true. 이것이 주 프로세스일 수 있습니다. 정리가 실행되지 않는 것처럼 보이는 경우, 문제를 진단하기 전에 라우팅 및 구성을 확인하십시오.아래 예시에서 https://matrix.example.com<홈서버의 클라이언트용 기본 URL>을 실제 홈서버 URL로 바꾸고, 유효한 방 ID를 설정한 다음, 관리자 토큰을 내보내십시오 ADMIN_TOKEN. 베어러 토큰은 비공개로 유지하십시오.
이벤트 기록 삭제 API는 지정된 시점보다 오래된 이벤트를 Synapse 데이터베이스에서 제거합니다. 다른 서버의 메시지는 수정되지 않으며, 채팅방을 삭제하는 것과는 다릅니다. Synapse는 기본적으로 원격 사용자가 보낸 이벤트는 삭제하지만 로컬 사용자의 이벤트는 유지합니다. 로컬 사용자의 이벤트 도 삭제하려면 이 옵션을 delete_local_events활성화 해야 true합니다. 채팅방의 멤버십 및 주제와 같은 상태 정보는 유지됩니다.
예를 들어, Linux 호스트에서 현재 시간으로부터 180일 전을 마감 시간으로 설정하려면 타임스탬프를 밀리초 단위로 계산하고, 이를 확인한 다음, 단일 회의실 사용 요청을 제출하면 됩니다.
export SYNAPSE_URL='https://matrix.example.com'
export ROOM_ID='!roomid:example.com'
export ADMIN_TOKEN='replace-with-a-server-admin-token'
PURGE_BEFORE_MS=$(python3 -c 'import time; print(int((time.time() - 180*86400) * 1000))')
printf 'Cutoff (Unix milliseconds): %s\n' "$PURGE_BEFORE_MS"
curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_history/$ROOM_ID" \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'Content-Type: application/json' \
-d "{\"purge_up_to_ts\":$PURGE_BEFORE_MS,\"delete_local_events\":true}"
Synapse의 기본 동작을 원하면 이 값을 생략 delete_local_events하거나 설정하세요 . API에서 를 반환하면 삭제 작업이 시작된 것이며, 반드시 완료된 것은 아닙니다. 상태 엔드포인트를 주기적으로 확인하여 보고될 때까지 기다리 거나, 상태가 인 경우 해당 엔드포인트를 조사하세요 .falsepurge_idcompleteerrorfailed
curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
-H "Authorization: Bearer $ADMIN_TOKEN"
대규모 삭제 작업은 몇 분 이상 소요될 수 있습니다. 작업이 진행되는 동안 사용자는 삭제되는 지점 이후의 메시지는 해당 방에서 더 이상 페이지로 이동할 수 없을 수 있습니다. Synapse는 각 방에 최소 하나의 메시지를 유지하므로 이 API를 사용해도 방의 타임라인이 완전히 비워지지는 않습니다.
특정 시간 제한 전에 마지막으로 사용된 로컬 미디어를 한 번 정리하려면 현재 로컬 미디어 엔드포인트를 사용하십시오. 이 엔드포인트는 before_ts밀리초 단위의 유닉스 타임스탬프이며, size_gt특정 바이트 임계값 이상의 파일을 대상으로 지정할 수도 있습니다. 기본 설정은 프로필 또는 룸 아바타 이미지에 사용되는 미디어를 유지하는 것입니다. 이러한 파일을 의도적으로 제거하려는 경우가 아니면 이 설정을 사용하지 마십시오 keep_profiles=false.
curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/media/delete?before_ts=$PURGE_BEFORE_MS" \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'Content-Type: application/json' \
-d '{}'
응답 total및 삭제된 미디어 ID를 검토하십시오. 엔드포인트는 로컬 원본 파일과 썸네일을 삭제합니다. 이전 경로(<code>.h</code>)는 사용하지 마십시오 /media/<server_name>/delete. Synapse 문서에서는 해당 경로가 v1.78.0부터 더 이상 사용되지 않는다고 명시하고 있습니다. 현재 로컬 미디어 엔드포인트는 별도의 외부 미디어 저장소를 사용하지 않습니다.
캐시된 원격 미디어는 별도의 범주입니다. 동일한 마감 시간 이전에 마지막으로 액세스된 캐시의 원격 미디어를 제거하려면 다음을 사용하십시오.
curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_media_cache?before_ts=$PURGE_BEFORE_MS" \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H 'Content-Type: application/json' \
-d '{}'
응답에는 캐시된 항목 중 삭제된 항목의 수가 보고됩니다. 사용자가 나중에 해당 파일을 요청하면 Synapse는 원본 서버에서 파일을 다시 다운로드할 수 있으므로, 이 작업은 로컬 디스크 사용량 증가와 네트워크 트래픽 증가, 검색 지연을 초래합니다.
Synapse 메시지 보존은 기본적으로 비활성화되어 있습니다. 자체 보존 상태가 없는 회의실에 대해 서버 전체에 적용되는 기본 설정을 적용하려면 구성에 정책을 추가하고 활성화하십시오. 이 예에서는 최대 보존 기간을 1년으로 설정합니다.
retention:
enabled: true
default_policy:
max_lifetime: 1y
Synapse에서 지원하는 기간 단위(예: d일 또는 년 ) 를 사용하세요 y. 회의실 관리자와 운영자는 회의실 m.room.retention상태 이벤트를 설정할 수 있으며, 서버 관리자는 허용되는 최대 수명을 설정할 수 있습니다 . 정책을 활성화하기 전에 전체 정책을 검토하세요. 자격이 있는 이벤트는 백그라운드 삭제 작업에 의해 영구적으로 제거됩니다. Synapse는 만료된 이벤트를 클라이언트에서 즉시 숨기지만, 데이터베이스 삭제 작업은 주기적으로 실행되므로 작업이 실행될 때까지 행이 남아 있을 수 있습니다. 상태 이벤트는 메시지 보존 정책에 포함되지 않습니다.allowed_lifetime_minallowed_lifetime_max
미디어의 경우, media_retention예를 들어 다음과 같이 수명을 추가하세요.
media_retention:
local_media_lifetime: 90d
remote_media_lifetime: 14d
이 수명은 단순히 업로드 기간 제한이 아니라 비활성 기간을 나타냅니다. 파일에 액세스한 경우 Synapse는 마지막 액세스 시간을 사용하고, 한 번도 액세스하지 않은 미디어의 경우 생성 시간을 사용합니다. 원본 파일과 썸네일은 삭제됩니다. 격리된 미디어와 격리에서 보호된 로컬 미디어는 이 정리 작업에서 삭제되지 않습니다. 미디어 저장소를 호스팅하는 프로세스에서 미디어 보존 설정을 구성한 다음, 사용 중인 Synapse 버전의 구성 설명서를 참조하여 설정을 확인하십시오.
변경 사항을 적용하기 전에 공식 삭제 기록 API , 미디어 관리 API , Synapse 구성 설명서 및 메시지 보존 정책 문서를 읽어보세요 . 여기에 설명된 API 동작은 2026년 10월 10일에 확인된 공식 문서를 기반으로 합니다. 설치된 릴리스에 따라 엔드포인트 및 구성을 확인하십시오.
complete. 유지 관리 로그를 위해 삭제 ID와 응답을 보관하십시오.VACUUM FULL디스크 공간을 회수할 수 있지만 배타적 잠금이 필요합니다. 다운타임 및 영향 요소를 고려하여 일정을 계획하고 PostgreSQL VACUUM 문서를 참조하십시오 . SQLite의 경우 Synapse의 보존 문서 VACUUM에서 해당 작업을 확인할 수 있습니다.Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.
오류가 특정 브라우저 또는 특정 이벤트에만 국한되는지 확인한 다음, Element의 복구 키 또는 신뢰할 수 있는 장치를 사용하여 암호화된 나머지 기록을 손상시키지 않고 복구할 수 있습니다.
Synapse의 기록 및 미디어 삭제 API 또는 보존 설정을 사용하여 오래된 데이터를 안전하게 제거한 다음 완료 여부와 디스크 공간 복구를 확인하십시오.
최신 라이브러리를 설치하고, 전용 Matrix 계정을 연결한 다음, 더욱 안전한 자격 증명 처리와 명확한 테스트를 포함하는 간단한 !echo 봇을 실행하세요.
등록, 로그인 및 테스트가 각각 다른 세 개의 Mautrix 브리지를 설정하여 Docker 네트워킹, 계정 정책 및 동기화 관련 예상치 못한 문제를 방지하세요.
Synapse 저장소를 채우는 항목을 찾고, 안전한 미디어 보존 설정을 지정하고, 디스크에서 파일을 직접 삭제하지 않고 원격 캐시를 정리하세요.
기기 활동을 검토하고, 관리자 API를 통해 비활성으로 확인된 Synapse 계정을 비활성화하고, 선택적 삭제 플래그가 실제로 무엇을 제거하는지 알아보세요.
PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.
Synapse 설정을 변경하기 전에 Matrix 룸이 원격 홈서버에 느리게 참여하는 원인, 페더레이션 백오프, 로컬 데이터베이스 부하 또는 아웃바운드 발신자 대기열 등을 추적해 보세요.
자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.