Discourseフォーラム管理者のための短いドキュメントを作成中です。何か見落としていませんか？

Canapin · 2025 年 12 月 27 日午後 5:47

私はいくつかの友人や団体のためにDiscourseフォーラムを設定しました。彼らが管理においてより自律的になるようにしたいので、私が自分で介入する可能性が低くなります。

彼らは何ヶ月も、あるいは何年もDiscourseをユーザーおよび共同管理者として使用してきました。彼らは「新しい管理者」ではありませんが、日常的なDiscourseの保守方法（モデレーションの基本以外）や、技術的な問題が発生した場合に管理者が知っておくべきことについて、深い知識が不足しています。なぜなら、私は常にそれらのことを処理するためにそこにいたからです。

将来的にも私は利用可能ですが、目標は、最も一般的な問題を自分で追跡し、対処できるようにすることです。

これは私がこれまでに書いたものです（私のテキストはフランス語で書かれるため、文章がおかしくても気にしないでください。これはIAによって英語に翻訳されています）：

アップデート

ウェブインターフェース経由

管理者パネルに不機嫌そうな赤いスマイリーが表示されたら（適用すべき重要なアップデートがあることを意味します）、アップデートを実行します。
アップデートは以下から実行できます：
https://tonforum.fr/admin/upgrade

アップデートは2段階で行われることがあります。他の部分をアップグレードする前に、まず「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

ログ

Eメール

デバッグに役立ちます。

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 日午後 9:42

私が明確にしておきたい点がいくつかあります。

一つは、ウェブインターフェースからアップデートを試みる時点で、アップデートが失敗し、フォーラムがダウンする可能性があることを認識しておくことです。準備をしてください。

もう一つは、ホストにアクセスできなくなったり、破損したりした場合、バックアップファイルとymlファイルが必要になるということです。これらはすでに安全な別のシステムに保存されている必要があります。

この二点をまとめると、アップデートを試みる前には必ずバックアップを取得し、そのバックアップをダウンロードしておいてください。

Heliosurge · 2025 年 12 月 27 日午後 10:58

Edさん、非常に的を射たご意見ありがとうございます。以前、誰かが別のシステムへのバックアップ用のスクリプトを作成したのを覚えています。検索して確認する必要があります。

ここにOPの投稿からの引用があります。Canapin氏の返信には、Googleドライブ/Dropboxへのバックアップに関するリンクがあります。

Lhc_fl:

最近、友人がVPSプロバイダーが予告なく倒産するという問題に遭遇しました。残念ながら、安さを求めて、彼女はニッチなプロバイダーを選びました。データダウンロードすら提供していないようなプロバイダーでした。さらに悪いことに、彼女は定期的にバックアップをダウンロードする習慣がありませんでした。一晩で、彼女のサイトはそこにあったすべてのデータとともに消えてしまいました。

これに衝撃を受け、私は、追加のオブジェクトストレージサービスを購入したり、他のものにお金をかけたりすることなく、サーバーからローカルコンピューターに定期的に自動的にバックアップをダウンロードするPowershellスクリプトを作成しました。必要なのは、定期的に使用している（そして十分なハードディスク容量がある）インターネットに接続されたWindowsコンピューターだけです。

このスクリプトは、5日以上前のバックアップを自動的にクリーンアップします。自動バックアップの間隔と、ローカルに保存される最も古いバックアップ時刻は、必要に応じて設定できます。
$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Discourseバックアップダウンロードタスクを開始します..."
Write-Output '------------------------'
Write-Output "最新のバックアップファイルを取得しています..."
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 "取得に失敗しました...ログはこちらです:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "再取得しますか？ (y/N)"
            if ($answer -ne 'y') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "エラー: ファイル名 $filename の取得に失敗しました"
        Write-Output ''
        $answer = Read-Host '再試行しますか？(y/N)'
  
        if ($answer -eq 'y') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "最新のバックアップ: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename は既に存在します。再度ダウンロードしますか？(y/N)"
            Write-Output ''
            if ($answer -ne 'y') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "ダウンロードを開始します..."
            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 "ダウンロード完了"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "ダウンロードに失敗しました >_<...ログは以下です:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "もう一度ダウンロードしますか？ (y/N)"
                    Write-Output ''
                    if ($answer -ne 'y') {
                        break
                    }
                }
            }

        }
  
        Write-Output "古いバックアップファイルのクリーンアップを試みます..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "古いバックアップファイル $file を削除します ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "古いバックアップファイル $file の削除中にエラーが発生しました >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "$count 個の古いバックアップファイルをクリーンアップしました"
            Write-Output ''
        }
        else {
            Write-Output 'クリーンアップする必要のある古いバックアップファイルはありません'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}
上記のスクリプトを scriptname.ps1 として、バックアップをダウンロードしたいパスに保存します。「PowerShellで実行」を試してください。成功したら、次のステップに進むことができます。
タスクのスケジュール設定

「タスクスケジューラ」を検索します。

スケジュールされたタスクの追加をダブルクリックします。スケジュールされたタスクウィザードが表示されます。

次へをクリックし、次に参照をクリックします。スケジュールするプログラムの選択ダイアログが表示されます。

作成したスクリプトに移動してクリックし、開くをクリックします。スケジュールされたタスクウィザードに戻ります。

タスクに名前を付けるか、デフォルト（ファイル名）のままにして、スクリプトを実行する頻度を指定し、次へをクリックします。

スクリプトを実行する開始時刻と日付（毎日、毎週、毎月などを指定した場合）および繰り返し間隔を指定し、次へをクリックします。この項目は、Discourseの自動バックアップサイクルと一致させる必要があります。

スクリプトを実行するアカウントのユーザー名とパスワードを入力し、次へをクリックします。

詳細なプロパティを設定する場合は、チェックボックスを選択し、完了をクリックします。

@Canapin ランチャーリビルドアプリでは、次のように実行する必要があるのではないでしょうか。

./launcher r build app

これは、このサイトの他のドキュメントで私が実行するのに慣れている方法です。しかし、物事を行うには多くの方法があることを学んだので（笑）。

素晴らしい書き込みで役に立ちました。

NateDhaliwal · 2025 年 12 月 28 日午前 12:56

しかし、その前にcd /var/discourseを実行するので、./はそのディレクトリを指すことになり、ランチャーのパスは実質的に/var/discourse/launcherになるのではないでしょうか？

Heliosurge · 2025 年 12 月 28 日午前 3:58

それを知りませんでした。他のディスコースのチュートリアルに従って使っていただけです。しかし、理にかなっています。ありがとうございます。

Ed_S · 2025 年 12 月 28 日午前 6:01

ホストに ssh で接続して調査または修正する方法がドキュメントの読者にわからない場合、誰が対応できるでしょうか？エスカレーションのヒントを追加する価値があるかもしれません。ここでメタについて質問する方法についてのヒント、あるいは ask を使用することについてのヒントも役立つかもしれません。

Jonathan5 · 2025 年 12 月 28 日午後 11:42

それは良い情報ですね。フォーラム自体が作成したバックアップをダウンロードすることしか知りませんでした。

Canapin · 2025 年 12 月 29 日午後 2: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 から実行します。

アップデートは2段階で行われることがあります。最初に「Docker_Manager」をアップデートしてから、残りをアップグレードできる場合があります。

コマンドライン経由

場合によっては、コマンドライン経由でアップデートを行う必要があります（必要な場合はDiscourse管理ページに表示されます）。

SSH経由でサーバーに接続します
次のコマンドを使用してフォーラムを再構築します（再構築は常にDiscourseを更新します）。
```
/var/discourse/launcher rebuild app
```
時々、フォーラムが正しく動作していることを確認した後、ディスクスペースを解放するために使用されていないDockerイメージ（以前のアップグレードの残り物）を削除すると便利です。
```
/var/discourse/launcher cleanup
```

フォーラムが機能しなくなった場合はどうすればよいですか？

フォーラムの再構築は多くの問題を解決し、コマンドラインでのアップデートと同じコマンドで実行できます。

/var/discourse/launcher rebuild app

これでかなり良くなり、重要なことを見落としていないと思います

私がフォーラムをインストールした場合、バックアップは自動的に私のGoogleドライブにコピーされますが、理想的には将来的にあなたが責任を負うスペースに保存されるべきです。いつかそのことについて話しましょう ↩︎ ↩︎
これには、メールサーバーのユーザー名とパスワード、およびトップレベルの管理者メールアドレス（実際には私のもの）が含まれています。 ↩︎ ↩︎

Jonathan5 · 2025 年 12 月 29 日午後 6:52

もしこれが機能すれば、いつもの2行バージョン（以前は3行だったので、傾向を継続できます）よりも良い（より簡単な）推奨事項になるでしょう。

merefield · 2025 年 12 月 29 日午後 7:16

どちらも動作します。

./ のディレクトリにいる場合、ランチャーの場所がパスに含まれていないため、これが必須です。

Linuxでは、コマンドがパスに含まれていない場合、どのファイルを意図しているか間違いがないように、その完全なパスを指定する必要があります。

merefield · 2025 年 12 月 29 日午後 7:19

はい、しかし、多くの場合、最初にクリーンアップなど複数のことを行うことがあります。その場合、先にcd（チェンジディレクトリ）した方が簡潔になるかもしれません。

Andrew_Rowe · 2025 年 12 月 30 日午前 2:27

私も同意します。今後の利用のためにこのトピックをブックマークしました。ありがとうございます。

Canapin · 2025 年 12 月 30 日午後 4:17

さて、自動翻訳されたガイドの全文はこちらです。

あらゆる事態に備えるための準備

フォーラムと同じサーバーに保存されているローカルバックアップに加えて、それらのバックアップのコピーを別のサーバーまたはクラウドに保存することを強くお勧めします^[1]。

また、ファイル /var/discourse/containers/app.yml のコピーを安全な場所に保管しておくと便利です^[2]。このオプションのファイルは、フォーラムの再インストールや別のサーバーへの移行の際に役立ちます。

~~何か深刻な疑問がある場合は、私に連絡してください。~~

アップデート

アップデートを行う前に、フォーラムの最新のバックアップをダウンロードすることを強くお勧めします。

インターフェース経由

管理画面で不機嫌な赤いスマイリーが表示されたら（重要なアップデートがあることを意味します）、アップデートを実行してください。
アップデートは https://tonforum.fr/admin/upgrade から実行できます。

アップデートは2段階になることがあります。まず「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

ログ

Eメール

デバッグに役立ちます:

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	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フォーラム管理者のための短いドキュメントを作成中です。何か見落としていませんか？

アップデート

ウェブインターフェース経由

コマンドライン経由

サーバー上の重要なファイルの場所

app.yml

mail-receiver.yml

バックアップ

フォーラム管理者の重要なページ

テーマとコンポーネント

ログ

Eメール

スタッフアクション

エラーログ

バックアップ

リソース

あらゆる状況に備えていることを確認してください

フォーラムが機能しなくなった場合はどうすればよいですか？

再構築後もフォーラムが機能しない場合はどうすればよいですか？

リソース

あらゆる状況に備えていることを確認してください

アップデート

インターフェース経由

コマンドライン経由

フォーラムが機能しなくなった場合はどうすればよいですか？

あらゆる事態に備えるための準備

アップデート

インターフェース経由

コマンドライン経由

フォーラムが動作しなくなった場合はどうすればよいですか？

再構築後もフォーラムが動作しない場合は？

サーバー上の重要なファイルの場所

app.yml

mail-receiver.yml

バックアップ

フォーラム管理画面の重要なページ:

テーマとコンポーネント

ログ

Eメール

スタッフアクション

エラーログ

バックアップ

リソース

関連トピック

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`