profilebio-dashboard

Dashboard de subdominios · profilebio.me

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.

Qué hace

1. Crear el API Token de Cloudflare

  1. Entrá a https://dash.cloudflare.com/profile/api-tokens → Create Token.
  2. Usá la plantilla Edit zone DNS (Use template).
  3. En Zone Resources elegí Include → Specific zone → profilebio.me.
  4. Continue → Create token y copiá el valor (solo se muestra una vez).

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.

2. Configurar el proyecto

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.

3. Entrar y cambiar la contraseña

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.

  1. Abrí http://localhost:3000 e ingresá con admin / admin.
  2. Apenas entrás se abre solo el cuadro Cambiar contraseña. Elegí la nueva (mínimo 8 caracteres), repetila y guardá.
  3. Listo: el aviso rojo desaparece y ya podés crear y borrar subdominios.

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.

4. Correr

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.

5. CI

.github/workflows/ci.yml corre en cada push y pull request: npm ci, lint, tipos, tests, build y npm audit --omit=dev.

Rotar el token

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:

  1. https://dash.cloudflare.com/profile/api-tokens → Create Token → plantilla Edit zone DNS → zona profilebio.me.
  2. Copiá el token nuevo.
  3. En .env.local, reemplazá la línea CLOUDFLARE_API_TOKEN=... y reiniciá el servidor.
  4. npm run check:token → tiene que terminar en Todo en orden.
  5. Recién ahí, en Cloudflare, Roll/Delete el token viejo.

Si el paso 4 falla, volvé al token anterior: mientras no lo borres, sigue sirviendo.

Acceso directo en el escritorio (Windows)

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.

Deploy

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.

Cómo está armado

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)

Regla del nombre

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.

Seguridad

Auditoría completa (hallazgos, evidencia y verificación): .dev/docs/auditoria-REPORT.md.

Errores de Cloudflare que traduce

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