Appflowy cloud 部署测试避坑指南

在进行 Appflowy cloud 部署测试时，我可谓是踩坑无数。下面，我想从几个关键方面来分享一下我的经验。

先给大家讲讲我的基础情况。Appflowy cloud 的部署是在 docker 环境下，借助 docker compose 来完成的。我之前对 docker 有一些浅显的了解，但 compose 完全没用过。我对 linux 环境也有一定认知，不过并不精通，日常办公大多在 windows 环境下。我家里的 NAS 是群晖，它是基于 Linux 环境运行的。

1. 资料查阅

在部署过程中，资料查阅至关重要，下面是我参考过的一些站点和文章：

• 官网：https://appflowy.com/
• github：https://github.com/AppFlowy-IO ，这里面包含 appflowy-cloud 和 appflowy 相关内容。
• 网友文章：https://blog.owenyang.top/article/self-hosting-appflowy-with-appflowy-cloud-on-synology
• 油管视频：https://www.youtube.com/@mayursmahajan

在此要特别提醒大家，一定要多关注官方文档。Appflowy +cloud 的更新速度很快，如果不及时查看官方文档，一旦有更新，出现问题时你可能根本不知道错在哪里。比如，有一次从 0.916 升级到 0.917，我发现后台管理界面不见了，当时以为是自己的配置出了问题，反复折腾了好几天，最后才发现是升级时路由地址发生了变化。

2. 安装环境

刚开始准备部署测试时，我想着在办公室的电脑上先跑通流程，于是下载了 windows 版本的 docker，还在这个 docker 里下载了 appflowy 的 docker 镜像（后来才知道，在 docker compose 部署时会自动下载，真是走了弯路），同时也下载了 github 上的源码。但在部署测试时，总是出现一个异常（现在已经记不清具体错误了），导致无法正常推进。我在这上面耗费了好几天时间，始终没有解决。后来我把测试环境换到 linux 虚拟机上，那个错误就消失了。所以，建议大家将 Appflowy cloud 部署在 Linux 环境中。我最终要部署在群晖上，因为群晖本身基于 linux，也就没什么问题了。

3. 数据库选择

为什么要单独说数据库的选择呢？这是因为看了上面提到的那位网友的文章，他提到数据库单独安装 postgres，而不使用 docker 里自带的数据库，这样做更便于备份。我觉得很有道理，就也打算单独安装。安装过程倒是挺顺利的，没遇到什么问题，可在部署前对数据库进行初始化时，我却遇到了大麻烦，在这里卡了至少 10 天，其中的艰辛真是难以言表。好在最后成功搞定了外部数据库的配置和连接，具体的配置方法我会在后续的配置文章中详细讲解。

4. Appflowy cloud 数据备份

对于像 Appflowy cloud 这样的知识库应用来说，数据备份的重要性不言而喻。只有确保备份流程顺利走通，我才会真正进行部署。所以，在学习和测试备份的过程中，又是一段漫长的经历。Appflowy cloud 的数据备份包括数据库备份和 minio 文件系统的备份，这两者缺一不可。前面也提到过，起初我想单独安装这两个应用来实现备份，但后来发现直接在 docker 中就可以进行访问和备份操作，所以最后我并没有单独安装这两个软件。数据库备份通过命令就能完成，minio 文件备份则直接进入 minio 系统，下载压缩包即可。

5. Appflowy cloud 升级

正如前面所说，Appflowy cloud 是一款更新频繁的应用，通常一周到两周就会有更新。因此，了解升级方法很有必要。客户端的升级相对简单，直接覆盖安装就行。但后端的 cloud 升级就比较麻烦了，刚开始我以为直接下载源码就是升级，结果发现并非如此。实际上，不仅需要升级 docker 镜像，还得对配置文件进行更新。在学习升级的过程中，我顺便学习了 git 的相关命令，发现用 git 进行升级会更加便捷。后续我会详细分享具体的操作方法。

 

今天就先分享到这里，后面我会找时间详细介绍部署方法，希望能对大家有所帮助。