Question 1

Ubuntu 24.04에서 'needs attrs!=21.1.0,>=26.1.0, but got attrs==23.2.0' 오류로 Synapse 1.153.0이 시작되지 않는 문제를 해결하는 방법은?

Accepted Answer

이 문제는 Synapse 1.153.0에서 `attrs` 최소 버전이 실수로 상향 조정되면서 발생했으며, Synapse 1.154.0에서 되돌려졌습니다.

Debian/Ubuntu 패키지를 업그레이드하여 해결하세요:

```bash
sudo apt update
sudo apt install matrix-synapse-py3
sudo systemctl restart matrix-synapse
```

`packages.matrix.org`에서 1.154.0을 아직 사용할 수 없는 경우, 임시 해결 방법으로 이전에 정상 작동하던 버전으로 다운그레이드하세요:

```bash
sudo apt install matrix-synapse-py3=1.152.1+noble1
sudo systemctl restart matrix-synapse
```

패키지 환경을 잘 이해하지 못하는 경우 pip로 `attrs`를 수동으로 강제 지정하지 마세요. 공식 해결 방법은 Synapse 1.154.0 이상으로 업그레이드하는 것입니다.

Question 2

Synapse mautrix bridge 암호화가 sticky events를 활성화한 후에 'UnboundLocalError: cannot access local variable now_token' 오류로 실패하는 이유는 무엇인가요?

Accepted Answer

이는 Synapse v1.150.0부터 v1.152.1까지의 알려진 버그로, sticky events가 동기화 처리 중 Python unbound local error를 유발합니다. 이 버그로 인해 mautrix-signal/WhatsApp과 같은 브리지가 복호화 키를 수신하지 못합니다. 임시 해결책: Synapse를 v1.149.0으로 다운그레이드하세요. 영구적인 수정은 관련 GitHub 이슈 #19409에서 추적 중입니다.

Question 3

Sliding Sync가 pos offset이 동일하게 유지될 경우 새로 요청된 required_state 이벤트를 전송하지 않는 이유는 무엇입니까?

Accepted Answer

Synapse 1.136.0 (및 이전 버전)에서 required_state 변경 사항이 다른 방 활동이 발생할 때까지 무시되는 알려진 버그입니다. 해결 방법: 방에서 이벤트를 트리거(예: 메시지 전송)하여 강제로 동기화합니다. 영구적인 수정은 PR #19792를 통해 다시 도입됩니다.

Question 4

Synapse 오류 "400 - 1 validation error for Mentions"를 암호화되지 않은 방에서 메시지를 보낼 때 어떻게 수정하나요?

Accepted Answer

이 문제는 Synapse 1.147.1과 Element Web 1.12.8/1.12.12에 영향을 줍니다. Element Web은 아무도 멘션되지 않았을 때도 m.mentions: {}를 전송합니다. Synapse는 이벤트 콘텐츠를 immutabledict로 표현하고, Pydantic v2는 Mentions 모델을 검증할 때 immutabledict({})를 거부합니다. 암호화된 방은 Synapse가 평문 콘텐츠를 보지 않기 때문에 영향을 받지 않습니다.

Pydantic 검증 전에 매핑 형태의 입력을 dict로 변환하여 Synapse에서 수정하세요:

from typing import Any, List
from pydantic import BaseModel, Field, model_validator

class Mentions(BaseModel):
    user_ids: List[str] = Field(default_factory=list)
    room: bool = False

@model_validator(mode='before')
    @classmethod
    def coerce_immutabledict(cls, v: Any) -> Any:
        if hasattr(v, 'items') and not isinstance(v, dict):
            return dict(v)
        return v

이 패치를 Synapse 패키지나 Docker 이미지에 적용하고, 다시 빌드/재배포한 뒤 Synapse를 재시작하세요. 가능하다면 이슈 #19689에 대한 수정이 포함된 공식 Synapse 릴리스로 업그레이드하세요. 임시 해결 방법: 암호화된 방을 사용하세요. 여기서는 메시지 콘텐츠가 Synapse 검증 전에 암호화됩니다.

Question 5

Synapse의 비밀번호 재설정 /requestToken 흐름에서 이메일 계정 열거를 어떻게 방지하나요?

Accepted Answer

homeserver.yaml에서 request_token_inhibit_3pid_errors: true를 설정한 다음 Synapse를 재시작하세요. 그러면 /requestToken 엔드포인트가 이메일 주소나 기타 제3자 식별자가 등록되어 있는지 공개하는 대신 프라이버시를 보호하는 응답을 반환합니다.

request_token_inhibit_3pid_errors: true

이슈 #18415에 대한 수정이 포함된 최신 Synapse 버전은 이 값을 기본적으로 true로 설정합니다. 이전의 사용성 중심 동작을 선호한다면 명시적으로 false로 설정하세요:

request_token_inhibit_3pid_errors: false

더 엄격한 프라이버시 요구 사항이 있는 경우 matrix-authentication-service를 통해 인증 흐름을 처리할 수도 있습니다.

synapse

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트