如何在Ubuntu20.04上安装Discourse

作为 Write for DOnations 计划的一部分，作者选择了 Free and Open Source Fund 来接受捐赠。

Discourse 是一个开源的讨论平台。您可以将 Discourse 用作邮件列表、讨论论坛或长篇聊天室。在本教程中，您将使用容器化应用程序 Docker 在隔离环境中安装 Discourse。

先决条件

在开始之前，您需要做一些事情：

一台 Ubuntu 20.04 服务器，至少有 2GB 内存，一个 sudo 非 root 用户和一个防火墙。如需指导，您可以参考我们的 Ubuntu 20.04 初始服务器设置教程。
Docker 安装在您的服务器上。为此，您可以按照我们的 Ubuntu 20.04 Docker 安装教程的步骤 1 进行操作。
具有指向您服务器 IP 的可用 A 记录的域（或子域）。如果您在 DigitalOcean 上管理您的 DNS，那么您可以按照本指南将您的 IP 与您的域关联。本教程将使用 discourse.your_domain。
SMTP 邮件服务器。如果您不想运行自己的邮件服务器，您可以使用其他服务，例如 Mailgun 上的免费帐户。

在下载和安装 Discourse 之前，创建 /var/discourse 目录。这是所有与 Discourse 相关的文件所在的位置：

sudo mkdir /var/discourse

最后将官方Discourse Docker Image克隆成/var/discourse：

sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse

有了 Discourse Docker 镜像，您现在可以安装和配置您的平台。

移动到 /var/discourse 目录：

cd /var/discourse

现在启动包含的设置脚本：

sudo ./discourse-setup

Discourse 安装脚本会询问以下问题：

OutputHostname for your Discourse?

输入 discourse.your_domain 或您为平台选择的任何主机名。

OutputEmail address for admin account?

选择您要用于 Discourse 管理员帐户的电子邮件地址。它可以与您的 Discourse 域无关，并且可以是您认为方便的任何电子邮件地址。

请注意，此电子邮件地址将成为 Discourse 管理员的默认地址。稍后，当您从其控制面板设置 Discourse 时，您将需要重复使用此电子邮件地址。

OutputSMTP server address?

OutputSMTP user name?

OutputSMTP port?

OutputSMTP password?

输入这些问题的 SMTP 服务器详细信息。如果您使用 Mailgun，则 SMTP 服务器地址将为 smtp.mailgun.org，用户名和密码是 Mailgun 的 domains 选项卡下您域的 SMTP 凭据。

最后，Discourse 安装脚本会要求您确认所有这些设置。确认您的设置，脚本将生成一个名为 app.yml 的配置文件。安装过程将自动开始。

注意：如果您在安装后需要更改或修复这些设置，请编辑您的/containers/app.yml文件并运行./launcher rebuild app。否则，您的更改将不会生效。

Discourse 安装大约需要 2-8 分钟，之后您的实例将运行。现在您可以打开 Web 浏览器并创建管理员帐户。

在您喜欢的网络浏览器中访问 discourse.your_domain，您将看到 Discourse 'Congrats' 启动画面。

如果您收到 502 Bad Gateway 错误，请尝试等待一两分钟，然后刷新您的浏览器；您的 Discourse 安装可能尚未完成。

页面加载后，点击蓝色的 Register 按钮。您将看到一个名为 Register Admin Account 的表单，其中包含以下字段：

然后点击表单上蓝色的注册按钮提交。你会看到一个对话框，上面写着 Confirm your Email。检查您的收件箱中的确认电子邮件。如果您没有收到，请尝试单击重新发送激活电子邮件按钮。如果您仍然无法注册新的管理员帐户，请参阅 Discourse 电子邮件故障排除清单。

注册您的管理员帐户后，设置向导将启动并引导您完成 Discourse 的基本配置。您可以现在浏览它或单击也许稍后跳过。

完成或跳过设置向导后，您将看到一些主题和 Discourse 的管理员快速入门指南。快速入门指南标记为 READ ME FIRST，并包含进一步自定义 Discourse 安装的提示。

您的 Discourse 平台现在可以使用了。如果您将来需要升级 Discourse，您可以通过从 Git 存储库中提取最新版本的代码并重新构建应用程序来从命令行执行此操作：

cd /var/discourse
sudo git pull
sudo ./launcher rebuild app

您还可以在浏览器中更新 Discourse。访问【X6X】【X10X】，点击【X23X】升级到最新版本【X56X】，按照提示操作。

您现在可以开始管理您的 Discourse 论坛并让用户注册。您可以在官方 Discourse About 页面上了解有关 Discourse 的更多功能。

随着社区的发展，您可能会考虑扩展部署，您可以按照教程如何使用负载均衡器和托管数据库集群扩展 Discourse 部署。