Discourse 是一个现代化、高性能的开源论坛系统，支持邮件通知、Markdown、插件扩展等功能。本教程将带你在 Ubuntu 22.04 上快速部署 Discourse，并通过官方推荐的 Docker 部署方式进行安装。
📌 系统要求（官方推荐）
- Ubuntu 20.04 / 22.04
- 2GB RAM（最低）/ 4GB RAM（推荐）
- 1 CPU（最低）
- 域名准备好（支持 HTTPS）
- 开放 80 / 443 端口
一、更新 Ubuntu 系统环境
sudo apt update -y
sudo apt-get install apt-transport-https ca-certificates git curl gnupg -y
安装必要组件（git / curl / gnupg 用于获取 Docker 与 Discourse）。
二、添加 Docker GPG 密钥与官方存储库
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
| sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
🔹 使用官方 Docker 源可确保稳定与最新版本。
三、安装 Docker（Discourse 官方唯一推荐方式）
sudo apt-get install docker-ce docker-ce-cli containerd.io -y
安装完成后检查版本：
docker --version
四、下载 Discourse 官方 Docker 环境
sudo mkdir /var/discourse
sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse
/var/discourse是 Discourse 官方标准安装路径。
五、运行 Discourse 安装程序（自动生成配置）
cd /var/discourse
sudo ./discourse-setup
接下来安装器会一步步引导你：
- 输入 你的域名（如
forum.example.com） - 输入 管理员邮箱
- SMTP 邮件服务器（例如 Mailgun、腾讯企业邮、阿里邮箱等）
- SMTP 用户名与密码
- 系统会自动：
- 生成
app.yml - 下载镜像
- 配置 nginx / Let’s Encrypt
- 构建 Discourse 实例
- 生成
⚠️ 必须配置正确的 SMTP，否则无法创建管理员帐号。
六、访问 Discourse 网页界面
安装完成后直接访问：
http://你的域名
或使用 HTTPS（如果启用 Let’s Encrypt）：
https://你的域名
即可看到全新 Discourse 论坛首页。
七、注册管理员账户
首次访问网站，使用 你在安装过程中填写的管理员邮箱 注册，即可自动成为管理员。
如未收到验证邮件，请检查 SMTP 设置是否正确。
八、升级 Discourse（官方推荐流程）
进入安装目录：
cd /var/discourse
sudo git pull
sudo ./launcher rebuild app
该命令将：
- 拉取最新 Discourse 镜像
- 更新插件
- 自动迁移数据库
- 重建运行环境
🔥 此命令是 Discourse 官方唯一推荐的升级方式。
🧩 常用维护命令（可选）
重启 Discourse：
sudo ./launcher restart app
停止：
sudo ./launcher stop app
查看日志：
sudo ./launcher logs app
🎉 按照以上步骤，你已经成功地在 Ubuntu 22.04 上安装并运行一个完整的 Discourse 论坛。
你现在已经拥有：
- HTTPS 支持
- 自动邮件功能
- 完整后台管理界面
- 高性能、可扩展社区系统
Discourse 是目前最好的开源论坛方案之一，无论是企业社区、技术讨论区还是兴趣社群，它都能轻松胜任。
