Xwayland를 사용하는 Wayland 환경에서 Element Desktop이 충돌하는 문제를 해결합니다.
Xwayland를 통해 Element Desktop을 테스트하고, 로컬 데이터를 보존하며, Linux Wayland에서 앱이 충돌할 때 그래픽 또는 패키지 문제를 격리하십시오.
Linux 또는 앱 업데이트 후 Element Desktop이 충돌하거나 열리지 않는 문제가 발생하면 먼저 Xwayland를 통해 테스트해 보세요. 모든 Element 프로세스를 종료한 다음 element-desktop --ozone-platform=x11터미널에서 Element를 실행합니다. Electron 38은 Wayland 세션에서 네이티브 Wayland를 사용하도록 기본 설정을 변경했으며, Electron 문서에는 Xwayland 플래그를 사용하면 X11 호환성 경로로 되돌릴 수 있다고 나와 있습니다. 이렇게 하면 Element가 안정적으로 작동한다면, 업데이트된 패키지나 컴포지터 관련 문제를 확인하는 동안 임시 해결책으로 사용할 수 있습니다.
이것이 모든 경우에 Wayland가 원인이라는 것을 증명하는 것은 아닙니다. Element는 Electron 애플리케이션이지만, 오래된 패키지, 그래픽 드라이버, 확장 프로그램 또는 로컬 구성으로 인해 충돌이 발생할 수도 있습니다. 계정 데이터를 삭제하지 않고 문제를 분리하려면 아래 단계를 따르세요.
Wayland는 현재 많은 Linux 데스크톱에서 사용되는 디스플레이 프로토콜입니다. Xwayland는 기존 X11 애플리케이션이 Wayland 세션 내에서 실행될 수 있도록 하는 호환성 계층입니다. Electron 38은 Ozone 플랫폼의 기본값을 Wayland로 변경했습니다 . auto이제 XDG_SESSION_TYPE=waylandElectron은 기본적으로 Wayland에서 네이티브로 실행됩니다. Electron은 또한 기존의 환경 변수를 제거했습니다 . Xwayland를 강제로 사용하도록 설정ELECTRON_OZONE_PLATFORM_HINT 하는 공식 스위치는 `--Xwayland --ozone-platform=x11...
Element Desktop은 Electron 환경에서 Element Web을 실행합니다. 데스크톱 코드는 Element Web 저장소에 있으며, 프로젝트 문서에는 데스크톱 앱이 Electron으로 래핑된 형태로 설명되어 있습니다. Element 다운로드 페이지는 현재 Debian 및 Ubuntu용 공식 Linux 설치 경로를 제공하며, 다른 배포판용 커뮤니티에서 관리하는 패키지 링크도 제공합니다. 패키지 동작은 배포판 및 패키징 형식에 따라 다를 수 있습니다.
터미널을 열고 현재 활성화된 디스플레이 세션을 확인하십시오.
echo "$XDG_SESSION_TYPE"
element-desktop --version
첫 번째 명령이 를 출력하면 wayland세션이 Wayland입니다. 를 출력하면 x11Electron의 Wayland 기본 설정 변경이 충돌의 원인일 가능성은 낮습니다. 일부 패키징 형식에서는 버전 명령을 사용할 수 없을 수 있습니다. 이 경우 앱의 정보 화면이나 패키지 관리자를 확인하세요.
동일한 터미널에서 Element를 시작하고 출력 결과를 계속 표시하십시오.
element-desktop
창이 닫히기 전에 출력되는 첫 번째 오류 메시지와 함께 사용 중인 Linux 배포판, 데스크톱 환경, 그래픽 드라이버, Element 버전 및 설치 유형(예: Element APT 패키지, Flatpak 또는 커뮤니티 패키지)을 기록해 두십시오. 로그를 공유할 때 액세스 토큰, 메시지 내용 또는 개인 계정 데이터는 게시하지 마십시오.
테스트를 시작하기 전에 Element를 완전히 종료하십시오. 남아 있는 프로세스를 확인하고 필요한 경우 Element 프로세스만 중지하십시오.
pgrep -a element
프로세스가 멈춘 경우 바탕 화면의 시스템 모니터에서 해당 프로세스를 종료하거나, pkill element-desktop표시된 프로세스가 Element인지 확인한 후 다음 명령을 실행하세요.
element-desktop --ozone-platform=x11
공식 Debian/Ubuntu 패키지의 실행 파일은 일반적으로 입니다 element-desktop. 다른 패키지는 다른 실행 파일을 사용할 수 있습니다. Flatpak의 경우 애플리케이션 ID 뒤에 스위치를 추가해 보세요.
flatpak run im.riot.Riot --ozone-platform=x11
해당 애플리케이션 ID가 시스템에 설치되어 있지 않으면 flatpak listElement 앱 ID를 찾아 대체하십시오. 패키지의 실행 구문을 확인하지 않고 임의의 래퍼 명령에 플래그를 추가하지 마십시오.
앱을 몇 분 동안 실행해 보고 이전에 충돌을 일으켰던 작업을 반복해 보세요. 앱이 계속 열려 있으면 Xwayland 실행을 임시 해결책으로 사용하세요. Electron은 네이티브 Wayland와 Xwayland에서 일부 창 동작이 다르다는 점을 알려드립니다. 예를 들어, Wayland에서는 특정 프로그래밍 방식의 창 크기 조정 및 위치 지정 작업이 제한됩니다. Electron BrowserWindow 설명서에서 이러한 제한 사항과 Xwayland 전환 방법에 대해 자세히 설명합니다.
일회성 테스트의 경우, 파일을 변경하지 않으므로 터미널 명령어가 가장 안전합니다. 만약 이 방법으로 충돌 문제가 지속적으로 해결된다면, 데스크톱 실행기에 해당 인수를 추가할 수 있습니다. 정확한 방법은 Element 설치 방식에 따라 다릅니다.
Exec=줄을 편집하여 추가합니다 --ozone-platform=x11. 아래의 벤더 파일은 편집하지 마십시오. /usr/share/applications패키지 업데이트로 인해 덮어쓰여질 수 있습니다.flatpak run im.riot.Riot --ozone-platform=x11. 먼저 설치된 앱 ID를 확인하십시오.원래 실행기 명령은 그대로 두고 실행 파일이나 Flatpak 앱 ID 뒤에 플래그를 추가하세요. 더 이상 사용되지 않는 변수를 내보내는 것과 같은 광범위한 셸 변경은 피하세요 ELECTRON_OZONE_PLATFORM_HINT. Electron 38에서 해당 변수가 제거되었습니다. 나중에 추가된 인수를 제거하여 네이티브 Wayland로 되돌릴 수 있습니다.
원래 사용했던 패키지 소스에서 Element를 업데이트한 다음, 일반 런처와 Xwayland 플래그를 사용하여 다시 테스트하십시오. Element 공식 다운로드 페이지 에 최신 Linux 설치 지침이 나와 있습니다. 서로 다른 소스의 패키지를 혼용하지 마십시오. 중복 설치로 인해 동일한 시스템에 여러 런처와 버전이 설치될 수 있습니다.
충돌이 계속되면 GPU 가속을 비활성화한 상태로 한 번 실행하여 그래픽 경로에 문제가 있는지 테스트하십시오.
element-desktop --disable-gpu
이것은 진단 테스트이며, 영구적인 권장 설정이 아닙니다. 동작이 변경되면 배포판에서 지원하는 방법으로 그래픽 드라이버를 업데이트하고 알려진 컴포지터 또는 GPU 드라이버 문제를 확인하십시오. 여러 개의 Chromium 플래그를 한 번에 조합하지 마십시오. 테스트당 하나의 변경 사항만 적용해야 결과가 유용합니다.
문제가 현재 로컬 프로필에만 국한되는지 여부도 확인할 수 있습니다. ~/.config/Element첫 단계로 Flatpak 데이터 디렉터리를 삭제하지 마세요. 해당 디렉터리에는 로컬 앱 상태가 저장되어 있을 수 있으며, 삭제하면 로그아웃되거나 동기화되지 않은 데이터가 손실될 수 있습니다. 더 안전한 첫 번째 확인 방법은 빌드에서 Electron의 --user-data-dir옵션을 지원하는 경우 별도의 임시 프로필을 생성하고, 해당 프로필이 `/etc/flatpak.php` 아래의 새 디렉터리를 가리키도록 설정하는 것 입니다 /tmp. 이는 진단 목적으로만 사용하고, 계정 동작을 테스트할 필요가 없다면 로그인하지 마세요. 새 프로필을 생성한 후에도 결과가 달라지면 원래 디렉터리를 보존하고 로컬 상태를 조사하세요. 삭제하지 않는 것이 좋습니다.
변경 후 Element를 여러 번 실행하고, 이전에 충돌을 일으켰던 대화 또는 보기를 열고, 원래 상태가 재현될 때까지 충분히 오래 실행 상태로 두십시오. 터미널에 더 이상 동일한 치명적인 오류가 보고되지 않는지 확인하십시오. 그런 다음 업데이트 후 일반 런처를 다시 테스트하십시오. 충돌이 네이티브 Wayland 모드에서만 다시 발생하는 경우, 문서화된 Xwayland 해결 방법을 유지하고 버전, 배포판, 컴포지터, GPU 드라이버, 실행 명령 및 개인 정보가 삭제된 로그를 Element에 보고하십시오.
Element의 이슈 트래커에는 Ubuntu 24.04에서 한 사용자가 Wayland 환경에서 앱이 열리지 않고 GBM 버퍼 내보내기 오류가 발생한다고 보고한 사례가 있습니다. 이 문제는 보고된 그래픽 경로 오류 하나를 보여주는 것이지, 모든 시스템에 적용되는 보편적인 진단이나 확정된 해결책을 제시하는 것은 아닙니다. 자세한 내용은 Element 프로젝트 이슈를 참조하십시오 . Xwayland를 설치하거나 패키지를 새로 업데이트해도 문제가 해결되지 않으면, 관련 없는 설정을 반복적으로 변경하기보다는 터미널 출력과 시스템 정보를 제공해 주시는 것이 도움이 될 것입니다.
Xwayland를 통해 Element Desktop을 테스트하고, 로컬 데이터를 보존하며, Linux Wayland에서 앱이 충돌할 때 그래픽 또는 패키지 문제를 격리하십시오.
UnifiedPush 및 ntfy를 사용하여 Element Android를 설정한 다음, 알림이 실패할 경우 자체 호스팅 Matrix 게이트웨이 및 Android 백그라운드 설정을 확인하십시오.
Nextcloud 업로드 설정, iOS 권한, 배터리 모드 및 iPhone 백그라운드 예약 기능의 제한 사항을 확인하여 백그라운드 사진 감지 기능을 복원하세요.
ONLYOFFICE의 글꼴 힌팅 모드를 비교하고, 확대/축소 및 Linux 글꼴 사용 가능 여부를 확인하고, 흐림 효과가 편집기에만 적용되는지 아니면 데스크톱 전체에 영향을 미치는지 검증하십시오.
ONLYOFFICE 데스크톱 편집기에서 PDF를 로컬로 변환한 다음 DOCX 파일을 검토하여 레이아웃 변경 사항, 스캔한 페이지 및 수정이 필요한 텍스트를 확인하십시오.
ONLYOFFICE 데스크톱 편집기에 ownCloud 계정을 추가하고, 연결을 통해 얻을 수 있는 이점을 이해한 다음, 직접 액세스, 동기화 및 브라우저 편집 중에서 선택하세요.
올바른 포털 또는 WebDAV 주소를 사용하고, 휴대폰에서 HTTPS 연결 가능 여부를 테스트하고, 사설 네트워크, TLS 및 로그인 문제를 구분하십시오.
ONLYOFFICE 데스크톱 편집기용 사용자 지정 플러그인을 빌드하고 테스트한 다음, 해당 .plugin 아카이브를 설치하고 디버깅을 위해 개발자 도구를 활성화합니다.
Calc에서 Python 함수를 사용할 수 있도록 만들고, 열려 있는 스프레드시트에서 해당 함수를 실행하고, LibreOffice와 시스템 Python을 혼동하지 않고 누락된 매크로 또는 가져오기 문제를 해결하세요.
Writer 문서의 나머지 부분은 계속 사용할 수 있도록 유지하면서 특정 구절에 대한 일반적인 편집을 차단하는 방법과 파일 암호화가 더 나은 선택인 경우를 알아보세요.