カスタムドメインを設定する

hanamii のプロジェクトには、www.example.com のような独自ドメイン（カスタムドメイン）を割り当てられます。SSL 証明書（Let's Encrypt）は自動で発行されるため、証明書の購入や更新作業は不要です。

前提条件

• プロジェクトが デプロイ済み であること（未デプロイのプロジェクトには設定できません）
• 対象ドメインを所有しており、DNS レコードを編集できること
• ワークスペースの owner または admin ロールであること
• 1 プロジェクトに設定できるドメインは 1 つ です

設定の流れ

1. プロジェクト詳細の ドメイン タブを開く
2. カスタムドメインを追加 から、割り当てたいドメイン（例: www.example.com）を入力して 設定 を押す
3. 画面に表示される DNS レコードを、お使いの DNS プロバイダー（お名前.com、ムームードメイン、Cloudflare など）で設定する
4. DNS 設定が完了したら 有効化する を押す
5. SSL 証明書の発行完了を待つ（発行中は「SSL発行中」、完了すると「SSL」バッジが表示されます）

DNS レコードの設定

DNS レコードは「あなたのドメインへのアクセスを hanamii に向ける」ための設定です。

登録したドメインの形によって、設定するレコードの種類が変わります。

向き先の値はドメイン登録後に hanamii の画面に表示されます。表示された値をそのままコピーして DNS プロバイダーに設定してください。

サブドメインの場合（かんたん）

www.example.com や app.example.com のようなサブドメインであれば、どの DNS プロバイダーでも標準の CNAME レコード で設定できます。迷ったらサブドメインでの運用をおすすめします。

ルートドメインの場合（プロバイダーによる）

example.com のようなルートドメイン（apex ドメイン）には、DNS の仕様上 CNAME レコードを設定できません。代わりに ALIAS / ANAME レコード（CNAME 相当の動きをするプロバイダー独自機能）を使います。

対応状況はプロバイダーごとに異なります。

ALIAS 非対応のプロバイダーでルートドメインを使いたい場合、次のどちらかを選べます。

1. サブドメインで運用する — www.example.com を hanamii に設定し、プロバイダーの URL 転送機能で example.com から www.example.com へリダイレクトする（最も簡単）
2. DNS 運用だけ Cloudflare などに委任する — ドメインの所有はそのままに、ネームサーバーを Cloudflare（無料）に変更し、Cloudflare 側で DNS レコードを設定する

有効化と SSL 証明書の発行

DNS レコードを設定したら、hanamii の画面で 有効化する を押します。

• 「有効化に失敗しました」と表示された場合は、DNS レコードの値と反映状況を確認して再度お試しください。DNS の反映には数分〜数十分程度かかることがあります
• 有効化後、SSL 証明書（Let's Encrypt）の発行が自動で始まります。発行が完了すると「SSL証明書が発行されました」と通知され、https:// でアクセスできるようになります
• 証明書の発行完了後は、HTTP でのアクセスは自動で HTTPS にリダイレクトされます

よくある質問

Q. すでに他のサービスで稼働中のドメインを切り替えたい

稼働中のドメインの向き先を変更すると、DNS の反映が完了するまでの間、一時的にアクセスできない時間が発生する可能性があります。切り替えはアクセスの少ない時間帯に行うことをおすすめします。

Q. ドメインを外したい

ドメインタブの 削除 から削除できます。削除後は元の公開 URL でのアクセスに戻ります。再度使う場合は設定からやり直しになります。

Q. 複数のドメインを 1 つのプロジェクトに設定できますか

現在は 1 プロジェクトにつき 1 ドメインです。

Q. A レコード（固定 IP）での設定はできますか

hanamii は固定 IP を提供していないため、CNAME / ALIAS レコードでの設定のみに対応しています。