Obsidian Vaultを「個人ナレッジ基盤」に変える——Cloudflare R2 + mkdocs + Pages + Access構成ガイド

導入の目的
Obsidianは素晴らしいツールです。Markdownベースでデータが手元に残り、プラグインエコシステムも充実しています。自分も日常的にObsidianでメモ、調査ログ、技術ノートを書き溜めています。また、GitHub上のPrivateリポジトリで管理することで、多数のデバイスやスマートフォンでの同期も可能で便利。
ただ、画像を含むVaultの容量が大きくなり同期も遅くなってきた。スマートフォンの容量もかなり食う。 公式の同期の仕組もあるがどうやら容量制限があるらしい。
自分だけが見られるWebサイトでVaultの内容が公開できればいいのだが…と考えて、現時点でたどりつけたのがCloudflareを活用した構成です。この記事では、自分が実際に運用している構成を、セットアップ手順とともに解説します。
構成の全体像 自分だけ見られるVaultを目指して
自分がやっていることを、「自分だけが見られるVault」と定義します。単なる静的サイトホスティングではなく、以下の要件を満たすシステムです。
- 編集体験: Obsidianなりエディタなりローカルでできればよい
- 画像管理: クラウドストレージに自動アップロード
- 公開: Markdown → 静的サイトに自動ビルド&デプロイ
- 認証: 自分だけがアクセスできる
- コスト: サービス利用にかかるコストは低減、自分の学習にかかるコストは「私が楽しければ無視」してよい
以下がアーキテクチャの全体像です。
この構成のポイントは、すべてのインフラがCloudflareの無料枠に収まることです。各構成要素を順番に見ていきます。
構成要素1 Cloudflare R2(画像ストレージ)
なぜR2を選んだのか
Obsidianで技術ノートを書いていると、スクリーンショットや図を大量に貼り付けます。これらをGitリポジトリに含めると、リポジトリが肥大化してcloneやpushが遅くなります。
Cloudflare R2を画像ストレージとして使う理由は明確です。
- エグレス(転送量)課金が無料: AWS S3と違い、データ取り出しに費用がかかりません
- 無料枠が十分: ストレージ10GB/月、ClassA操作100万回/月、ClassB操作1,000万回/月
- S3互換API: 既存のツールやプラグインがそのまま使えます
今の自分の用途であれば、10GBの無料枠を超えることはないと判断しました。 まあ、多少超えても、料金はかなりお安いですしね…
WranglerスクリプトとPythonによる一括アップロード
ObsidianからR2へ画像を直接アップロードするプラグイン(S3 Image Uploaderなど)を使う手もありますが、自分の構成ではよりシンプルに**「ローカルに画像を保存し、自作スクリプトで一括アップロード・リンク置換する」**アプローチをとっています。
これにより、Obsidian上では通常のローカルファイルとして画像を扱いながら、Web公開時はR2の画像を配信できるようになります。
R2バケットの作成
- Cloudflareダッシュボードにログイン
- 「R2 Object Storage」→「バケットを作成」を選択
- バケット名(例:
obsidian-img)を入力し、リージョンを選択
Wrangler CLIによる一括アップロード
Cloudflareの公式CLIツールであるwranglerを使用して、Obsidianの画像フォルダ(3_Resources/_resourcesなど)にある画像をR2に一括アップロードします。
自分は以下のようなBashスクリプトを用意して運用しています。
# 抜粋: _resources内の画像を全てR2にアップロードする
while IFS= read -r -d '' filepath; do
rel_path="${filepath#$RESOURCES_DIR/}"
r2_key="_resources/$rel_path"
content_type=$(get_content_type "$filepath")
wrangler r2 object put "$BUCKET/$r2_key" \
--file="$filepath" \
--content-type="$content_type" \
--remote
done < <(find "$RESOURCES_DIR" -type f \( -name "*.png" -o -name "*.jpg" \) -print0)
Markdown内のリンクをR2のURLに置換
画像がR2にアップロードできたら、Markdown内のローカル画像リンクを、R2の公開URL(カスタムドメイン)へ書き換える必要があります。
これもPythonスクリプトを用意し、正規表現を用いてMarkdownファイル内のリンクを一括置換しています。
# 抜粋: Pythonによるリンク書き換え処理
import re
LINK_PATTERN = re.compile(r'(\!\[[^\]]*\]\()((?:\.\.\/)*)(?:3_Resources\/)?(_resources\/)([^)\s]+)(\))')
# ... リンクを https://<カスタムドメイン>/_resources/xxx に置換 ...
構成要素2 Git + mkdocs + Cloudflare Pages(ビルド&ホスティング)
Markdown → 静的サイトの自動パイプライン
この構成の中核は、ObsidianのMarkdownをGitで管理し、mkdocsで静的サイトにビルドし、Cloudflare Pagesで自動デプロイするパイプラインです。
Material for MkDocsを使う理由は、Obsidianとの互換性が高く、見た目も洗練されているためです。WikiリンクやCallout記法への対応もプラグインで実現できます。
デプロイフロー
以下がデプロイの流れです。Markdownを保存してpushするだけで、自動的にサイトが更新されます。
mkdocs.ymlの設定例
以下は自分が使っている mkdocs.yml の設定例です。Material for MkDocsをベースに、Obsidianとの互換性を高める設定を入れています。
site_name: My Obsidian Notes
site_dir: site
use_directory_urls: false
# Obsidian特有の不要なファイルをビルド対象から外す設定
exclude_docs: |
.*
Excalidraw/**
4_Archives/PDF/**
3_Resources/Logs/**
3_Resources/images/**
3_Resources/Prompts/**
3_Resources/Scripts/**
3_Resources/Snippets/**
3_Resources/Templates/**
3_Resources/VRM/**
*.py
GEMINI.md
CLAUDE.md
README.md
theme:
name: material
language: ja
custom_dir: overrides
features:
- navigation.instant # ページ遷移を高速化(SPA風)
- navigation.tracking # 読んでいる場所を追跡
- navigation.sections # PARA構造を強調
- navigation.top # 長いノート用「トップへ戻る」ボタン
palette:
# ライトモード(昼用)の設定
- scheme: default
primary: indigo
accent: purple
toggle:
icon: material/brightness-7
name: Switch to dark mode
# ダークモード(夜用)の設定
- scheme: slate
primary: indigo
accent: lime
toggle:
icon: material/brightness-4
name: Switch to light mode
extra_css:
- stylesheets/extra.css
markdown_extensions:
- obsidian_callouts
- admonition
- pymdownx.magiclink
- pymdownx.tilde
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.tasklist:
custom_checkbox: true
- footnotes
extra_javascript:
- https://unpkg.com/mermaid@11/dist/mermaid.min.js
plugins:
- search:
enabled: false
- obsidian-bridge # Wikiリンク等をサポート
Cloudflare Pagesの設定
- Cloudflareダッシュボードで「Workers & Pages」→「新規作成」→「Pagesタブ」を選択
- GitHubリポジトリを接続
- ビルド設定を入力:
- ビルドコマンド:
bash build.sh - ビルド出力ディレクトリ:
site - 環境変数:
PYTHON_VERSION=3.12
- ビルドコマンド:
※自分の環境では、Obsidian用の不要なディレクトリを除外したり、特定プラグインのバグ回避パッチを当てるために build.sh というシェルスクリプトを用意し、その中で mkdocs build を呼び出しています。
requirements.txt には以下のように、使用するテーマやプラグインを記載します。
mkdocs==1.6.1
mkdocs-material==9.7.2
git+https://github.com/tadashi-aikawa/mkdocs-obsidian-bridge
これでGitHubにpushするたびに、Cloudflare Pages上で自動的にビルドとデプロイが実行されます。無料枠でもビルド500回/月、帯域幅無制限と、個人利用には十分すぎるスペックです。
構成要素3 Cloudflare Access(認証)
Zero Trustで「自分だけ」のアクセス制御
サイトを公開したら、次は「自分だけがアクセスできるようにする」必要があります。ここで使うのがCloudflare Access(Zero Trust)です。
認証方式の選択
Cloudflare Accessでは複数の認証方式を選択できます。
- メールOTP(ワンタイムパスワード): 設定不要で最も手軽。指定したメールアドレスにコードが届きます
- Google認証: Googleアカウントでのログイン。OAuthの設定が必要ですが、普段使いには便利です
- GitHub認証: GitHubアカウントでのログイン。開発者なら自然な選択肢です
自分はメールOTPとGitHub認証を併用していますが、以下メールOTPでの設定手順を記載します。
Cloudflare Accessの設定手順
- Cloudflare Zero Trustダッシュボード(
one.dash.cloudflare.com)にアクセス - 「Access」→「Applications」→「Add an application」を選択
- 「Self-hosted」を選択
- アプリケーションドメインにCloudflare PagesのURLを入力
- ポリシーを作成:
- Action: Allow
- Include: Emails — 自分のメールアドレスを指定
これで、サイトにアクセスすると認証画面が表示され、許可されたメールアドレスでのみアクセスできるようになります。
コスト比較——Obsidian Publish vs この構成
この構成の最大の魅力は、「Cloudflareの無料枠だけで完結する」ことです。
| 項目 | Obsidian Publish | この構成(Cloudflare) |
|---|---|---|
| ホスティング | $8/月(Publish) | $0(Pages無料枠: ビルド500回/月、帯域幅無制限) |
| 画像ストレージ | Publish内に含まれる | $0(R2: 10GB/月無料枠) |
| 認証・アクセス制御 | なし(公開 or リンク共有) | $0(Access: 50ユーザー無料枠) |
| CDN | Publish内に含まれる | $0(Cloudflare CDN) |
| カスタムドメイン | 対応(追加設定) | 対応(Pages標準機能) |
| 月額合計 | $8/月(約$96/年) | $0/月 |
※執筆時点(2026年2月)の情報です。最新の料金は各公式サイトをご確認ください。
もちろん、Obsidian Publishには「Obsidianから直接公開できる手軽さ」「グラフビューの公開」といったObsidianならではの価値があります。
まとめ
この構成の利点
- コスト$0: Cloudflareの無料枠だけで運用可能
- 編集体験が変わらない: ローカル環境での執筆フローはそのまま
- 自由度が高い: Material for MkDocsのテーマ・プラグインで見た目を自在にカスタマイズ
- セキュリティ: Zero Trustでエンタープライズグレードのアクセス制御
- データの所有: すべてのデータが自分のGitリポジトリとCloudflareアカウントにある
注意点
- セットアップの手間: 初回構築にはCloudflareの各サービスの設定が必要です。慣れていない方は数時間かかる可能性があります
- mkdocsの学習コスト:
mkdocs.ymlの設定やプラグインの理解に多少の学習が必要です - Obsidianとの完全互換ではない: 一部のObsidian独自記法(埋め込みやDataview等)はmkdocsでは再現できません。公開用のノートはmkdocs互換の記法を意識する必要があります
まだ改善の余地はあるかもしれませんが、ひとまず当初の目的を達成できました。なによりこういう仕組みをという体験には、コスト以上の満足感があります。Obsidianのローカルファースト思想と、Cloudflareの無料インフラを組み合わせることで、個人ナレッジ基盤は驚くほど手軽に構築できます。
ぜひ試してみてください。