AppFlowy Cloud安装与配置完全指南：零基础入门

最新推荐文章于 2025-04-06 10:04:33 发布

柳俐文Tower

最新推荐文章于 2025-04-06 10:04:33 发布

阅读量1.9k

点赞数 14

本文链接：https://blog.csdn.net/gitblog_01242/article/details/143045542

版权

AppFlowy Cloud安装与配置完全指南：零基础入门

AppFlowy-Cloud AppFlowy is an open-source alternative to Notion. You are in charge of your data and customizations. Built with Flutter and Rust. 项目地址: https://gitcode.com/gh_mirrors/ap/AppFlowy-Cloud

一、项目基础介绍及编程语言

AppFlowy Cloud是一款开源的Notion替代品，它让你完全掌控自己的数据和个性化定制。此项目采用了当下流行的跨平台UI框架Flutter进行前端构建，并利用系统级性能强大的Rust语言来打造后端服务。AppFlowy Cloud致力于提供一个安全的用户认证体系、文件存储解决方案以及实时WebSocket通信，以支持高效且协作的工作环境。

二、关键技术和框架

技术栈概览：

后端：Rust，借助其高效性和安全性处理核心逻辑。
数据库交互：使用sqlx库进行数据库访问，支持异步操作，提高效率。
云服务基础设施：通过WebSocket提供实时通信，确保用户间高效协作。
容器化部署：采用Docker进行服务封装，便于部署与管理。

关键框架与工具：

Flutter：用于创建响应式且美观的客户端界面。
Redis：作为缓存和消息队列，加快数据访问速度。
PostgreSQL：作为主数据库，存储核心应用数据。
Minio：提供对象存储服务，作为自托管的S3兼容存储解决方案。

三、安装与配置详 steps

准备工作：

安装软件：
- 确保电脑上已安装Docker，它是运行AppFlowy Cloud服务的基石。
- 安装Rust，包括Cargo（Rust的包管理和构建工具）。
- 为了数据库管理，可选安装PgAdmin或准备PostgreSQL命令行工具。
- 加载Redis命令行客户端（redis-cli）。

获取源代码：打开终端，克隆项目到本地：

git clone https://github.com/AppFlowy-IO/AppFlowy-Cloud.git

安装步骤：

配置环境：
- 进入项目根目录，将dev.env副本重命名为.env，并根据需求编辑配置文件，特别是SMTP设置等。
- 设置环境变量，如数据库密码等，如果需要。
启动依赖服务：使用Docker Compose启动必要的服务背景运行：
```
docker-compose --file docker-compose-dev.yml up -d
```

数据库初始化：配置完成后，执行数据库迁移与准备步骤：

cargo install sqlx-cli
sqlx database create
sqlx migrate run
cargo sqlx prepare --workspace

运行AppFlowy Cloud服务器：开启AppFlowy Cloud的服务前端及后端：
```
./script/run_local_server.sh
```
或单独运行服务（如果需要独立调试）：
```
cargo run
```
测试环境：在服务器成功启动后，可以通过cargo test命令执行单元测试，确保一切正常运作。