Discourse 搭建

Discourse logo

0. 简要介绍

Discourse 是由 Stack Overflow 创始人之一的 Jeff Atwood 主导的开源论坛项目，使用时能感受到和 Stack Overflow 的关联性，比如为鼓励有效的技术讨论、控制人身攻击等做了很多努力，页面的布局方式也有相似之处。Discourse 提供了非常丰富的配置方式，也支持插件扩展，是值得学习的论坛类开源项目。

本文主要介绍通过 Docker 镜像的方式在公有云环境中部署 Discourse 环境，公有云选为阿里云，操作系统为 Ubuntu 16.04。

1. 准备工作

1.1 阿里云环境准备

Discourse 官方文档中推荐的最低配置是 1 核 2G，这里就选用了最低配：ecs.n4.small，对于没有很高访问量的站点，这个配置也足够用了。

阿里云虚拟机配置

服务器购买完成后，记得要更新一下系统，最新的系统修复了不少 bug：

apt update
apt upgrade -y

1.2 邮箱配置

Discourse 比较依赖邮箱系统，需要根据邮箱来进行注册和消息通知，所以一定要有一个可用的邮件服务系统，Discourse 推荐使用第三方的邮件系统，其实自己搭建也是完全可行的，但邮件系统搭建也要花费一定的精力，而且也有一定的难度，本文使用的邮箱系统是 ElastishMail，具体的注册方式就不详细描述了。

1.3 注册域名

使用 IP 访问当然也是没有问题的，不过总归是不方便，建议还是为接下来要搭建的 Discourse 站点注册一个域名，阿里云收购了万网，所以域名注册在阿里云的网站内就可以搞定了。

2. 基础安装

Discourse 本身是挺复杂的，看安装过程的耗时和输出信息就知道了。幸运的是，Discourse 提供了自动化安装的脚本，较低了部署的难度。Discourse 依赖的软件并不多，主要是 git（用来拉取 Discourse 的代码）、docker（因为要使用 Docker 部署） 和 ruby（原因是 Discourse 是用 ruby 编写的）以及 ruby 的包管理工具 gem。

安装 git

# install git
$ sudo apt install git

安装 docker

# install docker
$ sudo wget -qO- https://get.docker.com/ | sh

配置 docker 使用国内的镜像

# Configure docker to use Chinese mirrors
$ sudo vim /etc/docker/daemon.json 
{
  "registry-mirrors": ["https://registry.docker-cn.com",
                       "http://hub.c.163.com"]
}
$ sudo systemctl restart docker.service

安装 discourse

# install discourse
$ sudo -s
$ mkdir /var/discourse
$ git clone https://github.com/discourse/discourse_docker.git /var/discourse
$ cd /var/discourse
$ ./discourse-setup

运行 discourse-setup 脚本后，会提示输入一些安装信息，以此输入之前注册的域名和邮箱信息即可。

Hostname for your Discourse? [discourse.example.com]:
Email address for admin account(s)? [[email protected],[email protected]]:
SMTP server address? [smtp.example.com]:
SMTP port? [587]:
SMTP user name? [[email protected]]:
SMTP password? [pa$$word]:
Let's Encrypt account email? (ENTER to skip) [[email protected]]:

配置完成后，需要进行很久的编译，稍安勿燥，半小时之内都是正常的。等待脚本 discourse-setup 脚本执行结束，就可以访问刚刚配置好的 discourse 网站了！

Disourse 欢迎界面

PS：Discourse 在国内云环境中部署，因为众所周知的原因，软件包的下载可能会遇到问题，本文所参考的一篇资料中谈到了gem 的连接问题，不过在写作本文的过程中并没有遇到该问题，如果遇到网络原因造成的安装失败，大家就需要各现神通了。

3. 进阶配置

3.1 设置自动备份

为了网站的信息安全，当然要对数据定期进行备份，配置备份的界面如下：

备份设置

图中配置的是每天备份一次，保留最近的七个备份。但这依然有问题，原因是备份文件是存储在 docker 内部的，万一 docker 崩溃了，备份文件也一样拿不回来，更为保险的方式是将备份文件再上传到第三方的存储系统中，discourse 也支持这样的配置，但因为 discourse 的作者生活在美帝，用的都是 S3、Dropbox、Box 和 Google Drive，我等只有看着流口水的份，所以完全不可用。目前我的解决方式是 crontab 启动定时任务，然后用 python 上传备份文件到内部的 Ceph 集群里，因为没有通用性，就先不把这种方式的详细步骤放上来了，如果有需要的话，我可以考虑把上传到 OSS 公有云的方法补充上。另外自己写 Discourse 的插件也是可行的，只是我对 Ruby 完全不了解，所以没有采用这种方式。

3.2 设置 https

对于 HTTPS 的支持，discourse 也提供了自动化脚本，只需修改配置文件，并重新编译即可。

修改配置文件：需要在 /var/discourse/containers/app.yml 的 templates 段中增加一个行：

$ cat /var/discourse/containers/app.yml
...
templates:
...
  - "templates/web.letsencrypt.ssl.template.yml"
...

然后执行以下命令：

$ /var/discourse/launcher rebuild app

脚本运行结束后即完成了 https 的配置，但这个执行时间依旧不短，大概在十到二十分钟。

4. 参考资料

• Discourse cloud installation guide
• 在大陆地区的云上部署 Discourse
• Discourse automatic backups
• Stuck for a step for long time during installation
• Discourse plugins
• Discourse plugins page on github
• How to install a plugin
• Setting up Let's Encrypt