更新日: 2026-05-04  |  Phase 1（1-1 〜 1-4）完了

PoC ナレッジサイト

本サイトは Raspberry Pi 5 × Cloudflare Tunnel PoC プロジェクトの ナレッジ資料・設計書・手順書を一元管理するドキュメントサイトです。 Phase 1（1-1〜1-4）が完了し、現在は Phase 2（要件定義準備）を進行中です。

Phase 1 完了: https://api.your-domain.com/ping → {"message":"pong"} の疎通確認済み。 Named Tunnel + Cloudflare DNS 移管により本番用ドメインでの公開を達成。

資料一覧

レポート PoC 結果レポート（Phase 1）

Phase 1 全体（1-1〜1-4）のPoC結果・達成事項・課題まとめ

設計書 基本・詳細設計書（Phase 1-4）

Named Tunnel 設定問題解決・Cloudflare DNS 移管の基本・詳細設計

ナレッジ Phase 1-4 ナレッジ資料

Named Tunnel 設定・DNS 移管の知見・トラブルシューティング集

構成案 堅牢性強化システム構成案

本番運用に向けた堅牢性強化要素の構成案と「なぜ必要か」完全解説

設計書 システム通信経路一覧と図解

全通信経路（同一PC内通信含む）の一覧表とASCIIアート図解

手順書 DNS 移管手順書（Squarespace → Cloudflare）

SquarespaceからCloudflareへのDNS移管手順書（スクリーンショット付き）

開発ログ 開発ログ

Phase 1-1〜1-4 の設計方針変更・協議経緯・実装進捗を時系列で記録した開発ログ

システム概要

コンポーネント内容
ハードウェアRaspberry Pi 5
サーバーFastAPI（Docker コンテナ、ポート 8000）
トンネルCloudflare Named Tunnel（cloudflared コンテナ）
ドメインyour-domain.com（Cloudflare DNS 管理）
DNSxxxx.ns.cloudflare.com / yyyy.ns.cloudflare.com
Public Hostnameapi.your-domain.com → http://api:8000
Tunnel ID716ae640-c39a-4fd0-b41b-a4b63d7a6b0b

Phase 進捗

Phase内容状態
Phase 1-1Raspberry Pi 基礎環境構築完了
Phase 1-2Cloudflare Tunnel 外部公開検証完了
Phase 1-3データアップロード安定性検証完了
Phase 1-4本番用ドメイン適用検証（Named Tunnel + DNS 移管）完了
Phase 2要件定義準備進行中

次のアクション

Phase 2 として、開発者打ち合わせに向けた要件定義準備を進めています。 詳細は PoC 結果レポート および 堅牢性強化システム構成案 を参照してください。