Gerenciamento de Domínios Railway

Adicione, visualize ou remova domínios para serviços Railway.

Quando Usar

• Usuário pede para "adicionar um domínio", "gerar um domínio", "obter uma URL"
• Usuário quer adicionar um domínio customizado
• Usuário pergunta "qual é a URL do meu serviço"
• Usuário quer remover um domínio

Adicionar Domínio Railway

Gere um domínio fornecido pelo Railway (máx. 1 por serviço):

railway domain --json

Para um serviço específico:

railway domain --json --service backend

Resposta

Retorna a URL do domínio gerado. O serviço deve ter um deployment.

Adicionar Domínio Customizado

railway domain example.com --json

Resposta

Retorna os registros DNS necessários:

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

Informe ao usuário para adicionar esses registros ao seu provedor de DNS.

Ler Domínios Atuais

Use a skill railway-environment para ver domínios configurados, ou consulte diretamente:

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

Os domínios estão em config.services.<serviceId>.networking:

• serviceDomains - Domínios fornecidos pelo Railway
• customDomains - Domínios fornecidos pelo usuário

Remover Domínio

Use a skill railway-environment para remover domínios:

Remover domínio customizado

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

Remover domínio railway

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

Em seguida, use a skill railway-environment para aplicar e fazer commit da alteração.

Opções CLI

Flag	Descrição
[DOMAIN]	Domínio customizado a adicionar (omita para domínio railway)
-p, --port <PORT>	Porta para conectar
-s, --service <NAME>	Serviço de destino (padrão: vinculado)
--json	Saída em JSON

Composição

• Ler domínios: Use a skill railway-environment
• Remover domínios: Use a skill railway-environment
• Aplicar remoção: Use a skill railway-environment
• Verificar serviço: Use a skill railway-service

Tratamento de Erros

Nenhum Serviço Vinculado

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

Domínio Já Existe

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

Nenhum Deployment

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

Domínio Inválido

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