npm package: @soymaycol/mayhost
Description: Un hosting simple para crear servidores de code-server con PHP
Author: SoyMaycol
Latest version: 1.0.4

**MayHost** es una plataforma de hosting local que permite crear y gestionar servidores code-server de forma sencilla y profesional. Diseñado para desarrolladores que necesitan un entorno de desarrollo accesible desde cualquier dispositivo.

```
┌─────────────────────────────────────────────────────────────┐
│ CARACTERÍSTICAS PRINCIPALES                                 │
├─────────────────────────────────────────────────────────────┤
│ • Sistema de usuarios con autenticación                     │
│ • Gestión de servidores code-server                         │
│ • Sistema de monedas virtuales (MayCoins)                   │
│ • Interfaz web responsive y moderna                         │
│ • Panel de administración intuitivo                         │
│ • Primer servidor completamente gratuito                    │
└─────────────────────────────────────────────────────────────┘
```

## ▓▓▓ INSTALACIÓN

### ▪ Requisitos del Sistema

```bash
┌─ SERVIDOR WEB ────────────────────────────────┐
│ • Apache/Nginx con PHP 7.4+                  │
│ • Extensiones PHP: json, session             │
│ • Permisos de escritura en directorio        │
└───────────────────────────────────────────────┘

┌─ CODE-SERVER ─────────────────────────────────┐
│ • Node.js 16+ instalado                      │
│ • code-server instalado globalmente          │
│ • Puertos 8081+ disponibles                  │
└───────────────────────────────────────────────┘
```

### ▪ Instalación via npm

```bash
# Instalación global
npm install -g @soymaycol/mayhost

# Verificar instalación
mayhost --version
```

## ▓▓▓ USO

### ▪ Comandos Básicos

```bash
# Iniciar servidor en puerto por defecto (8080)
mayhost

# Iniciar en puerto específico
mayhost -p 3000
mayhost --port 3000

# Ver version
mayhost --version
```

### ▪ Ejemplos de Uso

```
╭─────────────────────────────────────────────────╮
│ EJEMPLO 1: Inicio Básico                        │
├─────────────────────────────────────────────────┤
│ $ mayhost                                       │
│ ✓ MayHost iniciado en http://localhost:8080     │
╰─────────────────────────────────────────────────╯

╭─────────────────────────────────────────────────╮
│ EJEMPLO 2: Puerto Personalizado                 │
├─────────────────────────────────────────────────┤
│ $ mayhost --port 9000                           │
│ ✓ MayHost iniciado en http://localhost:9000     │
╰─────────────────────────────────────────────────╯
```

## ▓▓▓ FUNCIONALIDADES

### ▪ Sistema de Usuarios

```
┌─ REGISTRO Y LOGIN ────────────────────────────┐
│ • Registro de nuevos usuarios                 │
│ • Autenticación con contraseña hasheada      │
│ • Sesiones PHP seguras                       │
│ • 250 MayCoins iniciales por usuario         │
└───────────────────────────────────────────────┘
```

### ▪ Gestión de Servidores

```
┌─ CREACIÓN DE SERVIDORES ──────────────────────┐
│ • Primer servidor gratuito                   │
│ • Servidores adicionales: 250 MayCoins       │
│ • Asignación automática de puertos           │
│ • Configuración personalizable               │
└───────────────────────────────────────────────┘

┌─ ADMINISTRACIÓN ──────────────────────────────┐
│ • Panel de control web                       │
│ • Estado en tiempo real                      │
│ • Acceso directo a servidores                │
│ • Copia de credenciales                      │
└───────────────────────────────────────────────┘
```

### ▪ Características de la UI

```
┌─ INTERFAZ MODERNA ────────────────────────────┐
│ • Diseño minimalista y profesional           │
│ • Sidebar colapsable                          │                │
│ • Animaciones suaves                          │
│ • Iconos FontAwesome                          │
└───────────────────────────────────────────────┘
```

## ▓▓▓ SEGURIDAD

### ▪ Medidas Implementadas

```
┌─ AUTENTICACIÓN ───────────────────────────────┐
│ • Contraseñas hasheadas con PASSWORD_DEFAULT  │
│ • Sesiones PHP seguras                        │
│ • Validación de entrada de datos              │
│ • Protección CSRF básica                      │
└───────────────────────────────────────────────┘

┌─ AUTORIZACIÓN ────────────────────────────────┐
│ • Verificación de sesión activa               │
│ • Acceso controlado a funciones               │
│ • Aislamiento por usuario                     │
└───────────────────────────────────────────────┘
```

### ▪ Logs y Diagnóstico

```bash
# Verificar procesos code-server
ps aux | grep code-server

# Verificar puertos ocupados
netstat -tlnp | grep 808

# Verificar logs del servidor web
tail -f /var/log/apache2/error.log
```

## ▓▓▓ LICENCIA

```
┌─────────────────────────────────────────────────────────────┐
│ MIT License                                                 │
│                                                             │
│ Copyright (c) 2024 SoyMaycol                               │
│                                                             │
│ Por la presente se concede permiso, libre de cargos,       │
│ a cualquier persona que obtenga una copia de este          │
│ software y de los archivos de documentación asociados      │
│ (el "Software"), a utilizar el Software sin restricción... │
└─────────────────────────────────────────────────────────────┘
```

---

Hecho por SoyMaycol <3