一、简介

FFReader 以 AppImage 格式提供 x64 与 arm64（aarch64）两种架构的 Linux 程序包，具备广泛的发行版兼容性。你可以从互联网了解 AppImage 程序包在你所用系统上的通用运行方式，也可以直接按本指引快速上手。

如需了解 FFReader 的具体功能，请参阅FFReader使用手册；命令行与 AI 使用请参阅CLI/AI使用手册。

二、选择并下载合适的程序包

在 Linux 系统中打开「终端程序」，输入 uname -a 命令：

• 若返回内容包含 x86_64，请下载 x64 版本；
• 若返回内容包含 aarch64，请下载 arm64 版本。

具体参考下图命令：

确认架构后，前往下载页面下载对应架构的 Linux 程序包。

三、基础使用

大部分 Linux 发行版可直接双击运行 FFReader：

1. 下载适合你系统的程序包并解压；
2. 找到以 AppImage 结尾的可执行程序，双击打开。

若程序打开失败，请右键点击文件打开「属性」，在「权限」界面勾选「可执行」权限（不同 Linux 发行版界面可能略有差异），勾选后再次双击运行。

四、运行不起来怎么办

如果添加可执行权限后仍无法运行，请按以下步骤排查。

第一步： 在程序所在目录右键打开终端，执行以下命令给程序添加可执行权限：

chmod +x FFReader-*.AppImage

第二步： 执行以下命令运行程序（arm64 请替换为 arm64 程序包文件名），如无问题程序即可启动：

./FFReader-x86_64.AppImage

第三步： 如程序依然无法运行，则尝试以下命令（arm64 请替换为 arm64 程序包文件名）：

./FFReader-x86_64.AppImage --appimage-extract-and-run

大部分情况下不需要通过终端加参数运行 FFReader；但若你的发行版始终无法运行，建议按本章节在终端中加参数运行。若这种方式仍无法运行，说明 FFReader 程序包与你的系统环境不兼容，建议联系你所在公司的 IT 人员，或尝试从 FFReader 官方提供的源码自行编译一份适配你系统的版本。

五、安装到系统使用

如果你能通过双击运行，或在终端通过 --appimage-extract-and-run 参数运行 FFReader，则可按本章节把 FFReader 安装到系统，像其他程序一样在系统程序栏找到并运行 FFReader。

1. 下载并安装 AppManager

AppManager 是一个可以把 AppImage 安装到系统的工具，可从以下地址下载：

• GitHub：https://github.com/kem-a/AppManager/releases
• Gitee：https://gitee.com/cnldw/FinanceFileReader/tree/master/linuxtools

下载后，如同前几章节运行 FFReader 一样，双击运行 AppManager，或在终端中添加 --appimage-extract-and-run 参数运行。AppManager 启动后会出现如下图所示的界面，拖动 AppManager 图标到右侧「Applications」目录，即可完成 AppManager 的安装。

2. 使用 AppManager 把 FFReader 安装到系统

打开 AppManager 后，点击「导入 Appimages」按钮，如下图所示：

找到已解压的 FFReader 程序包所在目录并点击打开，AppManager 会自动扫描到 FFReader 程序，点击「导入」按钮完成导入：

导入完成后，如下图所示，点击 FFReader 图标进入下一界面，然后点击「打开」尝试运行 FFReader：

如此时仍打开失败，请将界面滚动到最下方，点击「解压 AppImage」。此步骤类似第四章的 --appimage-extract-and-run 参数，将 FFReader AppImage 镜像预先解压，防止部分系统解压异常。解压完毕后再次尝试打开，一般即可正常启动：

使用 AppManager 加载到系统并验证启动无问题后，后续即可在系统软件栏找到 FFReader 并直接运行，无需再打开 AppManager。如下图所示，在麒麟 V10 程序菜单找到 FFReader：

六、兼容性与支持

FFReader 致力于在各种信创环境中运行，并持续兼容更多国产 Linux 发行版。但囿于操作系统环境复杂，并不能保障兼容所有系统环境。如程序无法在你的操作系统上稳定运行，建议寻求 IT 人员支持，也可联系作者获取支持（酌情付费支持，请理解）。