Webアプリのデプロイ手順|公開先・独自ドメイン・DNS・HTTPSの基本
自分のパソコンでは動くWebアプリも、ほかの人に使ってもらうには公開環境の準備が必要です。「どこに配置すればよいか」「独自ドメインは必要か」「公開すると動かないのはなぜか」と迷うこともあるでしょう。
公開までの基本的な流れは、アプリの構成を確認し、対応する環境へデプロイして動作を確かめ、必要に応じて独自ドメインを設定することです。この記事では、公開先の選び方と、DNS・HTTPS・エラー確認のポイントを整理します。
目次
1.デプロイ・ホスティング・ドメイン・URLの違い
デプロイとは、アプリや設定を、実行・配信する環境へ配置して利用できる状態にすることです。本番公開だけでなく、動作確認用の環境へ配置する場合にも使われる言葉です。
ホスティングは、アプリやファイルを実行・配信する環境の提供を指します。一方、ドメイン名とURLは、その環境へアクセスする際に使う名前やアドレスです。
| 用語 | 主な役割 | 例 |
|---|---|---|
| デプロイ | アプリや設定を対象環境へ反映する | 修正したアプリを本番環境へ配置する |
| ホスティング | ファイルの配信やアプリの実行環境を提供する | 静的サイトの配信サービス |
| ドメイン名 | インターネット上で使う名前 | example.com |
| URL | アクセスするリソースを示すアドレス | https://example.com/study/ |
| DNS | 名前に対応するIPアドレスなどの情報を調べる仕組み | ドメイン名から接続先を調べる |
例えば、https://example.com/study/では、httpsが通信方式を示すスキーム、example.comがホスト名、/study/がパスです。DNSにページごとのパスを登録するわけではありません。
独自ドメインは公開の必須条件ではありません。ホスティングサービスから提供されるURLで先に動作を確認し、運用上の必要に応じて独自ドメインを追加できます。
2.静的サイトか、サーバー処理が必要なアプリかを確認する
公開先を選ぶ前に、アプリがどこで処理を行うかを整理します。HTML・CSS・JavaScriptを配信すれば動くものと、サーバー側でプログラムを実行するものでは、必要な環境が異なります。
| 構成 | 例 | 公開先に必要なもの |
|---|---|---|
| 静的ファイルを配信するサイト | 紹介ページ、ブラウザ内で動く計算ツール | HTML・CSS・JavaScriptなどの配信機能 |
| サーバー側で処理するアプリ | Djangoによるログイン・データ保存 | 対応する実行環境、起動設定、必要に応じたデータベース |
| フロントエンドとAPIを分ける構成 | 画面から別サービスのAPIへ通信するアプリ | 画面の配信先、APIの実行先、通信・認証の設定 |
静的サイトでも、ブラウザでJavaScriptを実行して画面を変化させることはできます。「静的」とは、画面が動かないという意味ではありません。ただし、秘密のAPIキーを使う処理や、利用者ごとの権限確認などは、別のサーバー側の仕組みが必要になります。
例えば、GitHub Pagesは静的サイトのホスティングサービスです。PythonやPHPのファイルを置いても、サーバー側のプログラムとして実行されるわけではありません。
また、Next.jsなどのフレームワークは、使う機能によって公開方法が変わります。静的に書き出せる構成と、リクエスト時のサーバー処理が必要な構成を区別し、対応するデプロイ方法を選んでください。
サービス名より先に、必要な条件を整理する
- 使っている言語・フレームワークを実行できるか。
- データベースやアップロードファイルを継続して保存できるか。
- ビルド方法、起動方法、公開するフォルダーを設定できるか。
- 環境変数や秘密情報を適切に管理できるか。
- 料金、利用上限、休止条件、用途の制限が運用に合うか。
同じサービスでも、静的配信、サーバー実行、データ保存で機能や料金が分かれる場合があります。無料枠の有無だけで決めず、実際に使う構成の条件を公式資料で確認しましょう。
3.まずは提供URLでデプロイと動作確認を行う
独自ドメインを設定する前に、ホスティングサービスの提供URLでアプリを動かします。この段階で表示やAPI通信を確認すると、アプリの問題とドメイン設定の問題を分けて調べやすくなります。
| 手順 | 確認すること |
|---|---|
| 1.公開対象を選ぶ | リポジトリ、ブランチ、対象フォルダー |
| 2.構築方法を設定する | 依存関係の導入、ビルドコマンド、成果物の出力先 |
| 3.実行環境を設定する | 必要な場合は起動コマンド、環境変数、データベース接続 |
| 4.デプロイする | ビルドや起動のログにエラーがないか |
| 5.提供URLで確認する | 画面、画像、リンク、フォーム、API、保存処理 |
ローカルで動いたからといって、本番環境でも同じ条件になるとは限りません。言語やライブラリのバージョン、ファイル名の大文字・小文字、接続先、保存先などの違いを確認してください。
例:HTML・CSSだけのサイトをGitHub Pagesで公開する
次は、ビルド不要のHTML・CSSで作った学習用サイトを公開する例です。機密情報を含まない公開用リポジトリを用意し、その直下にindex.htmlと必要な画像・CSSを配置します。
- 対象リポジトリの「Settings」→「Pages」を開きます。
- 「Build and deployment」の「Source」で「Deploy from a branch」を選びます。
- ファイルを置いたブランチと、公開元の「/(root)」を選んで保存します。
- 「Actions」などで公開処理の結果を確認します。
- 「Pages」に表示される公開URLを開き、画像やリンクも確認します。
リポジトリ単位のサイトでは、URLにリポジトリ名が含まれる場合があります。CSSや画像のパスをサイトの最上位から指定していると、想定と異なる場所を参照することがあるため、公開URLで確認しましょう。
フレームワークのビルドが必要な場合は、上記の手順をそのまま当てはめず、対応するGitHub Actionsの設定などを使います。ソースコードの保存先と、配信するビルド成果物の場所を区別してください。
4.環境変数に入れれば、秘密情報になるとは限らない
データベースの接続情報や秘密のAPIキーは、公開リポジトリやブラウザへ配信するコードに含めません。サーバー側で必要な値は、デプロイ先の環境変数やシークレット管理機能から渡します。
ただし、環境変数に入れた値がすべて秘密として扱われるわけではありません。フロントエンドのビルド時に読み込まれ、配信するJavaScriptへ埋め込まれる値もあります。
例えば、Viteでは、既定でVITE_から始まる環境変数をクライアント側のコードから利用できます。ここに秘密のAPIキーを入れると公開され得るため、秘密情報を使う処理はバックエンドなどで行ってください。
本番環境では、APIの接続先に開発用のlocalhostが残っていないかも確認します。ブラウザ内のコードから参照するlocalhostは、通常、そのブラウザを動かしている利用者の端末を指します。
AIを使うアプリを公開する場合も、APIキーの保管場所と利用者の権限確認が必要です。OpenAI APIを例に、開発と運用の基本を整理しています。
OpenAI APIの使い方|Pythonで始める開発手順と料金・セキュリティの基本 記事を読む →5.独自ドメインは、ホスティング側とDNS側の両方を設定する
独自ドメインを使う場合は、ドメインを取得したうえで、ホスティング側に利用する名前を登録し、指定されたDNSレコードを設定します。画面の操作順や必要なレコードは、サービスの公式手順に従ってください。
例えば、example.comとwww.example.comは異なるホスト名です。どちらを主なURLとして使うかを決め、両方からアクセスできるようにするなら、両方の設定と転送方法を確認します。
A・AAAA・CNAMEレコードの違い
| 種類 | 主な役割 | 設定時の注意 |
|---|---|---|
| A | 名前をIPv4アドレスに対応させる | ホスティング側が指定する公開用の値を使う |
| AAAA | 名前をIPv6アドレスに対応させる | 利用先の案内に従い、古い設定との競合も確認する |
| CNAME | 名前を別の名前の別名として設定する | 通常はホスト名を指定し、https://やパスは含めない |
| TXT | 文字列の情報を登録する | ドメイン所有確認などで指定された値を登録する場合がある |
192.168.0.1などはプライベートネットワーク用のアドレスです。一般公開するホスティング先の例として、そのまま設定する値ではありません。IPアドレスやホスト名は、利用先から指定されたものを使います。
CNAMEは、ブラウザの表示URLを別のURLへ変更する仕組みではありません。wwwあり・なしのURLを統一するには、DNS設定とは別に、ホスティング側などでHTTPリダイレクトを設定します。
DNSレコードの編集と、ネームサーバーの変更を区別する
DNSレコードを編集することと、ドメインのDNS情報を管理するネームサーバーを変更することは別の作業です。ドメインを購入した会社とは別のサービスでDNSを管理している場合もあります。
現在どこでDNSを管理しているかを確認し、実際に使われている設定を編集してください。ネームサーバーを切り替える場合は、メールに使うMXレコードなど、既存の設定も引き継ぐ必要があります。
反映されない場合は、設定とキャッシュを確認する
DNSの変更後も、問い合わせ先に古い情報がキャッシュされていると、しばらく以前の接続先が使われる場合があります。TTLは、その情報をキャッシュできる時間に関わる設定です。
ただし、「つながらないのは反映待ち」と決めつけないでください。編集したDNSの管理先、名前、レコードの種類、値を確認し、ホスティング側のドメイン検証結果も調べましょう。一定時間待てば必ず直るわけではありません。
6.HTTPSを設定し、通信とアプリの動作を確認する
HTTPSは、TLSを使って通信を保護する仕組みです。公開するドメインに対応した証明書を用意し、ブラウザに証明書の警告が出ない状態でアクセスできるかを確認します。
ホスティング側が証明書の発行・更新を管理する場合もありますが、DNS設定や所有確認が正しくないと発行できないことがあります。独自ドメインを追加しただけで完了とせず、管理画面の状態を確認してください。
ページ本体がHTTPSでも、画像やスクリプト、APIの接続先にHTTPが残っていると、混在コンテンツの問題が起こる場合があります。ブラウザの開発者ツールで、読み込みに失敗している通信を確認しましょう。
また、HTTPSはログイン機能やアクセス権限の確認を代わりに行うものではありません。個人データや管理画面を扱うアプリでは、認証・権限・入力確認などの実装も必要です。
7.公開後に動かないときは、症状から切り分ける
公開後の不具合は、デプロイ、DNS、証明書、アプリの設定など、複数の場所で発生します。すべてを同時に変更せず、まず何が成功し、何が失敗しているかを整理しましょう。
| 症状 | 最初に確認すること |
|---|---|
| デプロイが失敗する | ビルドログ、依存関係、実行バージョン、設定コマンド |
| 提供URLでも表示されない | アプリの起動、公開フォルダー、入口となるファイル |
| 提供URLは動くが独自ドメインは動かない | DNS、ホスティング側のドメイン登録、証明書 |
| 画像やCSSだけ表示されない | ファイルの配置、パス、大文字・小文字、公開時の基準パス |
| 下層ページを再読み込みすると404になる | ルーティング方式と、公開先の書き換え設定 |
| 画面は開くがAPI通信に失敗する | APIのURL、応答状態、認証情報、CORS設定 |
| 保存したデータが再デプロイ後に消える | 一時的なファイル領域を使っていないか、永続保存先の設定 |
CORSは、APIの認証機能ではない
CORSは、別のオリジンへの通信について、ブラウザがレスポンスをスクリプトに公開してよいかを判断するための仕組みです。オリジンは、スキーム・ホスト・ポートの組み合わせで区別されます。
例えば、https://app.example.comからhttps://api.example.comへ通信する構成では、API側で必要なCORS設定を行います。エラーを消すためだけに、すべてのオリジンを無条件で許可しないようにしましょう。
また、CORSはAPIの利用者を認証したり、ブラウザ以外からのアクセスを防いだりする仕組みではありません。利用者の認証や権限確認は、API側で別に実装します。
公開時のエラーをAIに修正してもらう場合も、変更範囲と根拠の確認が必要です。コードを採用する前のレビュー手順を紹介しています。
AI生成コードのレビュー方法|仕様・テスト・保守性を確認する実践手順 記事を読む →8.更新・再デプロイ・復旧の方法を決めておく
コードを更新したとき、自動でデプロイされるかどうかは、公開元のブランチやワークフローの設定によって異なります。「GitHubへ保存すれば必ず公開される」とは考えず、対象の設定と実行結果を確認してください。
更新後は、トップページだけでなく、ログイン、入力、保存など主要な操作を試します。どの変更を公開したか、問題が起きた場合にどの状態へ戻すかも分かるようにしておきましょう。
データベースの構造を変える更新では、コードを戻すだけでは復旧できない場合があります。バックアップと復元方法を確認し、データ変更とアプリ更新の順序を検討してください。
- 公開した変更と、確認した動作を記録する。
- エラーログと、利用量・費用の確認方法を決める。
- データの保存先と、バックアップ・復元方法を確認する。
- ドメインの更新期限と、証明書の更新状況を管理する。
- サービス停止や移転時は、不要なDNS設定も見直す。
GitHub Actionsで処理を自動実行する場合は、実行条件や秘密情報、再実行の扱いが重要です。SNS自動投稿を題材に基本を解説しています。
GitHub ActionsでSNS自動投稿する方法|定期実行・Secrets・重複投稿対策 記事を読む →9.Webアプリの公開に関するよくある質問
独自ドメインを取得すれば、検索順位は上がりますか?
独自ドメインを取得しただけで、検索順位が上がるとは言えません。覚えやすいURLや継続的な運用に役立つ一方、検索で見つけてもらうには、内容、ページ構成、クロールできる状態なども確認する必要があります。
公開したら、すぐGoogle検索に表示されますか?
URLを開けることと、検索エンジンにインデックスされることは別です。一般向けのページなら、検索エンジンがアクセスできるか、意図しないnoindex設定がないかなどを確認しましょう。公開やサイトマップ送信だけで、登録や順位が保証されるわけではありません。
無料で公開できますか?
提供URLと無料枠で公開できるサービスもありますが、利用条件はサービスやプランによって異なります。サーバー処理、データベース、通信量、独自ドメインの更新費用などを分けて確認してください。
独自ドメインで表示されないときは、待てばよいですか?
最初に、提供URLで動くか、DNSとホスティング側の設定が一致しているかを確認します。そのうえで、キャッシュや証明書発行の待機状況を調べましょう。設定の誤りは、待つだけでは解消しません。
10.公開は、動作確認と運用まで含めて進める
Webアプリを公開するときは、まず静的配信で足りるか、サーバー側の実行環境が必要かを確認します。対応する環境へデプロイして提供URLで試し、その後、必要に応じて独自ドメインとHTTPSを設定しましょう。
公開後も、更新時の確認、エラーログ、費用、データの保存状態を管理します。最初は小さな構成で一通りの流れを経験し、確認できた範囲から機能を広げてください。
参考資料
- MDN:URLとは何か
- GitHub Docs:Creating a GitHub Pages site
- GitHub Docs:Configuring a publishing source for your GitHub Pages site
- Next.js:Static Exports
- Cloudflare:DNS record types
- Cloudflare:Time to Live(TTL)
- RFC 1918:Address Allocation for Private Internets
- Vite:Env Variables and Modes
- GitHub Docs:Securing your GitHub Pages site with HTTPS
- MDN:オリジン間リソース共有(CORS)
- Google検索セントラル:SEOスターターガイド
Learning Tools
記事を検索したい方はここから!
記事を検索
関連記事や、今の内容に近いテーマをすぐに検索できます。
例: AI / 情報Ⅰ / Python / 統計 / 資格 / 学習法