Esta guía detalla la creación de un repositorio GIT tanto en su Alojamiento Web como en su Servidor Cloud de Infomaniak.

Introducción

• GIT y GitHub están disponibles de forma predeterminada en ambos entornos mencionados.

Creación del repositorio GIT

Configuración en el servidor:

• El repositorio GIT se encuentra en /git_depot
• El sitio web se encuentra en la carpeta /web/[proyecto] (en su servidor FTP)

Líneas de comando a indicar:

cd
mkdir git_depot
cd git_depot/
git init --bare [projet].git
cd [projet].git
git update-server-info

Envío del repositorio local al servidor

Para realizar en el equipo local:

git init
git remote add origin ssh://user@[xxxxx].ftp.infomaniak.com:/home/clients/[123456789]/git_depot/[projet].git
git status
git add .
git commit -a -m "init"
git push --set-upstream origin master
git push

Clonación del sitio en el directorio del servidor

Para realizar en el servidor:

cd
cd web
rm -r [projet]/
git clone /home/clients/[123465789]/git_depot/[projet].git [projet]/

Ha llegado a esta página porque tiene una redirección web en su dominio que está mal configurada. Infomaniak no puede identificar la ruta correcta de esta redirección, por lo que se le redirige a esta página para ayudarle a corregir esta situación.

Verificación de la zona DNS

Para restablecer el funcionamiento de su redirección, primero debe eliminar los rastros de una antigua redirección mal configurada:

1. Acceda a su zona DNS.
2. Elimine los registros correspondientes (consulte la lista a continuación) que corresponden a su redirección.
3. Haga clic en el icono ⋮ a la derecha de la entrada DNS y seleccione Eliminar:
   
   • Probablemente no encontrará todos los registros citados en la lista, esto es completamente normal.
   • Cualquier adición/modificación puede tardar hasta 48 horas en propagarse.
4. Recree la redirección web.

Lista de registros a verificar y eliminar

Los registros DNS pueden ser de tipo:

• A y que apuntan a xx.xx.xx.xx (solo números)
• AAAA y que apuntan a una IP xxxx:xxxx:x:x::x (números y letras)
• TXT cuyo cadena se parece a “(número)|(URL)”
  • por ejemplo 1|infomaniak.com si su redirección apunta a infomaniak.com
• TXT cuyo cadena se parece a “(letra)|(texto)”
  • por ejemplo t|Text, d|Text o k|Text

Esta guía detalla los puertos abiertos disponibles para los sitios Node.js (solo) alojados en Infomaniak.

Puertos abiertos en salida

Web

• HTTP (tcp/80)
• HTTP alternativo (tcp/8080)
• HTTPS (tcp/443)
• FTP Data (tcp/20)
• FTP Control (tcp/21)

Correo

• POP3 (tcp/110)
• IMAP (tcp/143)
• SMTP submission (+ STARTTLS) (tcp/587)
• SMTPS (tcp/465)
• IMAPS (tcp/993)
• POP3S (tcp/995)

Base de datos

• MySQL (tcp/3306)
• MongoDB (tcp/27017)
• PostgreSQL (tcp/5432)
• Redis (tcp/6379)
• Redis TLS (tcp/6380)
• ElasticSearch (tcp/9200)

Varios

• SSH (tcp/22)
• Git pack transfer (tcp/9418)

Puertos abiertos en entrada

• HTTP (tcp/80)
• HTTPS (tcp/443)
• SSH (tcp/22)

Esta guía explica cómo resolver un problema de instalación de certificado SSL (Let's Encrypt o Sectigo) si utiliza Cloudflare con reglas de seguridad estrictas, como el filtrado por país o direcciones IP.

Ajustar la configuración SSL / geobloqueo

Cuando se solicita un certificado SSL a través de Infomaniak (Let's Encrypt gratuito o Sectigo), la autoridad de certificación debe verificar que es el propietario del dominio. Esta verificación puede realizarse por HTTP (a través de archivos especiales colocados en su sitio), DNS o correo electrónico:

• Let's Encrypt utiliza /.well-known/acme-challenge/.
• Sectigo utiliza generalmente /.well-known/pki-validation/ (o DNS / correo electrónico según la opción elegida).

Si estas verificaciones fallan (por ejemplo, porque Cloudflare bloquea el acceso), el certificado no puede ser emitido o renovado. Además, Let's Encrypt ya no verifica solo desde un lugar. Desde hace algún tiempo (y más aún desde marzo de 2024), realiza sus verificaciones desde varios países al mismo tiempo – incluidos nuevos como Suecia o Singapur. Resultado: si uno de estos países está bloqueado por sus configuraciones de Cloudflare, la solicitud del certificado puede fallar, incluso si todo lo demás está correctamente configurado.

Peor aún: incluso si intenta hacer una excepción solo para la dirección del desafío (.well-known/acme-challenge), esto no siempre funciona con algunas reglas de Cloudflare. De hecho, las reglas de bloqueo por país o IP se aplican antes de cualquier excepción basada en rutas de URL.

Ajustar el modo SSL/TLS

En Cloudflare, utilice el modo Full o Full (strict). Estos modos toleran temporalmente un certificado caducado o auto-firmado, hasta que la validación se complete:

Permitir las rutas de validación

Evite las "IP Access Rules" bloqueantes y prefiera las "Custom Rules" que permiten sin restricciones las rutas:

• /.well-known/acme-challenge/ (Let's Encrypt)
• /.well-known/pki-validation/ (Sectigo)

Desactivar temporalmente el geobloqueo

Si es necesario, desactive temporalmente el bloqueo geográfico o IP durante la validación, luego vuelva a activar sus protecciones después de la emisión o renovación del certificado.

Infomaniak ofrece diferentes planes de Site Creator, gratuitos o de pago, que se adaptan a diversas necesidades. Es fundamental comprender bien las condiciones asociadas a cada tipo de plan antes de tomar una decisión.

Comprender los diferentes planes de Site Creator

Site Creator está disponible…

• … ya sea de forma gratuita con cada alojamiento web de pago existente (puede añadir uno si es necesario):
  
  • En este caso, solo se puede configurar 1 Site Creator por alojamiento web de Infomaniak.
  • Para gestionar varios sitios creados con Site Creator en la misma Organización, es necesario tener varios alojamientos web.
• … ya sea de forma independiente (independiente, disponible en 3 versiones) y, en este caso, no requiere ninguna otra oferta especial:
  
  1. Site Creator Free
  2. Site Creator Lite
  3. Site Creator Pro

1. Site Creator Free

Este plan está diseñado como una solución de prueba y descubrimiento y es totalmente gratuito. Está dirigido a usuarios que desean familiarizarse con la herramienta o publicar una página web extremadamente sencilla:

• Solo permite una única página web y ofrece un espacio de disco reducido (5 GB).
• Esta oferta no permite la conexión a un nombre de dominio personalizado (tendrá el formato *.infomaniak.site) e incluye la visualización obligatoria del anuncio publicitario de Infomaniak.
• No se incluyen módulos de crecimiento importantes, como la gestión completa de un blog, el uso de la Inteligencia Artificial para la generación de texto o la función "Mapa del sitio".

2. Site Creator Lite

El plan Lite es la oferta de nivel de entrada de pago de Infomaniak. Es ideal para la creación de un sitio web o un blog personal sencillo, ya que elimina las principales limitaciones de la versión gratuita y desbloquea los módulos necesarios para un sitio web completo:

• Permite la creación de un sitio web más completo con un límite de 6 páginas web y un espacio en disco más amplio (15 GB).
• Incluye la oferta de un nombre de dominio durante un año y, lo que es esencial, la eliminación de cualquier anuncio publicitario de Infomaniak en el sitio web.
• A diferencia de la oferta gratuita, el plan Lite desbloquea el acceso a funciones importantes para la navegación y la organización, en particular el módulo de creación y gestión de blogs, así como el módulo Mapa del sitio.

3. Site Creator Pro

La oferta Pro es la fórmula premium de Site Creator. Está dedicada exclusivamente a los proyectos más ambiciosos, como el lanzamiento de una tienda en línea completa, gracias a la eliminación de todas las restricciones de contenido y la integración de herramientas de comercio y análisis avanzados:

• Elimina cualquier limitación en el contenido al ofrecer páginas web ilimitadas y un amplio espacio en disco de 50 GB.
• Esta es la única oferta que incluye la gestión completa del comercio electrónico (pedidos, inventario, descuentos) y permite la integración de las pasarelas de pago esenciales (Stripe, PayPal, Mollie) para una actividad comercial en línea.
• El plan Pro es el único que ofrece acceso a herramientas de análisis y seguimiento del rendimiento externas cruciales, como Google Analytics, Hotjar y herramientas como Google reCaptcha.

Compromiso relacionado con las ofertas de pago

A diferencia de otros productos de Infomaniak, algunas ofertas de Site Creator incluyen un nombre de dominio gratuito. Estas ofertas requieren un compromiso firme de una duración mínima de 12 meses, sin posibilidad de reembolso, ni siquiera parcial, incluso si:

• decide dejar de usar Site Creator antes de que finalice el primer año,
• cancela sus productos,
• cierra su cuenta de usuario o su Organización.

Evolución de las ofertas y conservación de su sitio

Es posible pasar de una oferta gratuita a una oferta de pago más completa:

1. Haga clic aquí para acceder a la gestión de su sitio en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic en el menú de acción ⋮ a la derecha del sitio correspondiente en la tabla que se muestra.
3. Haga clic en Modificar la oferta:
   

También es posible pasar a una oferta superior (por ejemplo, de Lite a Pro).

Si desea mantener su sitio web activo, debe renovar obligatoriamente la misma oferta de pago. No es posible cambiar a una versión gratuita de Site Creator, incluso si:

• no utiliza ninguno de los módulos de pago,
• su sitio web solo tiene una página.

¿Qué hacer si desea volver a la oferta gratuita?

En este caso, debe:

• cancelar su sitio web actual después de copiar manualmente toda la información que desea conservar,
• activar una nueva oferta gratuita de Site Creator,
• recrear su sitio web y pegar en él el contenido recuperado del sitio anterior.

Esta guía detalla la instalación y el mantenimiento de Ghost en un hosting web de Infomaniak, para obtener una plataforma optimizada para el blogging y la publicación editorial, una alternativa eficiente a Substack o Medium.

Requisitos previos

• Un sitio de tipo Node.js (se recomienda v22).
• Un acceso SSH activo.
• Una base de datos MySQL/MariaDB.
• Detenga la aplicación Node.js desde el panel de control de su sitio Node.js antes de cualquier operación técnica.

Instalación de Ghost

Para ello:

1. Conéctese a su servidor mediante SSH (¿necesita ayuda?).

2. Ejecute los siguientes comandos para iniciar el instalador:

   # Clone tools repo
   git clone https://github.com/Infomaniak/hosting-tools.git
   cd hosting-tools/h3-ghost
   # Run installation script
   bash ./install.sh

3. El script ahora:
   • le hará algunas preguntas (URL del sitio, información de la base de datos, SMTP, etc.)…
   • descargará y configurará Ghost automáticamente…
   • tomará unos minutos — ¡sea paciente!

Responda a las preguntas cuidadosamente utilizando los detalles que ha anotado. ¡No cierre el terminal hasta que haya terminado!

Configuración del Manager (Node.js)

Una vez que el script haya terminado, vaya a su Panel de control de Infomaniak:

1. Haga clic aquí para acceder a la gestión de su sitio en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al sitio correspondiente:
   
3. Haga clic en Gestionar parámetros avanzados:
   
4. Haga clic en la pestaña Node.js para acceder a la configuración.

5. En el campo de comando de ejecución, introduzca:

   /srv/customer/node_modules/ghost-cli/bin/ghost run

6. Asegúrese de que el número de puerto sea 3000.
7. Caja de comando de build : desactívela.
8. Haga clic en el botón Guardar en la parte inferior de la página:
   
9. En la página principal, haga clic en el botón Start (o Restart si ya está en ejecución).
10. Confirme la operación si es necesario:
    
11. Observe los registros que muestran la creación de la base de datos y el inicio de la aplicación.

Actualización de Ghost

Para actualizar Ghost CMS a la última versión o a una versión específica, siga estos pasos:

1. Detenga la aplicación Node.js en el Manager Infomaniak.

2. Acceda al directorio de su sitio Ghost

   # Navigate to your Ghost site directory
   cd ~/sites/ghost-site-name

   Reemplace ghost-site-name por el nombre real de su carpeta (por ejemplo, blog, mysite, etc.).

3. Asegúrese de que los permisos de los archivos sean correctos (la operación puede tardar varios minutos):

   # Ensure file permissions are correct
   find ./ -type d -exec chmod -v 00775 {} \;

4. Compruebe las actualizaciones disponibles:

   # Check available ghost updates
   /srv/customer/node_modules/ghost-cli/bin/ghost check-update

   Para la última versión (la operación puede tardar varios minutos):

   # Update to the latest version
   /srv/customer/node_modules/ghost-cli/bin/ghost update

   Para una versión específica como la v5 (la operación puede tardar varios minutos):

   # Update to a specific version (e.g., v5)
   /srv/customer/node_modules/ghost-cli/bin/ghost update v5

   • ¿Por qué pasar por la v5? Si usa Ghost v4 y desea pasar a la v6, Ghost requiere pasar por la v5 como paso intermedio. Es indispensable para las actualizaciones de versión mayor.
5. Espere a que se complete la actualización y, a continuación, reinicie la aplicación desde el panel de control del sitio para aplicar la actualización.

¡Terminado! Acceda a su blog Ghost

Diríjase a continuación a la URL de su sitio para comenzar:

1. Abra su navegador y vaya a https://domain.xyz/ghost (reemplace domain.xyz con su dominio actual).
2. La primera vez:
   1. Creará una cuenta de administrador (su identificación para el blog)...
   2. ¡Luego, podrá comenzar a escribir artículos!

Configuración de usuarios/correo electrónico

Para crear el primer usuario, agregue /ghost a la URL de su sitio (por ejemplo https://ghost.domain.xyz/ghost) y siga el asistente.

También puede configurar la "dirección de soporte del portal de miembros": cuando los nuevos miembros deseen registrarse, el portal envía la confirmación de doble opt-in desde una dirección específica.

Por defecto, es la dirección "noreply" de su dominio. Para actualizarla, navegue a "Configuración", "Membresía", "Configuración del portal", "Personalizar" y "Página de la cuenta":

Resolver una incompatibilidad técnica entre Ghost y MariaDB

Algunas consultas SQL provocan errores HTTP 400 en MariaDB, lo que resulta en este tipo de error:

[2025-01-01 12:54:28] ERROR "GET /ghost/api/admin/posts/6834625e35802b06f1496305/?formats=mobiledoc%2Clexical&include=tags%2Cauthors%2Cauthors.roles%2Cemail%2Ctiers%2Cnewsletter%2Ccount.conversions%2Ccount.clicks%2Csentiment%2Ccount.positive_feedback%2Ccount.negative_feedback" 400 27ms
Could not understand request.
Error ID:
8f2b0d90-3a30-11f0-a25f-fd9c83e1cf02
Error Code:
ER_BAD_FIELD_ERROR
----------------------------------------
Error: select `posts`.*,
...

Si es necesario, existe un parche para adaptar el comportamiento de Ghost.

Para usar este parche, ingrese este comando:

# Enter the current version folder and apply the MariaDB patch
cd current
curl -L https://gist.githubusercontent.com/reneluria/8cbbfbc001e542c77d6d5887fbafe5d3/raw/65e0ce31753b4687d0eb67fc030734a35d3ffbad/ghost-post.patch | patch -p0

Esta guía permite resolver un problema en el CMS Prestashop y más específicamente con su módulo “Búsqueda por facetas” ("Faceted search") que permite la gestión de filtros en las páginas categoría de productos.

El problema

Este módulo de búsqueda específico de Prestashop crea una caché en la base de datos para acelerar la búsqueda, sin embargo, la tabla correspondiente nunca se limpia, lo que causa problemas en la infraestructura de alojamiento.

Primera solución

La primera solución consiste en desactivar la caché propuesta.

Para ello:

1. En el panel de administración de PrestaShop, vaya a Módulos → Gestor de módulos.
2. Seleccione Módulos y utilice el campo de búsqueda para encontrar “facet”.
3. Haga clic en Configurar junto al módulo obtenido en el resultado:
   
4. Desactive el botón al respecto:
   

Segunda solución

La segunda solución consiste en establecer un cronjob que permita limpiar la tabla, por ejemplo todas las noches:

1. Desde los parámetros del módulo, copie la URL existente en el botón Clear cache:
   

Luego, desde el Manager Infomaniak, cree un webcron (consulte esta otra guía al respecto) para ejecutar la URL copiada en el punto 1 anterior, por ejemplo 1 vez por día y por noche.

Esta guía se refiere al módulo de WordPress "Infomaniak Connect para OpenID", que permite a los usuarios iniciar sesión en su sitio de WordPress (ya sea alojado por Infomaniak o no) utilizando sus credenciales de Infomaniak.

Introducción

• Permitir el inicio de sesión a través de una cuenta de Infomaniak en su sitio de WordPress permite a sus visitantes comentar, registrarse en cursos o acceder a cualquier contenido reservado para miembros con un solo clic, sin tener que crear una nueva cuenta.
• Esto les ahorra tiempo y es un método más seguro para usted, ya que no tiene que gestionar contraseñas adicionales.
• El funcionamiento de este módulo externo es idéntico a las opciones "Iniciar sesión con Google", "Iniciar sesión con Facebook" o “Iniciar sesión con Apple”; utiliza los protocolos estándar OAuth2 y OpenID Connect para permitir una autenticación única (SSO).

A. Crear una aplicación con Auth Infomaniak

Para ello:

1. Haga clic aquí para acceder a la gestión de su producto Auth en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic en el botón para Crear una nueva aplicación:
   
3. Elija el tipo “Front-End web”.
4. Asigne un nombre a su aplicación.
5. En el campo URL, indique el nombre de dominio correspondiente a su sitio WordPress, al que deberá añadir /openid-connect-authorize (consulte la documentación de GitHub si es necesario).
6. Haga clic en el botón para finalizar la creación de la aplicación:
   
7. Anote cuidadosamente los 2 datos que obtendrá al finalizar su aplicación OAuth2:
   

B. Configurar la extensión de WordPress

Para ello:

1. Busque la extensión Infomaniak Connect for OpenID en la plataforma de extensiones de WordPress desde su sitio.
2. Instale y active la extensión:
   
3. Configure la extensión desde el menú Ajustes:
   
4. Los únicos campos que debe completar son ID de cliente y Clave secreta del cliente, y provienen de la información obtenida en el punto A anterior:
   
5. No olvide guardar los cambios realizados en la configuración de la extensión.
6. Ahora se muestra un botón adicional en su página de inicio de sesión para usuarios /wp-admin (/wp-login.php), que permite iniciar sesión con su cuenta de Infomaniak:
   

Esta guía se refiere al módulo Typo3 "t3ext-infomaniak-auth" que permite a los usuarios conectarse a su sitio Typo3 (ya sea alojado por Infomaniak o no) utilizando sus identificadores Infomaniak.

Prólogo

• Permitir la conexión a través de una cuenta Infomaniak en su sitio Typo3 permite a sus visitantes comentar, inscribirse en cursos o acceder a cualquier contenido reservado para miembros con un solo clic, sin tener que crear una nueva cuenta.
• Es un ahorro de tiempo para ellos y un método más seguro para usted, ya que no tiene que gestionar contraseñas adicionales.
• El funcionamiento de este módulo externo es idéntico a las opcionesIniciar sesión con Google", "Iniciar sesión con Facebook" o "Iniciar sesión con Apple"; utiliza los protocolos estándar OAuth2 y OpenID Connectpara permitir una autenticación única (SSO).

A. Crear una aplicación con Auth Infomaniak

Para ello:

1. Haga clic aquí para acceder a la gestión de su producto Auth en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic en el botón para crear una nueva aplicación:
   
3. Elija el tipo "Web Front-End".
4. Asigne un nombre a su aplicación.
5. En el campo URL, indique el nombre de dominio correspondiente a su sitio Typo3 después del cual agrega /openid-connect-authorize (consulte la documentación de GitHub si es necesario).
6. Haga clic en el botón para finalizar la creación de la aplicación:
   
7. Tome nota de las 2 informaciones obtenidas al finalizar su aplicación OAuth2:
   

B. Configurar la extensión Typo3

En SSH, despliegue si es necesario Composer para poder recuperar las extensiones t3ext-infomaniak-auth. Para ello:

• El comando SSH para la instalación de la extensión es el siguiente:
  • https://packagist.org/packages/infomaniak/t3ext-infomaniak-auth 

Luego, en Typo3:

1. Conéctese a su interfaz de administración Typo3.
   • Verifique si es necesario que la extensión Infomaniak esté activada:
     
2. Haga clic en Configuración en el menú lateral izquierdo.
3. Haga clic en Configurar extensiones:
   
4. Haga clic en la flecha ‍ a la derecha de typo3-openid-main para desarrollar la pestaña cliente.
5. Los únicos campos que debe completar son clientID y clientSecret y provienen de las informaciones obtenidas en el punto A anterior.
6. No olvide guardar los cambios realizados en la configuración de la extensión:
   
7. Un botón adicional, para una conexión por identificador Infomaniak, ahora es visible en su página de conexión destinada a los usuarios:
   

Esta guía se refiere al módulo Drupal "Infomaniak_Connect" que permite a los usuarios conectarse a su sitio Drupal (ya sea alojado por Infomaniak o no) utilizando sus identificadores de Infomaniak.

Prólogo

• Permitir la conexión a través de una cuenta de Infomaniak en su sitio Drupal permite a sus visitantes comentar, inscribirse en cursos o acceder a cualquier contenido reservado para miembros con un solo clic, sin tener que crear una nueva cuenta.
• Esto ahorra tiempo y es un método más seguro para usted, ya que no tiene que gestionar contraseñas adicionales.
• El funcionamiento de este módulo externo es idéntico a las opcionesIniciar sesión con Google", "Iniciar sesión con Facebook" o "Iniciar sesión con Apple"; utiliza los protocolos estándar OAuth2 y OpenID Connectpara permitir la autenticación única (SSO).

A. Crear una aplicación con Auth Infomaniak

Para ello:

1. Haga clic aquí para acceder a la gestión de su producto Auth en el Administrador de Infomaniak (¿Necesita ayuda?).
2. Haga clic en el botón para Crear una nueva aplicación:
   
3. Seleccione el tipo "Web Front-End".
4. Asigne un nombre a su aplicación.
5. En el campo URL, indique el nombre de dominio correspondiente a su sitio Drupal después del cual agrega /openid-connect-authorize (consulte la documentación de github si es necesario).
6. Haga clic en el botón para completar la creación de la app:
   
7. Tome nota de las 2 informaciones obtenidas al finalizar su aplicación OAuth2:
   

B. Configurar la extensión Drupal

En SSH, despliegue si es necesario Composer para poder recuperar las extensiones openid_connect y infomaniak_connect. Para ello:

• Debe editar si es necesario el archivo composer.json ya que la versión de openid_connect aún no se considera estable. Agregue:

• "minimum-stability": "dev",
  "prefer-stable": true

• Los comandos SSH para la instalación de las 2 extensiones están aquí:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Luego, en Drupal:

1. Busque el módulo Infomaniak entre sus módulos preinstalados.
2. Selecciónelo.
3. Haga clic en el botón Instalar:
   
4. La instalación de las dependencias se realizará:
   
5. En Configuración, haga clic para configurar la conexión OpenID:
   
6. Haga clic en el botón de edición:
   
7. Los únicos campos que debe completar son Client ID y Client Secret y provienen de las informaciones obtenidas en el punto A anterior:
    
8. No olvide guardar los cambios realizados en la configuración de la extensión.
9. En la pestaña Configuración, puede elegir el tipo de visualización para su página de inicio de sesión; no olvide guardar:
   
10. Un botón adicional, para iniciar sesión con un identificador Infomaniak, ahora es visible en su página de inicio de sesión destinada a los usuarios:
     

Esta guía explica por qué es importante utilizar una versión reciente de Node.js para su aplicación y cómo seleccionar una versión más reciente con un sitio Node.js alojado en la infraestructura de Infomaniak.

Prólogo

• Node.js = nombre oficial del lenguaje/entorno.
• NodeJS = nombre "técnico" o simplificado en ciertos contextos (a menudo por razones prácticas, no hay una verdadera diferencia técnica).

¿Es peligrosa una versión obsoleta de Node.js?

Cuando utiliza una versión de Node.js que se acerca al final de su soporte, aparece un mensaje de advertencia en el panel de control del sitio correspondiente.

El entorno de ejecución Node.js evoluciona regularmente: cada nueva versión trae mejoras de rendimiento, seguridad y soporte para nuevas funcionalidades. Utilizar una versión que ya no se actualiza lo expone a riesgos de seguridad y problemas de funcionamiento con otros componentes. Las personas malintencionadas podrían explotar vulnerabilidades conocidas en estas versiones para comprometer su aplicación. Por lo tanto, se recomienda encarecidamente utilizar una versión reciente y oficialmente soportada.

Existen tres situaciones posibles:

• Versión completamente soportada: no se requiere ninguna acción
• Versión con soporte de seguridad únicamente: se recomienda pasar a una versión más reciente
• Versión obsoleta: se recomienda encarecidamente actualizar a una versión más reciente

Utilizar una versión más reciente de Node.js

Las versiones más recientes de Node.js ofrecen mejores rendimientos y un comportamiento más estable para sus aplicaciones modernas.

Antes de modificar la versión utilizada

• Si su aplicación utiliza un framework o una biblioteca específica (Next.js, Express, etc.), verifique el buen soporte de la versión objetivo de Node.js.
• Si su código ha sido desarrollado a medida, consulte la documentación oficial de Node.js para identificar los cambios realizados (API obsoletas, gestión de módulos, etc.).

¿Y si surge un problema?

Si su aplicación no funciona correctamente después de cambiar la versión de Node.js, puede volver a una versión anterior (si aún está soportada) a través de la pestaña Configuración avanzada del sitio correspondiente.

Esta guía explica cómo ajustar la configuración de un sitio Node.js alojado en la infraestructura de Infomaniak. Aprenderá a adaptar el comportamiento de su aplicación según su evolución, sus dependencias o sus preferencias técnicas.

Requisitos previos

• Instalar un sitio Node.js en su alojamiento.
• Probar sus modificaciones localmente antes de aplicarlas en producción.
• Verifique que sus scripts (start, build) estén bien definidos en su archivo package.json.
• Si modifica la estructura de su proyecto, piense en ajustar la carpeta de ejecución y los comandos asociados.
• Importante: el puerto de escucha definido en el Manager debe corresponder imperativamente al utilizado en el código de la aplicación.

Acceder a la configuración

Cada sitio dispone de un tablero de control dedicado para controlar la aplicación (iniciar, detener, reiniciar), consultar los registros de ejecución, gestionar las versiones de Node.js y activar los certificados SSL:

1. Haga clic aquí para acceder a la gestión de su sitio en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al sitio en cuestión:
   
3. Haga clic en Gestionar parámetros avanzados:
   
4. Haga clic en la pestaña Node.js para acceder a los ajustes:
   

Comandos y automatización

Carpeta de ejecución

La carpeta de ejecución indica la ubicación en el servidor donde se ejecutarán los comandos de construcción (build) y de lanzamiento. Debe apuntar al directorio raíz de su aplicación, donde se encuentra su archivo package.json.

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Comando de construcción (Build)

Si su aplicación requiere un paso de preparación (instalación de dependencias, compilación de TypeScript, minificación), indique aquí el comando a ejecutar. Este es el método recomendado para desplegar sus actualizaciones.

A diferencia de una ejecución manual en SSH, esta interfaz utiliza un entorno con rendimiento mejorado para garantizar una construcción rápida sin afectar los recursos de su sitio en producción. Puede encadenar varias tareas (como un git pull seguido de un build) y seguir el progreso y los registros del proceso en tiempo real directamente desde el Manager.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Nota: Si su proyecto ya está compilado o no requiere ningún paso intermedio, este campo puede quedarse vacío.

Comando de inicio

Esta instrucción inicia su servidor. Debe ser idéntica a la utilizada en su entorno de desarrollo local para iniciar el punto de entrada de la aplicación.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Puerto de escucha

Su aplicación debe escuchar obligatoriamente en el puerto dinámico asignado por el Manager. Este puerto se transmite a su código a través de la variable de entorno PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Versión de Node.js

Puede seleccionar la versión de Node.js deseada en la configuración. Se recomienda priorizar una versión estable (LTS) para asegurar la seguridad y la sostenibilidad de su proyecto.

Aplicar y validar los cambios

Una vez que sus modificaciones se hayan guardado en el Manager, debe reiniciar su aplicación desde el panel de control para que los nuevos parámetros (nueva versión de Node, nuevo puerto o nuevo comando de build) se tengan en cuenta.

En caso de dificultad al inicio, puede consultar la consola de ejecución o referirse a esta otra guía para solucionar problemas.

Esta guía le ayuda a diagnosticar rápidamente el origen de un problema si su sitio Node.js, alojado en la infraestructura de Infomaniak, no funciona como se espera.

Verificar el estado de la aplicación

Desde el panel de control de su sitio Node.js, puede consultar el estado actual de la aplicación:

• Activo: su aplicación funciona normalmente.
• En proceso de reinicio: la aplicación se está reiniciando, espere unos instantes.
• Detenida o Con error: hay un problema.

En caso de error o detención:

• Haga clic en « Iniciar » o « Reiniciar » la aplicación.
• Consulte inmediatamente la consola de ejecución para identificar posibles errores técnicos.

Leer la consola de ejecución

La consola muestra los mensajes de error generados al iniciar su aplicación. Aquí están los errores frecuentes:

• Comando de inicio incorrecto: verifique que está utilizando la sintaxis correcta (por ejemplo: npm start, node app.js, etc.).
• Error en el código fuente: puede tratarse de una excepción no manejada, de un módulo faltante o de un puerto definido incorrectamente.

Verificar los parámetros de la aplicación

En la sección Configuración avanzada del sitio, asegúrese de que todos los ajustes sean correctos:

• Carpeta de ejecución: carpeta en la que se ejecutan los comandos build y start.
• Comando de construcción (opcional): por ejemplo npm run build si su aplicación lo requiere.
• Comando de inicio: por ejemplo node index.js, npm start, etc.
• Puerto de escucha: el puerto en el que la aplicación espera las solicitudes (por ejemplo 8080, 3000, etc.).
  • El puerto configurado en su aplicación debe coincidir con el definido en el Manager.
• Versión de Node.js: asegúrese de que sea compatible con su código.

Infomaniak pone a disposición los gestores de paquetes NPM y Yarn. Puede elegir el que se adapte a su proyecto en el asistente de configuración.

¿Sigue bloqueado?

¿El sitio sigue inaccesible?

• Su aplicación puede estar en modo mantenimiento.
• El puerto de escucha de la aplicación puede ser incorrecto o bloqueado.
• La aplicación no devuelve una respuesta HTTP correcta (no hay res.send() o res.end() en su servidor, por ejemplo).

¿Ha utilizado un método avanzado de instalación?

Si ha importado su código a través de Git, ZIP, SSH o SFTP, asegúrese de que:

• El código se ha descomprimido o clonado correctamente en la carpeta adecuada.
• Los archivos esenciales (package.json, server.js, index.js, etc.) están presentes.
• Las dependencias están correctamente instaladas (node_modules presente después de npm install o yarn install).

Si el problema persiste después de todas estas verificaciones:

• Intente crear un nuevo sitio con el método simple para probar con un ejemplo funcional.
• Compare su configuración con la del ejemplo proporcionado.
• Consulte la documentación oficial de Node.js para errores específicos.
• En caso de necesidad, contacte con el soporte de Infomaniak con una copia de los registros mostrados en la consola.

Los sitios Node.js propuestos por Infomaniak permiten ejecutar aplicaciones Node.js en un entorno flexible, listo para usar, sin tener que gestionar una infraestructura de servidor.

Preámbulo

• Ofreciendo la flexibilidad de un servidor sin la complejidad de su administración, este tipo de alojamiento es particularmente adecuado para proyectos API REST, para desplegar el CMS Ghost, n8n, Strapi o frameworks como Express.js, NestJS o también socket.io, next.js, herramientas empresariales o prototipos para:
  • desarrolladores que desean desplegar aplicaciones Node.js sin gestionar infraestructura.
  • webmasters que buscan experimentar o formarse en Node.js.
  • agencias y freelancers que trabajan en varios proyectos de clientes.
  • estudiantes, profesores y escuelas que necesitan un entorno sencillo para probar código.
• Los gestores de paquetes NPM y Yarn están soportados.
• Si instala Node.js en un alojamiento web dentro de un Servidor Cloud, su sitio no funcionará con los recursos garantizados del Servidor Cloud gestionado.
  • Consulte esta otra guía para usar Fast Installer y desplegar NVM.
• Node.js = nombre oficial del lenguaje/entorno; NodeJS = nombre "técnico" o simplificado en ciertos contextos (a menudo por razones prácticas, no hay diferencia técnica real).

Crear un sitio Node.js

Para acceder a un plan de alojamiento web y agregar un sitio Node.js:

1. Haga clic aquí para acceder a la gestión de sus alojamientos en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al alojamiento correspondiente:
   
3. Haga clic en el botón azul Agregar:
   
4. Elija un proyecto con tecnologías avanzadas.
5. Haga clic en Siguiente:
   
6. Elija Node.js.
7. Seleccione una posible otra versión si es necesario.
8. Haga clic en Siguiente:
   
9. Elija el tipo de dominio a asignar a este nuevo sitio:
   1. un nombre de dominio ya adquirido
   2. un subdominio creado a partir de un nombre de dominio ya adquirido
   3. un nombre de dominio aún disponible y a ordenar
10. Ingrese el nombre de dominio o el subdominio.
11. Elija las opciones avanzadas posibles.
12. Haga clic en Siguiente:
    
13. Elige uno de los dos enfoques posibles:
    
    1. Método rápido:
       • Un proyecto de ejemplo preconfigurado se instala automáticamente.
       • Este enfoque es ideal para descubrir Node.js o comenzar rápidamente una base funcional.
    2. Método personalizado:
       • El código fuente puede importarse a través de Git, archivo ZIP, SSH o SFTP.
       • Defines tú mismo los scripts, puntos de entrada, puerto de escucha y comandos de compilación necesarios.
14. ¡Listo, el sitio está preparado:
    

Cada sitio tiene un tablero de control dedicado para controlar la aplicación (iniciar, detener, reiniciar), consultar la consola de ejecución, gestionar las versiones de Node.js, configurar los dominios y activar los certificados SSL:

Para profundizar en la configuración de tu sitio Node.js, consulta esta otra guía.

Esta guía explica cómo importar datos externos (archivos, carpetas, etc.) a su kDrive utilizando el protocolo WebDAV proporcionado por su proveedor de Cloud.

Preámbulo

• Consulte esta otra guía si está buscando información para copiar datos específicos de un kDrive a otro cuando su usuario tiene acceso a los 2 kDrive involucrados.

Importar datos externos por WebDAV

Requisitos previos

• Poseer una oferta kDrive o kSuite
• Tener permisos suficientes dentro de kDrive o kSuite.
• No cambie sus contraseñas hasta que la importación esté completa!

Para acceder a la herramienta de importación, donde se deben importar los datos:

1. Haga clic aquí para acceder a la aplicación web kDrive de Infomaniak (servicio en línea ksuite.infomaniak.com/kdrive).
2. Haga clic en el ícono Configuración ​ en la esquina superior derecha.
3. Verifique o seleccione el kDrive correspondiente en el menú desplegable del menú lateral izquierdo.
4. Haga clic en General en el menú lateral izquierdo.
5. Haga clic en Importar datos externos:
   
6. Haga clic en el botón azul Iniciar:
   
7. Haga clic en WebDAV.
8. Complete la información solicitada según la fuente (especialmente la dirección WebDAV que posee - obtenida en la fuente).
9. Elija el kDrive de destino y la ubicación deseada para alojar los datos importados.
10. Haga clic en Iniciar:
    

Esta guía detalla las reglas específicas a seguir al crear una contraseña de usuario con mysqli_connect() que contiene el carácter “dólar” $ en las plataformas Infomaniak.

Prólogo

• Si al utilizar mysqli_connect(), obtienes el mensaje de error "Acceso denegado para el usuario" y tu contraseña de usuario de base de datos contiene un signo $, el problema puede deberse al funcionamiento de las cadenas de caracteres en PHP.
• El problema también puede surgir con scripts de mensajería.

Reglas a seguir

Cuando se utiliza el carácter especial $ en una contraseña de usuario y este es seguido por cualquier otro carácter que no sea un número, el nombre de la variable no es válido y la sustitución no se realiza correctamente.

Aquí hay soluciones para corregir esto:

• Coloca la contraseña entre comillas simples: '$******'
• Asegúrate de que un número siga directamente al dólar: "$2*****"
• Usa una barra invertida para "escapar" el dólar en la contraseña: "\$****"

Esta guía explica las diferencias entre un Dominio (o sitio principal), un Subdominio y un Alias.

Prólogo

• Aunque están relacionados, estos tres elementos (Dominio, Subdominio y Alias) tienen funciones y finalidades diferentes.
• Pueden afectar a un Alojamiento Web a través de su nombre de dominio, o incluso al correo electrónico ya que es perfectamente posible tener direcciones de correo electrónico en un subdominio, por ejemplo.

¿Qué es un Dominio?

El dominio o nombre de dominio es la puerta de entrada principal a su sitio web. Es a partir de él que sus usuarios accederán a su contenido. Es este dominio principal el que define lo que aparecerá en la barra de URL de los navegadores de sus usuarios.

Requisitos previos

• Poseer un dominio.
• Poseer un alojamiento web de Infomaniak.

Consulte la guía Crear un nuevo sitio en su alojamiento web.

¿Qué es un Subdominio?

El Subdominio se simboliza con una palabra adicional que se encuentra antes de su nombre de dominio principal. Esto es muy útil en varios casos, por ejemplo:

• esto puede servir para mostrar contenido "exclusivo" o dirigido, por ejemplo, al acceder a faq.infomaniak.com se llega a la base de conocimientos donde se encuentran todas las guías
• esto también puede servir (temporalmente o permanentemente) al crear un nuevo sitio o rediseñar un sitio existente, creando, por ejemplo, new.domain.xyz cuando el sitio principal era hasta entonces domain.xyz

Requisitos previos

• Poseer al menos un dominio.
• Poseer un alojamiento web de Infomaniak.

Consulte la guía Agregar un subdominio a su alojamiento web.

¿Qué es un Alias?

Un Alias o Dominio Alias es un segundo nombre de dominio que apunta directamente a su sitio principal, comparten las mismas páginas web. El alias es otra puerta de acceso a su sitio web. Por ejemplo, el sitio principal de la Confederación Helvética es www.ch.ch y www.suisse.ch es su alias.

Requisitos previos

• Poseer varios nombres de dominio.
• Poseer un alojamiento web de Infomaniak.

Consulte la guía Agregar un alias a su alojamiento web.

El equivalente también existe para un Servicio de Correo.

La ventaja de un Alias es permitirle aumentar la visibilidad de su sitio ante su público objetivo, ofreciéndole más puntos de acceso para acceder a él.

Esta guía detalla los rangos de direcciones IP públicas utilizadas por Infomaniak; esto facilita, en particular, la configuración de los sistemas de seguridad (firewall, filtrado, whitelisting).

Prólogo

• Las direcciones se indican en formato CIDR (ejemplo: 192.0.2.0/24), que agrupa varias direcciones consecutivas.
• El formato de la lista incluye los rangos IP (ranges) utilizados por los siguientes productos:
  • kuite: todos los productos kSuite
  • vps: todos los VPS
  • public-cloud: todo el Public Cloud
  • all: abarca todas las IP de la red de Infomaniak

Rangos de direcciones IPv4 e IPv6

El enlace al archivo JSON que lista las IP es:

https://prefixes.infomaniak.com/json

Esta guía se refiere a las aplicaciones OAuth2 para conectarse a sus servicios externos a través de su identificador de inicio de sesión de Infomaniak.

Gestionar las aplicaciones OAuth2 de Infomaniak

Para ello:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic en el botón azul Crear una nueva aplicación:
   
3. Elija el tipo adecuado según sus necesidades y proyecto actual.
4. Asigne un nombre a la aplicación.
5. Ingrese la URL de la aplicación según la información técnica disponible.
6. Haga clic en el botón para crear la aplicación:
   
7. Copie la información (Client ID, Client secret) en un lugar seguro - ya no será accesible después de esto:
   

Esta guía explica cómo eliminar un sitio de un Alojamiento Web.

Introducción

• Una vez eliminado, el sitio ya no aparecerá en Internet con su URL anterior.
• El cupo de sitios disponibles en su alojamiento recuperará un espacio libre.

Eliminar un sitio de un alojamiento Web de pago

Para acceder a los Alojamientos Web y eliminar un sitio:

1. Haga clic aquí para acceder a la gestión de su alojamiento en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al alojamiento correspondiente:
   
3. Haga clic en el menú de acción ⋮ a la derecha del sitio correspondiente en la tabla que se muestra.
4. Haga clic en Eliminar el sitio:
   

Desvincular un sitio de un alojamiento Starter gratuito

Un alojamiento Starter (página web básica) contiene solo un sitio, que es específico del nombre de dominio, por lo tanto, no es posible, como en las ofertas de pago, realizar un multisitio ni eliminar un sitio para agregar otro.

Por lo tanto, debe cancelar directamente el alojamiento Starter:

• Esto cancelará solo su producto de alojamiento web Starter, es decir, la parte relacionada con su sitio web, sin afectar a otros productos, como el correo electrónico o el nombre de dominio, por ejemplo.
• Deberá confirmar la solicitud de cancelación por correo electrónico; de lo contrario, no se eliminarán datos.
• Se enviará una confirmación de cancelación a los demás administradores de la Organización, si los hubiera.
• Las copias de seguridad se eliminarán de forma irreversible al cancelar, lo que hará que cualquier restauración sea imposible.

Para cancelar:

1. Haga clic aquí para acceder a la gestión de su alojamiento en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic en el menú de acción ⋮ situado a la derecha del alojamiento correspondiente.
3. Seleccione la opción Cancelar:
   
4. Siga el procedimiento hasta el final.