独自ドメインを設定する
公開したプロジェクトは、https://{サブドメイン}.monjiro.io で閲覧できます。独自ドメインを設定すると、https://docs.example.com のように、お持ちのドメインで公開ページを配信できます。HTTPS の証明書は自動で発行・更新されるため、ご用意いただく必要はありません。
独自ドメインを設定できるのは、組織のオーナーと管理者です。料金は利用プランをご覧ください。GitHub と連携した OSS プロジェクトは、Free プランでも設定できます(OSS プロジェクト(GitHub 連携))。
利用できるドメイン
- docs.example.com や help.example.co.jp のような、お持ちのドメインのサブドメインを利用できます。
- example.com のようなルートドメイン(サブドメインのないドメイン)は利用できません。ルートドメインでも公開したい場合は、www.example.com を独自ドメインとして設定し、ルートドメインからは、ドメインを購入したサービスの転送機能で www.example.com に転送してください。
- 1つのプロジェクトに設定できる独自ドメインは1つです。同じドメインを、ほかのプロジェクトで使用することはできません。
設定する
証明書を発行するには、事前にドメインが問次郎を向いている必要があります。画面の手順に沿って、CNAME レコードを追加してから登録します。
- プロジェクトの設定の画面を開き、左のメニューで「公開とアクセス」を選びます。プロジェクトの設定の画面は、編集画面の上のバーにある歯車のボタン、またはダッシュボードの「プロジェクトの設定」から開きます。
- 「独自ドメイン」にある「設定する」を押します。
- 使用するドメイン(例:docs.example.com)を入力して「次へ」を押します。
- 表示された CNAME レコードを、お使いの DNS に追加します。
| 項目 | 設定する値 |
|---|---|
| 種類 | CNAME |
| 名前(ホスト名) | 使用するドメイン(例:docs.example.com。サービスによっては docs の部分のみを入力します) |
| 値(向け先) | 画面に表示される値(xxxx.cloudfront.net の形式) |
- DNS の設定が反映されるのを待ってから(多くの場合は数分から数十分)、「確認して登録」を押します。まだ反映されていない場合は、「CNAME レコードが、まだ問次郎を向いていません」と表示されます。しばらく待ってから、再度押してください。
- 登録すると「完了」が表示され、証明書の発行が始まります。状態が「有効」になるまで、数分から数時間かかることがあります。状態は「公開とアクセス」の「独自ドメイン」の欄に表示され、変わるまで自動で更新されます。
CNAME レコードは、ドメインを購入したサービス(お名前.com、ムームードメイン、Amazon Route 53、Cloudflare など)の DNS の設定画面で追加します。
CNAME レコードのプロキシを無効(「DNS のみ」)にしてください。プロキシが有効な場合、DNS が問次郎を向いていることを確認できず、登録できません。
状態について
- 確認中: 証明書の発行を待っています。CNAME レコードは削除せずに、しばらくお待ちください。
- 有効: 独自ドメインで公開ページを配信しています。
- 失敗: 証明書を発行できませんでした(CNAME レコードを途中で削除・変更したなど)。理由が画面に表示されます。独自ドメインを外し、CNAME レコードを確認してから、登録し直してください。
独自ドメインが有効になったあとも、https://{サブドメイン}.monjiro.io の URL で引き続き閲覧できます。
独自ドメインを外す
プロジェクトの設定の「公開とアクセス」の「独自ドメイン」にある「独自ドメインを外す」を押し、確認の「本当に外す」を押します。外すと、すぐに独自ドメインでは閲覧できなくなります。追加した CNAME レコードは、外したあとに削除して問題ありません。
ほかの設定との関係
- プランの変更: Starter 以上のプランから Free に変更すると、独自ドメインでは閲覧できなくなります(https://{サブドメイン}.monjiro.io では引き続き閲覧できます)。独自ドメインの設定は残るため、プランを戻せば、再び利用できるようになります。OSS プロジェクトは、Free プランでも独自ドメインで閲覧できます。
よくある質問
現在別のサイトで使用しているサブドメインを、そのまま切り替えられますか?
はい。ただし、CNAME レコードを問次郎に向けてから証明書が発行されるまで(数分程度)、HTTPS で開けない時間が発生します。利用者の少ない時間帯に切り替えることをおすすめします。
「CNAME レコードが、まだ問次郎を向いていません」と表示されて登録できません。
CNAME レコードの値が、画面に表示されている値と一致しているかをご確認ください。DNS の設定の反映には時間がかかることがあります(多くの場合は数分から数十分、まれに 24〜48 時間)。反映されてから、再度「確認して登録」を押してください。設定の途中で画面を閉じても、再度「設定する」から同じドメインを入力すれば続けられます。
なかなか「有効」になりません。
CNAME レコードを削除・変更していないかをご確認ください。ステータスが「失敗」になった場合は、一度設定を解除してから5分ほど待ち、最初から登録し直してください。