Пишу краткую документацию для администраторов форумов Discourse, которые я помог настроить. Что-то упустил?

Canapin · 27.Декабрь.2025 17:47:25

Я настроил форумы Discourse для нескольких друзей и ассоциаций. Я хочу, чтобы они были более автономными в администрировании, чтобы мне реже приходилось вмешиваться лично.

Они используют Discourse в качестве пользователей и совладельцев админ-панели уже несколько месяцев или лет. Они не «новые администраторы», но им не хватает глубоких знаний о том, как поддерживать Discourse в повседневной работе (помимо базовой модерации), что нужно знать администратору и как действовать в случае технических сбоев, так как раньше я всегда брал эти вопросы на себя.

Я по-прежнему буду доступен в будущем, но цель — позволить им самостоятельно отслеживать и решать наиболее распространенные проблемы.

Вот что я пока написал (переведено с помощью ИИ на английский, так как мой текст будет на французском, поэтому не обращайте внимания, если некоторые предложения кажутся странно написанными):

Обновления

Через веб-интерфейс

Запускайте обновления, когда в админ-панели появляется красный смайлик с недовольным выражением лица (это означает, что есть важное обновление для применения).
Обновления выполняются по адресу:
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 · 27.Декабрь.2025 21:42:48

Хочу прояснить несколько моментов.

Во-первых, при попытке обновить форум через веб-интерфейс имейте в виду, что обновление может не удалиться, и ваш форум может стать недоступным. Будьте готовы к этому.

Во-вторых, если ваш хостинг станет недоступным или файлы будут повреждены, вам понадобятся резервные копии и файлы yml. Убедитесь, что они уже сохранены в надёжном месте на отдельной системе.

Соединяя эти два совета: всегда делайте резервную копию и скачивайте её перед попыткой обновления.

Heliosurge · 27.Декабрь.2025 22:58:40

Привет, Эд, очень дельные замечания. Насколько я помню, один из участников некоторое время назад создал скрипт для резервного копирования на другую систему. Нужно будет поискать и проверить.

Вот довольно полная цитата из оригинального поста. У 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 rebuild разве не нужно запускать его так:

./launcher r build app

Так я привык запускать его, следуя другим инструкциям на этом сайте. Хотя я узнал, что часто существует множество способов сделать одно и то же. Lol

Отличная статья, очень полезно.

NateDhaliwal · 28.Декабрь.2025 00:56:31

Но поскольку перед этим вы выполняете cd /var/discourse, то ./ просто указывает на эту директорию, то есть путь к launcher по сути является /var/discourse/launcher, верно?

Heliosurge · 28.Декабрь.2025 03:58:53

Я не знал об этом. Я просто использовал это, как в других руководствах по Discourse. Но это логично. Спасибо.

Ed_S · 28.Декабрь.2025 06:01:10

Интересно, стоит ли добавить несколько советов по эскалации? Если человек, читающий документ, не знает, как подключиться к хосту по SSH для расследования или исправления проблемы, то кто тогда сможет? Возможно, стоит добавить совет о том, как задавать вопросы здесь, на Meta, а также напоминание о том, что можно использовать ask.

Jonathan5 · 28.Декабрь.2025 23:42:41

Хорошо, что я это узнал. Я знал только о скачивании резервной копии, созданной самим форумом.

Canapin · 29.Декабрь.2025 14:09:37

Спасибо за вашу помощь!

Я добавил это в начало моего руководства:

Убедитесь, что вы готовы к любой ситуации

Настоятельно рекомендуется, в дополнение к локальным резервным копиям (сохраненным на том же сервере, что и форум), иметь копию этих резервных копий на другом сервере или в облаке^[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 Диск, но в идеале в будущем они должны сохраняться в пространстве, за которое вы отвечаете. Мы поговорим об этом однажды ↩︎ ↩︎
Он содержит имя пользователя и пароль почтового сервера, а также электронную почту администратора высшего уровня (на самом деле мою). ↩︎ ↩︎

Jonathan5 · 29.Декабрь.2025 18:52:34

Если это сработает, то это будет лучшей (более простой) рекомендацией по сравнению с обычным вариантом в две строки (который раньше состоял из трёх, так что мы можем продолжить эту тенденцию).

merefield · 29.Декабрь.2025 19:16:07

Оба варианта работают.

Если вы находитесь в директории ./, то ./ необходим, так как расположение лаунчера не указано в PATH.

В Linux, если команда не находится в PATH, необходимо указать её полный путь, чтобы исключить любые ошибки в выборе файла.

merefield · 29.Декабрь.2025 19:19:23

Да, но часто вы можете выполнять несколько действий, например, сначала очистку. В таком случае переход в директорию (cd) сначала может оказаться более кратким.

Andrew_Rowe · 30.Декабрь.2025 02:27:21

Я согласен и добавил тему в закладки для будущего использования, спасибо

Canapin · 30.Декабрь.2025 16:17:31

Что ж, вот полностью автоматически переведённое руководство:

Убедитесь, что вы готовы к любым непредвиденным ситуациям

Настоятельно рекомендуется, помимо локальных резервных копий (хранящихся на том же сервере, что и форум), иметь копию этих резервных копий на другом сервере или в облаке^[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 Диск, но в идеале в будущем они должны сохраняться в пространстве, за которое отвечаете вы. Обсудим это однажды ↩︎
Он содержит идентификатор и пароль почтового сервера, а также адрес электронной почты администратора ~~(на самом деле мой)~~. ↩︎

Тема		Ответов	Просм.
MKJ's Opinionated Discourse Deployment Configuration Sysadmins explanation , install	39	7151	16.02.2026
Problem when updating Discourse Forum Self-hosting unsupported-install	20	2175	29.06.2023
Digital Ocean hosting: Do I need a system admin? Self-hosting hosting	28	6834	14.12.2017
How to backup and restore a whole /var/discourse app folder? Self-hosting	17	5733	19.06.2020
Improving import and export support Feature	29	8553	08.10.2014

Пишу краткую документацию для администраторов форумов Discourse, которые я помог настроить. Что-то упустил?

Обновления

Через веб-интерфейс

Через командную строку

Расположение важных файлов на сервере

app.yml

mail-receiver.yml

Резервные копии

Важные страницы в админ-панели форума

Темы и компоненты

Логи

Электронная почта

Действия персонала

Логи ошибок

Резервные копии

Ресурсы

Убедитесь, что вы готовы к любой ситуации

Что делать, если форум больше не работает?

Что делать, если форум все еще не работает после пересборки?

Ресурсы

Убедитесь, что вы готовы к любой ситуации

Обновления

Через интерфейс

Через командную строку

Что делать, если форум больше не работает?

Убедитесь, что вы готовы к любым непредвиденным ситуациям

Обновления

Через интерфейс

Через командную строку

Что делать, если форум перестал работать?

Что делать, если форум всё ещё не работает после пересборки?

Расположение важных файлов на сервере

app.yml

mail-receiver.yml

Резервные копии

Важные страницы в панели администратора форума:

Темы и компоненты

Логи

Электронная почта

Действия персонала

Логи ошибок

Резервные копии

Ресурсы

Связанные темы

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`