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

你可能感兴趣的:(Discourse 搭建)