我正在为我帮助设置的 Discourse 论坛管理员撰写一份简短的文档。我遗漏了什么吗？

Canapin · 2025 年12 月 27 日 17:47

我已经为一些朋友/协会设置了 Discourse 论坛。我希望他们在管理方面更加自主，这样我就不必亲自干预了。

他们已经作为用户和联合管理员使用了 Discourse 几个月或几年了。他们不是“新管理员”，但他们缺乏关于如何日常维护 Discourse（除了版主基础知识）以及作为管理员应该了解什么以及在出现技术问题时该怎么做的深入知识，因为我一直都在处理这些事情。

我将来仍然可以提供帮助，但目标是让他们能够自行跟踪和解决最常见的问题。

这是我到目前为止写下的内容（已翻译成英文，因为我的文本将用法语编写，所以如果有些句子写得奇怪请不要在意）：

更新

通过 Web 界面

当管理面板中出现一个不高兴的红色笑脸时（表示有一个重要的更新需要应用），请运行更新。
更新通过以下方式进行：
https://tonforum.fr/admin/upgrade

有时需要分两步进行：您必须先更新“Docker_Manager”，然后才能升级其余部分：

通过命令行

有时，必须通过命令行进行更新（如果需要，Discourse 管理页面会明确说明）。

通过 SSH 连接到服务器
使用以下命令重建论坛（重建总会更新 Discourse）：
```
/var/discourse/launcher rebuild app
```
有时，在确认论坛正常工作后，删除未使用的 Docker 镜像（先前升级的残留物）以释放磁盘空间会很有用：
```
/var/discourse/launcher cleanup
```

服务器上重要文件的位置

`app.yml`

包含服务器配置和已安装插件的列表。如果您需要将论坛迁移到另一台服务器或应用某些配置（例如，将上传和备份移动到另一个磁盘），这非常有用。它位于此处：

/var/discourse/containers/app.yml

`mail-receiver.yml`

包含允许通过电子邮件接收回复并将其发布到论坛的软件的配置。它位于此处：

/var/discourse/containers/mail-receiver.yml

备份

备份文件存储在此处：

/var/discourse/shared/standalone/backups/default

论坛管理中的重要页面

一些可能有用的页面

主题和组件

它们包含自定义 CSS 和 HTML：

https://tonforum.fr/admin/config/customize/themes

日志

电子邮件

调试时很有用：

https://tonforum.fr/admin/email-logs

管理员操作日志

非常有用。它记录了版主和管理员执行的（几乎）所有站点设置更改和其他操作。

https://tonforum.fr/admin/logs/staff_action_logs

错误日志

当问题不明显时可以提供线索：

https://tonforum.fr/logs/

备份

要更改备份频率和最大备份数量、查看或下载它们：

https://tonforum.fr/admin/backups

资源

https://meta.discourse.org
官方支持。请随时在上面发帖；社区成员和开发人员通常非常乐于助人。

您认为可以添加/删除哪些内容？我认为可以删除 /logs/ 部分，因为它很少用到。我甚至不确定在管理了几年实例的过程中是否在其中找到了有用的信息。

Ed_S · 2025 年12 月 27 日 21:42

我想澄清几件事。

第一，在尝试通过网页界面进行更新时，请注意更新可能会失败，并且您的论坛可能会宕机。请做好准备。

第二，如果您的主机变得无法访问或损坏，您将需要备份文件和 yml 文件。您需要将它们保存在单独系统上的安全位置。

综合以上两点：在尝试更新之前，请务必进行备份并下载备份。

Heliosurge · 2025 年12 月 27 日 22:58

嗨，Ed，你说得很有道理。我记得之前有位成员创建了一个脚本用于备份到另一个系统。需要搜索一下确认一下。

这里是 OP（原始帖子）的一部分。Canapin 有一个很好的回复，其中包含一个关于备份到 Google Drive/Dropbox 的链接。

Lhc_fl:

最近，我的一位朋友遇到了 VPS 提供商突然在没有通知的情况下倒闭的问题。不幸的是，为了省钱，她选择了一个小众提供商——一个甚至不提供任何数据下载的提供商。更糟糕的是，她没有定期下载备份的习惯。一夜之间，她的网站和上面的所有数据都消失了。

对此感到震惊，我编写了一个 Powershell 脚本，可以定期自动将备份从您的服务器下载到您的本地计算机，而无需购买任何额外的对象存储服务或在其他方面花费一分钱。您所需要的只是一台您经常使用（并且有充足硬盘空间）并连接到互联网的 Windows 计算机。

该脚本将自动清理 5 天前的备份。您可以根据需要设置自动备份间隔和本地保存的最旧备份时间。
$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Starting Discourse backup download task..."
Write-Output '------------------------'
Write-Output "Fetching the latest backup file..."
Write-Output ''

while ($true) {

    $filename = ''

    while ($true) {
        try {
            Write-Output "> ssh -p $ssh_port $ssh_address 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'"
            Write-Output ''
            $filename = ssh -p $ssh_port "$ssh_address" 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'
            break
        }
        catch {
            $filename = ''
    
            Write-Output "Failed to fetch... Here is the log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Do you want to re-fetch? (y/N)"
            if ($answer -ne 'y') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Error: Failed to fetch file name $filename"
        Write-Output ''
        $answer = Read-Host 'Retry?(y/N)'
  
        if ($answer -eq 'y') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Latest backup: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename already exists. Do you want to download it again?(y/N)"
            Write-Output ''
            if ($answer -ne 'y') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Start downloading..."
            Write-Output ''
            
            while ($true) {
                try {
                    Write-Output "scp -p $ssh_port ${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename .\\backups\\"
                    Write-Output ''

                    scp -p $ssh_port "${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename" .\\backups\\
                    
                    Write-Output "Download completed"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download failed >_<... The following is the log:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Download again? (y/N)"
                    Write-Output ''
                    if ($answer -ne 'y') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Start trying to clean old backup files..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Delete old backup file $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "An error occurred while deleting old backup file $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Cleaned $count old backup files"
            Write-Output ''
        }
        else {
            Write-Output 'No old backup files need to clean up'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}
将以上脚本保存为 scriptname.ps1 在您希望下载备份的路径中。尝试“使用 Powershell 运行”。如果成功，则可以进入下一步。

要安排任务

搜索“任务计划程序”。

双击“添加任务”。出现“计划任务向导”。

单击“下一步”，然后单击“浏览”。出现“选择要调度的程序”对话框。

导航到您创建的脚本并单击它，然后单击“打开”。您返回到“计划任务向导”。

为任务提供一个名称，或保留默认名称（即文件名），指定运行脚本的频率，然后单击“下一步”。

指定开始时间和日期（如果指定了“每天”、“每周”或“每月”等），以及重复执行的频率，然后单击“下一步”。此项应与您的 discourse 的自动备份周期匹配

输入运行脚本的帐户的用户名和密码，然后单击“下一步”。

如果要配置高级属性，请选中该复选框，然后单击“完成”。

@Canapin 使用启动器重建应用，它不需要像这样运行吗：

./launcher r build app

这只是我从本站其他文档中学到的运行方式。正如我所学到的，事情往往有多种做法。哈哈

写得不错，很实用。

NateDhaliwal · 2025 年12 月 28 日 00:56

但是在那样做之前你会先 cd /var/discourse，所以 ./ 只是指代那个目录，那么 launcher 的路径本质上是 /var/discourse/launcher，对吗？

Heliosurge · 2025 年12 月 28 日 03:58

我之前不知道。我只是按照其他关于 discourse 的教程来使用它。但说得通。谢谢你。

Ed_S · 2025 年12 月 28 日 06:01

我想知道是否值得添加一些升级提示？如果阅读文档的人不知道如何通过 ssh 连接到主机进行调查或修复，谁可以？也许可以提供一个关于在这里的元（meta）上提问的提示，也许也可以提供一个关于使用 ask 的提示。

Jonathan5 · 2025 年12 月 28 日 23:42

这很有用。我只知道如何下载论坛本身创建的备份。

Canapin · 2025 年12 月 29 日 14:09

感谢您的帮助！

我在指南的开头添加了以下内容：

确保您为任何情况做好准备

强烈建议，除了本地备份（保存在论坛所在的同一服务器上）之外，还要在另一台服务器或云端保存这些备份的副本^[1]。

将文件 /var/discourse/containers/app.yml 的副本保存在安全位置也很有用^[2]。如果重新安装论坛或迁移到另一台服务器，将使用此可选文件。

如果对任何事情有任何严重的疑问，请联系我 (canapin@gmail.com)。

在更新部分添加了以下内容：

在进行任何更新之前，强烈建议下载论坛的最新备份。

添加了以下内容：

如果论坛不再工作怎么办？

重建论坛可以解决许多问题，使用的命令与命令行更新的命令相同：
/var/discourse/launcher rebuild app
重建后论坛仍然不工作怎么办？

请联系我 (canapin@gmail.com) 或在官方支持论坛上发帖。

我还提到了指南末尾的 ask.discourse.org。

资源

https://meta.discourse.org ：官方支持，不要犹豫在那里发帖——社区成员和开发人员都非常乐于助人
https://ask.discourse.com ：一个根据 Discourse 支持和数据训练的聊天机器人，在回答问题方面非常有效（是的，真的）

完整文本

确保您为任何情况做好准备

强烈建议，除了本地备份（保存在论坛所在的同一服务器上）之外，还要在另一台服务器或云端保存这些备份的副本^[1:1]。

将文件 /var/discourse/containers/app.yml 的副本保存在安全位置也很有用^[2:1]。如果重新安装论坛或迁移到另一台服务器，将使用此可选文件。

如果对任何事情有任何严重的疑问，请联系我 (canapin@gmail.com)。

更新

在进行任何更新之前，强烈建议下载论坛的最新备份。

通过界面更新

当管理员界面出现不高兴的红色笑脸时（表示有重要的更新需要进行），请进行更新。
更新通过 https://yourforum.com/admin/upgrade 进行

有时需要分两步进行：您首先需要更新“Docker_Manager”，然后才能升级其余部分：

通过命令行更新

有时，必须通过命令行进行更新（如果需要，Discourse 管理页面会提示）。

通过 SSH 连接到服务器
使用以下命令重建论坛（重建将始终更新 Discourse）：
```
/var/discourse/launcher rebuild app
```
不时地，在确保论坛正常工作后，删除未使用的 Docker 镜像（先前升级的残留物）以释放磁盘空间可能很有用：
```
/var/discourse/launcher cleanup
```

如果论坛不再工作怎么办？

重建论坛可以解决许多问题，使用的命令与命令行更新的命令相同：

/var/discourse/launcher rebuild app

我认为现在相当不错了，而且我没有遗漏任何重要内容

如果我安装了您的论坛，您的备份会自动复制到我的 Google Drive，但理想情况下，将来应将它们保存在您负责的空间中。我们以后会谈论这个 ↩︎ ↩︎
它包含邮件服务器的用户名和密码以及顶级管理员电子邮件（实际上是我的）。 ↩︎ ↩︎

Jonathan5 · 2025 年12 月 29 日 18:52

如果这有效，那么它将比通常的两行版本（以前是三行，所以我们可以继续这个趋势）是一个更好（更简单）的建议。

merefield · 2025 年12 月 29 日 19:16

两者都有效。

如果您的当前目录是 ./，则需要这样做，因为启动器（launcher）的位置不在路径（path）中。

Linux 要求，如果一个命令不在路径中，您必须提供其完整路径，这样才不会弄错您指的是哪个文件。

merefield · 2025 年12 月 29 日 19:19

是的，但通常你可能在做多项工作，例如先进行清理。在这种情况下，先 cd 可能会更简洁。

Andrew_Rowe · 2025 年12 月 30 日 02:27

我同意，我已经收藏了这个主题以备将来使用，谢谢

Canapin · 2025 年12 月 30 日 16:17

好的，这是完整的自动翻译指南：

确保您为任何突发事件做好准备

强烈建议，除了本地备份（存储在与论坛相同的服务器上）之外，还要在另一台服务器或云端保存一份备份副本^[1]。

将文件 /var/discourse/containers/app.yml 的副本保存在安全位置也很有用^[2]。如果需要重新安装论坛或迁移到另一台服务器，此可选文件非常有用。

~~如果您对任何事情有任何疑虑，请与我联系。~~

更新

在进行更新之前，强烈建议下载论坛的最新备份。

通过界面更新

当管理界面中出现一个不高兴的红色笑脸时（表示有一个重要的更新需要执行），请进行更新。
更新通过 https://tonforum.fr/admin/upgrade 进行

它们有时分两步进行：您首先需要更新“Docker_Manager”，然后才能升级其余部分：

通过命令行更新

有时必须通过命令行进行更新（如果需要，Discourse 管理页面会提示）。

通过 SSH 连接到服务器
使用以下命令重建论坛（重建总会更新 Discourse）：
```
/var/discourse/launcher rebuild app
```
偶尔，在确保论坛正常工作后，删除未使用的 Docker 镜像（先前升级的残留物）以释放磁盘空间会很有用：
```
/var/discourse/launcher cleanup
```

如果论坛不再工作怎么办？

重建论坛可以修复许多问题，使用的命令与通过命令行更新的命令相同：

/var/discourse/launcher rebuild app

重建后论坛仍然不工作怎么办？

~~请咨询我或~~ 在官方支持论坛上发帖。

服务器上重要文件的位置

`app.yml`

它包含服务器配置和已安装插件的列表。如果需要将论坛迁移到另一台服务器，或者对于某些配置（例如将上传和备份移动到另一个磁盘），它非常有用。它位于此处：

/var/discourse/containers/app.yml

`mail-receiver.yml`

它包含允许接收和在论坛上发布电子邮件回复的软件的配置。它位于此处：

/var/discourse/containers/mail-receiver.yml

备份

备份文件位于此处：

/var/discourse/shared/standalone/backups/default

论坛管理中的重要页面：

可能很有用的页面

主题和组件

它们包含自定义 CSS 和 HTML 等内容：

https://tonforum.fr/admin/config/customize/themes

日志

电子邮件

用于调试：

https://tonforum.fr/admin/email-logs

管理员操作日志

非常有用。它记录了（几乎）所有站点设置更改以及其他版主和管理员操作。

https://tonforum.fr/admin/logs/staff_action_logs

错误日志

当出现原因不明确的问题时，可以提供线索。

https://tonforum.fr/logs/

备份

用于更改备份频率和最大数量、查看或下载备份：

https://tonforum.fr/admin/backups

资源

https://meta.discourse.org : 官方支持，请随时在那里发帖，成员和开发者都很乐意提供帮助
https://ask.discourse.com : 一个根据 Discourse 支持和数据训练的聊天机器人，在回答问题方面非常有效（是的，真的）

~~如果我安装了您的论坛，您的备份会自动复制到我的 Google Drive，但理想情况下，将来应该将它们保存到您负责的空间。我们总有一天会谈论这个的~~ ↩︎
它包含邮件服务器的标识符和密码，以及管理员电子邮件 ~~(实际上是我的)~~。 ↩︎

话题		回复	浏览量
MKJ's Opinionated Discourse Deployment Configuration Sysadmins explanation , install	32	6732	2025 年12 月 15 日
Problem when updating Discourse Forum Installation unsupported-install	20	2011	2023 年6 月 29 日
Digital Ocean hosting: Do I need a system admin? Hosting	28	6701	2017 年12 月 14 日
How to backup and restore a whole /var/discourse app folder? Installation	17	5554	2020 年6 月 19 日
Improving import and export support Feature	29	8433	2014 年10 月 8 日

我正在为我帮助设置的 Discourse 论坛管理员撰写一份简短的文档。我遗漏了什么吗？

更新

通过 Web 界面

通过命令行

服务器上重要文件的位置

app.yml

mail-receiver.yml

备份

论坛管理中的重要页面

主题和组件

日志

电子邮件

管理员操作日志

错误日志

备份

资源

确保您为任何情况做好准备

如果论坛不再工作怎么办？

重建后论坛仍然不工作怎么办？

资源

确保您为任何情况做好准备

更新

通过界面更新

通过命令行更新

如果论坛不再工作怎么办？

确保您为任何突发事件做好准备

更新

通过界面更新

通过命令行更新

如果论坛不再工作怎么办？

重建后论坛仍然不工作怎么办？

服务器上重要文件的位置

app.yml

mail-receiver.yml

备份

论坛管理中的重要页面：

主题和组件

日志

电子邮件

管理员操作日志

错误日志

备份

资源

相关话题

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`