# Railway Domain

> Adicionar, visualizar ou remover domínios para serviços Railway. Use quando o usuário quer adicionar um domínio, gerar um domínio railway, verificar domínios atuais, obter a URL de um serviço ou remover um domínio.

- Skill: `artubss/railway-domain` (Agent Skill)
- Install (CLI): `npx skillmds add artubss/railway-domain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/artubss/railway-domain/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: artubss (https://skillmd.com/u/artubss)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/artubss/railway-domain

---


# 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):

```bash
railway domain --json
```

Para um serviço específico:
```bash
railway domain --json --service backend
```

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

## Adicionar Domínio Customizado

```bash
railway domain example.com --json
```

### Resposta
Retorna os registros DNS necessários:
```json
{
  "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:

```graphql
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
```json
{
  "services": {
    "<serviceId>": {
      "networking": {
        "customDomains": { "<domainId>": null }
      }
    }
  }
}
```

### Remover domínio railway
```json
{
  "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".
```