※本記事はアフィリエイト広告(PR)を含みます。
静的なサイトなら、無料で公開できます。GitHub Pagesで実際に出し、無料の範囲とホスティングの選択肢を整理します。
前回: メールが迷惑メールになる理由 — DNSレコードを読む
はじめに のカリキュラムでは 第7段階「公開する」 にあたります。
作業場所は2つあります
– VMの中(Ubuntu) …
~/react-demo/を直すところ、git pushするところ – Windows のブラウザ … GitHub の設定画面、公開されたページを見るところどちらで打つかは、各手順の先頭に必ず書いてあります。
クレジットカードは要りません
この記事でやることに、カード登録は一切要りません。 GitHub のアカウントだけで完結します。 Netlify と Vercel も出てきますが、アカウント作成は任意にしてあります。作らなくても記事は読めます。
金額・無料枠の条件は、必ず公式で確認してください
無料枠の中身は、しょっちゅう変わります。 この記事では具体的な数字を書きません。 「どの項目に上限があるか」だけを示すので、実際の値は必ず公式の料金ページで確認してください。
前回まででやったことを並べてみます。
nginx を入れて、Docker を動かして、APIを書いて、Reactで画面を作って、ビルドして dist/ を出して、GitHubに上げて、Actionsでテストを回しました。
この全部が、まだ自分のPCの中でしか動いていません。
VMのIPアドレスは 192.168.x.x です。あれは家の中でしか意味を持たない番号で、ネットワークの回でやったとおり、外からは届きません。作ったものを、誰にも見せられていないということです。
AWSでEC2を1台立てた回は、そこを一度だけ越えました。でも、その日のうちに全部消しました。 料金の回で書いたとおりです。
止め忘れと消し忘れ。個人の事故はほぼこれ。
消したのは正しい判断でした。けれど、消したので、また見せられなくなりました。
この回で、そこを終わらせます。しかも、止め忘れても課金されない方法で。
答えは拍子抜けするほど単純です。サーバーを動かさなければいいのです。
対象レベル: 中級 / 区分: 必修
この記事でわかること
- 「無料ホスティング」の無料は、太っ腹だからではないこと。静的ファイルを配るのは、本当に原価が安いという理由がある
- ホスティングには4種類あること(共有 / VPS / 静的 / サーバーレス)。自分がVMでやってきたのはVPS型で、いま選ぶのは別の型だということ
https://ユーザー名.github.io/リポジトリ名/はサブディレクトリで、Vite のbaseを直さないとCSSが必ず404になること- 無料が終わるのは「転送量・ビルド時間・商用利用」の3箇所で、CPUやメモリではないこと
- 静的ホスティングにはサーバーが無いので、APIを別の場所に置く判断が必ず要ること
この記事でやること
- 「無料」の線引きを先に決める(何が安くて、何は安くならないのか)
~/react-demo/を GitHub に上げ、Actions でdist/を GitHub Pages に出す- CSSが404になるのをわざと起こして、
baseの設定で直す - https が自動で付いていることをブラウザで確認する
- 公開したページを消す(Pages を無効化して、外から見えないことを確認する)
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| ホスティング | 自分が作ったものを、他人が見られる場所に置いて動かし続けてもらうこと。「レンタルサーバー」も「クラウド」も、やっていることはこれ |
| 静的ファイル | 誰がいつ取りに来ても、まったく同じ中身が返るファイル。HTML・CSS・JS・画像。dist/ の中身がまさにこれ |
| 動的 | 取りに来た人や時刻によって、返す中身が変わること。DBを引いたり、ログイン状態で出し分けたりするもの |
| 静的ホスティング | 静的ファイルを置くことしかできない代わりに、極端に安い(多くは無料)置き場所 |
| GitHub Pages | GitHub が用意している静的ホスティング。リポジトリの中身、またはActionsが作った成果物を、そのまま公開できる |
| サブディレクトリ | https://example.com/foo/ のように、サイトのルートではなく1段下に置かれている状態。今回の最大の落とし穴 |
base | Vite の設定項目。「このサイトはどのパスの下に置かれるか」をビルド時に教えるもの |
| サーバーレス関数 | リクエストが来た瞬間だけ起動して、返したら消えるプログラム。Lambdaの回でやったもの |
| プレビューURL | プルリクエストごとに、そのブランチの内容だけを映した一時的なURLが自動で作られる仕組み |
| 転送量(帯域 / バンド幅) | そのサイトから外に出ていったデータの合計量。無料枠が終わる原因の第1位 |
① 先に「無料」の線引きをする
この記事のすべての判断が、ここから出てきます。 先に置きます。
静的ファイルを配るだけ → 本当に安い(無料になりうる)
サーバーが動き続けるもの → 無料にならない
なぜそうなるのか。提供する側の原価を考えると、はっきりします。
| 静的ファイルを配る | サーバーを動かし続ける | |
|---|---|---|
| 必要なもの | ファイルの置き場所と、配る回線 | CPUとメモリを、24時間占有し続ける |
| 誰も見に来ない時間 | コストはほぼゼロ | 誰も来なくてもコストは同じ |
| 1人増えたときの追加コスト | 転送量が少し増えるだけ | 同時に処理する分だけCPUが要る |
| 配る場所 | 世界中のキャッシュに複製できる(CDNの回でやったもの) | 複製するには台数を増やすしかない |
静的ファイルは、置いておくだけならタダ同然です。 そしてCDNの回でやったとおり、同じ中身を返すものは、いくらでもコピーして各地に置ける。だから提供する側は、無料で配っても痛くありません。
一方で、あなたのAPIは違います。 「サーバーとは待ち続けるプログラム」の回で書いたとおり、サーバーは待っている間もずっとメモリに居座ります。 誰も来なくても、電気は流れ続けています。これを無料で配ってくれる会社は、基本的にありません。
「無料ホスティングは怪しいのでは」と最初に思いました。 怪しくありません。配っているものが、そもそも安いだけです。 逆に言えば、サーバーが要る部分を無料でやろうとすると、必ずどこかで無理が出ます。 そこが後半の話です。
この線引きを持って読むと、以降の判断が全部同じ形になります。
dist/の中身 → 静的 → 無料で出せる~/serverのAPI → 動的 → 無料の置き場所は選択肢が狭い(⑦で扱います)- WordPress(このサイト) → 動的(PHPとDBが動く) → 静的ホスティングには載らない(⑨で扱います)
② ホスティングは4種類ある
「サーバーを借りる」と一口に言いますが、中身は4種類あります。ここを分けずに調べ始めると、記事によって言うことが違って混乱します。
| 型 | 何を借りているか | 自分がやる仕事 | 例 |
|---|---|---|---|
| 共有サーバー | 1台のサーバーの一部屋。他人と同居 | アプリを置くだけ。OSは触れない | レンタルサーバー各社 |
| VPS / IaaS | 仮想マシン1台まるごと。root権限つき | OSの管理も、更新も、監視も全部 | EC2、VPS各社 |
| 静的ホスティング | ファイルの置き場所と配信網だけ | ファイルを置くだけ。サーバーは無い | GitHub Pages、Netlify、Vercel、Cloudflare Pages |
| サーバーレス | 関数の実行時間だけ | コードを書くだけ。サーバーは見えない | Lambda、各社のFunctions |
上から下に行くほど、自分の仕事が減って、できることも減ります。 これはトレードオフで、どれが偉いという話ではありません。
自分がやってきたのはどこか
VMwareのVMは、2段目のVPS型そのものです。
Ubuntu Serverを立てて、初期設定をして、nginxを入れて、権限を直して、サービスを enable して、パッケージを更新して。この全部が「2段目を選んだ人の仕事」です。
そしてEC2の回で、同じ仕事をクラウドでやりました。 だから「VMとほぼ同じで、違うのは請求書とネットワークだけ」という結論になったわけです。
今回選ぶのは3段目です。 仕事が激減します。その代わり、できることも激減します。
| VM(2段目) | 静的ホスティング(3段目) | |
|---|---|---|
| SSHで入れるか | 入れる | 入れない。そもそも「中」が無い |
| nginx の設定 | 自分で書く | 書けない。書く場所が無い |
| DBを置けるか | 置ける | 置けない |
| APIを動かせるか | 動かせる | 動かせない |
| OSの更新 | 自分の責任 | 考えなくていい |
| 落ちたとき | 自分で起こす | 自分の仕事ではない |
| 料金 | 動かした時間ぶん | 多くの場合ゼロ |
「できないことが多い」は、欠点であると同時に、無料の理由です。 ここを納得してから進んでください。
なぜ最初からこれを教えないのか。 仕組みが分からないまま「無料で公開できます」だけ覚えると、APIを足したい日に完全に詰まるからです。 VMを触って、nginx を書いて、EC2を立てたあとだからこそ、「今回は何をしなくてよくなったのか」が分かります。
③ 準備 — ~/react-demo/ を GitHub に上げる
ここからVMの中の作業です。 まず、いま何があるかを確認します。
VMの中で、
dist/ に index.html と assets/ ができれば準備完了です。ビルドツールの回でやったとおり、dist/ はただの静的ファイルの束です。
この束を、他人が取りに来られる場所に置く。 それが今回やることの全部です。
Git の状態を確認する
VMの中で、
「fatal: not a git repository」と出た場合は、まだリポジトリになっていません。GitHubの回と同じ手順でリポジトリにします。
.gitignore を必ず確認してください。
node_modules と dist が入っていることを確認します。ビルドツールの回で書いたとおり、この2つはGitに入れません。 今回は特に重要です。dist/ は GitHub の中で作らせるので、手元のものを上げる必要がありません。
もし git status に node_modules/ が大量に出ているなら、.gitignore に足してから、
GitHub にリポジトリを作って push する
Windowsのブラウザで GitHub を開き、新しいリポジトリを react-demo という名前で作ります。
リポジトリ名が、そのままURLの一部になります。
https://ユーザー名.github.io/react-demo/です。あとで変えると全部やり直しになるので、ここで決めてください。
公開範囲について、先に判断が要ります。
| Public(公開) | Private(非公開) | |
|---|---|---|
| コードが読めるか | 世界中の誰でも読める | 自分だけ |
| GitHub Pages を無料で使えるか | 使える | 無料プランでは使えないことがある。公式で確認 |
個人の学習用なら Public で構いません。 ただしPublicにする前に、必ず確認してください。
一度 push したものは、消しても履歴に残ります。 Secrets の回で書いたとおり、
.envや APIキーが1回でも入ったら、そのキーは失効させるしかありません。 「あとで消せばいい」は通用しません。
問題なければ、VMの中で、
your-name は自分のアカウント名に置き換えてください。大文字小文字も区別されます。
確認方法: ブラウザでリポジトリを開き、src/ と package.json が見えていればOKです。node_modules/ が見えていたら、.gitignore が効いていません。 上の git rm -r --cached からやり直してください。
④ GitHub Pages に dist/ を出す
ここが今回の中心です。
やることは、CI/CDの回で書いたワークフローの、素直な延長です。
| 前回のCI | 今回 | |
|---|---|---|
| いつ動くか | push したとき | 同じ |
| 何をするか | npm ci → テスト | npm ci → npm run build |
| 結果をどうするか | 成功/失敗を表示するだけ | dist/ を GitHub Pages に渡す |
「テストを走らせる」が「ビルドして置いてくる」に変わっただけです。ランナーの仕組みも、npm ci を使う理由も、前回のままです。
なぜ Actions を使うのか
dist/ を手元でビルドして、それを Git に入れて push すれば、Actions は要りません。 実際、そういう手順の記事もあります。
やりません。理由は2つです。
dist/は毎回全部が差分になります。 minify されているので、履歴が読めないゴミで埋まります- 「手元でビルドしたものを上げる」は、手順を忘れます。 CI/CDの回で自動化した理由と同じです
ソースだけをGitに置いて、成果物はGitHubの中で作らせる。 これが今の標準です。
Pages の公開元を Actions にする
Windowsのブラウザで、リポジトリの Settings → Pages を開きます。
Source(公開元)を「GitHub Actions」に変更します。
ここが分岐点です。 GitHub Pages には2つのやり方があります。
やり方 何を公開するか ブランチから公開 リポジトリに入っているファイルそのもの。HTMLを直接置く昔ながらの形 GitHub Actions から公開 ワークフローが作った成果物。ビルドが要るものはこちら Vite を使っている時点で、後者一択です。 前者を選ぶと、
src/の中の JSX がそのまま配られて動きません。
[スクリーンショット: 01_pages_source設定.png] Settings → Pages の画面で、Source が「GitHub Actions」になっているところを撮ってください。リポジトリ名が読める形でお願いします。
ワークフローを書く
VMの中で、
中身はこれです。
name: Deploy to GitHub Pages
on:
push:
branches: [main]
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: pages
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: コードを取得する
uses: actions/checkout@v4
- name: Node.js を用意する
uses: actions/setup-node@v4
with:
node-version: '22'
- name: 依存を入れる
run: npm ci
- name: ビルドする
run: npm run build
- name: dist を成果物として預ける
uses: actions/upload-pages-artifact@v3
with:
path: dist
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Pages に反映する
id: deployment
uses: actions/deploy-pages@v4
前回書いた ci.yml と見比べてください。 増えたのは3ブロックだけです。
| 増えたもの | 何をしているか |
|---|---|
permissions: | このワークフローに何を許すかの宣言。Pages に書き込む権限は、既定では付いていません。 これを書かないと最後で権限エラーになります |
concurrency: | 同じ公開先に、2つのデプロイが同時に走らないようにするもの。連続で push したときの事故防止 |
jobs が2つ | 作る仕事(build)と、置く仕事(deploy)を分けています。 needs: build で「buildが終わってから」という順番を作っています |
id-token: writeは何か。 「このワークフローは本当にこのリポジトリのものだ」という証明書を発行する権限です。deploy-pagesは、パスワードやトークンを預けるのではなく、その場で発行される短命の証明で認証します。 Secretsの回で書いた「秘密は置かないのが一番」を、GitHub 自身がやっている形です。あなたが書く Secrets は1つもありません。
動かす
VMの中で、
Windowsのブラウザで、リポジトリの Actions タブを開きます。Deploy to GitHub Pages が走っているはずです。
確認方法: build と deploy の両方に緑のチェックが付き、deploy のところに URL が表示されます。
https://your-name.github.io/react-demo/
[スクリーンショット: 02_actions成功.png] Actions の実行結果画面で、build と deploy の2つが成功していて、公開URLが表示されているところを撮ってください。
クリックしてください。 ここからが本題です。
⑤ 必ずハマる — CSSが404になる
開いた画面は、たぶん真っ白です。
壊れていません。全員がここを通ります。
F12 を押して、Console と Network を見てください。 開発者ツールの回でやったとおりです。
GET https://your-name.github.io/assets/index-C0sCkigK.js 404 (Not Found)
GET https://your-name.github.io/assets/index-DiwrgTda.css 404 (Not Found)
[スクリーンショット: 03_css404.png] 真っ白なページと、F12 の Network タブで assets/ のファイルが404になっているところを、同じ画面に入るように撮ってください。
なぜこうなるのか
URLをよく見てください。
実際に置かれている場所 : https://your-name.github.io/react-demo/assets/index-....js
ブラウザが取りに行った先 : https://your-name.github.io/assets/index-....js
↑ /react-demo/ が無い
/react-demo/ が抜けています。
原因は dist/index.html の中にあります。VMの中で見てみます。
<script type="module" crossorigin src="/assets/index-C0sCkigK.js"></script>
<link rel="stylesheet" crossorigin href="/assets/index-DiwrgTda.css">
/assets/... です。先頭にスラッシュがあります。
CSSの回やHTMLの回で出てきた話ですが、先頭がスラッシュのパスは「サイトのルートから」という意味です。
| 書き方 | 意味 |
|---|---|
/assets/a.js | サイトのルートから見た assets/a.js |
assets/a.js | いまいる場所から見た assets/a.js |
./assets/a.js | 同上(明示しただけ) |
Vite は既定で「このサイトはルートに置かれる」と思ってビルドします。 ローカルの npm run preview も、nginx に置いたときも、ルートだったので何も起きませんでした。
GitHub Pages は違います。
https://your-name.github.io/ ← ここはアカウントのトップ。自分のサイトではない
https://your-name.github.io/react-demo/ ← 自分のサイトはこの下
リポジトリ名のぶん、1段下に置かれます。 だから、ルートからのパスが全部ずれます。
これはビルドツールの回の最後で予告していた罠です。 あのときは「サブディレクトリに置くなら
baseが要る」と1行書いただけでした。その日が来ました。
直す
VMの中で、vite.config.js を開きます。無ければ作ります。
base の行を足します。
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
export default defineConfig({
plugins: [react()],
base: '/react-demo/',
})
baseの値は「リポジトリ名を前後のスラッシュで挟んだもの」です。最後のスラッシュを忘れないでください。'/react-demo'だとassetsの直前にスラッシュが入らず、/react-demoassets/...という壊れたパスになります。
確認方法: VMの中でビルドし直して、index.html を見ます。
<script type="module" crossorigin src="/react-demo/assets/index-C0sCkigK.js"></script>
<link rel="stylesheet" crossorigin href="/react-demo/assets/index-DiwrgTda.css">
/react-demo/ が入りました。 これで、GitHub Pages 上の実際の位置と一致します。
VMの中で push します。
Actions が走り終わったら、もう一度 https://your-name.github.io/react-demo/ を開いてください。画面が出ます。
[スクリーンショット: 04_公開ページ.png] 公開された React の画面と、アドレスバーの https://ユーザー名.github.io/react-demo/ が読めるように撮ってください。
ここで一度、手を止めてください。 このURLは、いま世界中の誰でも開けます。 スマホの回線(Wi-Fiを切って)で開いてみてください。開きます。 VMを立てた回から、ずっと家の中だけで動いていたものが、初めて外に出ました。
ローカルで動かなくなった、と焦る前に
base を足すと、npm run dev はどうなるのか。
変わりません。 Vite の開発サーバーは base を見て、http://localhost:5173/react-demo/ で配ります。トップにアクセスするとリダイレクトされるので、驚かないでください。
npm run preview も同じです。本番と同じ形で確認できるという、ビルドツールの回で書いたとおりの動きです。
⑥ https は、何もしなくても付いている
アドレスバーを見てください。https:// になっています。
証明書を取っていません。設定もしていません。
HTTPSの回でやったとおり、本来これは証明書を発行してもらって、サーバーに置いて、更新し続ける仕事です。WordPressで強制HTTPSにした回では、入れただけでは足りないという話までやりました。
それが全部、向こう側の仕事になっています。
確認方法: Windowsのブラウザで、鍵アイコンをクリックして証明書を見てください。
- 発行先 …
*.github.io - 発行者 … 公的な認証局
- 有効期限 … 数ヶ月先
[スクリーンショット: 05_https証明書.png] 鍵アイコンから開いた証明書の詳細で、発行先と有効期限が読めるように撮ってください。
もう1つ確認します。
http://(sなし)でアクセスしてみてください。 https:// に飛ばされます。WordPressの回で自分で書いた .htaccess のリダイレクトと、同じことが起きています。
「無料なのに証明書まで付くのか」と思いますが、理由は①と同じです。 証明書の自動発行は、いまや原価がほぼゼロです。しかも、静的ホスティング側は「証明書を1枚取って、全ユーザーで使い回す」ことができます。
*.github.ioの*がそれです。あなた専用の証明書は、発行されていません。 独自ドメインを当てたときだけ、専用のものが発行されます(⑧)。
⑦ 別の落とし穴 — /tasks/3 を直接開くと、また404
ルーティングの回を通っている人は、ここも踏みます。
~/react-demo/ に react-router-dom を入れている場合、公開ページのトップは開けても、https://your-name.github.io/react-demo/tasks/3 を直接開くと404になります。
あの回とまったく同じ現象です。 原因も同じで、
サーバーは
/tasks/3というファイルを探しに行き、無いので404を返す。 JavaScript が動く前に終わっている。
あの回は nginx に try_files を書いて直しました。 今回は書く場所がありません。 ②の表に書いたとおり、静的ホスティングには設定ファイルを置くサーバーが無いからです。
やり方が2つあります。
やり方A: 404.html を置く
GitHub Pages は、見つからないURLに対して 404.html を返します。 ここに index.html と同じ中身を置いておくと、結果的にReactが起動して、正しい画面を描きます。
ワークフローの「ビルドする」の直後に、1行足します。
- name: ビルドする
run: npm run build
- name: SPA用に 404.html を用意する
run: cp dist/index.html dist/404.html
さらに、ルーターにもサブパスを教える必要があります。 src/main.jsx の <BrowserRouter> を直します。
<BrowserRouter basename={import.meta.env.BASE_URL}>
<App />
</BrowserRouter>
import.meta.env.BASE_URLは、vite.config.jsに書いたbaseの値がそのまま入る変数です。2箇所に/react-demo/と手書きしないためにこう書きます。片方だけ直して壊す、という事故が消えます。
確認方法: push して Actions が終わったら、.../react-demo/tasks/3 をアドレスバーに直接打って開いてください。詳細画面が出れば成功です。
やり方B: HashRouter に変える
ルーティングの回で名前だけ出した HashRouter を使うと、URLが .../react-demo/#/tasks/3 になります。
# から後ろはサーバーに送られないので、サーバーは常に index.html を返します。 404が原理的に起きません。
| やり方A(404.html) | やり方B(HashRouter) | |
|---|---|---|
| URLの見た目 | 普通 | # が入る |
| 検索エンジン | 素直に扱われる | 扱いが不利になりやすい |
| サーバー側の対応 | 必要(404.html) | 不要 |
| 実際に返るステータス | 404 が返ってから中身が出る | 200 |
Aを勧めます。 URLが普通だからです。Bは「サーバー側に一切手を入れられない場所」でのみ考えてください。
⑧ Netlify と Vercel は、何が違うのか
アカウント作成は任意です。 作らなくても構いません。ここは仕組みの話が本体です。
GitHub Pages でできたことは、この2つでもできます。 違いは、周りに付いてくるものです。
| GitHub Pages | Netlify / Vercel | |
|---|---|---|
| ビルド | 自分でActionsを書く | 向こうがやる。 リポジトリを繋ぐと、Viteだと判断して npm run build を勝手に走らせる |
| 公開されるパス | /リポジトリ名/ の下 | ルート(/)。だから base の問題が起きない |
| プレビューURL | 無い | プルリクエストごとに専用URLが自動で作られる |
| サーバーレス関数 | 無い | 付いてくる(Functions) |
| リダイレクト・ヘッダの設定 | ほぼできない | 設定ファイルで書ける |
| 設定ファイル | ワークフロー | netlify.toml / vercel.json |
① ビルドを代わりにやってくれる
④で書いたワークフローが、丸ごと要らなくなります。 リポジトリを選ぶと、「Viteですね、npm run build して dist を配りますね」と勝手に判断します。
便利です。同時に、中で何が起きているか見えません。
だから、この記事は GitHub Pages を先にやりました。 Actions を自分で書けば、
npm ci→npm run build→ 成果物を渡す、という3ステップが全部見えます。 その3ステップを知ってから「勝手にやってくれる」を使うのと、知らずに使うのは別物です。 壊れたときに差が出ます。
② プレビューURL
これが一番大きい違いです。
CI/CDの回で、プルリクエストのときにテストを走らせました。あれは「壊れていないか」しか分かりません。 見た目が崩れていても、テストは通ります。
Netlify / Vercel は、プルリクエストごとに、そのブランチの内容だけを映した一時的なURLを作ります。
本番 : https://myapp.netlify.app/
PR #12 用 : https://deploy-preview-12--myapp.netlify.app/
マージする前に、実物を見られます。 チームで作業するときに効きます。
③ サーバーレス関数が付いてくる
②の表で「静的ホスティングにはサーバーが無い」と書きました。 Netlify と Vercel は、その穴を、4段目のサーバーレスで埋めています。
決まった場所(netlify/functions/ や api/)にJSのファイルを置くと、そのファイルがそのままURLになります。
netlify/functions/hello.js → https://myapp.netlify.app/.netlify/functions/hello
api/hello.js → https://myapp.vercel.app/api/hello
Lambdaの回でやったものと、同じ考え方です。リクエストが来た瞬間だけ動いて、返したら消えます。
ただし、Lambdaと同じ制約もそのまま来ます。
- 実行時間に上限がある(長い処理は途中で切られる)
- 常駐できないので、DBへの接続を使い回せない(コネクションの話がそのまま問題になる)
- 状態を持てない(メモリに置いたものは次で消える)
Cloudflare Pages もある
同じ枠で語られる4つ目です。もともとCDNの会社なので、配信網が強いという特徴があります。関数(Workers)も付きます。
選び方を1行で言うと、こうです。
| やりたいこと | 素直な選択 |
|---|---|
| とにかく静的なものを出したいだけ | GitHub Pages |
| APIも一緒に置きたい / プレビューURLが欲しい | Netlify / Vercel / Cloudflare Pages |
| サーバーの中を触りたい | そもそも静的ホスティングではない |
⑨ 無料が終わるのは、どこか
「無料」には必ず境目があります。 そして、境目はCPUやメモリではありません。 ①で書いたとおり、そこは原価が低いからです。
境目は、だいたいこの3つです。
| 項目 | 何が起きると超えるか | 超えたらどうなるか |
|---|---|---|
| 転送量(帯域) | アクセスが増える。画像や動画が重い。当たると一気に増える | 止まるか、有料に切り替わる。サービスによって違う |
| ビルド時間 | push が多い。ビルドが遅い。失敗して何度も回す | ビルドが走らなくなる。公開済みのページは残ることが多い |
| 商用利用の可否 | 仕事で使う。広告を出す。物を売る | 規約違反。予告なく止められうる |
具体的な数字は、この記事に書きません。
理由は2つあります。
- しょっちゅう変わります。 記事を書いた時点の値を信じて計画を立てると、外れます
- プランごとに条件が違います。 同じ「無料」でも、個人アカウントと組織アカウントで別ということがあります
必ず、いまの公式ページを開いて確認してください。 リンクは末尾に置きました。
特に注意すべき「商用利用」
転送量やビルド時間は、数字なので分かりやすいです。危ないのは3つ目です。
無料プランには「個人利用に限る」「商用は不可」という条件が付いていることがあります。 これは使っているうちに気づくものではありません。 ある日止まります。
確認するのはここです。
- 無料プランの説明に「Personal」「Hobby」「Non-commercial」といった語が出てこないか
- 利用規約(Terms)に、業務利用・EC・広告についての記述が無いか
「学習用の練習サイトを置く」なら、まず問題になりません。 「仕事の受注ページを置く」「アフィリエイトを貼る」なら、必ず規約を読んでください。 判断がつかないときは、有料プランを使うのが一番安いです。 止まって信用を失うほうが高くつきます。
そして、これは課金事故にならない
料金の回で一番怖かったのは、「上限が無い」ことでした。
静的ホスティングの無料プランは、そこが違います。
| 従量課金のクラウド | 静的ホスティングの無料プラン | |
|---|---|---|
| 上限を超えたら | 請求が増える | 多くの場合、止まる |
| 止め忘れたら | 課金が続く | 何も起きない |
| カード登録 | 必要 | 無料プランでは不要なことが多い |
「止まる」は、個人にとっては安全装置です。 請求書が来るより、はるかにいい。
ただし、有料プランに上げた瞬間に、従量課金の世界に戻ります。 そこは同じ目で見てください。
⑩ APIはどうするのか
②の表で確認したとおり、静的ホスティングにサーバーはありません。
つまり、~/server で書いた Node.js のAPIは、GitHub Pages に載りません。 載せる場所がありません。
「ではフロントを公開しても意味が無いのでは」と思いますが、そうでもありません。
- APIを呼ばない画面(紹介ページ、ポートフォリオ、資料)は、これだけで完成します
- 他人のAPIを呼ぶ画面も動きます(ブラウザから直接叩けるものなら)
自分のAPIが要るなら、置き場所を別に決めます。 選択肢はこうです。
| 置き場所 | 向いている場面 | 料金の考え方 | 注意 |
|---|---|---|---|
| サーバーレス関数(Netlify / Vercel / Cloudflare Workers) | 小さいAPI。たまにしか呼ばれない | 呼ばれた回数と時間。呼ばれなければゼロ | 常駐できない。 DB接続を使い回せない。実行時間に上限 |
| 別にサーバーを立てる(VPS / EC2) | いま書いた ~/server をそのまま動かしたい | 時間ぶん。動かし続けたら止まらない | 料金の回の世界に戻る。 OS管理も自分 |
| マネージドなアプリ実行環境(PaaS各社) | コンテナを置けば動かしてほしい | プランによる。無料枠は縮小傾向 | 無料枠で寝かせると、起動が遅い(コールドスタート) |
| BaaS(認証・DB込みのサービス) | DBと認証をまとめて借りたい | 行数・容量・リクエスト数 | 移りにくくなる(そのサービス前提の書き方になる) |
どれも、料金と無料枠は公式で確認してください。 ここでも数字は書きません。
そして、忘れてはいけないことが1つあります。
フロントとAPIのドメインが別になった瞬間、CORS が出ます。
https://your-name.github.ioからhttps://api.example.comを叩くと、ブラウザが止めます。 APIの回でやった話が、ここで現実になります。API側に許可を書く必要があります。
このサイトの順路では、まだAPIを外に出しません。 監視の回やセキュリティの回でやったことを、外に出したサーバーで全部やる覚悟ができてからにします。
API を動かし続ける場所が要るなら、無料の静的ホスティングとは別に、小さな VPS を 1 台だけ持つ組み合わせになります。シンVPS
は 1GB(1 コア・30GB)が 1 ヶ月契約 750 円〜36 ヶ月契約で月額換算 451 円(税込・2026 年 9 月 1 日改定後、2026-11 時点)で、50 種類以上の OS・アプリイメージを無料で使えるとしています。無料のお試し期間は無く最低利用期間は 3 ヶ月なので、「無料の線引き」で言えば、ここから先は払う側に入ります。
⑪ 独自ドメインを当てる話
この記事では設定しません。 ただし、どこを触るかだけは知っておいてください。
your-name.github.io/react-demo/ は、借りたURLです。 自分のドメインを当てると https://demo.example.com/ になります。
DNSの回でやったレコードが、そのまま出てきます。
| 当てたいもの | 触るレコード | 何を指すか |
|---|---|---|
demo.example.com(サブドメイン) | CNAME | your-name.github.io という名前を指す |
example.com(トップ) | A / AAAA | サービス側が公開しているIPアドレスを指す |
なぜトップだけ A レコードなのか。 DNSの回で書いたとおり、ドメインのトップには CNAME を置けないからです。 CNAME は「この名前は別名です」という意味なので、同じ名前に他のレコード(MX など)を同居させられません。 メールのMXレコードが必ずトップに要るので、トップにCNAMEを置くと、メールが死にます。 だからトップはIPを直接書きます。
触る場所は3箇所です。
- ドメインを買った会社の管理画面 … DNSレコードを足す
- ホスティング側の設定画面 … 「このドメインを使う」と登録する
- 証明書 … 多くの場合、自動で発行されます。 登録後しばらく待つ
順番を間違えると、証明書の発行に失敗します。 DNSを先に反映させてから、ホスティング側に登録してください。逆にすると、向こうが所有確認できずに弾かれます。
反映を確認する方法は、DNSの回でやったとおりです。 VMの中で、
期待した値が返ってから、次に進んでください。
ドメインを取るなら、取得先によっては小さな置き場が付いてくるものもあります。スタードメイン
は .com の新規取得が 1 年目 980 円・更新 2,047 円(税込・2026-11 時点)で、契約中は追加料金なしでスターレンタルサーバーのスタードメイン特典プラン(NVMe 5GB・無料独自 SSL・広告表示なし)を使えるので、dist/ の置き場を GitHub Pages 以外にもう 1 つ持てます。特典プランはメール機能・自動バックアップ・サポート対応が無い点は、公式の仕様表どおりに割り切って使うものです。
⑫ やりすぎない — このサイトは移さない
ここまで読むと、こう思うはずです。
「このサイト(obmes.com)も、無料で出せるのでは?」
移しません。 用途が違うからです。
| このサイト(WordPress) | GitHub Pages に載るもの | |
|---|---|---|
| 中身 | PHPが動いて、DBから記事を引いて、HTMLをその場で作る | すでに出来上がっているHTML |
| 記事を書くとき | ブラウザの管理画面で書く。すぐ反映される | ファイルを直して、コミットして、push して、ビルドを待つ |
| 必要なもの | PHPが動くサーバーとDB | ファイルの置き場所だけ |
①の線引きに戻ります。 WordPressは「サーバーが動き続けるもの」の側です。 静的ホスティングには、原理的に載りません。
「静的サイトジェネレータに移せば載る」というのは事実です。 ただし、それは移行ではなく、作り直しです。
- 記事の書き方が変わる(管理画面 → Markdown とGit)
- プラグインで足していた機能を、全部自分で作り直す
- パーマリンクが変われば、いま貼られているリンクが全部死ぬ
得るものは、月額のレンタルサーバー代だけです。 料金の回で書いたとおり、このサイトは定額のレンタルサーバーが向いている側です。
道具が増えると、全部を新しい道具に寄せたくなります。 そこで一度止まれるかどうかが、たぶん一番の分かれ目です。 今回覚えたのは「静的なものを出す道具」で、「全部を置き換える道具」ではありません。
つまずいたところ
真っ白なページを見て、ビルドが失敗したと思った
Actions は緑なのに、ページが真っ白。 最初に疑ったのはビルドでした。違いました。
ビルドは成功していて、配信も成功していて、index.html はちゃんと返っていました。 中に書いてあるパスだけが間違っていた。
F12 の Network を先に見ていれば、30秒で分かりました。 開発者ツールの回で書いた「F12は壊れたときに開くものではない」が、そのまま返ってきました。
「真っ白」は情報量ゼロです。 Console と Network を見るまで、何も分かっていないのと同じです。
base を '/react-demo' と書いて、また壊した
末尾のスラッシュを落としました。 結果は、
/react-demoassets/index-C0sCkigK.js
404の中身をちゃんと読めば書いてあったのに、「また404か」で流しました。エラーメッセージは、雑に読むと2回ハマります。
Pages の Source を変え忘れた
ワークフローは緑なのに、公開されているのは古い README.md のままという状態になりました。
Settings → Pages の Source が「ブランチから公開」のままだったからです。Actionsが作った成果物は、どこにも使われていませんでした。
「ワークフローが成功した」と「そのワークフローの結果が公開されている」は、別のことでした。
反映が遅くて、直っていないと思った
push して Actions が緑になったのに、ブラウザは古いまま。 何度もリロードしました。
キャッシュです。 Ctrl+Shift+R で直りました。
CDNの回でやったとおり、静的ホスティングは中身をキャッシュに複製して配ります。 速い理由と、古いものが出る理由は、同じ仕組みです。
確実に確かめたいときは、シークレットウィンドウで開いてください。
Private リポジトリで Pages が出せなかった
最初、コードを見られたくないので Private にしました。 Pages の設定画面に、有料プランを促す表示が出て進めませんでした。
Public にするか、有料プランにするかの二択です。「Publicにしたくない理由」が秘密情報の混入なら、そもそもコードから抜くのが先です。Secretsの回でやったとおりです。
後片づけ
今回作ったものは、放置しても課金されません。 それでも、消し方を知らないまま公開したままにするのは違います。
一番大事なこと: 公開したページは、検索エンジンに拾われることがあります。 練習用のものを出したままにしないでください。
1. GitHub Pages を無効化する
Windowsのブラウザで、リポジトリの Settings → Pages を開きます。
- 「Unpublish site」といったボタンがあれば、それを押します
- 無ければ、Source を「GitHub Actions」から外します(ブランチ公開か、無効に戻す)
画面の文言は変わります。 押すべきものが見つからないときは、「公開をやめる」意味の項目を探してください。
確認方法: シークレットウィンドウで https://your-name.github.io/react-demo/ を開きます。404 になれば消えています。
普通のウィンドウで見ないでください。 キャッシュで、消えたあとも表示され続けます。「消したのに見える」の9割はこれです。
[スクリーンショット: 06_pages無効化後.png] シークレットウィンドウで公開URLを開き、404 になっているところを撮ってください。
2. ワークフローを止める
Pages を無効化しても、push のたびにビルドは走り続けます。 ビルド時間を使うので、止めます。
VMの中で、
残しておきたい場合は、消さずに on: を変えるだけでも止まります。
on:
workflow_dispatch:
これで、push では動かず、ボタンを押したときだけ動きます。 CI/CDの回で使った workflow_dispatch と同じです。
3. リポジトリごと消す場合
Settings の一番下、Danger Zone に「Delete this repository」があります。
元に戻せません。 VMの
~/react-demo/に手元のコードが残っていることを確認してから消してください。ls ~/react-demo/src
消さなくても構いません。 課金されるものは1つもありません。
4. 手元は元に戻さない
vite.config.js の base は、消しても残しても構いません。
残す場合: npm run dev のURLが /react-demo/ 付きになります。それだけです。
消す場合: VMの中で base の行を消して npm run build すれば元通りです。
まとめ
- 「無料ホスティング」の無料は、静的ファイルを配る原価が本当に安いから。太っ腹だからではない
- 静的ファイルを配るのは安い / サーバーが動き続けるものは無料にならない。 この線引きが全部の判断の元
- ホスティングは4種類(共有 / VPS / 静的 / サーバーレス)。VMでやってきたのはVPS型で、今回選んだのは静的
- 静的ホスティングは、できることが少ない。 SSHで入れない、nginxを書けない、DBもAPIも置けない。それが無料の理由
dist/は GitHub の中で作らせる。 Gitに入れるのはソースだけhttps://ユーザー名.github.io/リポジトリ名/はサブディレクトリ。Vite のbaseを直さないとCSSが必ず404になるbaseの末尾のスラッシュを忘れない。'/react-demo/'import.meta.env.BASE_URLを使えば、サブパスを2箇所に手書きしなくて済む- https は何もしなくても付く。 ただし証明書は共用のワイルドカード証明書
- SPAの直リンク404は、
404.htmlにindex.htmlを複製して回避する。nginx のtry_filesの代わり - Netlify / Vercel の違いは、ビルド代行・プレビューURL・サーバーレス関数の3つ
- 先に Actions を自分で書いておくと、「勝手にやってくれる」の中身が分かる
- 無料が終わるのは、転送量・ビルド時間・商用利用。CPUやメモリではない
- 具体的な金額と条件は、必ず公式の料金ページで確認する。 変わるため
- 無料プランは超えると「止まる」。 従量課金のように請求が増え続けることはない
- 静的ホスティングにサーバーは無い。 APIが要るなら、置き場所を別に決める必要がある
- フロントとAPIのドメインが分かれたら、CORS が出る
- 独自ドメインは、サブドメインなら CNAME、トップなら A / AAAA。 DNSを先に反映させてから登録する
- このサイト(WordPress)は移さない。 用途が違う。道具が増えても、全部を寄せない
参考リンク
- GitHub Pages(公式)
- GitHub Pages ドキュメント
- GitHub Pages について(できること・制限)
- カスタムドメインの設定(GitHub 公式)
- actions/deploy-pages
- actions/upload-pages-artifact
- GitHub の料金プラン
- Vite — 静的サイトのデプロイ
- Vite —
baseオプション - Netlify
- Netlify の料金
- Netlify Functions ドキュメント
- Vercel
- Vercel の料金
- Vercel Functions ドキュメント
- Cloudflare Pages
- Cloudflare Pages の制限
- roadmap.sh — DevOps
次に読む
この記事は 【第7段階】公開する の 7 / 10 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | メールが迷惑メールになる理由 — DNSレコードを読む |
| → 次の記事 | AWSとVPSは値段が10倍違う — クラウドの選び方 |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント