Cloudflare Access で Astro ブログの特定ページだけを管理者限定にする
Cloudflare Zero Trust (Access) の無料枠を使い、Astro ブログの private 指定ページだけを管理者認証必須にする設計と実装手順。URL 直打ちでも閲覧不可にするための本番ドメイン・プレビューデプロイ両面の塞ぎ方、既存 unlisted との役割分担まで含めてまとめる。
概要
Cloudflare Pages にデプロイした Astro 製ブログで、「公開」「URL を知っている人のみ閲覧可(unlisted)」に加えて、管理者(自分)だけがアクセスできる private ページ を実現するためのリファレンス。
認証ロジックはアプリ側に一切実装せず、Cloudflare Zero Trust (Access) の無料枠(50 ユーザーまで無料)に委譲する。Astro 側は「private なページを特定 URL prefix 配下に出力する」ビルドにして、Access はその prefix を保護するだけ。
可視性レベルの設計
既存の unlisted と併用する前提で、3 段階に整理する。
| visibility | 公開一覧 | URL 直打ち | 認証 | 用途 |
|---|---|---|---|---|
public | 表示 | 可 | 不要 | 通常の公開記事 |
unlisted | 非表示 | 可 | 不要 | URL を知る人だけに共有 |
private | 非表示 | 不可(Access で遮断) | 必要 | 管理者専用の作業ログ等 |
unlisted は既存実装でカバー済みのため、本リファレンスでは private の実装のみを扱う。
全体アーキテクチャ
┌─────────────────────────────────────────────┐ │ Cloudflare Edge │Browser ─┤ │ │ ┌──────────────────┐ ┌────────────────┐ │ │ │ Access Policy │ → │ Cloudflare │ │ │ │ (/private/* を │ │ Pages (静的) │ │ │ │ 管理者のみ許可) │ │ │ │ │ └──────────────────┘ └────────────────┘ │ └─────────────────────────────────────────────┘- Access チェックは Cloudflare エッジで実行される。未認証リクエストはログイン画面(302)で止まり、Pages のオリジンに到達しない。
- そのため「ビルド成果物として
/private/ディレクトリが存在していても、認証を通らない限り HTML は返らない」。URL を知られても閲覧不可。
前提条件
- 独自ドメインを使う場合、そのドメインの ネームサーバーが Cloudflare 配下にあること。
- Cloudflare Pages プロジェクトに本番ドメインが接続済みであること。
- Zero Trust のチーム(Free プラン)が作成済みであること(
dash.cloudflare.com→Zero Trustから初回セットアップ)。
Astro 側の実装
1. Content Collection スキーマ
visibility を 3 値の enum として定義する。
// File: src/content/config.ts
import { defineCollection, z } from 'astro:content';
const blog = defineCollection({
type: 'content',
schema: z.object({
title: z.string(),
pubDate: z.date(),
description: z.string().optional(),
visibility: z.enum(['public', 'unlisted', 'private']).default('public'),
}),
});
export const collections = { blog };
記事側の frontmatter 例:
---
title: "開発ログ 2026-10-23"
pubDate: 2026-10-23
visibility: private
---
ここは自分しか見ない内容
2. 動的ルートで URL prefix を出し分ける
private な記事だけ /private/<slug>/ に出力する。これにより Access のポリシーをパスで一括適用できる。
---
// File: src/pages/[...slug].astro
import { getCollection } from 'astro:content';
export async function getStaticPaths() {
const posts = await getCollection('blog');
return posts.map((post) => {
const slug =
post.data.visibility === 'private'
? `private/${post.slug}`
: post.slug;
return { params: { slug }, props: { post } };
});
}
const { post } = Astro.props;
const { Content } = await post.render();
---
<article>
<h1>{post.data.title}</h1>
<Content />
</article>
3. 公開一覧から除外
トップページ等の公開一覧には public のみを出す。unlisted と private はどちらも非表示。
---
// File: src/pages/index.astro
import { getCollection } from 'astro:content';
const posts = (await getCollection('blog'))
.filter((p) => p.data.visibility === 'public')
.sort((a, b) => b.data.pubDate.valueOf() - a.data.pubDate.valueOf());
---
<ul>
{posts.map((p) => (
<li><a href={`/${p.slug}/`}>{p.data.title}</a></li>
))}
</ul>
4. 管理者用 private 一覧ページ(任意)
/private/index も /private/* に含まれるので自動で Access に保護される。
---
// File: src/pages/private/index.astro
import { getCollection } from 'astro:content';
const posts = (await getCollection('blog'))
.filter((p) => p.data.visibility === 'private')
.sort((a, b) => b.data.pubDate.valueOf() - a.data.pubDate.valueOf());
---
<h1>Private Log</h1>
<ul>
{posts.map((p) => (
<li><a href={`/private/${p.slug}/`}>{p.data.title}</a></li>
))}
</ul>
5. サイトマップ・RSS からも除外
@astrojs/sitemap を使う場合は filter オプションで private を除外する。
// File: astro.config.mjs 抜粋イメージ
import sitemap from '@astrojs/sitemap';
export default {
integrations: [
sitemap({
filter: (page) => !page.includes('/private/'),
}),
],
};
RSS 生成コードでも同様に visibility !== 'private' でフィルタする(unlisted も検索流入を避けたい場合はここで同時に除外して可)。
6. robots.txt に保険
Access が 302 を返すためクロールはされないが、保険として Disallow を入れておく。
// File: public/robots.txt
User-agent: *
Disallow: /private/
Cloudflare Access の設定
1. Access Application を作成
Zero Trust ダッシュボード → Access → Applications → Add an application → Self-hosted
| 項目 | 値 |
|---|---|
| Application name | 任意(例: blog-private) |
| Session Duration | 1 month 等お好みで |
| Application domain | yourblog.com(本番ドメイン) |
| Path | private |
これで https://yourblog.com/private/* が保護対象になる。
2. Policy
- Policy name:
only-me - Action:
Allow - Include:
Emails→ 管理者のメールアドレス 1 件
3. 認証方法
デフォルトの One-time PIN(メールで届くコード入力)で十分。Google 等の IdP を使いたい場合は Settings → Authentication → Add new から追加する。
4. プレビューデプロイを塞ぐ(重要)
本番ドメインだけ保護しても、Cloudflare Pages の プレビュー URL(*.your-project.pages.dev)経由で同じコンテンツに素通りでアクセスされる。以下のいずれかを必ず実施する。
(A) プレビュー URL にも Access を被せる(推奨)
同じ Application の domain に追加、または別 Application として:
| 項目 | 値 |
|---|---|
| Domain | *.your-project.pages.dev |
| Path | (空。サイト全体を保護) |
| Policy | 自分のメアドのみ Allow |
(B) プレビューデプロイを無効化
Pages プロジェクトの Settings → Builds & deployments → Preview deployments を None に設定。
5. ログアウト URL
https://<チーム名>.cloudflareaccess.com/cdn-cgi/access/logout
動作確認
- 未ログイン状態で
https://yourblog.com/private/some-slug/にアクセス → Cloudflare のログイン画面にリダイレクトされること。 - 登録メアドで PIN 認証 → 記事が表示されること。
- 登録外のメアドで試行 →
Access deniedが返ること。 *.pages.devのプレビュー URL で/private/some-slug/にアクセス → (A) を選んだ場合もログイン画面になること。- 公開トップ・サイトマップ・RSS に private 記事が 一切出現しないことを確認。
よくある誤解
- 「静的ファイルだから URL を知られたら見える」は誤り。 Access は Cloudflare エッジで動き、Pages のオリジン応答より前にリクエストを止める。認証を通らない限り HTML バイト列は配信されない。
- ただしプレビュー URL は別オリジン扱い なので、本番ドメインだけ保護しても抜け道になる。必ず塞ぐこと。
- Access を外した(削除した)瞬間に
/private/*は誰でも見える状態になる。設定変更時は注意。
チェックリスト
-
visibility: z.enum(['public', 'unlisted', 'private'])をスキーマに追加 - private な記事は
/private/<slug>/に出力されるルーティングに修正 - 公開一覧・サイトマップ・RSS から private を除外
- Cloudflare Access で本番ドメインの
/private/*を保護 -
*.pages.devにも Access を被せる、またはプレビュー無効化 -
robots.txtにDisallow: /private/を追加 - 未ログイン・別メアド・プレビュー URL の 3 パターンで動作確認
既存 unlisted との役割分担まとめ
unlisted: アプリ側実装で「一覧非表示・URL 直打ちは可」。共有リンクを渡した相手に見せる用途。private: Cloudflare Access で「認証必須」。管理者本人しか見ない作業ログ・ドラフト等の用途。
両者は直交した機能で、スキーマの visibility 1 フィールドで排他的に表現できる。