AIと創る「広告ゼロ」「都度課金型」の個人メディアプラットフォーム homepage-v2。Next.js 16 と AWS サーバーレス(CloudFront OAC / Lambda Function URL / DynamoDB)を採用し、Windows インストーラから簡単に自前運用環境をセットアップできる革新的なCMSです。
本記事では、直近でリリースされた v2.1.6 および v2.1.7 のアップデート内容をわかりやすく解説します。AIによる執筆体験の大幅な向上や、メディアアップロード時のセキュリティ強化など、運用者にとって見逃せない改善が盛りだくさんです。
- GitHub リポジトリ: okamoto53515606/homepage
- リリースノート一覧: GitHub Releases
homepage-v2 管理画面とバージョンの進化
homepage-v2 は、シンプルな操作感の管理者ダッシュボードを備えています。直感的なサイドメニューから記事の執筆やサイト設定、コメント管理などを一元的に行える設計になっています。

上記のダッシュボード画面では、左側に「記事管理」「コメント管理」「サイト設定」といった主要ナビゲーションが並び、フッター部分には最新バージョンである v2.1.7 の表示が確認できます。画面中央には「新しい記事を作成」ボタンなどのクイックリンクが配置され、日々のコンテンツ運用がスムーズに行えます。
この管理画面の裏側で、v2.1.5以降にどのような進化が遂げられたのかを見ていきましょう。
v2.1.6:メディアアップロードの堅牢化と Stored XSS 対策
v2.1.6 では、メディアアップロード経路における徹底的なセキュリティ見直しが実施されました。
1. SVG ファイルの全面拒否による Stored XSS 防止
SVG は内部に <script> タグを含めることができる「実行可能な画像」です。同一オリジンで SVG が配信されると、管理者の権限コンテキストでスクリプトが実行されてしまう恐れ(Stored XSS)がありました。
このリスクを排除するため、v2.1.6 からは SVG ファイルのアップロードを全面拒否し、PNG、JPEG、WebP、GIF、AVIF などのラスタ画像のみを受け付ける設計に改められました。
2. クライアント申告値に頼らない「マジックバイト検証」
従来はクライアントが送信してくる Content-Type ヘッダに依存していた画像判定を、ファイルの実データ先頭(マジックバイト)を直接解析する仕様に変更。偽装されたファイルや不正な入力を、デコード前に弾く強固な 3 段階検証が導入されています。
v2.1.7:CloudFront タイムアウトに負けない AI 執筆 UX
続く v2.1.7 では、homepage-v2 の中核機能である「AI 代筆・修正」におけるユーザー体験(UX)が劇的に改善されました。
「60秒の壁」と「非対称タイムアウト」の解消
AWS サーバーレス構成では、CloudFront のオリジン応答タイムアウトが 60秒、バックエンドの Lambda タイムアウトが 300秒(5分) に設定されています。
長文の AI 生成や修正処理では 60 秒を超過することがあり、ブラウザ側には 504 Gateway Timeout が返るものの、裏側の Lambda では処理が正常に継続・保存されるという「結果のズレ」が発生していました。
v2.1.7 ではこの課題に対し、以下のスマートなアプローチが導入されました。
- 継続処理の明示: CloudFront の接続が 60 秒で切れてもエラー扱いにせず、「バックエンドで処理を継続中(最大5分)」という案内をスピナー付きで表示。
- 軽量エンドポイントによる自動完了検知: 本文を含まない
updatedAtのみを返す超軽量な確認用 API を新設。10 秒間隔のポーリングにより、負荷をかけずに完了を自動検知します。 - 自動プレビュー更新 & 画面遷移:
- 記事修正: 更新を検知すると、自動的にプレビュー画面が最新状態へ更新されます。
- 記事生成: クライアント側で事前に
draftId(UUID)を発行して送信する仕組みを採用。記事生成完了と同時に、該当記事の編集画面へ自動遷移します。
- ボタン直上へのメッセージ移動: 処理結果や案内メッセージが送信ボタンの真上に表示されるようになり、スクロールによる見落としを防ぎます。
既存環境のアップデート手順
v2.1.6 / v2.1.7 ともにデータベースのスキーマ変更や CDK の構成変更を伴わないため、既存ユーザーは簡単な手順でアップデート可能です。
- Windows タスクトレイの「アプリを更新...」を実行
- ローカルのセットアップ画面(
http://localhost:3001)を開き、ヘッダが最新版になっていることを確認 - 「運用メニュー」から 「アプリコード更新」 をクリックして反映完了
個人開発の自由度と、プロダクションレベルの堅牢性を両立した「homepage-v2」。AI を活用したメディア運営に興味がある方は、ぜひ GitHub リポジトリ をチェックしてみてください!