概要
ImgLinkメディアアップロード統合 for Discourse。スコープ付きAPIキー、リトライ処理、管理者向け診断機能を搭載。
リポジトリリンク
https://github.com/imglink12x/discourse-plugin
インストールガイド
-
DiscourseコンテナにSSH接続します:
-
app.ymlにプラグインを追加します: -
コンテナを再構築します:
-
管理者設定でImgLink APIキーを設定します (下記の設定を参照)
詳細なセットアップ: https://imglink.cc/tools/forum-plugins
機能
-
Composerからの直接アップロード — Discourseの投稿エディタから直接画像をアップロード
-
スコープ付きAPIキー — 制限されたスコープの認証情報を使用。アカウント全体へのアクセス権なし
-
直接リンク & ビューアリンク — CDNの直接リンクと画像ビューアURLの両方を返す
-
リトライ + べき等性 — 不安定な接続に対する自動リトライロジック。重複アップロードを防止
-
管理者診断 — API認証、接続、アップロード権限を検証するための組み込みヘルスチェック
-
BBCode出力 — 埋め込み投稿のための自動BBCodeフォーマット
-
エラーロギング — アップロード失敗のトラブルシューティングのための詳細なログ
設定
ステップ 1: ImgLink APIキーの作成
-
ImgLinkにログインします (https://imglink.cc)
-
設定 → APIキー に移動します
-
これらのスコープを持つ新しいキーを作成します:
-
upload:create -
image:delete(クリーンアップワークフロー用、オプション)
-
-
APIキーをコピーします
ステップ 2: Discourse管理者設定への追加
-
管理者 → 設定 → プラグイン に移動します
-
ImgLink Settings までスクロールします
-
imglink_api_keyフィールドにAPIキーを貼り付けます -
(オプション) カスタムImgLinkインスタンスを使用している場合は
imglink_api_endpointを設定します -
保存します
ステップ 3: 診断の実行
-
管理者 → プラグイン → ImgLink Settings に移動します
-
設定を検証するために 「接続をテスト」 をクリックします
-
「✓ 接続成功」 と表示されるはずです
設定項目
| 設定名 | タイプ | デフォルト | 説明 |
|---|---|---|---|
imglink_api_key |
文字列 | (空) | upload:create スコープを持つImgLink APIキー |
imglink_api_endpoint |
文字列 | https://imglink.cc/api/v1 |
ImgLink APIのベースURL (セルフホストの場合はデフォルトのままにしてください) |
imglink_max_retries |
整数 | 3 |
失敗したアップロードの試行回数 |
imglink_retry_delay |
整数 | 1000 |
リトライ試行間の待機時間 (ミリ秒) |
imglink_timeout_ms |
整数 | 30000 |
アップロードリクエストのタイムアウト (30秒) |
imglink_enable_diagnostics |
ブーリアン | true |
管理者診断ツールとログを有効にする |
imglink_enable_direct_links |
ブーリアン | true |
ビューアでラップされたリンクではなく、直接のCDNリンクを返す |
バージョン互換性: Discourse 2.8+ | 最終更新日: 2026年3月 | サポート: https://imglink.cc/tools/forum-plugins