Fx.樂把 Fedora 43 装到 ARM 设备上这件事本身，对常玩开发板的人来说只是开胃菜，真正让人头大的是装完之后：想找个能日常用的办公套件，默认源翻了个底朝天，Office 文档不是打不开就是排版稀烂。我自己在树莓派 5 和一台 RK3588 迷你主机上都折腾过，最后固定下来的方案就是用 ONLYOFFICE 桌面编辑器。但这里面的槽点不少——官方安装文档写的是 x86 环境下的步骤，直接照搬到 aarch64 上，轻则包找不到，重则依赖解析直接崩给你看。这篇东西就是把我在 Fedora 43 ARM 环境下从零装好 ONLYOFFICE 桌面版的全过程，包括那些最容易劝退新手的依赖坑、输入法联动问题，以及装完之后的日常维护，一次说清楚。
1. 同一块 CPU，两套命运：ARM 装上 Fedora 只是第一步
1.1 为什么 ONLYOFFICE 在这里比在 x86 上难装
先说个可能让不少人意外的事实：ONLYOFFICE 桌面编辑器对 Linux ARM64 的支持是存在的，官方也确实在出 aarch64 的包。但问题的关键从来不是“有没有支持”，而是“你在 Fedora 43 上能不能顺利拿到对的包”。
x86_64 阵营的安装方式在网上满天飞，加起来无非三条路：官方仓库、Flatpak、AppImage。到了 ARM 这里，AppImage 基本不用想，官方 AppImage 长期只有 x86_64 构建；Flatpak 倒是省心，但沙箱环境和宿主机的输入法、字体对接经常闹脾气；最靠谱的还是走 RPM 系的原生路子，可惜 Fedora 默认的 fedora 和 updates 仓库里压根没有 ONLYOFFICE，需要自己引入第三方源。
这里建议你先把一个概念焊死在脑子里：aarch64 和 arm64 是一回事，都是 64 位 ARM 指令集的叫法，Fedora 的 dnf 里看到 aarch64 就是它；而 armv7hl 是 32 位 ARM，ONLYOFFICE 桌面版不支持，装了也白装。很多人在 ARM 设备上装软件失败，第一刀就砍在这个注意力不集中上。
1.2 先确认你拿的是 aarch64 还是 armv7hl 机器
别急着往下操作，先开终端敲一下：
bash复制uname -m
如果你看到的是 aarch64，恭喜，接下来所有步骤都能用。如果你看到 armv7hl 或者 armv6l，建议直接放弃安装 ONLYOFFICE 桌面版，老实回去用 LibreOffice 或者直接在浏览器里开 ONLYOFFICE 的 Web 版，否则后面每个报错都是在浪费生命。
那如果你是 Apple Silicon Mac 用户通过 Asahi Linux 跑 Fedora，或者手里是树莓派 4/5、RK3588 盒子、香橙派 5 这类设备，uname -m 输出的基本都是 aarch64，可以继续看。
我在这步还习惯顺手看一眼 CPU 型号，排除那种“号称 ARM 实际是 armv7 兼容模式”的坑：
bash复制lscpu | grep Architecture
输出里如果是 aarch64，那 64 位应用没问题；如果出现 i386 或者 x86_64，说明你可能根本没跑在 ARM 系统上，后面全白搭。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装仪式的三道前置工序：更新系统、导入密钥、挂载官方仓库
2.1 dnf 仓库配置文件手动写法
Fedora 43 上如果直接 sudo dnf install onlyoffice-desktopeditors，大概率得到一句“没有匹配的软件包”。原因很简单：官方仓库没挂上去。
ONLYOFFICE 官方给 RPM 系用户提供的是一个 onlyoffice.repo 文件。Fedora 的 dnf 自带 config-manager 插件，理论上一条命令就能加仓库：
bash复制sudo dnf install dnf-plugins-core
sudo dnf config-manager addrepo --from-repofile=https://download.onlyoffice.com/repo/onlyoffice.repo
但这招在 ARM 机器上经常翻车。官方 repo 文件里的 baseurl 在很多历史版本里直接硬编码了 x86_64 的目录，你在 aarch64 机器上用这个源，dnf 会老老实实去 x86_64 目录里翻包，结果当然是 404。
我自己更推荐手动写仓库文件，干净、可控、出问题也好排查。创建 /etc/yum.repos.d/onlyoffice.repo：
ini复制[onlyoffice]
name=ONLYOFFICE
baseurl=https://download.onlyoffice.com/repo/centos/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://download.onlyoffice.com/repo/onlyoffice.key
注意这里的 $basearch 是 dnf 内置变量，在 aarch64 机器上会自动替换成 aarch64。如果你的 dnf 版本比较老不认这个变量，手动改成 baseurl=https://download.onlyoffice.com/repo/centos/aarch64/ 也行，二选一即可。
然后导入 GPG 密钥，防止下载到被篡改的包：
bash复制sudo rpm --import https://download.onlyoffice.com/repo/onlyoffice.key
2.2 验证仓库是否真正生效
写完之后，先强制刷新缓存，别用旧的元数据去撞运气：
bash复制sudo dnf clean all
sudo dnf makecache
接着确认 ONLYOFFICE 源已经被正确识别：
bash复制dnf repolist | grep onlyoffice
正常情况下你会看到类似 onlyoffice ONLYOFFICE 这样的输出。再进一步确认源里确实有 aarch64 的包：
bash复制dnf list available | grep onlyoffice
如果列表为空，优先检查 baseurl 是不是被解析到了错误架构。你可以用下面这条命令看 dnf 实际拿的 URL：
bash复制dnf repolist --verbose onlyoffice
这一步能省下后面大量的无效操作，别跳。
3. 三选一的安装路径：DNF 源、独立 RPM、还有 Flatpak
3.1 路径一：用 dnf install 直接拉取官方源里的包（最推荐）
仓库挂好之后，安装本身就简单了：
bash复制sudo dnf install onlyoffice-desktopeditors
dnf 会自动解析依赖并下载。在 aarch64 的树莓派 5 上，装完大概占 500MB 到 800MB 磁盘空间（具体看版本），下载时间取决于网络，国内源通常比官方源快不少。装完直接命令行启动：
bash复制onlyoffice-desktopeditors
或者图形界面在应用列表里搜 “ONLYOFFICE” 点图标。
有一点值得说明：ONLYOFFICE 桌面版本质上是一个 Electron 壳套着自带的编辑器内核，所以你会看到一堆 libnss3、libatk、libgtk 之类的依赖被拉进来。不要在安装的时候手贱加 --no-install-recommends，否则启动时各种缺库报错会把你逼疯。
3.2 路径二：从官网下载 aarch64 的 RPM 包手动装
如果你只想给某一台机器装，不想动系统仓库，也可以去官网下载页选 “Fedora / CentOS” 分类下的 RPM 包，注意文件名里带 aarch64 的才是 ARM 版。
装法：
bash复制sudo dnf install ./onlyoffice-desktopeditors-*.x86_64.rpm
看清楚文件名，你拿到的应该是类似 onlyoffice-desktopeditors_....aarch64.rpm 这种。我在 Fedora 43 上遇到过一种情况：官网默认推的 RPM 包是给 RHEL 9 系的，拿到 Fedora 上装，依赖解析会撞上一堆版本不匹配。这时别硬刚，去 ONLYOFFICE 官方仓库目录里直接挑对应 Fedora 版本的构建会更稳妥。
3.3 路径三：Flatpak 沙箱方案
Flatpak 的好处是依赖全部打包在沙箱里，不污染宿主系统。Fedora 43 默认带 Flatpak，先启用 Flathub：
bash复制flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install flathub org.onlyoffice.desktopeditors
装完启动：
bash复制flatpak run org.onlyoffice.desktopeditors
这方案在 ARM 上的最大问题是：沙箱对中文输入法的支持需要额外权限配置。我前后试过几次，fcitx5 在 Flatpak 版里经常出现能打开编辑器但没法呼出输入法候选框的情况，折腾一整天不如回到原生命令放行。另外 Flatpak 版对中文字体的识别也偶尔抽风，需要手动给沙箱授权字体目录，属于“能跑但不够顺手”的类型。
3.4 三种方式对比
| 安装方式 | 依赖管理 | ARM 适配度 | 输入法体验 | 更新方式 | 综合推荐 |
|---|---|---|---|---|---|
| DNF 官方仓库 | 系统 dnf 统一管理 | 好 | 好 | sudo dnf upgrade |
首选 |
| 独立 RPM 包 | 手动处理依赖 | 一般 | 好 | 定期手动下载 | 临时使用可选 |
| Flatpak | 沙箱独立 | 中 | 差（需额外配置） | Flatpak 自带更新 | 桌面洁癖者可选 |
我个人长期用第一种。官方仓库这条路在 Fedora 43 aarch64 上打磨过之后非常稳，后面讲的依赖坑基本都是围绕它展开的。
4. 最常挡住去路的依赖错误：fonts-dejavu 与那些“找不到的包”
4.1 依赖报错的根因不在 ONLYOFFICE，而在 Fedora 的字体包拆分
很多人在执行 dnf install onlyoffice-desktopeditors 时，突然看到这么一条：
code复制Problem: package onlyoffice-desktopeditors-...-1.aarch64 requires fonts-dejavu, but none of the providers can be installed
第一反应是 ONLYOFFICE 的包坏了，其实不是。fonts-dejavu 这个包在 RHEL 系里是一个整体包，但 Fedora 很早就把它拆成了 fonts-dejavu-core、fonts-dejavu-mono、fonts-dejavu-sans-fonts 这类细分包。ONLYOFFICE 的 RPM 打包时写死了依赖 fonts-dejavu，在 Fedora 的仓库里找不到完全同名的包，就产生了这个看起来很吓人的依赖冲突。
这种情况下硬装会导致 ONLYOFFICE 只能装上但不能用，所以别直接 --force 跳过。
4.2 处理依赖冲突的完整步骤
我的处理办法是，先把 Fedora 里能提供的 dejavu 字体子包都装上，再用 dnf 去解析：
bash复制sudo dnf install fonts-dejavu-core fonts-dejavu-sans-fonts fonts-dejavu-mono
sudo dnf clean all
sudo dnf makecache
sudo dnf install onlyoffice-desktopeditors
大部分情况下这样跑一轮就通了。还有一个更省事的思路是安装兼容包。Fedora 43 的仓库里存在 fonts-dejavu 这个 meta 包的话，直接：
bash复制sudo dnf install fonts-dejavu
如果提示“没有匹配的软件包”，就用我上面提到的拆包子包方案，效果一样。装完用 rpm -q fonts-dejavu-core 确认字体包确实落地了。
4.3 如果还缺其他运行库怎么办
ONLYOFFICE 桌面版在 ARM 上还会遇到另一个高频依赖问题：libcurl.so.4 缺失。这通常不是真缺，而是系统装了多个版本的 libcurl，ONLYOFFICE 自带的库与系统库互相打架。
优先检查基础运行库：
bash复制sudo dnf groupinstall "Fonts"
sudo dnf install libX11 libXcomposite libXcursor libXdamage libXext libXfixes libXi libXrandr libXrender libXtst libsecret
这几个是 ONLYOFFICE 在 Linux 上跑起来必需的图形和系统库，ARM 和 x86 一视同仁。装完之后再启动，如果还报错，把报错信息里提到的 .so 名称记下来，几乎都能从名字判断出属于哪个包，用 dnf provides "*/libcurl.so.4" 反向检索后再装，可比你百度报错信息快得多。
5. 装完不叫完事：中文字体、输入法和 Qt 环境变量一起搞定
5.1 中文字体缺失的典型症状与补救
如果你直接装完就打开文档，很可能会遇到中文全部变成方块的情况。这不是 ONLYOFFICE 的问题，是系统里没有靠谱的中文字体，编辑器找不到可用的字形。
Fedora 43 默认装了部分 CJK 字体，但总有些场景下不够使。我的做法是额外装了文泉驿微米黑和思源黑体：
bash复制sudo dnf install wqy-microhei-fonts adobe-source-han-sans-cn-fonts
装完刷新字体缓存：
bash复制fc-cache -fv
然后重新打开 ONLYOFFICE。这里有个细节：如果 ONLYOFFICE 已经在运行，必须完全退出再启动，Electron 应用对字体变化的感知很迟钝，开着应用刷缓存是没用的。
我用的是 fcitx5。ONLYOFFICE 桌面版基于 Qt 技术栈，跟 fcitx5 的对接需要显式指定输入法模块环境变量，否则光标进到文档里，怎么按 Ctrl+Space 都唤不出中文候选框。
在 /etc/profile.d/ 下新建一个脚本，或者直接改 ~/.bashrc：
bash复制export QT_IM_MODULE=fcitx
export GTK_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
注意：ONLYOFFICE 桌面版内部其实就是用 GTK3，所以 GTK_IM_MODULE 也要设，缺失这个的话 Qt 的输入法桥梁接不上。
改完环境变量后，重启 fcitx5 或者干脆注销重新登录。fcitx5 在 Fedora 43 上如果用的还是自带 IBus，建议先在“设置 → 输入法”里确认 fcitx5 已被设为默认输入法框架，否则两个输入法框架抢键盘事件，也会出现唤不出来的问题。
有个更稳妥的启动方式：在 .bashrc 里加完环境变量后，用命令行启动只在当前用户环境生效的 ONLYOFFICE：
bash复制source ~/.bashrc
onlyoffice-desktopeditors
如果这样能正常输中文，就把桌面快捷方式里的 Exec 行改成：
code复制Exec=env QT_IM_MODULE=fcitx GTK_IM_MODULE=fcitx XMODIFIERS=@im=fcitx onlyoffice-desktopeditors %U
这样双击图标启动也带上环境变量，不再依赖终端。
5.3 写进 /etc/profile.d 的环境变量一次配好
我个人的习惯是不把这些变量堆在 .bashrc 里，而是放到 /etc/profile.d/onlyoffice-input.sh，这样不管你是桌面环境、SSH 会话还是脚本启动，都能拿到相同的变量配置：
bash复制sudo tee /etc/profile.d/onlyoffice-input.sh > /dev/null <<'EOF'
export QT_IM_MODULE=fcitx
export GTK_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
EOF
改完再 source /etc/profile.d/onlyoffice-input.sh 让当前会话生效，然后注销重登一次，确保图形会话的所有进程都继承了新环境变量。
6. 让桌面版真正成为臂上生产力：自动保存、版本恢复与日常更新
6.1 桌面版的保存机制与“强制保存”的真相
网上搜“onlyoffice 强制保存”，跳出来的大都是文档命令服务（Document Server）里通过回调地址触发保存的教程，那是服务器端的事。桌面版没有“强制保存”按钮，但它的自动保存机制会把你的劳动成果在后台频繁落盘。
打开 ONLYOFFICE，路径是“文件 → 选项 → 保存”，可以看到自动保存的间隔设置，默认是每 15 分钟保存一次。我建议改成 5 分钟。
更重要的是理解桌面版的保存逻辑：自动保存不等同于“另存为新版本”，它只在当前文件上操作。如果你需要保留不同修改阶段的版本，还是得养成 Ctrl+Shift+S 另存为的习惯。
6.2 崩溃后的文档恢复路径
Fedora 43 ARM 设备上跑 Electron 应用，偶尔碰到系统卡死或断电，别慌。ONLYOFFICE 桌面版在编辑时会生成临时副本，位置一般在：
bash复制~/.local/share/onlyoffice/DesktopEditors/Backup/
打开这个目录，你会看到一堆以 .bak 结尾的文件和临时目录。按修改时间排序，找到最近的那个，把扩展名改成 .docx 或者 .odt，直接用 ONLYOFFICE 打开，就能救回绝大部分内容。
注意：这个备份目录不会自动清理旧文件，跑久了会越来越大。我自己的习惯是每月定期清一次 30 天前的文件：
bash复制find ~/.local/share/onlyoffice/DesktopEditors/Backup/ -name "*.bak" -mtime +30 -delete
6.3 日常更新只用一个命令
走 DNF 仓库安装的 ONLYOFFICE，后续升级完全由 dnf 管：
bash复制sudo dnf upgrade onlyoffice-desktopeditors
或者整个系统统一升级时带上它：
bash复制sudo dnf upgrade
我实测在 Fedora 43 aarch64 上，ONLYOFFICE 升级不会覆盖你的本地配置和备份目录，字体设置、窗口布局、快捷键方案基本上都原样保留。偶尔会遇到升级后字体变模糊的情况，执行一下 fc-cache -fv，重开应用就恢复了。
最后分享一个日常使用套路：我在树莓派 5 上同时开着 ONLYOFFICE 写文档和 Firefox 刷网页，2GB 内存的版本会明显吃紧，建议至少 4GB 内存的板子跑桌面版才顺手。打开大文档时如果感觉卡顿，可以在设置里关掉硬件加速，ARM 上的显卡驱动远没有 x86 桌面那么齐整，关掉加速反而更稳。