domain

ドメイン管理

Railway サービスのドメインを追加、表示、または削除します。

使用する場面

• ユーザーが「ドメインを追加して」「ドメインを生成して」「URLを取得して」と依頼した場合
• ユーザーがカスタムドメインを追加したい場合
• ユーザーが「自分のサービスのURLは何ですか」と尋ねた場合
• ユーザーがドメインを削除したい場合

Railway ドメインを追加する

Railway が提供するドメインを生成します（サービスごとに最大 1 つ）。

railway domain --json

特定のサービスの場合：

railway domain --json --service backend

応答

生成されたドメインの URL を返します。サービスにはデプロイが必要です。

カスタムドメインを追加する

railway domain example.com --json

応答

必要な DNS レコードを返します：

{
  "domain": "example.com",
  "dnsRecords": [
    { "type": "CNAME", "host": "@", "value": "..." }
  ]
}

これらのレコードを DNS プロバイダーに追加するよう、ユーザーに伝えてください。

現在のドメインを読み取る

environment スキルを使用して設定済みのドメインを確認するか、直接クエリします：

query domains($envId: String!) {
  environment(id: $envId) {
    config(decryptVariables: false)
  }
}

ドメインは config.services.<serviceId>.networking にあります：

• serviceDomains - Railway が提供するドメイン
• customDomains - ユーザーが指定したドメイン

ドメインを削除する

environment スキルを使用してドメインを削除します：

カスタムドメインを削除する

{
  "services": {
    "<serviceId>": {
      "networking": {
        "customDomains": { "<domainId>": null }
      }
    }
  }
}

Railway ドメインを削除する

{
  "services": {
    "<serviceId>": {
      "networking": {
        "serviceDomains": { "<domainId>": null }
      }
    }
  }
}

その後、environment スキルを使用して変更を適用し、コミットします。

CLI オプション

フラグ	説明
[DOMAIN]	追加するカスタムドメイン（Railway ドメインの場合は省略）
-p, --port <PORT>	接続するポート
-s, --service <NAME>	対象のサービス（既定ではリンク済みのサービス）
--json	JSON 出力

組み合わせて使用する方法

• ドメインを読み取る：environment スキルを使用
• ドメインを削除する：environment スキルを使用
• 削除を適用する：environment スキルを使用
• サービスを確認する：service スキルを使用

エラー処理

サービスがリンクされていない場合

No service linked. Use --service flag or run `railway service` to select one.

ドメインがすでに存在する場合

Service already has a railway-provided domain. Maximum 1 per service.

デプロイがない場合

Service has no deployment. Deploy first with `railway up`.

ドメインが無効な場合

Invalid domain format. Use a valid domain like "example.com" or "api.example.com".