Introducción

OPanel es un panel de control de hosting para Debian. Permite operar un negocio de hosting completo en un solo servidor y, al sumar más servidores, estos forman un clúster que clientes y personal del proveedor tratan como si fuera una sola máquina.

Si conocés cPanel, WHM y WHMCS, la forma más rápida de ubicar a OPanel es por comparación:

Si conocés…	El equivalente en OPanel es…
WHM (el lado del operador)	La consola de operador: servidores, planes, clientes, suscripciones y facturación, para tu equipo
cPanel (el lado del cliente)	El portal de cliente: sitios, dominios, bases de datos, archivos, SSH y backups, para tus clientes
WHMCS / Blesta / HostBill	Tienda y facturación integradas: Stripe Checkout, facturas, gestión de impagos y suspensión — o conectá un sistema externo de estos mismos a través de la API

A diferencia de cPanel/WHM, las tres piezas viven en un mismo código y una misma API: la consola de operador y el portal de cliente son dos vistas de los mismos datos, y todo lo que puede hacer cualquiera de las dos interfaces, también puede hacerlo un script, a través de una API documentada y versionada.

El modelo de conceptos

Todo en OPanel cuelga de una misma cadena de pertenencia:

Platform (tu instalación)
 └─ Brand (la tuya, o la marca blanca de un revendedor)
     └─ Customer (una persona, empresa o agencia — la entidad de facturación)
         ├─ Users, mediante memberships (owner, admin, developer, billing, viewer)
         └─ Subscription (una instancia de un plan: límites, estado de facturación)
             └─ Site (un sitio WordPress, PHP o estático)
                 ├─ Domains (dominio principal, alias, redirecciones)
                 ├─ Databases y usuarios de base de datos
                 └─ Tareas cron, backups, acceso SSH

Conviene tener claro desde el principio:

Los usuarios no son clientes. Un usuario es una cuenta de acceso (email, contraseña, doble factor). Puede pertenecer a varios clientes a la vez, con un rol distinto en cada uno, que es justamente cómo una agencia gestiona 40 clientes desde una sola cuenta — algo que cPanel no permite.
Una suscripción es un plan en vigencia. Comprar un plan crea una suscripción, que lleva los límites del plan y el sitio o sitios a los que se aplica. Cambiar de plan cambia la suscripción, no el sitio.
El sitio es la unidad de aislamiento y de ubicación. Cada sitio tiene su propio usuario Unix, su propio sandbox de systemd, su propio proceso maestro de PHP-FPM, y vive en un único servidor web a la vez (se traslada entre servidores cuando hace falta, en forma automática o por decisión de un operador).
Las marcas son inquilinos reales, no un simple maquillaje. Una marca tiene sus propios clientes, personal, planes, precios, dominio del panel y, opcionalmente, su propia cuenta de Stripe. El personal de la plataforma ve y administra todas las marcas; el personal de una marca solo ve la suya.

Servidores y roles

Un solo servidor es, en sí mismo, un clúster de uno. Cada servidor que se suma a un clúster asume uno o más roles:

Rol	Qué ejecuta
`control`	El controlador: la API, la interfaz web, el motor de tareas, la facturación y la autoridad de certificación del clúster
`web`	Los sitios: nginx, PHP-FPM por sitio
`edge`	El tráfico público HTTP/HTTPS/HTTP/3, la emisión de certificados TLS y el WAF
`ssh`	La puerta de enlace SFTP/SSH orientada a los clientes
`db`	Las bases de datos MariaDB de los clientes
`cache`	Un pool compartido de Valkey

opanel install le da al primer servidor todos los roles. A medida que crecés, opanel join suma servidores con solo los roles que necesitan, y OPanel ubica los sitios nuevos, equilibra la carga y mueve sitios entre servidores por su cuenta. Ver Clúster.

Cómo leer esta documentación

Primeros pasos recorre los requisitos, la instalación y la primera hora con una instalación recién hecha.
Operar la plataforma es para quienes administran los servidores: clustering, seguridad, rendimiento, backups y actualizaciones.
Facturación y revendedores cubre planes, Stripe, sistemas de facturación externos y marcas blancas.
Guía del cliente está escrita para quienes efectivamente operan sitios en OPanel — el personal de hosting o de un revendedor puede derivar directamente a sus clientes ahí.
Migraciones cubre cómo traer sitios WordPress existentes y otras fuentes a OPanel.
Referencia tiene la CLI completa y la API pública.