静的サイトは本当に無料で出せる — GitHub Pages

GitHub Pagesで公開する。Webページのファイルと公開されたブラウザ、クラウドへの矢印。

※本記事はアフィリエイト広告(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を別の場所に置く判断が必ず要ること

この記事でやること

  1. 「無料」の線引きを先に決める(何が安くて、何は安くならないのか)
  2. ~/react-demo/ を GitHub に上げ、Actions で dist/ を GitHub Pages に出す
  3. CSSが404になるのをわざと起こして、base の設定で直す
  4. https が自動で付いていることをブラウザで確認する
  5. 公開したページを消す(Pages を無効化して、外から見えないことを確認する)

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
ホスティング自分が作ったものを、他人が見られる場所に置いて動かし続けてもらうこと。「レンタルサーバー」も「クラウド」も、やっていることはこれ
静的ファイル誰がいつ取りに来ても、まったく同じ中身が返るファイル。HTML・CSS・JS・画像。dist/ の中身がまさにこれ
動的取りに来た人や時刻によって、返す中身が変わること。DBを引いたり、ログイン状態で出し分けたりするもの
静的ホスティング静的ファイルを置くことしかできない代わりに、極端に安い(多くは無料)置き場所
GitHub PagesGitHub が用意している静的ホスティング。リポジトリの中身、またはActionsが作った成果物を、そのまま公開できる
サブディレクトリhttps://example.com/foo/ のように、サイトのルートではなく1段下に置かれている状態。今回の最大の落とし穴
baseVite の設定項目。「このサイトはどのパスの下に置かれるか」をビルド時に教えるもの
サーバーレス関数リクエストが来た瞬間だけ起動して、返したら消えるプログラム。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の中で、

bash
$ cd ~/react-demo
$ ls
$ npm run build
$ ls dist/

dist/ に index.html と assets/ ができれば準備完了です。ビルドツールの回でやったとおり、dist/ はただの静的ファイルの束です。

この束を、他人が取りに来られる場所に置く。 それが今回やることの全部です。

Git の状態を確認する

VMの中で、

bash
$ cd ~/react-demo
$ git status

「fatal: not a git repository」と出た場合は、まだリポジトリになっていません。GitHubの回と同じ手順でリポジトリにします。

bash
$ cd ~/react-demo
$ git init -b main
$ git add .
$ git commit -m "React demo の初回コミット"

.gitignore を必ず確認してください。

bash
$ cat .gitignore

node_modules と dist が入っていることを確認します。ビルドツールの回で書いたとおり、この2つはGitに入れません。 今回は特に重要です。dist/ は GitHub の中で作らせるので、手元のものを上げる必要がありません。

もし git status に node_modules/ が大量に出ているなら、.gitignore に足してから、

bash
$ git rm -r --cached node_modules dist
$ git add .gitignore
$ git commit -m "node_modules と dist を追跡から外す"

GitHub にリポジトリを作って push する

Windowsのブラウザで GitHub を開き、新しいリポジトリを react-demo という名前で作ります。

リポジトリ名が、そのままURLの一部になります。 https://ユーザー名.github.io/react-demo/ です。あとで変えると全部やり直しになるので、ここで決めてください。

公開範囲について、先に判断が要ります。

Public(公開)Private(非公開)
コードが読めるか世界中の誰でも読める自分だけ
GitHub Pages を無料で使えるか使える無料プランでは使えないことがある。公式で確認

個人の学習用なら Public で構いません。 ただしPublicにする前に、必ず確認してください。

bash
$ cd ~/react-demo
$ git log --oneline
$ grep -rn "password\|secret\|api_key\|API_KEY" --include="*.js" --include="*.jsx" --include="*.json" src/ 2>/dev/null

一度 push したものは、消しても履歴に残ります。 Secrets の回で書いたとおり、.env や APIキーが1回でも入ったら、そのキーは失効させるしかありません。 「あとで消せばいい」は通用しません。

問題なければ、VMの中で、

bash
$ git remote add origin git@github.com:your-name/react-demo.git
$ git push -u origin main

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つです。

  1. dist/ は毎回全部が差分になります。 minify されているので、履歴が読めないゴミで埋まります
  2. 「手元でビルドしたものを上げる」は、手順を忘れます。 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の中で、

bash
$ cd ~/react-demo
$ mkdir -p .github/workflows
$ nano .github/workflows/deploy-pages.yml

中身はこれです。

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の中で、

bash
$ git add .github/workflows/deploy-pages.yml
$ git commit -m "GitHub Pages へのデプロイを追加"
$ git push

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の中で見てみます。

bash
$ cat ~/react-demo/dist/index.html
<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 を開きます。無ければ作ります。

bash
$ cd ~/react-demo
$ cat 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 を見ます。

bash
$ npm run build
$ cat dist/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 します。

bash
$ git add vite.config.js
$ git commit -m "GitHub Pages のサブパスに合わせて base を設定"
$ git 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 PagesNetlify / 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つあります。

  1. しょっちゅう変わります。 記事を書いた時点の値を信じて計画を立てると、外れます
  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(サブドメイン)CNAMEyour-name.github.io という名前を指す
example.com(トップ)A / AAAAサービス側が公開しているIPアドレスを指す

なぜトップだけ A レコードなのか。 DNSの回で書いたとおり、ドメインのトップには CNAME を置けないからです。 CNAME は「この名前は別名です」という意味なので、同じ名前に他のレコード(MX など)を同居させられません。 メールのMXレコードが必ずトップに要るので、トップにCNAMEを置くと、メールが死にます。 だからトップはIPを直接書きます。

触る場所は3箇所です。

  1. ドメインを買った会社の管理画面 … DNSレコードを足す
  2. ホスティング側の設定画面 … 「このドメインを使う」と登録する
  3. 証明書 … 多くの場合、自動で発行されます。 登録後しばらく待つ

順番を間違えると、証明書の発行に失敗します。 DNSを先に反映させてから、ホスティング側に登録してください。逆にすると、向こうが所有確認できずに弾かれます。

反映を確認する方法は、DNSの回でやったとおりです。 VMの中で、

bash
$ dig +short demo.example.com CNAME
$ dig +short example.com A

期待した値が返ってから、次に進んでください。

ドメインを取るなら、取得先によっては小さな置き場が付いてくるものもあります。スタードメインは .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の中で、

bash
$ cd ~/react-demo
$ git rm .github/workflows/deploy-pages.yml
$ git commit -m "Pages へのデプロイを停止"
$ git push

残しておきたい場合は、消さずに 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)は移さない。 用途が違う。道具が増えても、全部を寄せない

参考リンク


次に読む

この記事は 【第7段階】公開する の 7 / 10 本目です。

記事
← 前の記事メールが迷惑メールになる理由 — DNSレコードを読む
→ 次の記事AWSとVPSは値段が10倍違う — クラウドの選び方

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend/DevOps›Deployment / Hosting
  • GitHub Pages / Netlify / Vercel — 静的サイトを無料で出す
  • ホスティングの4分類と、無料が終わる場所

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次