すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:カスタムドメイン名の使用 (Node.js SDK)

最終更新日:Nov 30, 2025

CNAME レコードを追加してカスタムドメイン名を特定のバケットにマッピングすると、そのドメイン名を使用して OSS リソースにアクセスできます。このトピックでは、カスタムドメイン名の使用方法について説明します。

カスタムドメイン名のマッピング

たとえば、カスタムドメイン名が example.com で、以前は http://img.example.com/x.jpg のような URL フォーマットですべてのイメージにアクセスしていた場合、リソースを OSS に移行した後にカスタムドメイン名をマッピングできます。これにより、元のアドレスを使用して引き続きイメージにアクセスできます。詳細については、「カスタムドメイン名を使用した OSS へのアクセス」をご参照ください。

カスタムドメイン名の使用

SDK でカスタムドメイン名をエンドポイントとして使用するには、cname パラメーターを true に設定します。

const OSS = require('ali-oss')

const client = new OSS({
  // カスタムドメイン名をエンドポイントとして使用します。
  endpoint: 'http://img.example.com', 
  // 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // yourRegion をバケットが配置されているリージョンに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。
  region: 'yourRegion',
  cname: true
});
重要

カスタムドメイン名は特定のバケットにマッピングされます。したがって、カスタムドメイン名をエンドポイントとして使用する場合、`list_buckets` 操作は使用できません。