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

[Canapin (Coin-coin le Canapin)]

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

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

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

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

---

更新

通过 Web 界面

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

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

通过命令行

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

1. 通过 SSH 连接到服务器
2. 使用以下命令重建论坛（重建总会更新 Discourse）：

3. /var/discourse/launcher rebuild app
   

4. 有时，在确认论坛正常工作后，删除未使用的 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]

我想澄清几件事。

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

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

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

[Heliosurge (Dan DeMontmorency)]

嗨，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 运行”。如果成功，则可以进入下一步。

要安排任务

1. 搜索“任务计划程序”。
2. 双击“添加任务”。出现“计划任务向导”。
3. 单击“下一步”，然后单击“浏览”。出现“选择要调度的程序”对话框。
4. 导航到您创建的脚本并单击它，然后单击“打开”。您返回到“计划任务向导”。
5. 为任务提供一个名称，或保留默认名称（即文件名），指定运行脚本的频率，然后单击“下一步”。
6. 指定开始时间和日期（如果指定了“每天”、“每周”或“每月”等），以及重复执行的频率，然后单击“下一步”。此项应与您的 discourse 的自动备份周期匹配
7. 输入运行脚本的帐户的用户名和密码，然后单击“下一步”。
8. 如果要配置高级属性，请选中该复选框，然后单击“完成”。

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

./launcher r build app

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

写得不错，很实用。