サーバー代0円!Obsidian × Quartz × Cloudflare Pages で個人開発メディアを構築した全手順

個人開発でWebサービスを作ったとき、それを世の中に広めるための「解説メディア」や「開発ブログ」をセットで持ちたくなります。
ただ、WordPressのためにレンタルサーバーを借りて月額費用を払うのは、初期の個人開発には負担が大きいですよね。

そこで今回は、維持費0円(ドメイン代なしなら完全無料)・執筆ストレス最小・セキュリティ安全な構成として、このサイト(LifeOpt Lab)自体にも採用している Obsidian × Quartz × Cloudflare Pages の構築構成と実践Tipsを共有します。


1. 全体構成(なぜこの組み合わせなのか?)

役割採用ツールメリット
執筆エディタObsidianローカルMarkdownで爆速執筆。内部リンクや図解(Mermaid)がそのまま書ける。
サイト生成(SSG)Quartz v5Obsidianの記法([[Wikilink]] 等)をそのまま美しいWebサイトに変換できる。
ホスティングCloudflare Pages無料プランでも商用利用OK・転送量&リクエスト数無制限。アクセスがバズっても課金されない。

2. ハマりやすいセキュリティ問題:「PATをプラグインに入れたくない」

ObsidianからGitHubへ自動同期する際、よく紹介されるのはサードパーティプラグインに GitHub の Personal Access Token(PAT)を設定する方法です。

ただ、昨今のセキュリティ意識からすると「外部プラグインにGitHubの書き込みトークンを渡すのは少し怖い」と感じる方も多いと思います。

解決策:Quartzの content/ フォルダを直接 Obsidian の保管庫にする

実は Quartz の初期設定(quartz.config.yaml)と .gitignore には、最初から以下の除外ルールが入っています。

ignorePatterns:
  - private
  - templates
  - .obsidian

つまり、リポジトリの content/ フォルダをそのまま Obsidian で開くだけで、以下の理想的な運用がトークンゼロで実現します:

  1. Obsidianの設定(.obsidian)はWeb公開されない(自動無視)。
  2. 下書きや非公開メモは content/private/ に入れるだけ(GitHubにもWebにも出ない)。
  3. 公開したい時だけ GitHub Desktop で「Push」を1クリック(APIトークン管理不要)。

TIP

注意:Obsidianで「新しい保管庫を作成」すると content/保管庫名/ のようにサブフォルダが作られてしまうことがあります。既存の content/ を使う場合は、必ず 「フォルダを保管庫として開く(Open folder as vault)」 を選んでください。


3. Cloudflare Pages デプロイ時の重要な注意点

Cloudflare Pages で Quartz を公開する際、初期設定のままだと踏みがちな罠が3つあります。

① 「Workers」ではなく「Pages」タブを選ぶ

Cloudflare の作成画面では最初「Workers」が選ばれがちですが、静的サイトは [Pages] タブ > [Git に接続] から作成します。

② ビルドコマンドに git fetch --unshallow && を付ける

Cloudflare Pages は高速化のため、デフォルトで最新の1コミットしか取得しない(Shallow Clone)仕様です。そのままだと Quartz が Git 履歴から記事の作成日・更新日を取得できず、全記事の日付が「ビルドした当日」になってしまいます。

  • フレームワークのプリセット: None
  • ビルドコマンド:
    git fetch --unshallow && npx quartz build
  • ビルド出力ディレクトリ: public
  • 環境変数: TZ = Asia/Tokyo(日本時間での日付ズレ防止)

③ quartz.config.yaml の baseUrl には https:// を書かない

baseUrl: https://example.pages.dev のようにプロトコルを含めてしまうと、生成される sitemap.xml のURLが二重になって Google Search Console でエラーになります。
必ず baseUrl: lifeopt-lab.pages.dev のようにホスト名のみを記載してください。


4. まとめ

この構成にしておけば、「メモを書く延長で記事が書けて、GitHubにプッシュするだけで世界中のエッジサーバーから爆速配信される」 環境が無料で手に入ります。

個人開発で作ったアプリを世の中に届けるための母艦として、ぜひ試してみてください!