Panel mínimo para crear y borrar registros CNAME en Cloudflare sobre profilebio.me.
No hace nada más: no maneja otros tipos de registro, ni zonas, ni configuración de la cuenta.
profilebio.me (incluye subdominios multi-nivel).Auto, tipo siempre CNAME.Include → Specific zone → profilebio.me.El token necesita únicamente estos permisos:
Zone → DNS → Edit (recurso: Zone · profilebio.me)
No uses el Global API Key: da acceso total a la cuenta.
cp .env.example .env.local
Completá .env.local:
| Variable | Para qué sirve |
|---|---|
ROOT_DOMAIN |
Dominio raíz. Por defecto profilebio.me. |
CLOUDFLARE_API_TOKEN |
Token del paso 1. Obligatoria. |
CLOUDFLARE_ZONE_ID |
Opcional. Si está vacío se resuelve por nombre. |
SESSION_SECRET |
Firma la cookie de sesión. Obligatoria. openssl rand -base64 32 |
ALLOW_DEFAULT_ADMIN |
1 crea la cuenta de fábrica admin / admin mientras no exista .data/auth.json. Solo local. |
DASHBOARD_PASSWORD |
Contraseña inicial. Obligatoria si desactivás ALLOW_DEFAULT_ADMIN o si el panel se publica. |
DATA_DIR |
Opcional. Dónde guardar .data/. En hosts con disco de solo lectura, apuntalo a /tmp. |
La primera vez el panel crea la cuenta admin / admin (requiere
ALLOW_DEFAULT_ADMIN=1 en .env.local) y la guarda hasheada con scrypt en
.data/auth.json, fuera de git.
Mientras siga la contraseña de fábrica el panel muestra un aviso y bloquea crear y borrar
registros (el listado sí funciona). Además, esa contraseña solo se acepta desde la propia
máquina: si el pedido llega por la red, el login responde 403. Los scripts dev y start
escuchan en 127.0.0.1, así que por defecto el panel ni siquiera es alcanzable desde la LAN.
Para cambiarla más adelante: botón Contraseña en la barra superior. Pide la actual y al guardar cierra las sesiones de otros dispositivos (la cookie lleva un número de versión).
¿Host público o Vercel? Borrá ALLOW_DEFAULT_ADMIN y definí DASHBOARD_PASSWORD. Si el
disco no es escribible, la cuenta vive en memoria a partir de esa variable (el cambio de
contraseña responde 503 y te pide cambiarla por entorno). Sin ninguna de las dos variables el
panel falla cerrado y no deja entrar a nadie.
¿Olvidaste la contraseña? Borrá .data/auth.json y reiniciá: vuelve a aparecer la cuenta
por defecto para que la cambies.
npm install
npm run dev # http://127.0.0.1:3000
Producción:
npm run verify # lint + tipos + tests + build
npm start # http://127.0.0.1:3000
| Script | Qué hace |
|---|---|
npm run dev |
Servidor de desarrollo en 127.0.0.1:3000. |
npm run build / npm start |
Build y servidor de producción. |
npm run lint |
ESLint (next/core-web-vitals + reglas de TypeScript y React). |
npm run typecheck |
tsc --noEmit. |
npm test |
62 tests con Vitest (validación, sesión, rate limit, CSRF, cliente de Cloudflare, log). |
npm run verify |
Los cuatro anteriores en orden. Es lo que corre el CI. |
npm run check:token |
Comprueba el token de Cloudflare contra la API real (zona, permisos y zone id). |
npm run format |
Prettier sobre todo el repo. |
Requiere Node ≥ 20.9 (lo exige Next 16); hay un .nvmrc con 20.
.github/workflows/ci.yml corre en cada push y pull request: npm ci, lint, tipos, tests, build
y npm audit --omit=dev.
El panel funciona con el token que ya está en .env.local; comprobalo con:
npm run check:token
Si querés reemplazarlo (por ejemplo porque el actual estuvo en un chat), son cinco pasos y no hace falta tocar código:
profilebio.me..env.local, reemplazá la línea CLOUDFLARE_API_TOKEN=... y reiniciá el servidor.npm run check:token → tiene que terminar en Todo en orden.Si el paso 4 falla, volvé al token anterior: mientras no lo borres, sigue sirviendo.
Tres piezas, para que abrir el panel sea instantáneo:
| Pieza | Qué hace |
|---|---|
| Acceso del escritorio | Apunta directo a node.exe con scripts/open-dashboard.mjs. No pasa por el intérprete de VBS (que muchas políticas de Windows bloquean). Con el servidor arriba abre el navegador en ~0,1 s. |
Acceso de Inicio (shell:startup) |
Deja el servidor corriendo al iniciar Windows, en segundo plano. |
Abrir CloudFlare Dashboard.vbs |
Alternativa sin ventana de consola, por si preferís no usar node.exe. |
El servidor usa el build de producción (next start, listo en ~1,5 s), no el servidor de
desarrollo. Si el código es más nuevo que el build (después de editar), el lanzador arranca el
servidor de desarrollo para no mostrar una versión vieja.
Crear los accesos directos (una vez):
$root = "C:\ruta\a\profilebio-dashboard"
$node = "C:\Program Files\nodejs\node.exe"
$script = Join-Path $root 'scripts\open-dashboard.mjs'
$icon = Join-Path $root 'assets\cloudflare-dashboard.ico'
$ws = New-Object -ComObject WScript.Shell
# Escritorio
$l = $ws.CreateShortcut((Join-Path ([Environment]::GetFolderPath('Desktop')) 'CloudFlare Dashboard.lnk'))
$l.TargetPath = $node
$l.Arguments = '"' + $script + '"'
$l.WorkingDirectory = $root
$l.IconLocation = $icon + ',0'
$l.WindowStyle = 7
$l.Save()
# Inicio de Windows (para que esté siempre listo)
$a = $ws.CreateShortcut((Join-Path ([Environment]::GetFolderPath('Startup')) 'CloudFlare Dashboard (servidor).lnk'))
$a.TargetPath = $node
$a.Arguments = '"' + $script + '" --serve-only'
$a.WorkingDirectory = $root
$a.IconLocation = $icon + ',0'
$a.WindowStyle = 7
$a.Save()
Cada apertura deja rastro en .data/launcher.log (y el servidor en .data/server.log), útil si
alguna vez no abre.
Para que no arranque solo con Windows, borrá el acceso de la carpeta de Inicio
(shell:startup).
El icono vive en assets/cloudflare-dashboard.ico y se regenera con
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/make-icon.ps1.
El puerto se puede cambiar con la variable DASHBOARD_PORT.
Vercel: importá el repo y cargá las variables del .env.example en
Settings → Environment Variables, sin ALLOW_DEFAULT_ADMIN y con
DASHBOARD_PASSWORD y DATA_DIR=/tmp. El disco no persiste: la cuenta se reconstruye en cada
instancia a partir de la variable.
VPS o cualquier host con Node: npm run build && npm start. Si va a estar expuesto,
ponelo detrás de HTTPS y no actives ALLOW_DEFAULT_ADMIN.
src/
├─ app/
│ ├─ page.tsx # Server component: login o dashboard
│ ├─ error.tsx # Error de render
│ ├─ global-error.tsx # Error del layout raíz
│ ├─ not-found.tsx # 404
│ ├─ icon.svg # Favicon
│ ├─ api/login/route.ts # POST usuario + contraseña → cookie firmada (HMAC)
│ ├─ api/password/route.ts # POST cambio de contraseña (sube la versión de sesión)
│ ├─ api/logout/route.ts # Borra la cookie
│ ├─ api/records/route.ts # GET listar · POST crear CNAME
│ └─ api/records/[id]/route.ts # PATCH editar · DELETE borrar (solo CNAME)
├─ components/ # LoginScreen · Dashboard · RecordsTable · EditSubdomainDialog …
└─ lib/
├─ config.ts # Env, normalización, validación y reglas de contraseña
├─ auth.ts # Sesión HMAC versionada + rate limit (cubo por IP y global)
├─ passwords.ts # scrypt, cuenta en .data, cuenta de fábrica
├─ http.ts # IP del cliente, same-origin, body con tope de 8 KB
├─ audit-log.ts # Registro de cada alta y baja de CNAME
└─ cloudflare.ts # Cliente API v4 (list / create / delete)
El campo Subdominio acepta un solo nombre, sin puntos: feria. Si pegás un hostname
completo (profilebio.github.io) el dashboard lo rechaza con un mensaje que te dice que eso
va en Destino. Así se evita el registro roto profilebio.github.io.profilebio.me.
.data/auth.json; nunca en texto plano.admin/admin solo existe si ALLOW_DEFAULT_ADMIN=1, solo se acepta
desde loopback, y mientras siga activa crear y borrar quedan bloqueados (403).httpOnly + Secure en producción + SameSite=Lax, firmada con
HMAC-SHA256 sobre versión + expiración, válida 7 días.login, password) con cubo por IP y cubo global: el intento
se consume de forma síncrona antes de verificar la contraseña, así una ráfaga concurrente
no puede saltearlo.SameSite=Lax, toda mutación exige Content-Type: application/json,
Sec-Fetch-Site de mismo origen y Origin coincidente con el host (importante porque todos
los subdominios de profilebio.me comparten site).POST limitado a 8 KB, con corte del stream.^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$), destino como hostname (sin IP, protocolo, puerto ni barra).CNAME (verifica el tipo antes del DELETE).nosniff, frame-ancestors 'none', Referrer-Policy, HSTS en producción y
Cache-Control: no-store en /api/*..data/audit.log (una línea JSON con fecha,
operación, nombre, destino, usuario e IP). Si el log no se puede escribir, la operación sigue
y solo se avisa por consola.Auditoría completa (hallazgos, evidencia y verificación): .dev/docs/auditoria-REPORT.md.
| Código Cloudflare | Mensaje en el dashboard |
|---|---|
81053 / 81057 / 81058 |
Ya existe un registro con ese nombre |
81044 |
El registro ya no existe en Cloudflare |
9109 / 9103 |
El token no tiene permiso sobre esta zona |
9005 / 1000 |
Token inválido o revocado |