Steam Deck 설정 가이드
Steam Deck에서 Citron Emulator 사용하기: 설치, Game Mode, 안전한 업데이트
공식 Linux AppImage를 사용해 Desktop Mode에서 실행 권한을 부여하고, 비 Steam 게임으로 추가한 다음, 2026년 7월 29일 nightly를 시험하기 전에 안정적인 롤백용 사본을 먼저 보관하세요.
Citron Emulator는 Steam Deck에서 실행되나요?
예. Steam Deck에서는 공식 Linux x86_64 AppImage를 통해 Citron을 실행할 수 있습니다. 가장 깔끔한 방법은 먼저 Desktop Mode에서 작업하면서 공식 GitHub 릴리스에서 올바른 x86_64 파일을 내려받고, 실행 권한을 준 뒤 한 차례 실행 테스트를 마치고, 그 동일한 파일을 Steam에 추가해 Game Mode에서 쓰는 방식입니다.
Citron Neo Wiki는 에뮬레이터 패키지를 직접 제공하지 않습니다. 2026년 7월 29일 기준으로 공식 Linux CI 태그는 커밋 494257a09를 가리킵니다. 기본 x86_64 AppImage는 57,682,142 bytes이며, x86_64_v3 AppImage는 57,835,274 bytes입니다. 대부분의 Steam Deck 사용자는 보다 특수성이 낮은 기본 x86_64 빌드부터 시작하는 편이 적절합니다.
정상 실행에 성공했다고 해서 모든 게임에서 같은 성능이 보장되지는 않습니다. 호환성은 게임 자체, 그래픽 백엔드, 본인이 소유한 콘솔에서 적법하게 추출한 firmware 및 keys, 드라이버 동작, 그리고 사용 중인 Citron 빌드에 따라 달라집니다. 무엇이 효과가 있었는지 파악할 수 있도록 변경 사항은 통제된 상태로 관리하세요.
설치 전 확인
깔끔한 Steam Deck 구성을 위해 필요한 것
설정을 바꾸기 전에 필요한 파일과 롤백 계획부터 준비하세요. 이렇게 하면 처음 실행할 때 겪는 혼란스러운 실패를 대부분 막을 수 있습니다.
| 필수 항목 | 권장 시작점 | 중요한 이유 |
|---|---|---|
| Steam Deck 모드 | 설치는 Desktop Mode에서 진행 | 파일 권한과 비 Steam 바로가기를 그쪽에서 더 쉽게 관리할 수 있습니다. |
| Citron 패키지 | 공식 릴리스의 Linux x86_64 AppImage | Windows ZIP과 Android APK는 SteamOS용 네이티브 패키지가 아닙니다. |
| 저장 위치 | Home/Applications/Citron처럼 고정된 폴더 | 나중에 AppImage를 옮기면 Steam 바로가기가 깨질 수 있습니다. |
| 합법적인 시스템 파일 | 직접 추출한 keys와 firmware | Citron에는 Nintendo 시스템 파일이 포함되어 있지 않습니다. |
| 롤백용 사본 | stable 2026-04-27을 별도 폴더에 보관 | nightly 태그는 같은 위치에서 갱신되며 회귀 문제가 생길 수 있습니다. |
데스크톱 모드
6단계로 Citron AppImage 설치하기
Steam에 추가한 뒤에는 바로가기 대상도 함께 수정하지 않는 한 파일 이름을 바꾸거나 위치를 옮기지 마세요.
공식 Linux 릴리스 열기
Citron CI nightly-linux 태그 또는 stable 2026-04-27 릴리스를 사용하세요. 내려받기 전에 태그, 커밋, 파일명, 바이트 크기, 게시 날짜를 확인합니다.
x86_64 AppImage 선택
citron_nightly-494257a09-linux-x86_64-use-nopgo.AppImage부터 시작하세요. Steam Deck에서는 aarch64를 피하고, x86_64_v3는 비교용 선택지로만 다루는 편이 좋습니다.
고정 폴더로 이동
홈 디렉터리에 예측 가능한 Applications/Citron 폴더를 만드세요. 대상 경로가 고정되어 있으면 Game Mode 바로가기와 이후 롤백용 파일 관리가 쉬워집니다.
실행 권한 부여
파일 속성을 열어 실행 권한을 켠 뒤 창을 닫으세요. 파일이 계속 압축 파일처럼 열리면 권한과 확장자를 다시 확인합니다.
Desktop Mode에서 1회 실행
게임을 추가하거나 여러 설정을 바꾸기 전에 Citron이 정상적으로 열리는지 먼저 확인하세요. 설정 폴더가 깔끔하게 생성되도록 일반적인 방식으로 종료합니다.
Citron을 Steam에 추가
데스크톱 Steam 클라이언트에서 비 Steam 게임 추가를 선택하고, AppImage를 찾아 추가한 뒤, 원하면 라이브러리 표시 이름을 Citron Emulator로 바꾸세요.
Game Mode
게임을 가져오기 전에 바로가기부터 안정적으로 만들기
에뮬레이터 바로가기 설정과 게임 라이브러리 구성은 서로 다른 단계로 나눠서 진행하세요.
바로가기 대상 경로 확인
게임별 바로가기를 만들기 전에 Game Mode에서 Citron 항목이 먼저 열리는지 확인하세요.
- 아무 반응이 없다면 Desktop Mode로 돌아가 AppImage를 다시 테스트하세요.
- 바로가기를 만든 뒤에는 AppImage 경로를 바꾸지 마세요.
- 실행 경로가 제대로 작동한 뒤에야 간단한 이름이나 아트워크를 정리하세요.
컨트롤러 레이아웃 먼저 설정
기본 Gamepad 템플릿으로 시작한 뒤, Citron이 제대로 인식하지 못하는 입력만 바꾸세요.
- 페이스 버튼, 스틱, 트리거, 메뉴 동작을 테스트하세요.
- 이유 없이 Steam Input 리맵과 Citron 내부 리맵을 겹쳐 쓰지 마세요.
- 실험에 들어가기 전에 정상 동작하는 레이아웃 하나를 저장해 두세요.
게임 디렉터리는 신중하게 추가
Citron에는 본인이 적법하게 덤프한 게임 파일이 들어 있는 폴더만 지정하세요.
- 업데이트와 DLC는 기본 게임 파일과 분리해 정리하세요.
- 출처가 불분명한 묶음 파일이나 미리 구성된 다운로드 미러 번들은 사용하지 마세요.
- 경로와 권한을 확인한 뒤 라이브러리를 새로고침하세요.
Desktop Mode는 계속 활용
로그 확인, 파일 권한 변경, AppImage 교체는 여전히 Desktop Mode가 가장 적합합니다.
- Game Mode는 플레이용으로 쓰고, 깊은 파일 관리는 Desktop Mode에서 처리하세요.
- 호환성 문제를 보고할 때는 빌드 해시를 기록해 두세요.
- 문제 해결 시에는 한 번에 변수 하나씩만 바꾸세요.
| 항목 | 기본값 | 조정이 필요한 경우 |
|---|---|---|
| 그래픽 API | Vulkan | 특정 타이틀에 알려진 렌더링 문제가 있거나 Citron 로그가 백엔드 문제를 가리킬 때 |
| 해상도 배율 | 1x / native | 성능이 안정적이고 여유가 있거나, 화면 품질이 분명히 지나치게 부드럽게 보일 때 |
| 프레임 제한 | 게임과 SteamOS 디스플레이 목표에 맞춤 | 프레임 페이싱이 불안정하거나 배터리 사용량이 불필요하게 높을 때 |
| 셰이더 동작 | 캐시가 자연스럽게 쌓이도록 둠 | 새 빌드로 캐시가 무효화됐거나 여러 차례 실행 후에도 끊김이 계속될 때 |
| 컨트롤러 | Steam Input Gamepad 템플릿 | 버튼 입력이 중복되거나 누락되거나 두 번 매핑될 때 |
| 전력 제한 | SteamOS 기본값 | 성능을 직접 확인했고 배터리와 성능 사이에서 의도적인 절충을 원할 때 |
버전 최신성
작동 중인 기준 환경을 잃지 않고 Citron 업데이트하기
nightly 태그는 계속 바뀌는 대상입니다. 매번 자산을 확인하고, 새 AppImage가 직접 테스트를 통과하기 전까지는 이전 파일을 보관하세요.
2026-04-27을 롤백 빌드로 보관
공식 stable 태그는 변하지 않았습니다. 별도 위치에 저장하고 nightly 파일로 덮어쓰지 마세요.
공식 release 2026-04-27을 확인했습니다.커밋 494257a09는 2026년 7월 29일에 게시됨
기본 x86_64 AppImage는 57,682,142 bytes입니다. x86_64_v3 옵션은 57,835,274 bytes입니다.
공식 nightly-linux 태그와 GitHub API에서 확인했습니다.Steam 바로가기를 바꾸기 전에 새 AppImage부터 테스트
Desktop Mode에서 실행하고, 같은 게임과 같은 설정으로 비교한 뒤, 결과가 만족스러울 때만 바로가기를 갱신하세요.
테스트가 끝날 때까지 이전 파일과 설정 백업을 보존하세요.Steam Deck에서 자주 생기는 문제와 집중 해결법
관련 없는 설정까지 건드리지 않도록 증상별 표를 기준으로 점검하세요.
| 증상 | 확인할 것 | 다음 단계 |
|---|---|---|
| AppImage가 열리지 않음 | x86_64 아키텍처, 실행 권한, 다운로드 완료 여부, 안정적인 로컬 경로를 확인하세요. | 공식 릴리스에서 다시 내려받고 Desktop Mode에서 테스트하세요. |
| Game Mode 바로가기가 아무 동작도 하지 않음 | Steam 바로가기 대상이 현재 존재하는 AppImage를 계속 가리키는지 확인하세요. | 데스크톱에서 정상 실행을 확인한 뒤 비 Steam 바로가기를 삭제하고 다시 추가하세요. |
| 컨트롤이 중복 입력됨 | Steam Input 매핑과 Citron 내부 컨트롤러 매핑을 비교하세요. | 한쪽 레이어를 기본값으로 되돌리고, 빠진 동작만 다시 매핑하세요. |
| 업데이트 후 게임이 끊김 | 같은 타이틀과 같은 설정으로 stable 및 이전 nightly와 비교하세요. | 셰이더 캐시가 다시 쌓이도록 기다린 뒤에도 회귀가 남으면 롤백하세요. |
| Citron이 게임 파일을 인식하지 못함 | 폴더 경로, 저장소 권한, 파일 소유권, 지원되는 덤프 형식을 확인하세요. | Desktop Mode에서 디렉터리를 다시 지정하고, 대체 ROM 묶음 파일은 내려받지 마세요. |
| 여러 설정을 바꾼 뒤 성능이 달라짐 | 변경한 설정을 모두 적어두고 보수적인 기준값으로 되돌리세요. | 설정을 한 번에 하나씩 다시 적용하며 결과를 기록하세요. |
자주 묻는 질문
Citron Steam Deck 관련 질문
Steam Deck 사용자는 어떤 Citron 파일을 내려받아야 하나요?
공식 Citron stable 또는 nightly 릴리스의 Linux x86_64 AppImage를 사용하세요. 일반적인 Steam Deck에서는 Android APK, Windows ZIP, macOS DMG, Linux aarch64 빌드를 사용하지 마세요.
Steam Deck에서는 stable과 nightly 중 무엇을 써야 하나요?
기준 환경이 필요하다면 stable 2026-04-27부터 시작하세요. 더 새로운 수정이 필요할 때만 2026년 7월 29일 nightly 494257a09를 시험하고, 롤백용으로 stable AppImage를 보관하세요.
Linux AppImage에 Proton이 필요한가요?
아니요. 공식 Linux AppImage는 네이티브 Linux 패키지입니다. Proton은 Windows 애플리케이션용이므로 이 파일에서 기본 경로가 되어서는 안 됩니다.
Citron을 Game Mode에 어떻게 추가하나요?
AppImage에 실행 권한을 주고 Desktop Mode에서 먼저 테스트한 뒤, 데스크톱 Steam 클라이언트에서 해당 AppImage를 비 Steam 게임으로 추가하세요.
Steam Deck에서 가장 좋은 Citron 설정은 무엇인가요?
우선 Vulkan, native 해상도, 기본 Steam Input Gamepad 레이아웃, SteamOS 기본 전력 설정으로 시작하세요. 반복 가능한 기준 환경을 만든 뒤에만 특정 게임에 맞춰 조정하는 편이 좋습니다.
이 가이드에 게임, keys, firmware가 포함되어 있나요?
아니요. 본인이 소유한 하드웨어와 콘텐츠에서 합법적으로 확보한 게임 덤프, keys, firmware만 사용하세요.
출처
공식 및 커뮤니티 참고 자료
릴리스 정보와 설치 흐름은 2026년 7월 29일 기준으로 아래 페이지들과 대조 확인했습니다.
- Citron 안정판 release 2026-04-27stable 태그, Linux x86_64 AppImage, 롤백 기준 버전을 확인할 수 있습니다.
- Citron CI의 Linux nightly 빌드현재 커밋 494257a09, 파일명, 크기, 공식 다운로드 대상을 확인할 수 있습니다.
- EmuDeck 커뮤니티 Citron 가이드Steam Deck에서의 Citron 활용과 EmuDeck 스타일 정리에 관한 커뮤니티 맥락을 제공합니다.