Docsbook
概要

カスタムドメインの設定

ドキュメントにdocsbook.ioではなく、独自のドメインを使用します。

必要条件: プレミアムサブスクリプション（1回限りの$29）

カスタムドメインを使用する理由#

利点#

  • 🎯 ブランディング — 独自のドメイン下のドキュメント
  • 📈 SEO — 独自のドメインへのリンクがランキングを向上
  • 🔐 信頼性 — 訪問者は他者のドメインではなく、あなた自身のドメインを確認
  • 💼 プロフェッショナリズム — 独自の製品に見える

例#

❌ Without domain:
docsbook.io/mycompany/product

✅ With domain:
docs.mycompany.com

要件#

  1. 独自のドメイン — あなたが登録したもの

    • お持ちでない場合は — GoDaddy、Namecheap、または別のレジストラで購入してください

  2. プレミアムサブスクリプション — 1回払い29ドル

  3. DNS設定へのアクセス — ドメインレジストラにて

ステップ1：設定を開く#

  1. ログインした状態でドキュメントを表示します
  2. 右下のFloat Widgetをクリックします
  3. 設定を開きます

ステップ 2: ドメインを入力#

カスタムドメイン セクションで:

  1. ドメインを入力します (例: docs.example.com)
  2. 保存 をクリックします

Docsbook は DNS 設定を生成します。

ステップ3：DNSの更新#

Docsbookから指示が提供されます：

Add a CNAME record:
Type:  CNAME
Name:  docs (or @)
Value: cname.vercel-dns.com

どこでDNSを変更しますか？#

ドメイン登録者のコントロールパネルを開きます:

GoDaddy#

  1. godaddy.comを開く → ログイン
  2. My Domains → ドメインを選択 → DNS
  3. DNSの横にある「Add」をクリック
  4. 次のように入力します:
    • Type: CNAME
    • Name: docs
    • Points to: cname.vercel-dns.com
  5. 保存

Namecheap#

  1. namecheap.comを開く → ログイン
  2. Domain List → Manage
  3. Advanced DNS
  4. 新しいレコードを追加:
    • Type: CNAME
    • Host: docs
    • Value: cname.vercel-dns.com
    • TTL: 3600
  5. 保存

Google Domains#

  1. domains.google.comを開く
  2. ドメインを選択
  3. DNS → Custom records
  4. 新しいレコードを作成:
    • DNS Record Type: CNAME
    • Name: docs
    • Data: cname.vercel-dns.com
  5. 保存

1and1 / Ionos#

  1. ログイン → Domains
  2. ドメインを選択
  3. Manage DNS
  4. レコードを追加:
    • Type: CNAME
    • Subdomain: docs
    • Alias: cname.vercel-dns.com
  5. 保存

Using a Root Domain#

If you want example.com (without docs):

  1. Our recommendation: use docs.example.com

    • Easier to configure
    • Lets you use example.com for the project site

  2. If you still want root:

    • Some registrars don't allow CNAME on root
    • Use an A record instead of CNAME: 76.76.19.0
    • Contact support@docsbook.io for help

ステップ4：待つ#

DNSレコードを追加した後、更新が伝播されます：

  • 通常: 15-30分
  • 最大: 48時間
  • ステータス確認: DNSCheckerを使用してください

ドメインを入力 → cname.vercel-dns.com が表示されるはずです

ステップ5: SSL証明書#

DNSの伝播が完了すると、Docsbookは自動的に:

  1. あなたのドメインを検出します
  2. SSL証明書（Let's Encrypt）を作成します
  3. HTTPSを有効にします

あなたのサイトは次のURLで利用可能です:

https://docs.example.com ✅

ドメインの検証#

すべてが正常に動作しているか確認する方法？#

方法1：簡単な確認

  1. ブラウザで開く: https://your-domain.com
  2. ドキュメントがロードされるはずです

方法2：DNS確認

# In terminal
nslookup docs.example.com
# Should show: cname.vercel-dns.com

方法3：オンラインサービス

  1. mxtoolbox.comを開く
  2. CNAMEルックアップ
  3. ドメインを入力
  4. cname.vercel-dns.comが表示されるはずです

トラブルシューティング#

DNS Not Updating#

問題: 2時間以上経過したが、ドメインが機能しない

解決策:

  1. ブラウザのキャッシュをクリアする (Ctrl+Shift+Delete)
  2. プライベートブラウザウィンドウを使用する
  3. DNSCheckerでDNSを確認する
  4. CNAMEレコードが正しく追加されていることを確認する
  5. さらに24時間待つ

古いサイトが表示され続けている#

問題: DNS は更新されたが、サイトの古いバージョンが表示される

解決策:

  1. Ctrl+F5 (キャッシュの完全クリア) を押す
  2. シークレットウィンドウで開く
  3. 24 時間待つ

HTTPS Not Working#

問題: https:// に証明書エラーが表示されます

解決策:

  1. 1時間待つ — 証明書が作成中です
  2. DNSが更新されていることを確認する
  3. ドメイン名にタイプミスがないか確認する
  4. support@docsbook.io まで連絡する

ドメインが表示するVercelまたはエラー#

問題: ドメインにアクセスすると、Vercelのメッセージが表示されます

解決策:

  1. Docsbookにドメインが追加されているか確認してください (設定で確認できます)
  2. DNS CNAMEが正しいことを確認してください
  3. 同期に1〜2時間待ちます

ドメインの変更#

別のものに切り替えるにはどうすればよいですか？#

  1. 設定を開きます
  2. カスタムドメインフィールドでドメインを変更します
  3. 保存をクリックします
  4. 新しいドメインのDNSを更新します
  5. 古いドメインは機能しなくなります

ドメインの削除#

docsbook.ioに戻るには？#

  1. 設定を開きます
  2. カスタムドメインフィールドをクリアします
  3. 保存をクリックします

ドキュメントは以下に戻ります:

docsbook.io/username/repo

ベストプラクティス#

1. サブドメインを使用する#

✅ docs.example.com
✅ guide.example.com
✅ api.example.com

❌ example.com (if your main site is there)

2. ドメインについて人に知らせる#

ドキュメントへのリンクをどこでも更新してください:

  • GitHub README
  • プロジェクトウェブサイト
  • メール署名
  • ソーシャルメディア

3. メール設定 (オプション)#

ドメインを取得したので、メールを追加できます。

これはDocsbookとは別のサービスで、レジストラを通じて設定します。

4. SEO への利用#

サイトがあなたのドメイン下にあるようになったので:

  • Google Analytics を設定する
  • トラフィックを追跡する
  • 検索エンジンに送信する

次に何をするか?#

提供： Docsbook