如何独立部署 FarBox

操作系统 Ubuntu 18.04

这是建议的操作系统，其它的 Linux 操作系统，基本逻辑一样，具体的自己探索。

服务器初始化并安装 Docker

sudo apt-get update && sudo apt-get install -y python-pip  && sudo apt-get install -y docker.io

注意: 安装 Docker，由于 Docker 的安装步骤也可能动态变化，具体的可以参考 Docker 官方的安装文档。

部署 FarBox (FarBox Bucket)

sudo docker pull hepochen/farbox_bucket:latest                                         
sudo pip install xserver
sudo xserver_package deploy farbox memcache=200mb && sudo xserver start farbox

执行下面命令，可以在服务器重启的时候，自动启动 FarBox 对应的服务:

xserver install_start

另外，可以执行下面的命令，每隔 2 分钟会检测 FarBox 的服务容器是否失败了需要重启:

xserver install_live

注: xserver 是我另外写的一套处理服务器端部署相关逻辑的小软件。

此时，FarBox 已经处于运行的状态了，访问 http://你的服务器IP 即可进行 Web 端的首次安装；当然前提是服务的 80 和 443 端口应该是开放的状态。

注意：

1. memcache 是 FarBox 运行需要的基本缓存服务，如果服务器内存比较有限，可以把上面 Demo 中的 200mb 调整更小一些。
2. Web 端如果提示 no template for index, 表示网站还没有模板，需要自己在 Dashboard 内选一个模板先。

在 Web 端初始化第一个 Bucket 之后，可能需要重启服务 (如果 Web 端数据正常则不需要处理)：

sudo docker exec -it farbox bash
supervisorctl restart all

数据存储的位置

• /data/farbox_ssdb: 主数据库
• /data/farbox_es: Elasticsearch 索引数据
• /data/farbox: 核心 Web 服务的数据
• /data/log/farbox: 日志文件
• /home/run/farbox: FarBox 的环境配置文件

注意: 如果你需要重新安装 FarBox，或许你需要尝试先移除 /data/farbox_ssdb，当然是具体情况而定。

邮件通知与其它配置

部署好之后，可以自行登录后台进行配置，第一个创建的 Bucket 会被认为是管理员。
如果需要邮件通知 (包括评论的回复)，需要自行配置 Ses ID、Ses Key、Ses Sender，这些是基于 Amazon AWS SES 提供的，需要自行申请和对应。

后续的版本更新

登录后台，找到 Install Python Package, 将从 farbox@pypi.org 上获得对应版本的 FarBox 的文件路径，复制、粘贴并提交，就可以了。
但请慎重操作，新的 FarBox Bucket 的版本未必一定会和你当前运行的版本兼容。

有疑问？

服务端相关的技术知识，扩展开来非常复杂，FarBox 的部署基本来说，就是 Ubuntu + Docker + Supervisor，其它的比如 SSDB、Memecache、Nginx 等都已经内嵌到 Docker 的容器内了。

如果有疑问，请 Google；如果找不到答案，说明不适合自行部署……