Ir al contenido

Documentación

Webmin y Virtualmin

Webmin es la integración de panel de control para servidores que ejecutan Virtualmin. Crea y gestiona cuentas de hosting web en una máquina que ya está en marcha. No hay ningún sistema operativo que instalar ni ninguna máquina que arrancar: se crea una cuenta, se le da un plan y más tarde se suspende, se cambia de plan o se elimina.

Webmin es el panel; Virtualmin hace el hosting

El producto se conoce como Webmin, y así se llama esta página. Lo que Provibr maneja en realidad es Virtualmin: el módulo que conoce los dominios, los planes y las cuotas. Webmin a secas administra una máquina Linux y no conoce en absoluto el concepto de cuenta de hosting.

En un servidor sin ese módulo la API remota sencillamente no está: responde igual que un módulo inexistente. Así que Provibr no puede recurrir a Webmin a secas, y tampoco lo aparenta: la conexión se rechaza con un motivo en lugar de crearse a medias.

Lo que hace falta

La API remota de Webmin habla HTTP Basic, así que aquí el secreto es una contraseña y no un token. Es una propiedad de Webmin y no una decisión nuestra, y es la razón por la que las dos reglas de abajo son más estrictas que en los demás paneles de control.

  • Host: la dirección del panel. Tiene que ser https, y el puerto 10000 se añade si se omite.
  • Usuario de Webmin: root funciona, pero es mejor un usuario que solo tenga el módulo Virtualmin.
  • Contraseña: la de ese usuario. No hay nada que acotar, así que conviene elegir el usuario con cuidado.
  • Huella TLS: obligatoria, porque el instalador de Webmin deja un certificado autofirmado.
Lo mejor es asignar el módulo Virtualmin a un usuario de Webmin creado para esto. Puede hacer todo lo que hace Virtualmin, que es mucho, pero no todo lo que hace Webmin.

https y la huella son obligatorios

Las demás integraciones de panel de control aceptan una dirección http sin cifrar y avisan de lo que eso cuesta. Esta no, y la diferencia está en el secreto: una clave de acceso de DirectAdmin se puede limitar a un puñado de comandos; una contraseña de Webmin no se puede limitar en absoluto.

Enviar esa contraseña sin cifrar, o hacia un certificado que nadie ha verificado, no es una decisión que tomemos en nombre del cliente. Por eso se rechaza http y el campo de la huella no puede quedar vacío.

La huella se lee desde cualquier máquina que alcance el panel y se pega tal cual: con o sin dos puntos, y el prefijo que imprima la herramienta puede quedarse.

shell
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Los comandos y la salida del terminal están en inglés en todas partes, en el panel y en estas páginas. Un solo texto, una sola verdad: lo que se lee aquí es literalmente lo que devolverá su host.

La API remota

Provibr no usa la interfaz web de Webmin. Llama a la API remota del módulo Virtualmin, que devuelve respuestas legibles por máquina en lugar de páginas. En algunas instalaciones esa vía está desactivada; se vuelve a activar en Webmin, Webmin Configuration, Advanced Options.

Cuando el panel responde con una página de inicio de sesión en lugar de con la API, el agente lo dice con todas las letras. Suele significar que la dirección apunta a una página y no al panel, o que la API remota está apagada.

Ajustes

No hay ninguno. Un servidor Webmin decide por su cuenta dónde vive una cuenta y qué dirección recibe, así que no queda nada que elegir. La pestaña de ajustes sigue existiendo, porque también es donde se reenvían las credenciales.

Planes

Un plan de Virtualmin es la descripción que el propio panel tiene de una cuenta: cuota de disco, tráfico mensual, cuántos dominios y buzones, qué funciones están activas. No es un plan de Provibr ni un sistema operativo: es un nombre al que hacemos referencia, y su contenido puede cambiar en el servidor del cliente sin que nosotros lo notemos.

La página de la integración puede leer la lista de planes con su contenido, de modo que se ve lo que se elige en vez de teclear un nombre de memoria.

Un plan web fija un plan de Virtualmin en una integración y le da un nombre propio. Pedir con un plan tiene prioridad sobre elegir uno suelto, y esa elección suelta sigue disponible para los casos que un plan no cubre.

Cómo se ve una cuenta en Provibr

Una cuenta de hosting es una fila de servidor corriente del tipo servidor web. Su identificador es el número interno que Virtualmin da al dominio, y su dominio, usuario, plan y funciones llegan en cada consulta.

  • Crear una cuenta requiere un dominio, una dirección de correo, un plan y una contraseña.
  • El usuario de unix se deriva del dominio, así que aquí los guiones son normales, a diferencia de DirectAdmin, que tiene su propia regla de nombres.
  • La contraseña no queda registrada en ningún sitio. Solo consta que se ha facilitado una; el valor viaja aparte.
  • Después se puede suspender, reanudar, cambiar de plan y eliminar. No hay consola: una cuenta de hosting no la tiene.
El identificador es el número y no el nombre, porque Virtualmin puede renombrar un dominio. Una clave basada en el nombre se soltaría de su fila la primera vez que alguien lo hiciera.

Cuotas y consumo

La cuota de disco y el tráfico viajan con la consulta habitual, así que una cuenta obtiene su gráfica de uso sin activar nada más, siempre que el servidor pueda medirlos.

Virtualmin solo informa de cuota y consumo cuando las cuotas del sistema de ficheros están activadas, y una instalación recién hecha las tiene apagadas. Mientras nadie las active, esos campos sencillamente no están. Provibr entonces no muestra nada en lugar de un cero: no medir y no consumir no son lo mismo.

Adoptar cuentas que ya existen

La pestaña de importación enumera las cuentas del panel y permite incorporar a Provibr las que se quiera. Las cuentas ya conocidas aparecen, pero no se pueden volver a seleccionar, de modo que se ve el cuadro completo y no uno filtrado.

Las cuentas importadas cuentan para la capacidad exactamente igual que las pedidas. Si se importan más de las que caben, se abre un exceso con el periodo de gracia habitual.