一、前言
Discourse 是一个现代化的开源论坛系统，采用 Ruby on Rails 和 Ember.js 构建，以移动优先的设计理念著称。目前已被英伟达、OpenAI、Cloudflare 等众多科技公司采用。
2026年，Discourse 的安装流程大幅简化，不再强制要求域名和邮箱服务，一行命令即可完成部署。
本文将带你从零开始，在 VPS 上部署属于自己的 Discourse 论坛。
二、准备工作
2.1 服务器配置要求
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 1核 | 2核或更高 |
| 内存 | 1GB（需配置SWAP） | 2GB或更高 |
| 硬盘 | 30GB SSD | 50GB以上SSD |
| 系统 | Ubuntu 20.04或22.04 | Ubuntu 22.04 |
如果服务器内存不足1GB，安装脚本会直接报错无法继续。建议至少使用2GB内存的服务器以获得流畅体验。
2.2 需要准备的东西
-
一台有公网IP的VPS，确保80和443端口已开放
-
SSH连接工具（Windows用户可用PuTTY，Mac或Linux用户直接用终端）
-
如需使用免费二级域名，提前注册一个Discourse ID账号
2.3 关于免费二级域名
Discourse 官方提供免费的二级域名，格式为 yourforum.discourse.diy。
如果不想购买域名，只需：
-
注册一个 Discourse ID 账号
-
在安装过程中选择使用免费二级域名
-
输入你想要的子域名即可
三、安装步骤
3.1 连接到服务器
使用SSH连接到你的VPS：
text
ssh root@你的服务器IP 3.2 更新系统（可选但推荐）
text
apt update && apt upgrade -y 3.3 一键安装 Discourse
在终端中执行以下命令：
text
wget -qO- https://raw.githubusercontent.com/discourse/discourse_docker/main/install-discourse | sudo bash 这条命令会自动完成：
-
检测系统环境
-
安装 Docker 及相关依赖
-
克隆 Discourse Docker 项目到 /var/discourse 目录
-
启动交互式配置向导
整个安装过程可能需要5到15分钟，取决于你的服务器性能和网络状况。
3.4 交互式配置向导
脚本运行后会进入交互式配置界面，需要回答以下几个问题：
第一步：管理员邮箱
系统会提示输入管理员邮箱地址，这个邮箱需要与你后续注册的 Discourse ID 账号关联。
第二步：域名配置
系统会询问是否使用自己的域名：
-
如果选择使用免费二级域名，输入 n，然后输入你想要的子域名名称，最后粘贴从 Discourse ID 获取的验证码
-
如果选择使用自定义域名，输入 y，并确保该域名的DNS A记录已指向当前服务器IP
第三步：SMTP邮箱配置
系统会询问是否立即配置SMTP：
建议输入 n 跳过。Discourse 现在支持通过 Discourse ID 进行身份验证，可以不配置SMTP就完成安装。你可以在论坛上线后再配置邮件服务。
第四步：SSL证书配置
如果使用自定义域名，系统会询问是否自动申请 Let’s Encrypt SSL 证书，输入邮箱地址即可自动配置 HTTPS。
3.5 等待安装完成
配置确认后，系统会自动：
-
生成配置文件 /var/discourse/containers/app.yml
-
拉取 Docker 镜像
-
启动 Discourse 容器
-
配置数据库和缓存
看到类似以下输出表示安装成功：
Successfully built and started Discourse.
验证容器运行状态：
text
docker ps 你应该能看到 local_discourse/app 镜像的容器正在运行，并且映射了80和443端口。
四、首次访问与初始化配置
4.1 访问你的论坛
在浏览器中输入你配置的域名：
-
免费二级域名：https://你的论坛名.discourse.diy
-
自定义域名：https://你的域名.com
首次访问可能需要等待1到2分钟让服务完全启动。
4.2 使用 Discourse ID 登录
点击 Login with Discourse ID 按钮，使用你之前注册的 Discourse ID 账号登录。登录后，系统会自动识别你为管理员。
4.3 完成设置向导
登录后，Discourse 会引导你完成初始化设置：
-
社区名称：为你的论坛起一个名字
-
语言选择：选择界面语言（支持简体中文）
-
可见性设置：公开则搜索引擎可收录，私有则仅登录用户可见
-
注册设置：开放注册或仅邀请注册
-
审核设置：是否启用管理员审核新用户
完成后点击确认保存设置。
4.4 创建第一个分类
向导会引导你创建论坛的第一个分类，输入分类名称和描述即可。
4.5 发布第一个帖子
点击 New Topic 按钮，写一篇欢迎帖然后发布。
五、常用管理操作
5.1 后台管理面板
访问 /admin 进入管理后台。在这里你可以：
-
管理用户和权限
-
创建和编辑分类
-
安装主题和插件
-
配置邮件服务
-
查看统计数据
5.2 配置 SMTP 邮件服务
虽然安装时可以跳过，但为了让用户能收到注册确认、密码重置、通知等邮件，建议配置SMTP。
进入后台的 Settings 中的 Email 选项，填写SMTP服务器地址、端口、用户名和密码即可。
5.3 切换中文界面
在后台 Settings 的 Required 中搜索 locale，选择 zh_CN 即可切换为简体中文界面。
5.4 常用管理命令
进入 Discourse 安装目录：
text
cd /var/discourse 重启 Discourse：
text
./launcher restart app 停止 Discourse：
text
./launcher stop app 查看日志：
text
./launcher logs app 更新 Discourse 到最新版本：
text
./launcher rebuild app 六、常见问题与解决方法
问题一：安装时报错说内存不足
原因是服务器内存不足。解决方法是升级服务器配置到2GB以上内存，或者配置SWAP交换空间。
问题二：访问论坛时显示错误或无法加载
原因是域名未正确配置或服务未完全启动。解决方法是等待1到2分钟让服务完全启动，确认域名的DNS解析已生效，检查防火墙是否开放了80和443端口。
问题三：Discourse ID 验证失败
原因是验证码输入错误或过期。解决方法是回到 Discourse ID 网站重新生成验证码，并确认安装时填写的邮箱与 Discourse ID 注册邮箱一致。
问题四：如何升级到最新版本
执行以下命令：
text
cd /var/discourse git pull ./launcher rebuild app 七、总结
恭喜！你已经成功安装并配置好了自己的 Discourse 论坛。
回顾整个过程：
-
准备服务器：约5分钟
-
运行安装脚本：约10分钟
-
配置向导：约3分钟
-
初始化设置：约5分钟
Discourse 的强大之处不止于此，你还可以安装各种插件扩展功能、自定义主题和样式、通过 API 进行二次开发、与主流社交平台集成。
希望这篇教程能帮助你顺利搭建起属于自己的社区！
