Atmosphere 1.8.0 安装教程：3 步完成 19.0.0 系统固件适配

Atmosphere 1.8.0 安装教程：3 步完成 19.0.0 系统固件适配

【免费下载链接】AtmosphereAtmosphère is a work-in-progress customized firmware for the Nintendo Switch.项目地址: https://gitcode.com/GitHub_Trending/at/Atmosphere

Atmosphere 是目前 Nintendo Switch 上最成熟的定制固件，从引导到系统服务全链路替换。这篇文章讲 19.0.0 固件适配这一件事：SD 卡要放什么、怎么从 RCM 进系统、哪些配置动一下就够了。读完你能在自己机器上跑起 Atmosphere 1.8.0，并且知道想改配置时该去哪里改。前置条件：机器能进 RCM（fusee 这个 payload 依赖 CVE-2018-6242 漏洞）、一张格式化的 SD 卡、Atmosphere 1.8.0 发布包。

为什么要折腾这件事

先说结论：你机器如果还在 18.x 系统、也不急着升，那可以不动。但想升系统的话，得先把 Atmosphere 换成支持新版系统的版本。changelog 写得很直白：1.7.1 的支持上限是 18.1.0，系统升上去之后旧版 Atmosphere 大概率起不来，轻则 fatal，重则黑屏。

1.8.0 的主要工作是"追上官方行为"。新系统改了安全监视器和内核的内部逻辑，所以 exosphère、mesosphère 都按官方 19.0.0 的行为重写了，loader、pm、ro 三个模块也同步更新。对用户来说这些改动基本不可见，体感就是"能用了"。

另外有一处修的是新硬件的锅：部分搭载 Hynix/Micron 内存颗粒的新机器之前点不亮，现在修好了。所以新机器用户这次可以放心跟。

快速上手：3 步完成 Atmosphere 19.0.0 安装

核心动作就三个：写文件、注入引导、初始化配置。

第 1 步：把发布包写进 SD 卡

1. 拿 Atmosphere 1.8.0 发布包，里面含atmosphere/目录和 fusee payload；想自己编译的话，克隆仓库后按docs/building.md装好 devkitA64 等依赖，在根目录跑make。
2. 把atmosphere/目录内容拷到 SD 卡根目录，fusee payload 也放根目录。
3. 这一步不要动/atmosphere/config/里任何配置，那是第 3 步的事。

# 源码构建（可选） git clone https://gitcode.com/GitHub_Trending/at/Atmosphere cd Atmosphere make # 需要 devkitA64 / devkitARM，见 docs/building.md

做完这一步，SD 卡根目录应该能看到atmosphere/文件夹和 fusee payload 文件，目录结构完整。

第 2 步：RCM 注入，最容易翻车的一步

⚠️ 硬件操作别急，按顺序来。

1. 关机，按住音量下键不放，按一下电源键后松开，再插 USB-C 线到电脑，机器即进入 RCM。
2. 打开 payload 注入工具（TegraRcmGUI 之类），选择 SD 卡根目录的 fusee payload，注入。
3. Atmosphere 要依次走 fusée → exosphère → 系统，首次引导比平时慢，耐心等。

成功的话你会看到启动画面，然后正常进入系统主页。

Atmosphere 默认启动画面，仓库里的insert_splash_screen.py可以替换成自定义 1280x720 图。

第 3 步：初始化配置，模板各就各位

1. 仓库/atmosphere/config_templates/里是所有配置模板，默认值本身是安全的，但建议拷一份出来再按需改。
2. 每个文件的去处不一样，别放混：stratosphere.ini、override_config.ini、system_settings.ini放/atmosphere/config/，exosphere.ini放 SD 卡根目录。
3. 用 emummc 的话，把emummc.ini一并拷到/emuMMC/目录。

cp config_templates/stratosphere.ini /atmosphere/config/ cp config_templates/override_config.ini /atmosphere/config/ cp config_templates/system_settings.ini /atmosphere/config/ cp config_templates/exosphere.ini /

做完这一步重启一次，你在override_config.ini里绑定的按键组合（默认注释示例是!L）就应该生效了。

不同场景下的 SD 卡配置差异

只玩卡带和数字版游戏

基本全默认。stratosphere.ini里nogc保持默认的保护行为，防止卡读卡器固件被系统更新偷偷升级（后续想降级的人会感谢你）；exosphere.ini的debugmode也别动，模板注释里写了：关了这个 Atmosphere 直接坏。

还想跑 Homebrew 和金手指

在/atmosphere/config/override_config.ini里绑 Homebrew 菜单和金手指管理器的按键；金手指文件放在/atmosphere/contents/<游戏程序ID>/cheats/下，文件名要跟游戏版本的 build ID 对应；Homebrew 有特殊内存需求的，去system_settings.ini的[hbloader]段调堆。

一张 SD 卡多台机器或 emummc 共用

重点看/emuMMC/emummc.ini和system_settings.ini的[atmosphere]段。推荐开enable_external_bluetooth_db，蓝牙配对库会同步到/atmosphere/bluetooth_devices.db，换机器不用重新配对手柄。

适配完成后正常的锁屏状态，说明各层组件都已接管。

踩坑记录与排错思路

排错顺序记一条就行：先判断卡在哪一阶段（引导 or 系统内），再查对应配置，最后看报告。

开机卡在启动画面不动

症状是注入成功但画面一直不往前走。多半是 fusee payload 和atmosphere/版本不配套，或 SD 卡内容残缺。先重新注入重试；还不行就核对atmosphere/目录是否完整，重点是package3和kips/都在。

进系统后卡带读不出来

通常是stratosphere.ini的nogc：设成 1 会强制关闭卡读卡器。检查一下/atmosphere/config/stratosphere.ini，需要读卡就改回 0 或恢复默认，重启再试。

Homebrew 或 NRO 拒绝启动

先查system_settings.ini里[ro]的ease_nro_restriction，它控制是否放宽 NRO 校验，模板默认就是 1，确认自己没把它关掉；确认无误还是起不来，就走下面一条。

想搞清楚为什么崩

崩溃报告会写到/atmosphere/erpt_reports/，1.8.0 之后生成速度很快，出问题时先来这里翻。需要更细的信息，打开system_settings.ini的[lm]段enable_sd_card_logging，日志会落到atmosphere/binlogs。

后续维护与社区入口

• 更新节奏：官方每出新系统固件不用马上跟，等 Atmosphere 的 release 明确写了支持对应系统版本，再一次性换包，中间版本可以跳。
• 换包之前把整个/atmosphere/config/备份走；建议把这个目录放进本地 Git 仓库，每次改动提交一次，回滚时不慌。
• 常见问题：docs/faq.md
• 更新日志：docs/changelog.md
• 编译指南：docs/building.md
• 配置说明：docs/features/configurations.md

19.0.0 适配到这儿基本就齐了。配置模板里的注释其实就是最好的文档，哪个参数不懂就打开读。真踩了坑也别慌，先看一眼 erpt 报告再去 issue 区问问，大概率你卡住的点别人也踩过。

【免费下载链接】AtmosphereAtmosphère is a work-in-progress customized firmware for the Nintendo Switch.项目地址: https://gitcode.com/GitHub_Trending/at/Atmosphere