Cloudflare OS Gadget Showcase
Cloudflare OS の運用に使える Gadget（活用ガイド）を 1 トピック 1 ページで大量に集めた公開サイト
Cloudflare OS Gadget Showcase
Cloudflare OS を「自分のデバイス（macOS / QNAP NAS）」で運用するための Gadget（活用ガイド）詰め合わせサイト。
Cloudflare OS は、AI エージェントや 自作アプリ（Gadget）をサンドボックスで安全に動かすためのオペレーティングシステムです。 本サイトは、cfos-sandbox の知見を発展させ、セットアップ → 運用 → 障害対応 → 保守 まで 用途別に切り取った 55 枚の Gadget として公開しています。
Tipこのサイトの特徴
- 1 トピック 1 ページ … 知りたいことだけを最短で読める
- 検索しやすい症状 → 原因 → 対処 … トラブル対応を早める
- 共通テンプレ … どのページも「目的 / 前提条件 / 手順 / よくある失敗 / 確認 / 次に読む」で統一
- 随時ページ増強 …
guides/*.qmdを足すだけで全 Gadget が増殖します
まず読むべき Gadget（最短ルート）
| 目的 | 読むページ |
|---|---|
| 今日中に起動する | 00-quickstart |
| 何かハマったら | 04-troubleshoot-guide |
| 壊しても戻せるようにする | 07-backup-restore |
| 質問したい | 10-faq |
目次：全 Gadget（55 枚）
基本セットアップ
| # | Gadget | 内容 |
|---|---|---|
| 00 | 00-quickstart | 起動まで最短（macOS / QNAP の分岐） |
| 01 | 01-macos-setup | macOS 前提・権限・セットアップの罠 |
| 02 | 02-qnap-basics | QNAP 前提・永続化・常駐の考え方 |
連携・アクセス制御
| # | Gadget | 内容 |
|---|---|---|
| 03 | 03-gatekeeper-integration | Gatekeeper 連携と“やってはいけない設定” |
| 08 | 08-access-control-recipes | 目的別アクセス制御レシピ |
| 09 | 09-common-misconfigurations | 典型設定ミス一覧（再発防止） |
| 11 | 11-security-hardening | 最小権限・FW・不要機能の切り方 |
ネットワーク・TLS
| # | Gadget | 内容 |
|---|---|---|
| 12 | 12-networking-basics | DNS・ポート・プロキシ・NAT/ブリッジ |
| 13 | 13-certificates-and-tls | 証明書・TLS・期限切れ対策 |
| 28 | 28-edge-cases | 特殊ケース（企業 LAN・VPN・プロキシ） |
| 29 | 29-dns-debugging | 名前解決が壊れたときの切り分け |
トラブル・ログ
| # | Gadget | 内容 |
|---|---|---|
| 04 | 04-troubleshoot-guide | エラー症状 → 原因 → 対処 |
| 05 | 05-logs-cheatsheet | ログの場所・読み方・よくある誤読 |
運用・保守
| # | Gadget | 内容 |
|---|---|---|
| 06 | 06-updates-strategy | 更新タイミング・復旧・戻し方 |
| 07 | 07-backup-restore | バックアップ対象 / 復元手順 / 検証 |
| 14 | 14-performance-tuning | 遅い/遅延：原因候補と優先度 |
| 15 | 15-resource-sizing | メモリ/ストレージの見積り |
| 16 | 16-storage-persistence | 永続化：どこに何を置くべきか |
| 24 | 24-config-management | 設定を壊さない運用（差分・管理・レビュー） |
| 25 | 25-quotas-and-spend-control | 費用・上限を意識した運用チェック |
| 26 | 26-automation-scripts | 日次・週次の運用タスク自動化 |
| 27 | 27-maintenance-schedule | 保守カレンダー例 |
監視・障害対応
| # | Gadget | 内容 |
|---|---|---|
| 17 | 17-startup-and-healthchecks | 自動起動・再起動・ヘルスチェック設計 |
| 18 | 18-monitoring-and-alerting | メトリクス・監視・閾値・通知 |
| 19 | 19-incident-playbook | 障害対応手順書 |
| 20 | 20-rollback-procedure | 更新失敗時の復帰フロー |
リファレンス
| # | Gadget | 内容 |
|---|---|---|
| 21 | 21-environment-variables | 環境変数一覧・意味・落とし穴 |
| 22 | 22-sample-configs | コピペ設定例（注意書きつき） |
| 23 | 23-checklists-before-change | 変更前チェックリスト |
| 30 | 30-compatibility-matrix | macOS / QNAP / バージョン差の互換性 |
| 31 | 31-checklists-after-change | 変更後チェックリスト |
| 32 | 32-template-bug-report | バグ報告テンプレート |
| 33 | 33-upgrade-notes-styleguide | 更新ログの書き方ガイド |
| 10 | 10-faq | 頻出 Q&A |
Cloudflare 深掘り
| # | Gadget | 内容 |
|---|---|---|
| 34 | 34-cloudflare-overview | Cloudflare 全体像・製品マップ |
| 35 | 35-workers-basics | Workers ランタイム・バインディングの基本 |
| 36 | 36-durable-objects | 強整合の状態を持つ Durable Objects |
| 37 | 37-workers-ai | Workers AI の活用法（推論・Embedding） |
| 38 | 38-d1-database | サーバーレス SQLite（D1） |
| 39 | 39-r2-storage | S3 互換の R2 オブジェクトストレージ |
| 40 | 40-kv-and-cache | KV と CDN キャッシュの使い分け |
| 41 | 41-tunnel-and-access | Tunnel＋Access で安全に公開 |
| 42 | 42-dns-and-security | DNS のフル活用と WAF |
| 43 | 43-vectorize-and-ai | Vectorize で RAG を構成 |
裏技シリーズ（ギーク向け）
| # | Gadget | 内容 |
|---|---|---|
| 44 | 44-pro-tips-catalog | 裏技カタログ（入口） |
| 45 | 45-internals-run-local | run-local を解剖して挙動を操る |
| 46 | 46-custom-gatekeeper | 自作 Gatekeeper で外部サービスを拡張 |
| 47 | 47-blueprint-crafting | Gadget を Blueprint 化・配布 |
| 48 | 48-data-mining-wrangler | .wrangler を直接読んで調査 |
| 49 | 49-multi-instance | 本番/検証を分離して同時運用 |
| 50 | 50-dev-vars-mastery | .dev.vars を極める |
| 51 | 51-headless-automation | CLI / cron でヘッドレス運用 |
| 52 | 52-debugging-hacks | DevTools / tail でデバッグ上級 |
| 53 | 53-workerd-runtime | workerd ランタイムを素振り |
| 54 | 54-chrome-v8 | What is Chrome V8?（エンジン深掘り） |
背景知識（3 分で理解する）
Cloudflare OS は、Cloudflare Workers 上に構築された「AI 生産性環境」です。 中心となる概念:
- Gadget（ガジェット）: AI が「あなた専用」に作る小さなアプリ。文書・スライド・アプリなど。
- Gatekeeper（ゲートキーパー）: 外部サービスとの接続を中継する「ドライバ」。承認・拒否・監査を一手に担う。
- Blueprint（ブループリント）: Gadget を再利用可能なテンプレート（コードごと）として共有する仕組み。
- workerd / Durable Objects: 各 Gadget を独立サンドボックスで実行し、リアルタイム共同編集を実現する基盤。
このサイトの裏側（どうやって作ったか）
Quarto（ウェブサイト型）で作られた静的サイトです。ソース・ビルド・デプロイ手順は リポジトリの README と DEV-MEMO.md に記録しています。
- 元ネタ: cfos-sandbox（Quarto サイト、ガイド 4 本）
- Cloudflare OS 本体: https://github.com/cloudflare/cloudflare-os
このサイトは、Cloudflare OS の運用メモを「Gadget」として公開するオープンノートです。 本文: CC BY 4.0