サーバー代0円!Obsidian × Quartz × Cloudflare Pages で個人開発メディアを構築した全手順
個人開発でWebサービスを作ったとき、それを世の中に広めるための「解説メディア」や「開発ブログ」をセットで持ちたくなります。
ただ、WordPressのためにレンタルサーバーを借りて月額費用を払うのは、初期の個人開発には負担が大きいですよね。
そこで今回は、維持費0円(ドメイン代なしなら完全無料)・執筆ストレス最小・セキュリティ安全な構成として、このサイト(LifeOpt Lab)自体にも採用している Obsidian × Quartz × Cloudflare Pages の構築構成と実践Tipsを共有します。
1. 全体構成(なぜこの組み合わせなのか?)
| 役割 | 採用ツール | メリット |
|---|---|---|
| 執筆エディタ | Obsidian | ローカルMarkdownで爆速執筆。内部リンクや図解(Mermaid)がそのまま書ける。 |
| サイト生成(SSG) | Quartz v5 | Obsidianの記法([[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 で開くだけで、以下の理想的な運用がトークンゼロで実現します:
- Obsidianの設定(
.obsidian)はWeb公開されない(自動無視)。 - 下書きや非公開メモは
content/private/に入れるだけ(GitHubにもWebにも出ない)。 - 公開したい時だけ 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にプッシュするだけで世界中のエッジサーバーから爆速配信される」 環境が無料で手に入ります。
個人開発で作ったアプリを世の中に届けるための母艦として、ぜひ試してみてください!