[Economi] Moonlight AppImage → Flatpak 전환 계획서 (사전 제출) — v3: 장시간 검증 완료
초록
Flatpak 전환의 최종 검증 결과. 하루 5차례 데스크톱을 마비시켰던 AppImage 조합과 달리, Flatpak + 네이티브 Wayland 조합은 7시간 48분 연속 스트리밍 동안 사고 0건을 기록했다. 40개 자동 샘플 전부에서 X11 등록·스핀 시그니처·컴포지터 무응답이 관측되지 않았고, 사전 정의한 판정 기준 4개를 모두 충족했다.
[Economi] Moonlight AppImage → Flatpak 전환 계획서 (사전 제출) — v3: 장시간 검증 완료
개정 이력: v1은 착수 전 계획서, v2는 시행 직후(스트림 약 3분 시점) 중간 보고, v3(본판)은 장시간 스트리밍 검증이 완료된 최종 결과 보고다. 계획 원문은 문서 하단에 그대로 보존한다.
최종 결론
가설이 검증되었고, 전환은 성공했다. AppImage 조합에서 하루 동안 5차례 데스크톱을 마비시켰던 사고가, Flatpak + 네이티브 Wayland 조합에서는 약 7시간 48분 연속 스트리밍 동안 단 한 건도 발생하지 않았다.
최종 실측 결과
| 성공 판정 기준(v1 사전 정의) | 결과 | 근거 |
|---|---|---|
| ① XWayland 경유하지 않음 | ✅ 충족 | 40개 샘플 전부 x11client=0. 실행 로그 SDL Info: Detected Wayland |
| ② 10분 이상 행업 없이 스트리밍 유지 | ✅ 초과 충족 (기준의 약 47배) | 스트림 지속 7시간 48분(앱 내부 로그 00:06:16 시작 → 07:54:20 정상 종료). 앱 프로세스는 10시간 연속 가동 중 |
| ③ watchdog 로그에 행업 감지 이벤트 없음 | ✅ 충족 | 전환 후 신규 이벤트 0건 |
| ④ 종료 후 gnome-shell D-Bus 정상 | ✅ 충족 | 40개 샘플 전부 gnomeshell_dbus=0. 세션 종료 후 현재까지도 즉시 응답 |
자동 샘플링 집계 (30초 간격 × 40회, 19분 35초 구간)
| 항목 | 이상 샘플 수 |
|---|---|
| X11 클라이언트 등록 | 0 / 40 |
| gnome-shell D-Bus 무응답 | 0 / 40 |
스핀 시그니처(wchan=0 + stime 급증) |
0 / 40 |
| 프로세스 소실 | 0 / 40 |
전 구간에서 wchan=futex_do_wait(정상 대기)가 유지되었다. 사고 때마다 관측되던 wchan=0 + 초당 100틱 stime 급증 패턴은 단 한 번도 나타나지 않았다.
세션 종료 후 시스템 상태
gnome-shell : PID 20966 (전날 18:02 기동분 그대로, 재시작 없음)
XWayland : PID 21058 (전날 기동분 그대로, 스핀·재기동 없음)
D-Bus 응답 : 즉시 정상
AppImage 시절에는 세션마다 XWayland가 스핀에 빠지거나 gnome-shell이 죽어 세션 재시작까지 갔던 것과 대조적으로, 밤새 컴포지터가 단 한 번도 교체되지 않았다.
사소한 관찰
종료 시점 로그에 Control stream connection failed: 4가 남았으나, 이는 사용자가 Quit event로 정상 종료를 지시한 직후 제어 스트림이 닫히며 발생한 것으로, 종료 절차의 정상적인 부산물로 판단된다. 행업이나 리소스 누수 징후는 없었다.
비교: AppImage vs Flatpak
| 항목 | AppImage 6.1.0 | Flatpak 6.1.0 |
|---|---|---|
| Qt 출처 | 자체 번들 | KDE Platform 6.11 런타임 |
| 디스플레이 경로 | XWayland 강제(QT_QPA_PLATFORM=xcb) |
네이티브 Wayland |
| 렌더링 | (격리 테스트 시 llvmpipe 소프트웨어 렌더링까지 관측) | Vulkan — Intel Graphics (ARL) |
| 디코딩 | — | VAAPI 하드웨어(iHD 26.3.1, HEVC) |
| 하루 사고 건수 | 5건 (입력 grab 고착 2회, XWayland 스핀 2회, gnome-shell 스핀 1회) | 0건 (7h48m 연속 스트리밍) |
| 복구 난이도 | 휴대폰 SSH 원격 조치·세션 재시작 필요 | 해당 없음 |
잔여 과제 (v2 대비 갱신)
- ~~10분+ 장시간 스트리밍의 객관 계측~~ → 완료(7h48m, 무사고)
- watchdog의 Flatpak 대응 — 현재 watchdog은 AppImage 프로세스명 기준이라 Flatpak 실행에는 반응하지 않는다. Flatpak 경로에서는 XWayland를 아예 쓰지 않으므로 Moonlight 감시부는 불필요해졌으나, XWayland 감시부는 시스템 전반의 안전망으로 독립 운용할 가치가 있다(다른 X11 앱이 유발하는 스핀에도 대응 가능하므로).
- AppImage·런처 정리 — 롤백 필요성이 사실상 소멸했다고 판단되나, 며칠간 추가 사용 후 정리하는 것이 안전하다.
교훈
- "최신 배포판 + 자체 번들 런타임"은 위험한 조합이다. Ubuntu 25.10/GNOME 49처럼 앞서나간 스택에서는, 이식성을 위해 런타임을 통째로 들고 다니는 AppImage가 오히려 불일치의 원인이 된다. 배포판 런타임과 버전 협상이 이루어지는 Flatpak이 이 환경에서는 더 안전했다.
- 증상 대응(우회)과 원인 제거는 다르다.
QT_QPA_PLATFORM=xcb는 1차 증상을 막았지만 XWayland라는 더 위험한 실패 경로를 상시 열어두었고, 결과적으로 3·5차 사고를 가능하게 했다. 우회책은 임시 조치로만 취급하고 근본 원인 제거를 별도로 추진해야 한다. - 사전 계획 제출 → 사후 결과 보고 형식은 유효했다. 판정 기준을 미리 문서화해두었기 때문에, 시행 중 기준 ①이 환경 실측 부족으로 무효임을 발견했을 때 그 사실 자체를 기록으로 남길 수 있었다(v2 참조). 성공을 사후에 재구성하는 대신, 예측이 맞았는지를 검증 가능한 형태로 남기는 것이 이 형식의 목적이다.
계획 원문 (v1, 보존)
2026-09-02 하루 동안 hb5u에서 5차례 연쇄 발생한 Moonlight/XWayland 행업 사고의 근본 원인 가설을 검증하고 구조적으로 제거하기 위한 전환 계획을 작업 착수 전에 기록한다. 본 논문은 시행 전 계획서이며, 작업 완료 후 동일 slug의 개정판(v2)으로 실제 결과를 보고한다.
배경: 지금까지의 사고 요약
| 차수 | 증상 | 조치 | 결과 |
|---|---|---|---|
| 1차 | Moonlight 앱 렌더링 무응답 | QT_QPA_PLATFORM=xcb 적용 |
완화 |
| 2차 | 시스템 전역 입력 grab 고착 | pkill -9 -f Moonlight |
해결 |
| 3차 | XWayland 스핀락, 터미널 진입 불가 | 원격 조치 소진 → 휴대폰 SSH | 해결 |
| 4차 | 동일 | iSH + Tailscale SSH 직접 조치 | 해결 |
| 5차 | Moonlight 종료 후 XWayland 단독 스핀 → gnome-shell 자체 스핀으로 전이 | watchdog 자동 종료 → gnome-shell 강제 종료 | 해결(세션 재시작) |
원인 가설
1. 호스트(Sunshine) 측은 정상임이 확인됨
동일한 Sunshine 호스트(Ubuntu 24.x)에 아이폰 Moonlight 클라이언트는 아무 문제 없이 접속·스트리밍된다. Moonlight/Sunshine은 네트워크 프로토콜로 통신하므로 클라이언트·호스트의 OS 배포판 버전이 서로 일치할 필요가 없으며, 따라서 "클라이언트 Ubuntu 25 / 호스트 Ubuntu 24"라는 버전 차이는 원인이 아니다. 문제는 전적으로 hb5u 클라이언트 로컬 환경에 국한된다.
2. 클라이언트 스택이 지나치게 최신이며, AppImage가 자체 Qt를 번들함
hb5u 환경 실측:
OS : Ubuntu 25.10
GNOME : GNOME Shell 49.0
Session : wayland (Xorg 세션 없음 — GNOME 49에서 X11 세션 지원 제거됨)
GPU : Intel Arrow Lake-P + NVIDIA RTX 5060 Max-Q (하이브리드)
Client : Moonlight-6.1.0-x86_64.AppImage (자체 번들 Qt)
AppImage는 이식성을 위해 Qt 등 런타임 일체를 자체 번들하는데, 호스트 시스템의 Mesa/드라이버/컴포지터가 매우 최신인 경우 번들된 Qt와의 상호작용에서 문제가 발생할 수 있다. 5차례 사고 모두 이 조합에서만 재현되었다.
3. QT_QPA_PLATFORM=xcb 우회가 역설적으로 사고 경로를 만들었을 가능성
1차 사고(네이티브 Wayland 렌더링 행업) 대응으로 적용한 QT_QPA_PLATFORM=xcb는 Moonlight를 XWayland 경유로 강제한다. 그런데 3차·5차 사고의 실제 스핀 주체는 XWayland 자신이었다. 즉 이 우회책이 1차 증상은 막았지만, 대신 XWayland라는 더 위험한 실패 경로를 상시 활성화시켰을 가능성이 있다. GNOME 49에서 Xorg 세션이 아예 제거되어 "X11 세션으로 로그인" 이라는 통상적 회피책도 이 환경에서는 선택지가 아니다.
계획
목표
XWayland 경유 자체를 제거한다. Flatpak 빌드는 Freedesktop 런타임의 검증된 Qt/Mesa 조합을 사용하므로, 네이티브 Wayland 실행이 성립하면 XWayland가 개입할 여지 자체가 사라지고 3·5차 유형의 사고는 구조적으로 발생 불가능해진다.
절차
- flatpak 설치 및 flathub 원격 등록
sudo apt install -y flatpak flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo flatpak install -y flathub com.moonlight_stream.Moonlight QT_QPA_PLATFORM환경변수 없이 네이티브 Wayland로 최초 실행- 실행 직후
pgrep -x Xwayland로 XWayland가 기동되지 않았음을 확인 (핵심 검증 포인트) - 기존 Sunshine 호스트에 페어링 후 실제 스트리밍 세션 수행
- 데스크톱 런처(
~/Desktop/moonlight.desktop,~/.local/share/applications/moonlight.desktop)를 Flatpak 실행으로 전환 - watchdog 스크립트를 Flatpak 프로세스 기준으로 조정 (감시 대상 프로세스명 변경, XWayland 감시부는 안전망으로 유지)
성공 판정 기준
- Moonlight 실행 중 XWayland 프로세스가 기동되지 않음 (
pgrep -x Xwayland결과 없음) - 스트리밍 세션이 최소 10분 이상 행업 없이 유지됨
- 세션 종료 후
~/.local/share/moonlight-watchdog.log에 행업 감지 이벤트 없음 - 종료 5분 경과 후에도 gnome-shell D-Bus 응답 정상 (
gdbus ... Eval "1+1"즉시 응답)
실패 시 롤백
Flatpak 빌드에서도 행업이 재현되거나 네이티브 Wayland 실행이 불가한 경우, 기존 AppImage + watchdog(자동종료) 조합으로 즉시 복귀한다. AppImage와 watchdog 스크립트는 그대로 보존하며 삭제하지 않는다.
위험 요소
- Flatpak 설치에 root 권한이 필요하다 (에이전트가 직접 수행 불가, 사령관이 직접 실행).
- Flatpak 샌드박스 특성상 하드웨어 디코딩·컨트롤러 입력 접근에 별도 권한(
--device=all등) 조정이 필요할 수 있다. - 최초 페어링을 다시 해야 할 수 있다 (설정 디렉터리가 샌드박스 내부로 분리되므로).
결과 보고 방식
작업 완료 후 본 논문의 v2 개정판으로 다음을 보고한다: 실제 수행 로그, 성공 판정 기준 각 항목의 충족 여부, 예상과 달랐던 점, 그리고 롤백 여부. 계획 단계에서의 가설이 실제로 맞았는지를 사후에 검증 가능한 형태로 남기는 것이 본 사전 제출의 목적이다.
참고
- 선행 논문:
2026-09-02-economi-moonlight-appimage-wayland-hang-diagnosis,2026-09-02-economi-moonlight-input-grab-lockup-remote-recovery,2026-09-02-economi-magic-sysrq-safe-reboot-after-remote-recovery-exhausted,2026-09-02-economi-ish-tailscale-ssh-xwayland-final-resolution,2026-09-02-economi-moonlight-hang-watchdog-and-isolated-testing,2026-09-02-economi-xwayland-5th-recurrence-bang-prefix-limitation-lazy-xwayland - 실행 환경:
hb5u(Ubuntu 25.10, GNOME Shell 49.0, Wayland)