别用一键应用：用 1Panel + 官方 discourse_docker 正确部署 Discourse（可被面板管理）

很多人想在一台 VPS 上用 1Panel 部署 Discourse，直觉上会去点“应用市场 → 一键安装”。但现实经常是：

装完能跑，但 装插件就崩
维护时点了“重建/重启”，就 502/起不来
想让 1Panel 的 WAF / 证书 / 备份 接管，又发现 Discourse 的部署方式“不像一个标准的 Docker Compose”

这篇文章给你一个更稳的思路：

用 1Panel 管服务器（反代 / HTTPS / WAF / 防火墙 / 备份），用 Discourse 官方 discourse_docker 完成安装与重建。

这个方案的目标不是“最省事”，而是：后期可维护、可升级、可加插件、并且能融进面板化运维体系。

说明：本文方案与踩坑点主要参考了 Akashio 的帖子《如何正确的使用 1Panel 部署 Discourse？》，并对照 Discourse 官方安装文档做了补充与纠错（链接见文末参考）。

1) 为什么 1Panel 的“一键 Discourse”容易翻车？

核心原因：Discourse 的官方安装方式虽然是 Docker，但它不是“标准 Docker Compose 拉镜像”那种模型。

官方推荐的 discourse_docker 工作流，会在安装/重建时根据你的配置（域名、SMTP、插件等）去 bootstrap / rebuild。
最终运行时可能就一个容器，但容器内封装了多种服务组件；它更像“带构建系统的部署套件”，而不是单纯的镜像拉取。

而很多面板的一键应用更偏向：

拉一组预制镜像（或运行一个容器再在容器里构建另一个镜像）
通过面板按钮去“重建/升级/改配置”

当这两种模型叠在一起，最常见的后果就是：

面板对容器的“重建”动作，并不等价于 Discourse 官方的 ./launcher rebuild app
插件安装、升级流程和官方预期不一致，导致状态漂移，最终“能跑但不可维护”

所以更推荐的折中是：

面板负责基础设施与安全（证书 / WAF / 防火墙 / 备份 / 反向代理）
Discourse 自己仍按官方方式安装与管理

2) 总体架构：Discourse 不直接占用 80/443

常见冲突点是：

1Panel 的站点/网关通常会占用 80/443
Discourse 默认也希望用 80/443 直接对外服务

更稳的做法是：

Discourse 容器只绑定到 127.0.0.1 的高端口（例如 8973）
由 1Panel 建站点（反向代理）把公网域名流量转发到 127.0.0.1:8973
HTTPS 证书、WAF、防火墙策略都在 1Panel 层做

这样 Discourse 不直接暴露在公网端口上，面板也更容易统一治理。

3) 实战：在 1Panel 环境中按官方 discourse_docker 安装

下面步骤默认你已经：

有一台干净的 Linux 服务器
已装好 1Panel
有一个准备给 Discourse 用的域名（例如 forum.example.com）

Step 0：规划目录（推荐放到 1Panel 的 Apps 目录下）

为了后续备份/管理更顺手，可以把 Discourse 放在：

/opt/1panel/apps/discourse

Step 1：拉取 `discourse_docker`

用 SSH 连到宿主机：

bash

sudo -s
git clone https://github.com/discourse/discourse_docker.git /opt/1panel/apps/discourse
cd /opt/1panel/apps/discourse

discourse_docker 仓库里有 launcher、samples/、containers/、shared/ 等目录结构，官方也明确：containers/ 目录是你要维护的容器定义目录，通常从 samples/ 复制模板开始。

Step 2：准备 `containers/app.yml`

Discourse 单容器安装通常基于 samples/standalone.yml。

把它复制到 containers/app.yml：

bash

cp samples/standalone.yml containers/app.yml

权限方面：containers/ 和 app.yml 会包含敏感配置（SMTP、密钥等），建议把权限收紧（至少不要 world-readable）。不少踩坑反馈里提到误把整个目录 chmod 到 700 导致问题，因此我更建议只对 containers/ 做收紧：

bash

chmod 700 containers

具体权限策略你可以按团队习惯调整，但原则是：只收紧需要收紧的目录，别一把梭把整个项目目录改到过严。

Step 3：修改 `containers/app.yml`（关键）

你需要重点改几个地方：

3.1 端口：避免与面板占用的 80/443 冲突

把对外端口改成只监听本机：

yml

expose:
  - '127.0.0.1:8973:80' # http
  - '127.0.0.1:4433:443' # https（可选）

思路就是：容器别直接暴露到公网，公网访问交给 1Panel 的反代站点。

3.2 域名

yml

DISCOURSE_HOSTNAME: 'forum.example.com'

3.3 管理员邮箱（很重要）

安装向导会要求管理员激活，务必提前写好：

yml

DISCOURSE_DEVELOPER_EMAILS: '[email protected]'

3.4 SMTP（建议认真配；但“可以先跳过”）

参考 Discourse 官方安装文档，SMTP 在新版本安装流程里是可跳过的：如果跳过 SMTP，可以使用 Discourse ID 登录等方式先把站跑起来，后面再补邮件配置。

但生产环境还是建议配好 SMTP（通知、注册、找回密码都需要）下列是基础的配置。如果还有问题建议去了解官方文档

yaml

DISCOURSE_SMTP_ADDRESS: smtp.example.com #发信客户端
DISCOURSE_SMTP_PORT: 587 #发信端口一般配置465/587
DISCOURSE_SMTP_USER_NAME: [email protected] #邮箱/Username
DISCOURSE_SMTP_PASSWORD: 'pa$$word' #密码
DISCOURSE_SMTP_FORCE_TLS: true #TLS开关如果使用465/587端口一定要开启否则无法正常发信

3.5 volumes：让数据在 rebuild 后仍然存在

你需要确保 uploads / 日志等在宿主机持久化（shared/ 目录就是为这个设计的），这样你后面 ./launcher rebuild app 不会“重建=清空”。建议配置

yml

volumes:
  - volume:
      host: /opt/1panel/apps/discourse/shared/standalone
      guest: /shared
  - volume:
      host: /opt/1panel/apps/discourse/shared/standalone/log/var-log
      guest: /var/log

（具体 volume 配置建议以 standalone.yml 模板为基准，只在你明确知道含义时再改。）

Step 4：开始构建并启动

在 discourse_docker 目录下执行：

bash

./launcher rebuild app

这一步会拉依赖、构建镜像并启动容器，时间取决于你机器配置与网络环境。构建完成后会在1Panel->容器出现"app"的容器

4) 在 1Panel 里配置站点反代与 HTTPS

当容器起来后，你可以在 1Panel：

网站 → 新建网站 → 反向代理
域名填 forum.example.com
反代地址填：127.0.0.1:8973

然后在站点配置里申请/配置证书：

开启 HTTPS
开启 HTTP → HTTPS 自动跳转

这样，你的公网访问链路就是：

User → 1Panel 站点/WAF/HTTPS → 127.0.0.1:8973 → Discourse 容器

5) 常见问题与踩坑修复

5.1 SMTP 配不好，卡在管理员激活

可以按参考帖的思路：

用 ./discourse-doctor 做诊断与测试邮件
改 containers/app.yml 的 SMTP 配置
只改 SMTP 时，通常不必完整 rebuild，可以用 destroy/start（以你的实际情况为准）

bash

./discourse-doctor
./launcher destroy app
./launcher start app

5.2 机器配置不够，构建阶段被 SIGKILL

这通常是内存不足导致 OOM。

参考帖里有人用 加大 swap 的方式跑过编译阶段：

低配机（例如 4C6G）建议预留 swap，至少保证 build 不会被系统杀

5.3 MaxMind GeoLite2 提示缺少密钥

这是可选项：用于 IP 地理位置相关功能；不影响论坛核心可用性。官方安装文档也给了如何配置 MaxMind license key 的说明。

5.4 安装插件

discourse_docker 的典型方式是在 app.yml 的 hooks 里增加插件 git clone，然后 rebuild：

找到 hooks -> after_code
增加插件仓库地址
然后 ./launcher rebuild app

6) 你应该怎么选：一键应用 vs 本文方案

我的建议是：

想省事临时体验：可以一键，但不要对“后期维护”抱太大期望
想长期运营社区：用本文方案更稳（面板负责安全与代理，Discourse 按官方装）

你最终要的不是“今天能跑”，而是：

半年后还能顺滑升级
想加插件不会炸
证书/WAF/访问控制能持续收敛

参考资料

Akashio 论坛帖子：《如何正确的使用 1Panel 部署 Discourse？》（本文主要参考）
- https://vibe.akashio.com/t/topic/36
Discourse 官方：Install Discourse on a Cloud Server
- https://github.com/discourse/discourse/blob/main/docs/INSTALL-cloud.md
Discourse 官方部署套件：discourse/discourse_docker
- https://github.com/discourse/discourse_docker

很多人想在一台 VPS 上用 1Panel 部署 Discourse，直觉上会去点“应用市场 → 一键安装”。但现实经常是：

装完能跑，但 装插件就崩
维护时点了“重建/重启”，就 502/起不来
想让 1Panel 的 WAF / 证书 / 备份 接管，又发现 Discourse 的部署方式“不像一个标准的 Docker Compose”

这篇文章给你一个更稳的思路：

用 1Panel 管服务器（反代 / HTTPS / WAF / 防火墙 / 备份），用 Discourse 官方 discourse_docker 完成安装与重建。

这个方案的目标不是“最省事”，而是：后期可维护、可升级、可加插件、并且能融进面板化运维体系。

说明：本文方案与踩坑点主要参考了 Akashio 的帖子《如何正确的使用 1Panel 部署 Discourse？》，并对照 Discourse 官方安装文档做了补充与纠错（链接见文末参考）。

1) 为什么 1Panel 的“一键 Discourse”容易翻车？

核心原因：Discourse 的官方安装方式虽然是 Docker，但它不是“标准 Docker Compose 拉镜像”那种模型。

官方推荐的 discourse_docker 工作流，会在安装/重建时根据你的配置（域名、SMTP、插件等）去 bootstrap / rebuild。
最终运行时可能就一个容器，但容器内封装了多种服务组件；它更像“带构建系统的部署套件”，而不是单纯的镜像拉取。

而很多面板的一键应用更偏向：

拉一组预制镜像（或运行一个容器再在容器里构建另一个镜像）
通过面板按钮去“重建/升级/改配置”

当这两种模型叠在一起，最常见的后果就是：

面板对容器的“重建”动作，并不等价于 Discourse 官方的 ./launcher rebuild app
插件安装、升级流程和官方预期不一致，导致状态漂移，最终“能跑但不可维护”

所以更推荐的折中是：

面板负责基础设施与安全（证书 / WAF / 防火墙 / 备份 / 反向代理）
Discourse 自己仍按官方方式安装与管理

2) 总体架构：Discourse 不直接占用 80/443

常见冲突点是：

1Panel 的站点/网关通常会占用 80/443
Discourse 默认也希望用 80/443 直接对外服务

更稳的做法是：

Discourse 容器只绑定到 127.0.0.1 的高端口（例如 8973）
由 1Panel 建站点（反向代理）把公网域名流量转发到 127.0.0.1:8973
HTTPS 证书、WAF、防火墙策略都在 1Panel 层做

这样 Discourse 不直接暴露在公网端口上，面板也更容易统一治理。

3) 实战：在 1Panel 环境中按官方 discourse_docker 安装

下面步骤默认你已经：

有一台干净的 Linux 服务器
已装好 1Panel
有一个准备给 Discourse 用的域名（例如 forum.example.com）

Step 0：规划目录（推荐放到 1Panel 的 Apps 目录下）

为了后续备份/管理更顺手，可以把 Discourse 放在：

/opt/1panel/apps/discourse

Step 1：拉取 `discourse_docker`

用 SSH 连到宿主机：

bash

sudo -s
git clone https://github.com/discourse/discourse_docker.git /opt/1panel/apps/discourse
cd /opt/1panel/apps/discourse

Step 2：准备 `containers/app.yml`

Discourse 单容器安装通常基于 samples/standalone.yml。

把它复制到 containers/app.yml：

bash

cp samples/standalone.yml containers/app.yml

bash

chmod 700 containers

具体权限策略你可以按团队习惯调整，但原则是：只收紧需要收紧的目录，别一把梭把整个项目目录改到过严。

Step 3：修改 `containers/app.yml`（关键）

你需要重点改几个地方：

3.1 端口：避免与面板占用的 80/443 冲突

把对外端口改成只监听本机：

yml

expose:
  - '127.0.0.1:8973:80' # http
  - '127.0.0.1:4433:443' # https（可选）

思路就是：容器别直接暴露到公网，公网访问交给 1Panel 的反代站点。

3.2 域名

yml

DISCOURSE_HOSTNAME: 'forum.example.com'

3.3 管理员邮箱（很重要）

安装向导会要求管理员激活，务必提前写好：

yml

DISCOURSE_DEVELOPER_EMAILS: '[email protected]'

3.4 SMTP（建议认真配；但“可以先跳过”）

但生产环境还是建议配好 SMTP（通知、注册、找回密码都需要）下列是基础的配置。如果还有问题建议去了解官方文档

yaml

DISCOURSE_SMTP_ADDRESS: smtp.example.com #发信客户端
DISCOURSE_SMTP_PORT: 587 #发信端口一般配置465/587
DISCOURSE_SMTP_USER_NAME: [email protected] #邮箱/Username
DISCOURSE_SMTP_PASSWORD: 'pa$$word' #密码
DISCOURSE_SMTP_FORCE_TLS: true #TLS开关如果使用465/587端口一定要开启否则无法正常发信

3.5 volumes：让数据在 rebuild 后仍然存在

你需要确保 uploads / 日志等在宿主机持久化（shared/ 目录就是为这个设计的），这样你后面 ./launcher rebuild app 不会“重建=清空”。建议配置

yml

volumes:
  - volume:
      host: /opt/1panel/apps/discourse/shared/standalone
      guest: /shared
  - volume:
      host: /opt/1panel/apps/discourse/shared/standalone/log/var-log
      guest: /var/log

（具体 volume 配置建议以 standalone.yml 模板为基准，只在你明确知道含义时再改。）

Step 4：开始构建并启动

在 discourse_docker 目录下执行：

bash

./launcher rebuild app

这一步会拉依赖、构建镜像并启动容器，时间取决于你机器配置与网络环境。构建完成后会在1Panel->容器出现"app"的容器

4) 在 1Panel 里配置站点反代与 HTTPS

当容器起来后，你可以在 1Panel：

网站 → 新建网站 → 反向代理
域名填 forum.example.com
反代地址填：127.0.0.1:8973

然后在站点配置里申请/配置证书：

开启 HTTPS
开启 HTTP → HTTPS 自动跳转

这样，你的公网访问链路就是：

User → 1Panel 站点/WAF/HTTPS → 127.0.0.1:8973 → Discourse 容器

5) 常见问题与踩坑修复

5.1 SMTP 配不好，卡在管理员激活

可以按参考帖的思路：

用 ./discourse-doctor 做诊断与测试邮件
改 containers/app.yml 的 SMTP 配置
只改 SMTP 时，通常不必完整 rebuild，可以用 destroy/start（以你的实际情况为准）

bash

./discourse-doctor
./launcher destroy app
./launcher start app

5.2 机器配置不够，构建阶段被 SIGKILL

这通常是内存不足导致 OOM。

参考帖里有人用 加大 swap 的方式跑过编译阶段：

低配机（例如 4C6G）建议预留 swap，至少保证 build 不会被系统杀

5.3 MaxMind GeoLite2 提示缺少密钥

这是可选项：用于 IP 地理位置相关功能；不影响论坛核心可用性。官方安装文档也给了如何配置 MaxMind license key 的说明。

5.4 安装插件

discourse_docker 的典型方式是在 app.yml 的 hooks 里增加插件 git clone，然后 rebuild：

找到 hooks -> after_code
增加插件仓库地址
然后 ./launcher rebuild app

6) 你应该怎么选：一键应用 vs 本文方案

我的建议是：

想省事临时体验：可以一键，但不要对“后期维护”抱太大期望
想长期运营社区：用本文方案更稳（面板负责安全与代理，Discourse 按官方装）

你最终要的不是“今天能跑”，而是：

半年后还能顺滑升级
想加插件不会炸
证书/WAF/访问控制能持续收敛

参考资料

Akashio 论坛帖子：《如何正确的使用 1Panel 部署 Discourse？》（本文主要参考）
- https://vibe.akashio.com/t/topic/36
Discourse 官方：Install Discourse on a Cloud Server
- https://github.com/discourse/discourse/blob/main/docs/INSTALL-cloud.md
Discourse 官方部署套件：discourse/discourse_docker
- https://github.com/discourse/discourse_docker

1) 为什么 1Panel 的“一键 Discourse”容易翻车？

2) 总体架构：Discourse 不直接占用 80/443

3) 实战：在 1Panel 环境中按官方 discourse_docker 安装

Step 0：规划目录（推荐放到 1Panel 的 Apps 目录下）

Step 1：拉取 discourse_docker

Step 2：准备 containers/app.yml

Step 3：修改 containers/app.yml（关键）

3.1 端口：避免与面板占用的 80/443 冲突

3.2 域名

3.3 管理员邮箱（很重要）

3.4 SMTP（建议认真配；但“可以先跳过”）

3.5 volumes：让数据在 rebuild 后仍然存在

Step 4：开始构建并启动

4) 在 1Panel 里配置站点反代与 HTTPS

5) 常见问题与踩坑修复

5.1 SMTP 配不好，卡在管理员激活

5.2 机器配置不够，构建阶段被 SIGKILL

5.3 MaxMind GeoLite2 提示缺少密钥

5.4 安装插件

6) 你应该怎么选：一键应用 vs 本文方案

参考资料

1) 为什么 1Panel 的“一键 Discourse”容易翻车？

2) 总体架构：Discourse 不直接占用 80/443

3) 实战：在 1Panel 环境中按官方 discourse_docker 安装

Step 0：规划目录（推荐放到 1Panel 的 Apps 目录下）

Step 1：拉取 discourse_docker

Step 2：准备 containers/app.yml

Step 3：修改 containers/app.yml（关键）

3.1 端口：避免与面板占用的 80/443 冲突

3.2 域名

3.3 管理员邮箱（很重要）

3.4 SMTP（建议认真配；但“可以先跳过”）

3.5 volumes：让数据在 rebuild 后仍然存在

Step 4：开始构建并启动

4) 在 1Panel 里配置站点反代与 HTTPS

5) 常见问题与踩坑修复

5.1 SMTP 配不好，卡在管理员激活

5.2 机器配置不够，构建阶段被 SIGKILL

5.3 MaxMind GeoLite2 提示缺少密钥

5.4 安装插件

6) 你应该怎么选：一键应用 vs 本文方案

参考资料

Step 1：拉取 `discourse_docker`

Step 2：准备 `containers/app.yml`

Step 3：修改 `containers/app.yml`（关键）

Step 1：拉取 `discourse_docker`

Step 2：准备 `containers/app.yml`

Step 3：修改 `containers/app.yml`（关键）