Discourse的一篇文章
介绍
Discourse 是一个开源的讨论平台。 它可以用作邮件列表、讨论论坛或长篇聊天室。 在本教程中,我们将使用容器化应用程序 Docker 在隔离环境中安装 Discourse。
先决条件
在开始之前,我们需要先设置一些东西:
- 一台具有至少 2GB RAM 的 Ubuntu 16.04 服务器,按照此 Initial Server Setup on Ubuntu 16.04 教程进行设置,包括 sudo 非 root 用户和防火墙。
- Docker 安装在您的服务器上,您可以按照 Ubuntu 16.04 的 Docker 安装教程的 Step 1 进行操作。
- 一个解析到你的服务器的域名,你可以按照这个主机名教程来设置。
- SMTP 邮件服务器。 如果您不想 运行自己的邮件服务器 ,您可以使用其他服务,例如 SparkPost 上的免费帐户。 如果您使用 SparkPost,则需要 创建 API 密钥 。
注意:如果你使用 1 GB 的 RAM,Discourse 需要一个交换文件。 尽管对于使用传统旋转硬盘的系统通常建议使用交换,但使用 SSD 交换可能会导致硬件随着时间的推移而退化。 出于这一考虑,我们不建议在 DigitalOcean 或任何其他使用 SSD 存储的提供商上启用交换。 这样做会影响您和您的邻居的底层硬件的可靠性。 因此,我们建议至少 2 GB 的 RAM 才能在 DigitalOcean Droplet 上运行 Discourse。 有关使用交换的详细信息,请参阅 如何在 Ubuntu 16.04 上添加交换空间。
第 1 步 — 下载话语
完成所有先决条件后,您可以直接安装 Discourse。
在其余的设置和引导过程中,您需要成为 root,所以首先,切换到 root shell。
sudo -s
接下来,创建 /var/discourse
目录,所有与 Discourse 相关的文件都将驻留。
mkdir /var/discourse
最后将官方Discourse Docker Image克隆成/var/discourse
。
git clone https://github.com/discourse/discourse_docker.git /var/discourse
有了我们需要的文件,我们可以继续进行配置和引导。
第 2 步 — 配置和引导话语
移动到 Discourse 文件所在的 /var/discourse
目录。
cd /var/discourse
从这里,您可以启动包含的设置脚本。
./discourse-setup
您将被问到以下问题:
您的 Discourse 的主机名?
输入您想用于 Discourse 的主机名,例如
discourse.example.com
,将example.com
替换为您的域名。 您确实需要使用域名,因为 IP 地址在发送电子邮件时不起作用。管理员帐户的电子邮件地址?
选择您要用于 Discourse 管理员帐户的电子邮件地址。 它可以与您的 Discourse 域完全无关,并且可以是您认为方便的任何电子邮件地址。
请注意,当第一个用户注册该电子邮件时,该电子邮件地址将默认成为 Discourse 管理员。 稍后当您从其 Web 控制面板设置 Discourse 时,您还需要此电子邮件地址。
SMTP 服务器地址?
SMTP 用户名?
SMTP 端口?
SMTP 密码?
输入这些问题的 SMTP 服务器详细信息。 如果使用 SparkPost,SMTP 服务器地址为
smtp.sparkpostmail.com
,用户名为 SMTP_Injection,端口为587
,密码为API 密钥。
最后,系统会要求您确认刚刚输入的所有设置。 确认设置后,脚本将生成一个名为 app.yml
的配置文件,然后启动引导过程。
注意:如果您需要在引导后更改或修复这些设置,请编辑您的 /containers/app.yml
文件并运行 ./launcher rebuild app
。 否则,您的更改将不会生效。
引导需要 2-8 分钟,之后您的实例将运行! 让我们继续创建管理员帐户。
第 3 步 — 注册管理员帐户
在您喜欢的 Web 浏览器中访问您的 Discourse 域以查看 Discourse 网页。
如果您收到 502 Bad Gateway 错误,请尝试等待一两分钟然后刷新; 话语可能还没有结束。
页面加载后,点击蓝色的 Register 按钮。 您将看到一个名为 Register Admin Account 的表单,其中包含以下字段:
- 电子邮件:从下拉菜单中选择您之前提供的电子邮件地址。
- 用户名:选择用户名。
- 密码:选择强密码。
然后点击表单上蓝色的注册按钮提交。 你会看到一个对话框,上面写着 Confirm your Email。 检查您的收件箱中的确认电子邮件。 如果您没有收到,请尝试单击重新发送激活电子邮件按钮。 如果您仍然无法注册新的管理员帐户,请参阅 Discourse 电子邮件故障排除清单。
注册您的管理员帐户后,设置向导将启动并引导您完成 Discourse 的基本配置。 您可以现在浏览它或单击也许稍后跳过。
完成或跳过设置向导后,您将看到一些主题和 Admin 快速入门指南(标记为 READ ME FIRST),其中包含进一步自定义 Discourse 安装的提示。
你都准备好了! 如果您将来需要升级 Discourse,您可以通过从 Git 存储库中拉取最新版本的代码并重新构建应用程序来从命令行执行此操作,如下所示:
cd /var/discourse git pull ./launcher rebuild app
您也可以通过访问http://discourse.example.com/admin/upgrade
,点击升级到最新版本并按照说明在浏览器中进行更新。
结论
您现在可以开始管理您的 Discourse 论坛并让用户注册。 在 Discourse About 页面 上了解有关 Discourse 功能的更多信息。