microfeedを読む、Cloudflare上で運用するフィード中心CMS

Cloudflareに寄せた軽量CMS

microfeed/microfeedは、CloudflareのWorkers、R2、D1でホストする軽量なコンテンツ管理システムです。Listen Notesが構築し、音声、動画、写真、文書、ブログ記事、外部URLをWebサイト、RSS、JSONフィードへ公開する用途をREADMEで示しています。サーバーを自分で運用せず、Cloudflare上に自分のフィードを持ちたい技術者を主な対象にしています。

実装言語はTypeScript、ライセンスはAGPL-3.0、既定ブランチはmain、アーカイブ状態はfalseです。2026年8月27日時点の取得情報では、4,052スター、1,414フォーク、43件のオープンイシューが記録されています。READMEはこのプロジェクトをオープンアルファと説明しており、Cloudflareを最初にサポートするプラットフォームとして扱います。他のホスティング事業者や安定版としての運用保証は素材から確認できません。

フィードモデルからサイトの形を作る

READMEは、Webのフィードを、人とボットが項目を公開し、購読者が新しい内容を受け取る仕組みとして捉えています。microfeedでは、ポッドキャストの音声、ブログ、画像ギャラリー、動画チャンネル、個人サイト、外部ニュースURLのキュレーション、更新とプレス情報を載せるマーケティングサイトを同じ基盤で構成できます。書籍サイト、変更履歴サイト、ドメイン販売リストも例に挙がっています。

公開形式はカスタマイズ可能なWeb、RSS、JSONフィードです。ヘッドレスCMSとしてGUIダッシュボード、RSS Feed、JSON Feed、API、Webhooks、`@microfeed/cli`を使う形も説明されています。外観は管理画面からカスタムHTMLとCSSを編集し、Feed JsonやItem Jsonの変数を使うmustache.jsテンプレートで調整します。見た目を変えても、投稿の意味、画像の権利、外部URLの更新、RSS読者への影響は別に確認する必要があります。

Workers、R2、D1の責任分担

microfeedはCloudflare Workersでコードを実行し、R2でメディアファイルを保存して配信し、D1でメタデータを保持します。管理ダッシュボードは組み込みのメールアドレスとパスワードによるログインで保護されます。Cloudflareの無料利用枠が個人や小規模事業に手頃だとREADMEは説明しますが、ドメイン名は別途必要で、実際の利用量や機能によって費用が変わる可能性があります。

この構成では、記事本文とメタデータ、画像や音声、認証情報の置き場所が分かれます。レコードの削除とR2オブジェクトの削除が同じタイミングで起きるか、アップロード途中の失敗で孤立したファイルが残るか、Cloudflareの権限を誰が持つかを導入前に確認します。READMEは構成要素を示しますが、容量上限、負荷試験、障害時の復旧時間、地域別の可用性を数値で保証していません。

CLIで始めるデプロイとインスタンス管理

READMEが推奨する導入入口は、Codex、Claude Code、Cursorなど、端末コマンドを実行してブラウザーを開けるローカルAIコーディングエージェントへ指示を渡す方法です。`npx @microfeed/cli manage`から始め、手順に従ってCloudflareへデプロイします。ランチャーはNode.js 22.12以上とnpmを必要とし、対象リリースとYarnランタイム、固定された依存関係を私有キャッシュへ用意し、現在のフォルダーへソースファイルを作らないと説明されています。初回は約1.3GBを使い、数分かかる場合があります。

ローカルGitコピーを使う手動経路では、リポジトリ、依存関係、Cloudflareアカウントを自分で確認し、`yarn manage`系のコマンドを実行します。一つのコピーから複数の独立インスタンスを管理でき、`yarn manage instances`と`use`で一覧と選択、`yarn manage connect`で既存の互換Workerへ接続できます。AIエージェントに権限を渡す場合も、Cloudflareトークンの範囲、対象アカウント、変更履歴を人間が確認し、デプロイ完了という表示だけを検証結果にしません。

本番とプレビューを分ける仕組み

READMEは、ローカルだけで動かすインスタンスを、シミュレートしたD1と任意のR2でコンピューター上に置けると説明します。Cloudflareのインスタンスはリポジトリへ保存し、そこからデプロイまたは管理します。プレビュー用デプロイでは、別のWorkerとD1データベースを作りながら、本番R2バケットを再利用します。本番メディアは`production/`、プレビューメディアは`preview/`へ分ける設計です。

本番データと同じメディアバケットを使うため、プレビューから本番への参照や、テスト用の公開URLが混ざらないかを確認します。削除には`yarn manage destroy`があり、ドライラン計画と正確なサイト名の確認を要求します。`--keep-data`を使えばデータベースとメディアバケットを残せるとREADMEは説明します。削除操作はCLIの文言だけでなく、Cloudflare側のリソース一覧、料金、バックアップの存在を照合してから行います。

管理者認証と公開コンテンツの境界

管理画面の既定パスは`/admin/`で、初期化時にメールアドレスとパスワード認証を設定できます。認証をスキップすると、Cloudflare Zero Trust Accessを追加するまで管理画面が公開状態になるとREADMEは注意しています。後から`yarn manage auth setup`、`reset-password`、`change-email`、`change-path`、`disable`で認証設定を変更でき、ワンタイムパスワードリンクは30分で期限切れになります。

公開は管理画面から投稿を作成、編集、削除する形です。R2が有効ならメディアをアップロードし、コンテンツのみモードでは外部URLを使います。ローカルAIエージェント向けの`@microfeed/cli`は、項目の作成、更新、削除、画像・音声・動画・文書のアップロードを行えると説明されています。CLIへ強い書き込み権限を渡す前に、対象インスタンス、公開範囲、削除確認、監査ログ、APIキーの保存方法を決めます。

スナップショット、追跡、AGPLの条件

ダウンロード追跡はSettingsのTracking URLsで設定し、OP3やPodtracなどのサードパーティURLをメディアリンクの前に置く機能として説明されています。バックアップは`yarn manage snapshot create`と`snapshot pull`で作り、D1のスキーマとデータ、移行履歴、R2バケット、オブジェクトメタデータ、チェックサムを含む、所有者が読めるアーカイブを取得します。READMEはアーカイブが暗号化されていないため、自分で暗号化するよう案内しています。

AGPL-3.0はネットワークサーバーソフトウェアを想定したコピーレフトライセンスで、修正版を運用する場合に利用者へソースコードを提供する条件を確認する必要があります。これはCloudflareの運用料金、外部サービスの規約、投稿コンテンツの権利処理を決めるものではありません。向いているのは、Cloudflareに依存することを受け入れ、フィード中心の公開と自分でのバックアップを管理できる人です。採用前に、暗号化、認証、削除、復元、プレビューの全経路を小規模データで確認します。

編集部の結論

microfeedは、Cloudflareを前提に、音声、動画、写真、文書、記事、外部URLを一つのフィードとして公開したい個人や小規模チームに向きます。GUIの管理画面と@microfeed/cli、Web・RSS・JSON・APIの出口を持つため、通常のCMSとヘッドレスCMSの両方を試せます。ただし、READMEはオープンアルファであり、バックアップは暗号化されないと説明しています。最初は重要でないインスタンスで認証、プレビュー、削除、スナップショット復元、Cloudflareの料金と権限を確認してから本番データを移してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes