問次郎

独自ドメインを設定する

公開したプロジェクトは、https://{サブドメイン}.monjiro.io で閲覧できます。独自ドメインを設定すると、https://docs.example.com のように、お持ちのドメインで公開ページを配信できます。HTTPS の証明書は自動で発行・更新されるため、ご用意いただく必要はありません。

Starter・Team・Enterprise プランでご利用いただけます

独自ドメインを設定できるのは、組織のオーナーと管理者です。料金は利用プランをご覧ください。GitHub と連携した OSS プロジェクトは、Free プランでも設定できます(OSS プロジェクト(GitHub 連携))。

利用できるドメイン

  • docs.example.com や help.example.co.jp のような、お持ちのドメインのサブドメインを利用できます。
  • example.com のようなルートドメイン(サブドメインのないドメイン)は利用できません。ルートドメインでも公開したい場合は、www.example.com を独自ドメインとして設定し、ルートドメインからは、ドメインを購入したサービスの転送機能で www.example.com に転送してください。
  • 1つのプロジェクトに設定できる独自ドメインは1つです。同じドメインを、ほかのプロジェクトで使用することはできません。

設定する

証明書を発行するには、事前にドメインが問次郎を向いている必要があります。画面の手順に沿って、CNAME レコードを追加してから登録します。

  1. プロジェクトの設定の画面を開き、左のメニューで「公開とアクセス」を選びます。プロジェクトの設定の画面は、編集画面の上のバーにある歯車のボタン、またはダッシュボードの「プロジェクトの設定」から開きます。
  2. 「独自ドメイン」にある「設定する」を押します。
プロジェクトの設定の「公開とアクセス」にある「アクセス」(すぐに反映)。「公開 URL」(https://internal.monjiro.io/)と「変更する」ボタン、「独自ドメイン」の「設定する」ボタン、「閲覧制限」の「設定する」ボタン(制限していません)、「検索エンジンに載せる」のスイッチが並んでいる。
  1. 使用するドメイン(例:docs.example.com)を入力して「次へ」を押します。
独自ドメインを設定する画面の手順1。使うドメインに docs.example.com を入力したところ
  1. 表示された CNAME レコードを、お使いの DNS に追加します。
手順2。DNS に追加する CNAME レコード(種類 CNAME、名前 docs.example.com、値 xxxx.cloudfront.net)と「確認して登録」ボタン
項目設定する値
種類CNAME
名前(ホスト名)使用するドメイン(例:docs.example.com。サービスによっては docs の部分のみを入力します)
値(向け先)画面に表示される値(xxxx.cloudfront.net の形式)
  1. DNS の設定が反映されるのを待ってから(多くの場合は数分から数十分)、「確認して登録」を押します。まだ反映されていない場合は、「CNAME レコードが、まだ問次郎を向いていません」と表示されます。しばらく待ってから、再度押してください。
  2. 登録すると「完了」が表示され、証明書の発行が始まります。状態が「有効」になるまで、数分から数時間かかることがあります。状態は「公開とアクセス」の「独自ドメイン」の欄に表示され、変わるまで自動で更新されます。
手順3。ドメインを登録し、証明書を発行していることを伝える完了の画面

CNAME レコードは、ドメインを購入したサービス(お名前.com、ムームードメイン、Amazon Route 53、Cloudflare など)の DNS の設定画面で追加します。

Cloudflare をお使いの場合

CNAME レコードのプロキシを無効(「DNS のみ」)にしてください。プロキシが有効な場合、DNS が問次郎を向いていることを確認できず、登録できません。

状態について

  • 確認中: 証明書の発行を待っています。CNAME レコードは削除せずに、しばらくお待ちください。
  • 有効: 独自ドメインで公開ページを配信しています。
  • 失敗: 証明書を発行できませんでした(CNAME レコードを途中で削除・変更したなど)。理由が画面に表示されます。独自ドメインを外し、CNAME レコードを確認してから、登録し直してください。

独自ドメインが有効になったあとも、https://{サブドメイン}.monjiro.io の URL で引き続き閲覧できます。

独自ドメインを外す

プロジェクトの設定の「公開とアクセス」の「独自ドメイン」にある「独自ドメインを外す」を押し、確認の「本当に外す」を押します。外すと、すぐに独自ドメインでは閲覧できなくなります。追加した CNAME レコードは、外したあとに削除して問題ありません。

ほかの設定との関係

  • 閲覧制限: 独自ドメインで閲覧する場合も、閲覧制限(IP 制限・メールアドレスでの制限)がそのまま適用されます。
  • プランの変更: Starter 以上のプランから Free に変更すると、独自ドメインでは閲覧できなくなります(https://{サブドメイン}.monjiro.io では引き続き閲覧できます)。独自ドメインの設定は残るため、プランを戻せば、再び利用できるようになります。OSS プロジェクトは、Free プランでも独自ドメインで閲覧できます。

よくある質問

現在別のサイトで使用しているサブドメインを、そのまま切り替えられますか?

はい。ただし、CNAME レコードを問次郎に向けてから証明書が発行されるまで(数分程度)、HTTPS で開けない時間が発生します。利用者の少ない時間帯に切り替えることをおすすめします。

「CNAME レコードが、まだ問次郎を向いていません」と表示されて登録できません。

CNAME レコードの値が、画面に表示されている値と一致しているかをご確認ください。DNS の設定の反映には時間がかかることがあります(多くの場合は数分から数十分、まれに 24〜48 時間)。反映されてから、再度「確認して登録」を押してください。設定の途中で画面を閉じても、再度「設定する」から同じドメインを入力すれば続けられます。

なかなか「有効」になりません。

CNAME レコードを削除・変更していないかをご確認ください。ステータスが「失敗」になった場合は、一度設定を解除してから5分ほど待ち、最初から登録し直してください。