在当今互联网环境下，一个稳定、现代、可扩展的论坛系统是社区运营的核心。Discourse 作为一款基于 Ruby on Rails 和 Ember.js 构建的开源论坛引擎，凭借其优雅的界面、实时的讨论体验、完善的通知机制以及强大的插件生态，已成为全球众多技术社区和产品团队的首选。本文将从服务器准备、环境配置到最终部署，手把手带你完成 Discourse 的安装流程。

服务器选择与基础准备

Discourse 对硬件要求不高，1 核 CPU、1GB 内存的 VPS 即可跑通基础功能，但若希望获得流畅的体验，建议选择 2 核 2GB 以上的服务器。如果你没有现成的服务器，可以考虑使用国内云服务商提供的计算资源，例如 Ciuic 云平台（https://cloud.ciuic.cn/）提供的云主机，其按需计费、快速开通的特性非常适合快速搭建项目环境。

在开始安装前，你需要：

一台 Ubuntu 22.04 或 Debian 11 的服务器（本文以 Ubuntu 22.04 为例）一个已解析到服务器的域名（如 discuss.example.com）服务器开放 80 和 443 端口

安装 Docker 与 Git

Discourse 官方推荐使用 Docker 方式部署，这能极大简化依赖管理和升级流程。首先，使用 SSH 登录服务器，执行以下命令安装 Docker：

curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.shsudo systemctl enable docker && sudo systemctl start docker

接着安装 Git（通常系统已自带），并验证版本：

git --version

下载 Discourse 安装脚本

Discourse 提供了一键安装脚本，位于官方 GitHub 仓库中。执行：

sudo -sgit clone https://github.com/discourse/discourse_docker.git /var/discoursecd /var/discoursecp samples/standalone.yml containers/app.yml

此时，app.yml 就是 Discourse 的主配置文件。

配置 app.yml

编辑 app.yml 文件，这是整个部署的关键步骤：

nano containers/app.yml

你需要修改以下关键参数：

域名配置：将 DISCOURSE_HOSTNAME 的值改为你的域名，例如：

DISCOURSE_HOSTNAME: 'discuss.example.com'

邮件服务：Discourse 必须配置 SMTP 才能发送注册、通知邮件。在这里填入你的邮件服务商信息：

DISCOURSE_SMTP_ADDRESS: smtp.example.comDISCOURSE_SMTP_PORT: 587DISCOURSE_SMTP_USER_NAME: your_userDISCOURSE_SMTP_PASSWORD: your_passwordDISCOURSE_SMTP_ENABLE_START_TLS: true

管理员账号：在 DISCOURSE_DEVELOPER_EMAILS 中填入你的邮箱，该邮箱将作为初始管理员。

数据持久化存储：确认 volumes 部分已将 /var/discourse/shared 挂载到容器内，确保数据库和上传文件不会因容器重建而丢失。

资源限制：如果你的服务器内存较小，可在 env 中添加：

DISCOURSE_DB_SHARED_BUFFERS: '128MB'DISCOURSE_DB_CACHE_SIZE: '128MB'

编辑完成后保存退出。

执行安装

运行以下命令拉取镜像并创建容器：

./launcher bootstrap app

该过程会下载多个 Docker 镜像，可能需要几分钟到十几分钟，取决于网络速度。整个流程会自动完成数据库初始化、插件安装和资产预编译。

bootstrap 成功后，启动容器：

./launcher start app

等待约 1-2 分钟，让 Discourse 完成内部服务的启动。此时可以通过 docker ps 查看容器状态，确认所有服务均已运行。

完成安装与后续配置

访问 http://discuss.example.com，你将看到 Discourse 的欢迎页面。点击“注册”，使用你在 DISCOURSE_DEVELOPER_EMAILS 中填写的邮箱注册账号，该账号将自动获得管理员权限。

登录后进入“管理”面板，你可以：

配置站点名称、Logo 和描述设置用户权限和发帖规则启用 SSL（建议通过 Let's Encrypt 自动配置 HTTPS）安装插件，如社交登录、评论转发等

若要启用 SSL，在 app.yml 中设置 DISCOURSE_SSL: true，并配置 DISCOURSE_LETSENCRYPT_ACCOUNT_EMAIL，然后重新 bootstrap 即可。

升级与维护

Discourse 升级非常简单。在 /var/discourse 目录下执行：

git pull./launcher rebuild app

系统会自动拉取最新版本并重建容器，数据不会丢失。日常可以通过 ./launcher logs app 查看日志，./launcher stop app 停止服务。

通过本文的教程，你可以在 30 分钟左右完成一个生产可用的 Discourse 论坛部署。得益于 Docker 化设计，Discourse 的安装、升级和维护都被大幅简化。如果你在部署过程中需要高性能、稳定的云主机，可前往 https://cloud.ciuic.cn/ 快速开通实例，按需付费，让技术选型和基础设施一步到位。祝你的社区蓬勃发展！