158 lines
4.3 KiB
Markdown
158 lines
4.3 KiB
Markdown
# 🛠️ Guía de Instalación en HestiaCP
|
|
|
|
**Desarrollado por U-Site.app** - [https://u-site.app](https://u-site.app)
|
|
|
|
## ⚠️ Problema Común en Hostings Compartidos
|
|
|
|
El instalador automático (`install.php`) **NO FUNCIONA** en hostings compartidos como HestiaCP, cPanel, etc., porque requiere privilegios de administrador para crear bases de datos y usuarios.
|
|
|
|
## ✅ Solución: Instalación Manual
|
|
|
|
Usa el archivo `install_manual.php` que he creado específicamente para hostings compartidos.
|
|
|
|
---
|
|
|
|
## 📋 Pasos en HestiaCP
|
|
|
|
### 1. Crear Base de Datos
|
|
1. Entra al panel de HestiaCP
|
|
2. Ve a **"Databases"** o **"Base de datos"**
|
|
3. Haz clic en **"Add Database"**
|
|
4. Configura:
|
|
- **Database Name:** `whatsapp_bot` (o el nombre que prefieras)
|
|
- **Database User:** Crea un usuario (ej: `whatsapp_user`)
|
|
- **Password:** Usa una contraseña segura
|
|
- **Privileges:** Selecciona **ALL** o todos los permisos
|
|
|
|
### 2. Anotar Credenciales
|
|
Guarda esta información que necesitarás:
|
|
|
|
```
|
|
Host: localhost
|
|
Puerto: 3306 (generalmente)
|
|
Base de datos: [el nombre que creaste]
|
|
Usuario: [el usuario que creaste]
|
|
Contraseña: [la contraseña que configuraste]
|
|
```
|
|
|
|
### 3. Ejecutar Instalación Manual
|
|
1. Abre tu navegador web
|
|
2. Ve a: `https://tudominio.com/ruta-del-bot/install_manual.php`
|
|
3. Completa el formulario con las credenciales del paso anterior
|
|
4. Haz clic en **"Configurar Sistema"**
|
|
|
|
---
|
|
|
|
## 🔧 Características del Instalador Manual
|
|
|
|
### ✅ Lo que SÍ hace:
|
|
- ✅ Conecta con tu BD existente
|
|
- ✅ Crea todas las tablas necesarias
|
|
- ✅ Inserta datos de configuración inicial
|
|
- ✅ Genera contraseña de admin aleatoria
|
|
- ✅ Configura el archivo `config.php`
|
|
- ✅ Detecta automáticamente la URL del servidor
|
|
- ✅ Protege contra reinstalaciones accidentales
|
|
- ✅ Crea archivo de credenciales
|
|
|
|
### ❌ Lo que NO necesita:
|
|
- ❌ Privilegios de root/administrador
|
|
- ❌ Crear la base de datos (ya la creaste)
|
|
- ❌ Crear el usuario (ya lo creaste)
|
|
- ❌ Configuración especial del servidor
|
|
|
|
---
|
|
|
|
## 📁 Estructura Típica en HestiaCP
|
|
|
|
```
|
|
/public_html/
|
|
├── tu-bot/
|
|
│ ├── install_manual.php ← Usa este archivo
|
|
│ ├── install.php ← NO uses este (no funciona)
|
|
│ ├── config/
|
|
│ ├── api/
|
|
│ └── ...resto de archivos
|
|
```
|
|
|
|
---
|
|
|
|
## 🚨 Errores Comunes y Soluciones
|
|
|
|
### Error: "se queda cargando"
|
|
**Problema:** El instalador automático intenta crear BD con privilegios que no tienes.
|
|
**Solución:** Usa `install_manual.php` en lugar de `install.php`
|
|
|
|
### Error: "Access denied for user"
|
|
**Problema:** Credenciales incorrectas o permisos insuficientes.
|
|
**Solución:**
|
|
- Verifica que el usuario tenga ALL PRIVILEGES en la BD
|
|
- Confirma host, usuario y contraseña
|
|
- Asegúrate de que la BD existe
|
|
|
|
### Error: "Connection refused"
|
|
**Problema:** Host o puerto incorrectos.
|
|
**Solución:**
|
|
- Usa `localhost` como host
|
|
- Confirma que el puerto sea 3306
|
|
- Verifica que MySQL esté corriendo
|
|
|
|
### Error: "Database doesn't exist"
|
|
**Problema:** Nombre de BD incorrecto o no existe.
|
|
**Solución:**
|
|
- Verifica el nombre exacto en el panel de HestiaCP
|
|
- Asegúrate de que la BD fue creada correctamente
|
|
|
|
---
|
|
|
|
## 🎯 Después de la Instalación
|
|
|
|
1. **Guarda las credenciales:** Se generará un archivo `CREDENCIALES_SISTEMA.txt`
|
|
2. **Prueba el sistema:** Ve a `test.php` para verificar
|
|
3. **Configura WhatsApp:** Ve a `server_setup.php`
|
|
4. **Accede al panel:** Ve a `index.php` con usuario `admin`
|
|
|
|
---
|
|
|
|
## 📞 Soporte Técnico
|
|
|
|
- **Email:** support@u-site.app
|
|
- **Web:** https://u-site.app/support
|
|
- **Documentación:** Este archivo y los comentarios en el código
|
|
|
|
---
|
|
|
|
## 🔐 Credenciales por Defecto
|
|
|
|
### Base de Datos
|
|
- **Host:** localhost
|
|
- **Usuario/Contraseña:** Los que TÚ configuraste en HestiaCP
|
|
|
|
### Panel Admin
|
|
- **Usuario:** admin
|
|
- **Contraseña:** Se genera automáticamente (se muestra durante instalación)
|
|
|
|
---
|
|
|
|
## ⚡ Comandos Útiles para Debugging
|
|
|
|
### Verificar conexión desde terminal:
|
|
```bash
|
|
mysql -h localhost -u tu_usuario -p tu_basedatos
|
|
```
|
|
|
|
### Ver tablas después de instalar:
|
|
```sql
|
|
USE tu_basedatos;
|
|
SHOW TABLES;
|
|
```
|
|
|
|
### Ver configuración de usuario:
|
|
```sql
|
|
SELECT User, Host FROM mysql.user WHERE User='tu_usuario';
|
|
SHOW GRANTS FOR 'tu_usuario'@'localhost';
|
|
```
|
|
|
|
---
|
|
|
|
**¡Listo! Con esta guía deberías poder instalar sin problemas en HestiaCP.** 🚀 |