Appflowy cloud 部署测试避坑指南

yjaApbRhi

在进行 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 进行升级会更加便捷。后续我会详细分享具体的操作方法。
 
今天就先分享到这里，后面我会找时间详细介绍部署方法，希望能对大家有所帮助。💖