Despliegue de Stra

Configuración

Ahora que todos los componentes están instalados, es hora de configurarlos para que funcionen con Strapi.

1. Creación de la base de datos PostgreSQL para Strapi

Primero, crearemos un usuario y una base de datos en PostgreSQL a los que Strapi se conectará.

# Conectarse a PostgreSQL como usuario postgres
sudo -i -u postgres psql

Dentro de la consola de PostgreSQL, ejecute los siguientes comandos:

CREATE USER strapiuser WITH PASSWORD 'su_contraseña_muy_segura';
CREATE DATABASE strapidb WITH OWNER strapiuser;
GRANT ALL PRIVILEGES ON DATABASE strapidb TO strapiuser;
\q

Reemplace ваш_очень_сложный_пароль por una contraseña segura. Salga de la consola de PostgreSQL (\q).

2. Creación del proyecto Strapi

Vaya al directorio de inicio de su usuario (/home/strapiuser) o a otro directorio conveniente, como /var/www. Usaremos /var/www para las aplicaciones web.

sudo mkdir -p /var/www/strapi
sudo chown -R strapiuser:strapiuser /var/www/strapi
cd /var/www/strapi

Cree un nuevo proyecto Strapi. Usamos el flag --no-run para que no se inicie inmediatamente.

npx create-strapi-app@latest my-strapi-project --quickstart --no-run

Durante la instalación, se le pedirá que elija el tipo de instalación. Para esta guía, seleccione Custom (manual settings) y luego PostgreSQL como base de datos. Ingrese los datos de conexión a la base de datos que creó anteriormente (Host: 127.0.0.1, Port: 5432, Database: strapidb, Username: strapiuser, Password: su_contraseña_muy_segura).

Vaya al directorio del proyecto:

cd my-strapi-project

3. Configuración de las variables de entorno de Strapi

Es mejor almacenar los secretos y los parámetros de configuración en el archivo .env. Cree o edite el archivo .env en el directorio raíz de su proyecto Strapi.

nano .env

Agregue o actualice las siguientes líneas:

HOST=0.0.0.0
PORT=1337
APP_KEYS=su_clave_de_aplicación_muy_compleja_y_larga # Se genera automáticamente con --quickstart, pero es mejor regenerarla
API_TOKEN_SALT=su_clave_muy_compleja_y_larga_para_tokens_api
ADMIN_JWT_SECRET=su_clave_muy_compleja_y_larga_para_el_panel_de_administración
JWT_SECRET=su_clave_muy_compleja_y_larga_para_jwt

DATABASE_CLIENT=pg
DATABASE_HOST=127.0.0.1
DATABASE_PORT=5432
DATABASE_NAME=strapidb
DATABASE_USERNAME=strapiuser
DATABASE_PASSWORD=su_contraseña_muy_segura
DATABASE_SSL=false

NODE_ENV=production

Para generar claves aleatorias fuertes para APP_KEYS, API_TOKEN_SALT, ADMIN_JWT_SECRET, JWT_SECRET, puede usar el comando:

node -e "console.log(crypto.randomBytes(32).toString('hex'))"

Ejecútelo varias veces para obtener claves únicas para cada parámetro. Guarde el archivo.

4. Inicio de Strapi con PM2

Ahora iniciaremos Strapi en modo producción usando PM2.

# Asegúrese de estar en el directorio raíz de su proyecto Strapi (/var/www/strapi/my-strapi-project)
npm run build
pm2 start npm --name "strapi-app" -- run start
# Guardar la lista de procesos de PM2 para el inicio automático
pm2 save

Verifique el estado de Strapi:

pm2 list
pm2 logs strapi-app

Strapi debería estar en ejecución y escuchando en el puerto 1337 (por defecto).

5. Configuración de Nginx como proxy inverso

Crearemos un archivo de configuración de Nginx para su dominio (por ejemplo, api.yourdomain.com).

sudo nano /etc/nginx/sites-available/api.yourdomain.com

Pegue la siguiente configuración, reemplazando api.yourdomain.com por su dominio:

server {
    listen 80;
    server_name api.yourdomain.com;

    location / {
        proxy_pass http://localhost:1337;
        proxy_http_version 1.1;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_cache_bypass $http_upgrade;
    }
}

Guarde el archivo. Cree un enlace simbólico a este archivo en sites-enabled y verifique la sintaxis de Nginx:

sudo ln -s /etc/nginx/sites-available/api.yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t

Si la sintaxis es correcta (syntax is ok), recargue Nginx:

sudo systemctl restart nginx

En este punto, su Strapi debería ser accesible por HTTP a través de Nginx en la dirección http://api.yourdomain.com (asegúrese de que el registro DNS de su dominio apunte a la IP de su VPS).

6. Configuración de SSL con Certbot (Let's Encrypt)

Para garantizar la seguridad y la confianza, es necesario configurar HTTPS. Certbot obtendrá e instalará automáticamente certificados SSL de Let's Encrypt.

# Instalar Certbot y el plugin de Nginx
sudo apt install -y certbot python3-certbot-nginx
# Obtener e instalar el certificado
sudo certbot --nginx -d api.yourdomain.com

Certbot le hará varias preguntas: una dirección de correo electrónico para notificaciones, la aceptación de los términos de servicio y, posiblemente, le ofrecerá redirigir el tráfico HTTP a HTTPS (seleccione "2: Redirect"). Certbot actualizará automáticamente la configuración de Nginx, añadiendo los parámetros SSL.

Verifique que Certbot haya configurado la renovación automática de certificados:

sudo systemctl status certbot.timer

El temporizador debe estar activo. Si no lo está, actívelo: sudo systemctl enable certbot.timer. Ahora su Strapi está disponible a través de HTTPS: https://api.yourdomain.com.

7. Verificación de la funcionalidad

Abra su dominio (por ejemplo, https://api.yourdomain.com) en el navegador. Debería ver la página de bienvenida de Strapi o la página de inicio de sesión del panel de administración. Si es la primera vez que lo inicia, se le pedirá que cree el primer administrador.

También puede verificar la disponibilidad de la API a través de curl:

curl -I https://api.yourdomain.com/admin/

Debería ver los encabezados HTTP con el código de estado 200 OK o 302 Found (redirección a la página de inicio de sesión).

Solución de problemas + Preguntas frecuentes

En esta sección se recopilan respuestas a preguntas frecuentes y soluciones a problemas típicos que puede encontrar al desplegar Strapi.

Nginx devuelve un error 502 Bad Gateway

Qué verificar: El error 502 generalmente significa que Nginx no puede comunicarse con el servicio de backend (en nuestro caso, Strapi). Asegúrese de que Strapi esté en ejecución y escuchando en el puerto correcto (por defecto 1337). Verifique los logs de Nginx (sudo tail -f /var/log/nginx/error.log) y los logs de Strapi (pm2 logs strapi-app).

Cómo solucionar: Asegúrese de que el proceso PM2 de Strapi esté activo (pm2 list). Si no lo está, intente iniciarlo manualmente (cd /var/www/strapi/my-strapi-project && npm run start) y revise los errores. Verifique que proxy_pass http://localhost:1337; en la configuración de Nginx apunte al puerto correcto.

Strapi no se inicia, errores de conexión a la base de datos

Qué verificar: Verifique el archivo .env en la raíz del proyecto Strapi. Asegúrese de que los parámetros DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USERNAME y DATABASE_PASSWORD sean correctos. Verifique que PostgreSQL esté en ejecución (sudo systemctl status postgresql) y que el usuario strapiuser tenga permisos de acceso a la base de datos strapidb.

Cómo solucionar: Restablezca la contraseña del usuario de PostgreSQL (sudo -i -u postgres psql -c "ALTER USER strapiuser WITH PASSWORD 'новый_пароль';") y actualícela en .env. Asegúrese de que el host local 127.0.0.1 esté permitido para la conexión en el archivo /etc/postgresql/16/main/pg_hba.conf (debe haber una línea host all all 127.0.0.1/32 md5 o scram-sha-256). Después de los cambios en pg_hba.conf, reinicie PostgreSQL: sudo systemctl restart postgresql.

No puedo obtener un certificado SSL con Certbot

Qué verificar: Asegúrese de que su dominio (por ejemplo, api.yourdomain.com) apunte correctamente a la dirección IP de su VPS a través de un registro A en el DNS. Certbot debe poder comunicarse con su servidor en el puerto 80 (HTTP) para verificar la propiedad del dominio. Verifique que Nginx esté en ejecución y escuchando correctamente en el puerto 80.

Cómo solucionar: Deshabilite temporalmente UFW (sudo ufw disable) e intente de nuevo. Si esto ayudó, significa que el firewall está bloqueando los puertos. Asegúrese de que sudo ufw allow http y sudo ufw allow https estén habilitados. Verifique la configuración de Nginx en busca de errores (sudo nginx -t). Asegúrese de que no haya otros procesos ocupando los puertos 80 o 443.

¿Qué configuración mínima de VPS es adecuada?

Para un despliegue mínimo de Strapi para un proyecto pequeño o de prueba, puede comenzar con un VPS con 2 núcleos de CPU, 4 GB de RAM y 80 GB de SSD. Esto será suficiente para el sistema operativo, PostgreSQL y Strapi sin una carga alta. Sin embargo, si planea un uso activo, un gran volumen de contenido o muchos usuarios, se recomienda aumentar la RAM a 8 GB y, posiblemente, considerar discos más potentes.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la mayoría de los proyectos Strapi, especialmente en las etapas iniciales e intermedias de desarrollo, un VPS es la opción óptima. Ofrece un excelente equilibrio entre rendimiento, flexibilidad y costo. Un servidor dedicado (dedicated) solo se justifica con cargas muy altas (miles de usuarios simultáneos, operaciones intensivas de BD), la necesidad de máxima aislamiento de recursos, requisitos específicos de hardware o normativas regulatorias especiales. Comience con un VPS y escale a un dedicado si y cuando sus necesidades superen las capacidades de virtualización.

Rendimiento lento del panel de administración de Strapi

Qué verificar: El rendimiento lento del panel de administración puede ser causado por la falta de recursos del VPS (CPU o RAM), una base de datos lenta o consultas no optimizadas. Verifique el uso de recursos del servidor (htop o free -h).

Cómo solucionar: Aumente la cantidad de RAM en el VPS si está cerca de agotarse. Optimice las consultas a la base de datos si tiene estructuras de contenido muy complejas. Asegúrese de que la base de datos esté en un disco SSD. Para entornos de producción, siempre ejecute Strapi en modo NODE_ENV=production, ya que en modo de desarrollo consume más recursos.

Conclusiones y próximos pasos

¡Felicidades! Ha desplegado con éxito Strapi Headless CMS en su VPS, configurando PostgreSQL, Nginx y certificados SSL. Ahora tiene una plataforma potente, segura y flexible para la gestión de contenido, lista para integrarse con cualquier aplicación frontend.

Aquí hay algunos próximos pasos que puede tomar para el desarrollo posterior de su proyecto Strapi:

• Desarrollo frontend: Utilice su API de Strapi para crear sitios web (con React, Vue, Next.js, Nuxt.js), aplicaciones móviles u otros productos digitales.
• Extensión de la funcionalidad de Strapi: Explore la documentación de Strapi para crear campos personalizados, plugins, ciclos de vida y roles de usuario.
• Monitoreo y optimización: Implemente herramientas de monitoreo (por ejemplo, Prometheus + Grafana) para rastrear el rendimiento del servidor y de Strapi, a fin de responder rápidamente a posibles problemas y optimizar los recursos.