linux安装appflowy分三类：普通用户用预编译版（.deb或appimage，5分钟启动但禁用ai）；开发者需源码编译（flutter run + cargo build）以启用appflowy_ai插件和自定义后端；企业用户可自建服务端实现私有化部署。
Linux 上安装 AppFlowy 不是「装个包就完事」，而是分三类场景：普通用户直接用预编译版、开发者本地编译、或自建服务端。关键判断是——你是否需要 AI 功能、是否想改源码、是否信任第三方二进制。预编译版最省事但功能受限；源码编译才能启用 appflowy_ai 插件和自定义后端。
预编译版安装：跳过编译，5分钟启动（适合普通用户）
官方发布页（https://github.com/AppFlowy-IO/AppFlowy/releases）提供 AppImage 和 .deb 两种格式。Ubuntu/Debian 用户优先选 .deb，避免 AppImage 权限问题：
- 下载最新
appflowy_*.deb文件后执行：sudo apt install ./appflowy_*.deb - 若提示依赖缺失（如
libasound2），补全命令：sudo apt --fix-broken install - 启动后默认数据存于
$HOME/.local/share/AppFlowy，路径不可在 UI 中修改，需手动编辑~/.config/AppFlowy/settings.json的data_dir字段
源码编译安装：必须走这步才能用 AI 功能和本地 Rust 后端
AI 功能（如文档总结、智能模板）依赖 frontend/appflowy_flutter 调用本地 rust-lib 服务，预编译版默认禁用。编译流程中两个易错点：
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
-
cargo build失败常见于缺少系统库：Ubuntu 需先运行sudo apt install build-essential libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev -
flutter pub get报错多因 Flutter 版本不匹配：AppFlowy 当前要求Flutter 3.16+，用flutter doctor检查时若提示Channel unknown，先执行flutter channel stable && flutter upgrade - 编译成功后，
flutter run默认连接本地 Rust 服务（localhost:8000），若想换地址，需修改frontend/appflowy_flutter/.env中的API_BASE_URL
Linux 系统级配置坑：权限、音视频、中文输入法
AppFlowy 基于 Flutter Desktop 构建，在 Linux 上对底层依赖更敏感：
- 启动黑屏或白屏？大概率是 GPU 渲染问题，强制用软件渲染：
flutter run --enable-software-rendering - 录音/摄像头权限被拒？需手动授权：
sudo usermod -a -G video,audio $USER，然后重启会话 - 中文输入法（如 fcitx5）无法上屏？在
~/.profile加入：export GTK_IM_MODULE=fcitx和export QT_IM_MODULE=fcitx - 桌面图标不显示？把
build/linux/x64/release/bundle/appflowy.desktop复制到~/.local/share/applications/并执行update-desktop-database ~/.local/share/applications
构建可执行文件后，怎么部署到其他 Linux 机器？
用 flutter build linux 生成的产物不是纯静态二进制，它依赖主机上的 glibc 版本和图形库。跨发行版部署要小心：
- Ubuntu 22.04 构建的包，在 CentOS 7 上大概率启动失败（
GLIBC_2.34 not found） - 真正便携的做法是打包为
AppImage：先确保已安装linuxdeploy，再运行./scripts/build_appimage.sh（脚本位于项目根目录） - 若仅需命令行启动，可忽略 GUI 依赖，直接调用
rust-lib/target/debug/appflowy_core，但它不提供任何 UI
最常被忽略的是：Rust 后端服务（appflowy_core）默认监听 127.0.0.1:8000，但 Flutter 前端硬编码了这个地址。一旦你改了后端端口或想让它响应局域网请求，必须同时改两处——rust-lib/src/main.rs 的绑定地址，和 frontend/appflowy_flutter/.env 的 API_BASE_URL，缺一不可。
