ドキュメント用のカスタムドメイン: docs.yourcompany.com の設定

docs.yourcompany.com は docsbook.io/yourorg/yourrepo よりもプロフェッショナルに見えます。SEO、信頼性、そして「これは本物の製品か」という第一印象にも影響します。正しく設定する方法は次のとおりです。

要約#

サブドメイン（docs.yourcompany.com）とサブディレクトリ（yourcompany.com/docs/）のどちらかを決定する
ドキュメントホストを指す CNAME または A レコードを DNS に追加する
SSL のプロビジョニングを待つ（通常 5 分未満）
以前の URL からのリダイレクトを設定する
内部リンクと外部からの参照を更新する

サブドメインとサブディレクトリ#

SEOに関する議論は現実のものです。2026年にはどちらも機能しますが、それぞれ異なるトレードオフがあります。

	サブドメイン (`docs.yourcompany.com`)	サブディレクトリ (`yourcompany.com/docs/`)
セットアップの複雑さ	容易（DNSレコード1つ）	困難（リバースプロキシまたは共有プラットフォーム）
SEOの権威性	主にルートドメインから継承	完全に継承
ホスティングの柔軟性	メインサイトから独立	メインサイトのインフラを共有
ブランドの一体感	明確に分離	緊密に結合
2026年に一般的か	ほとんどのドキュメントサイト	Stripe、GitHub、AWS

ほとんどのチームにとって、サブドメインのほうが簡単で、SEOの差も小さいです。メインサイトがドキュメントのリバースプロキシを適切にサポートするプラットフォーム上にある場合にのみ、サブディレクトリを選択してください。

サブドメインの設定（Docsbookの例）#

3つの手順：

1. Docsbook ダッシュボードで#

ワークスペース設定を開く
設定 → ドメイン
docs.yourcompany.com を入力
保存をクリック

ダッシュボードに、追加する必要がある DNS レコードが表示されます。

2. DNSプロバイダーで#

CNAMEレコードを追加します：

Type:  CNAME
Name:  docs
Value: cname.vercel-dns.com
TTL:   300 (or default)

DNSプロバイダーがルートでのCNAMEをサポートしていない場合（CloudflareのCNAMEフラット化など）、ご利用のプラットフォームが提供するAレコードの代替手段を使用してください。

3. SSL#

SSLは自動的に設定されます。Docsbook（Vercel経由）により、5分以内にLet's Encryptの証明書が発行されます。ダッシュボードに「Active」ステータスが表示されます。

合計所要時間：DNSの伝播を含め、通常5～15分です。

SSL に時間がかかる場合#

SSL が 30 分経過しても「保留中」のままの場合：

DNS がグローバルに伝播していることを確認します：dig docs.yourcompany.com が CNAME ターゲットに解決される必要があります
Let's Encrypt をブロックする CAA レコードを削除します
ドメインがすでに別のプロバイダーから HTTPS を提供していないことを確認します

リダイレクト#

以前、別の URL でドキュメントをホスティングしていた場合は、SEO を維持するために 301 リダイレクトを設定してください。

docsサブディレクトリから新しいサブドメインへ#

yourcompany.com/docs/* → docs.yourcompany.com/* (301)

ほとんどのプラットフォームでは、リダイレクトルールを使用してこれを実現できます。

GitBook の v パスから Docsbook へ#

GitBook の URL には通常、/v/1.0/ パターンが使用されます：

docs.yourcompany.com/v/1.0/api/auth → docs.yourcompany.com/api/auth (301)

ドメインの前段で Cloudflare を使用している場合は、1 つのページルールでこれを実行できます。詳しくはGitBook から Docsbook への移行をご覧ください。

Docusaurus のプレフィックスからルートへ#

Docusaurus は /docs/intro パスをよく使用します。ルートにフラット化する場合:

docs.yourcompany.com/docs/* → docs.yourcompany.com/* (301)

Docusaurus から Docsbook への移行を参照してください。

SEO に関する考慮事項#

切り替え後に確認すべき3つの事項：

Search Console#

新しいドメインを Google Search Console に追加します。サイトマップを送信します（Docsbook が /sitemap.xml を自動生成します）。4～6週間、インデックス登録レポートを確認します。

正規タグ#

何らかの理由で古い URL を代替として引き続き有効にしておく場合は、古い URL に新しい URL を指す正規タグを設定します。それでも、301 リダイレクトの方が優れています。読者だけでなく、ランキングシグナルも移行できるためです。

`llms.txt` 伝播#

ドメインを移行すると、AIエージェントはllms.txtを再発見する必要があります。通常は数回のクロールで再発見されます。確認してください：

curl https://docs.yourcompany.com/llms.txt | head -10

llms.txtの完全ガイドをご覧ください。

ユーザーにとっての変更点#

古いURLへのブックマーク：リダイレクトで対応
保存済みのサポート返信：更新が必要
内部の製品リンク：更新が必要
外部からのバックリンク：そのまま（301リダイレクトにより評価が引き継がれる）

URL以外のユーザーに表示される部分は変更されません。

プラットフォーム別カスタムドメイン対応#

プラットフォーム	カスタムドメイン対応	費用
Docsbook	はい、自動SSL付き	無料 — ドメインによってプロジェクト残高が消費されることはありません。docsbook.io/pricingを参照してください
Mintlify	はい	有料プランで利用可能 — mintlify.com/pricingを参照してください
GitBook	はい	有料プランで利用可能 — gitbook.com/pricingを参照してください
ReadMe	はい	有料プランで利用可能 — readme.com/pricingを参照してください
GitHub Pages	はい	無料
Vercel / Netlify	はい	無料ティア（アカウントごとにドメイン数の上限あり）

このカテゴリの料金は変動するため、各ベンダーの料金ページが唯一信頼できる情報源です。古くなった数字を再掲するのではなく、この表からすべての料金ページにリンクしています。

よくある間違い#

apexドメインをCNAMEに指定する — ほとんどのDNSプロバイダーではこれを許可していません。サブドメイン（docs.）またはフラット化されたAレコードを使用してください
リダイレクトを忘れる — 古いURLが404になる → SEO評価が下がる → オーソリティを失う
HTTPSが強制されていない — HTTPとHTTPSの両方を提供するプラットフォームがあります。HTTPSへ強制的にリダイレクトしてください
複数のdocsサブドメイン — 一度に設定できるCNAMEは1つだけです。まず古いものを削除してください

Docsbook は自動 SSL 付きで docs.yourcompany.com を提供し、ドメイン料金がプロジェクト残高から差し引かれることはありません。

無料で始める — クレジットカード不要

Updated Sep 3, 2026