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 RailwaycustomDomains- 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".