🛠️ Proxmox Tools

Colección de scripts útiles para administrar Proxmox VE, contenedores LXC y máquinas virtuales con interfaces interactivas al estilo Proxmox VE Helper Scripts.

📋 Scripts Disponibles

Script	Descripción	Uso Rápido
lxc-autologin.sh	Configurar auto-login en contenedores LXC	`bash <(wget -qLO - https://raw.githubusercontent.com/Pocholo95/personal-proxmox-tools/main/lxc-autologin.sh)`

🚀 Características

✨ Interfaces interactivas con menús visuales
🎨 Diseño colorido y fácil de usar
⚡ Modo CLI para automatización
💾 Instalación permanente opcional
🛡️ Validaciones de seguridad incorporadas
📖 Documentación detallada en cada script
🔄 Feedback visual durante operaciones

📦 Instalación

Opción 1: Uso Directo (Sin Instalar)

Ejecuta cualquier script directamente desde GitHub:

bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<nombre-script>.sh)

Opción 2: Clonar Repositorio

git clone https://github.com/tu-usuario/proxmox-tools.git
cd proxmox-tools
chmod +x *.sh

Opción 3: Instalación Individual

Cada script puede instalarse de forma permanente en /usr/local/bin/:

bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<nombre-script>.sh) --install

📚 Documentación de Scripts

🔐 lxc-autologin.sh

Configura auto-login en contenedores LXC de Proxmox, eliminando la necesidad de ingresar usuario y contraseña.

Uso Rápido:

# Modo interactivo
bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/lxc-autologin.sh)

# Modo CLI
bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/lxc-autologin.sh) 104

# Con usuario específico
bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/lxc-autologin.sh) 104 miusuario

# Instalar permanentemente
bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/lxc-autologin.sh) --install

Características:

✅ Interfaz interactiva con menú visual
📊 Lista de contenedores disponibles
🔄 Spinner animado durante operaciones
⚠️ Validación de contenedor y estado
💾 Instalación opcional como comando

Documentación completa: Ver en Wiki

🔧 Requisitos

Proxmox VE 7.x o superior
Acceso root al host de Proxmox
wget o curl instalado
Bash 4.0 o superior

📖 Guía de Uso General

Modo Interactivo

Todos los scripts ofrecen un menú interactivo cuando se ejecutan sin argumentos:

bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<script>.sh)

Esto mostrará un menú con opciones como:

Función principal del script
Listar recursos disponibles
Instalar script en el sistema
Ver información y ayuda
Salir

Modo CLI

Para automatización o uso rápido, pasa argumentos directamente:

bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<script>.sh) [argumentos]

Instalación Permanente

Para instalar cualquier script como comando del sistema:

# Con sudo si es necesario
bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<script>.sh) --install

Después podrás usar el comando directamente:

nombre-comando [argumentos]

⚠️ Consideraciones de Seguridad

🔒 Revisa siempre el código antes de ejecutar scripts de internet
🧪 Prueba primero en entornos de desarrollo
💾 Realiza backups antes de modificar configuraciones críticas
🔐 Ten cuidado con scripts que afectan la seguridad (como auto-login)
📝 Lee la documentación de cada script antes de usarlo

🐛 Troubleshooting

Error: "pct: command not found"

Solución: Asegúrate de estar ejecutando el script en el host de Proxmox, no dentro de un contenedor.

Error de permisos

Solución: Ejecuta con sudo o como root:

sudo bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<script>.sh)

El menú no se ve bien

Solución: Asegúrate de usar una terminal con soporte de colores ANSI. Si el problema persiste, usa el modo CLI.

Más ayuda

Para cada script específico, ejecuta:

bash <(wget -qLO - https://raw.githubusercontent.com/tu-usuario/proxmox-tools/main/<script>.sh) --help

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Aquí hay algunas formas de ayudar:

🐛 Reportar bugs - Abre un issue en GitHub
💡 Sugerir ideas - Propón nuevos scripts o mejoras
📝 Mejorar documentación - Ayuda a hacer más claro el README
🔧 Enviar pull requests - Contribuye código

¿Cómo contribuir?

Fork el repositorio
Crea una rama (git checkout -b feature/nuevo-script)
Commit tus cambios (git commit -am 'Agregar nuevo script')
Push a la rama (git push origin feature/nuevo-script)
Abre un Pull Request

Lineamientos para nuevos scripts

Al crear un nuevo script para este repositorio:

✅ Incluir modo interactivo con menú
✅ Incluir modo CLI para automatización
✅ Usar colores para mejor UX
✅ Validar entradas y condiciones
✅ Incluir opción --help
✅ Incluir opción --install
✅ Documentar en el README
✅ Comentar el código adecuadamente

📝 Roadmap

Scripts planeados para futuras versiones:

Contenedores LXC

💾 Backup automático y programado
📋 Clonación masiva con configuración
🔄 Actualización masiva de contenedores
📊 Monitoreo de recursos en tiempo real
🗂️ Gestión de templates

Máquinas Virtuales

🖥️ Creación rápida de VMs
💿 Gestión de ISOs y templates
📸 Snapshots automatizados

Networking

🌐 Configuración simplificada de redes
🔒 Gestión de firewall
🌉 Configuración de bridges

Almacenamiento

💾 Gestión de storages
📊 Análisis de uso de disco
🧹 Limpieza de recursos no utilizados

Sistema

⚙️ Configuración inicial de Proxmox
🔧 Mantenimiento automático
📈 Dashboard de estado del cluster

¿Tienes una idea? Abre un issue con la etiqueta enhancement.

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

👤 Autor

Tu Nombre

GitHub: @tu-usuario
Repositorio: proxmox-tools

🙏 Agradecimientos

Inspirado en Proxmox VE Helper Scripts de tteck
Comunidad de Proxmox VE
Todos los contribuidores del proyecto

📞 Soporte

🐛 Reportar bugs: GitHub Issues
💬 Discusiones: GitHub Discussions
📖 Documentación: GitHub Wiki
⭐ Si te es útil: Dale una estrella al repositorio

🌟 Estrellas en el tiempo

Hecho con ❤️ para la comunidad de Proxmox

Si este proyecto te ayudó, considera darle una ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
README.md		README.md
lxc-autologin.sh		lxc-autologin.sh

Pocholo95/personal-proxmox-tools

Folders and files

Latest commit

History

Repository files navigation