Instala ArozOS Fácilmente: Guía para Principiantes

October 3, 2025

Guía de Instalación Actualizada de ArozOS

Última actualización: 1 de octubre de 2025

Esta guía proporciona instrucciones detalladas de instalación para la versión más reciente de ArozOS (v2.021), enfocándose principalmente en la configuración para Windows y abordando los desafíos comunes de instalación y sus soluciones.

Índice

Novedades de ArozOS

ArozOS v2.021 es la versión más reciente, que incluye soporte para modo Lax en cookies de inicio de sesión, correcciones de errores en el uso de CPU, nuevos paquetes de fondos de pantalla y otras mejoras. Los planes futuros contemplan una reescritura importante hacia la v3, con soporte para arquitecturas distribuidas de computación, almacenamiento y autenticación.

Instrucciones Detalladas de Instalación para Windows

1. Verificación de Requisitos Previos

Para garantizar una instalación exitosa en Windows, verifica los siguientes requisitos:

Requisitos del Sistema:

Windows 10 o posterior (Windows 11 compatible)
Versión de 64 bits recomendada (versión arm64 con soporte experimental)
Cuenta de usuario con privilegios de administrador
Espacio libre en disco: mínimo 2GB
Memoria: mínimo 512MB (recomendado 2GB o más)

2. Instalación Detallada de FFmpeg

En Windows, FFmpeg debe agregarse a la variable de entorno %PATH%. A continuación se presenta un procedimiento seguro para principiantes.

Paso 1: Descargar FFmpeg

Seleccionar Fuente de Descarga
- Descarga compilaciones confiables para Windows desde gyan.dev o el repositorio GitHub de BtbN
- Recomendado: Descarga la versión “release essentials” desde https://www.gyan.dev/ffmpeg/builds/
- La versión essentials es suficiente para principiantes (cubre la mayoría de casos de uso)
Selección de Archivo
- “ffmpeg-release-essentials.7z” (versión ligera, aproximadamente 31MB)
- “ffmpeg-release-full.7z” (versión completa, todos los códecs compatibles)

Paso 2: Extraer y Colocar FFmpeg

Preparar Software de Extracción

Instala 7-Zip (https://www.7-zip.org/)
Haz clic derecho en el archivo .7z descargado → “7-Zip” → “Extraer aquí”

Determinar Ubicación de Colocación

Ubicación recomendada: C:\ffmpeg

⚠️ Importante: Evita rutas con espacios (ej., Program Files)

Verificar Estructura de Carpetas

C:\ffmpeg\
├── bin\
│   ├── ffmpeg.exe    ← Archivo requerido
│   ├── ffplay.exe
│   └── ffprobe.exe
├── doc\
└── presets\

Paso 3: Agregar a la Variable de Entorno PATH (Más Importante)

Método A: Método GUI (Recomendado para Principiantes)

Abrir Propiedades del Sistema

Presiona las teclas Windows + X
Selecciona “Sistema”
Haz clic en “Configuración avanzada del sistema”

Configurar Variables de Entorno

Pasos:
1. Haz clic en el botón “Variables de entorno”
2. Selecciona “Path” de “Variables del sistema”
3. Haz clic en el botón “Editar”
4. Haz clic en el botón “Nuevo”
5. Ingresa C:\ffmpeg\bin (ruta a la carpeta bin)
6. Haz clic en “Aceptar” tres veces para guardar la configuración

Verificar Configuración

Reinicia el PC (¡Importante!)
Abre el Símbolo del sistema (Win+R → cmd → Enter)
Ingresa el siguiente comando:

ffmpeg -version

Si se muestra la información de versión, la configuración fue exitosa

Método B: Método PowerShell (Para Usuarios Avanzados)

Abre PowerShell con privilegios de administrador y ejecuta:

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\ffmpeg\bin", [EnvironmentVariableTarget]::Machine)

3. Instalación de Go (Para Compilar desde Código Fuente)

Solo requerido al compilar desde código fuente. Omite este paso si usas la versión binaria.

Instalación de Go en Windows

Descarga

Sitio web oficial: https://go.dev/dl/
Selecciona el instalador de Windows (.msi)
Se requiere Go 1.20 o posterior

Pasos de Instalación

1. Haz doble clic en el archivo .msi descargado
2. Haz clic en “Siguiente” para continuar
3. Ruta de instalación: La predeterminada (C:\Program Files\Go) está bien
4. Haz clic en “Instalar”
5. Haz clic en “Finalizar” para completar

Verificar Instalación

go version

4. Instalación de ArozOS (Versión Windows)

Método A: Versión Binaria (Recomendado para Principiantes)

Para despliegue en Windows, se recomienda descargar los binarios y archivos web desde la página de Releases.

Descargar Archivos Requeridos

Página de Releases en GitHub: https://github.com/tobychui/arozos/releases

Descarga de la versión más reciente (v2.021):

arozos_windows_amd64.exe
web.tar.gz

Crear Carpeta y Colocar Archivos

Crear estructura de carpetas:
C:\ArozOS\             ← Sin espacios, solo caracteres ASCII
├── arozos_windows_amd64.exe
└── web.tar.gz

Extraer web.tar.gz

Extrae con 7-Zip (puede extraerse automáticamente)
Diseñado para autoextraerse en el primer inicio

Procedimiento de Inicio

1. Haz doble clic en arozos_windows_amd64.exe
2. Si aparece advertencia del Firewall de Windows, haz clic en “Permitir acceso”
3. Se abre ventana del Símbolo del sistema (¡no la cierres!)
4. Accede a http://localhost:8080 en el navegador

Método B: Compilar desde Código Fuente (Para Usuarios Avanzados)

Instalar Git para Windows

Descarga desde https://git-scm.com/download/win
Instala con la configuración predeterminada

Obtener Código Fuente y Compilar

git clone https://github.com/tobychui/arozos
cd arozos\src
go mod tidy
go build

Iniciar

arozos.exe

5. Configuración Inicial y Solución de Problemas

Configuración del Primer Inicio

Crear Cuenta de Administrador
- Nombre de usuario: solo caracteres alfanuméricos (sin caracteres especiales)
- Contraseña: se recomienda 8 caracteres o más
- Dirección de correo electrónico: para recuperación de contraseña
Configurar Pool de Almacenamiento En Configuración del Sistema > Disco y Almacenamiento > Pools de Almacenamiento, configura los ajustes de disco
- Nombre: nombre fácil de entender (ej., LocalDrive)
- UUID: identificador único (solo alfanumérico, ej., local1)
- Ruta: C:\Users[nombre_usuario]\ArozOSFiles (ejemplo)

Problemas Comunes y Soluciones

Problema 1: Puerto 8080 en uso

# Iniciar en puerto diferente
arozos_windows_amd64.exe -port 8081

Problema 2: FFmpeg no reconocido

Síntoma: No se pueden reproducir archivos de video/música
Solución:
1. Vuelve a verificar la variable de entorno PATH
2. Reinicia el PC
3. Verifica con ffmpeg -version

Problema 3: Bloqueado por firewall

Solución: Agrega a las excepciones del Firewall de Windows

Configuración → Actualización y Seguridad → Seguridad de Windows
→ Firewall y protección de red → Permitir una aplicación
→ Agregar arozos_windows_amd64.exe

Problema 4: web.tar.gz no se extrae

Extrae manualmente con 7-Zip
Verifica que las carpetas web y system estén colocadas correctamente

6. Configuración Avanzada y Mejores Prácticas

Utilización de Opciones de Inicio

ArozOS admite numerosos parámetros de inicio para personalización según el caso de uso:

# Iniciar con HTTPS (se requiere certificado)
arozos_windows_amd64.exe -tls=true -tls_port 443 -key mykey.key -cert mycert.crt

# Cambiar tamaño máximo de carga (predeterminado 8192MB)
arozos_windows_amd64.exe -max_upload_size 25

# Modo demo (solo lectura)
arozos_windows_amd64.exe -demo_mode=true

# Habilitar tanto HTTP como HTTPS
arozos_windows_amd64.exe -port 80 -tls=true -key mykey.key -cert mycert.crt -tls_port 443

Ejecutar como Servicio (Inicio Automático)

Usando el Programador de Tareas de Windows:

Abre el Programador de Tareas
Selecciona “Crear Tarea”
Desencadenador: “Al iniciar el sistema”
Acción: “Iniciar un programa”
- Programa: C:\ArozOS\arozos_windows_amd64.exe
- Iniciar en: C:\ArozOS
Marca “Ejecutar con los privilegios más altos”

Refuerzo de Seguridad

Configuración HTTPS
- Obtén certificados de Let’s Encrypt, etc.
- Usa la opción -tls=true al iniciar
Restricciones de Acceso
- Permite solo IPs específicas mediante firewall
- Se recomienda acceso mediante VPN
Copias de Seguridad Regulares
- Copia de seguridad regular de carpetas system y files
- Protege archivos de base de datos

7. Instalación Sencilla Usando Docker (Método Alternativo)

El despliegue de ArozOS usando Dockerfile también es posible:

# Después de instalar Docker Desktop
docker pull [nombre-imagen-docker]
docker run -p 8080:8080 -v C:\ArozOSData:/data [nombre-imagen-docker]

8. Integración de Unidades de Red

ArozOS puede montar varios sistemas de archivos de red (SMB, SFTP, WebDAV, FTP):

Ejemplo de Configuración de Compartición SMB:

Configuración del Sistema → Disco y Almacenamiento → Pools de Almacenamiento
Haz clic en “Agregar Almacenamiento”
Tipo de Sistema de Archivos: SMB
Ruta: \\192.168.1.100\CarpetaCompartida
Ingresa nombre de usuario y contraseña

9. Pruebas con VirtualBox (Entorno de Prueba)

Para pruebas antes del despliegue en producción, se recomienda construir un entorno Ubuntu Server con VirtualBox:

Configuración de VirtualBox
- Memoria: Asigna 2GB o más
- Disco: 20GB o más
- Red: Adaptador Puente
Reenvío de Puertos
Puerto del host: 8080 → Puerto del invitado: 8080
Después de la Instalación de Ubuntu Server
- Sigue las instrucciones de instalación para Linux a continuación

Implementación Práctica: Instalación en Ubuntu (Publicado en febrero de 2024)

¿Qué es ArozOS? El contenido principal es el siguiente. Lo probé personalmente, y poder operarlo a través del navegador fue la característica más conveniente. Creo que tiene muchas otras aplicaciones también.

https://arozos.com

Antes de la instalación, permíteme describir sus características. ArozOS es un entorno de escritorio basado en web y sistema de gestión de archivos de código abierto. Se ejecuta principalmente en sistemas Linux y BSD, y se caracteriza por su fácil configuración y uso. A continuación se resumen sus principales características. Es perfecto para principiantes con su conjunto completo de funciones.

Características de ArozOS

Soporte Multiplataforma:
- Se ejecuta en varios sistemas operativos. Particularmente común para uso en Linux y sistemas operativos basados en BSD.
Entorno de Escritorio Basado en Web:
- Proporciona una interfaz de escritorio gráfica accesible a través de navegadores. Esto permite el acceso al sistema desde cualquier lugar mediante conexión a internet.
Gestión de Archivos:
- Cuenta con capacidades avanzadas de gestión de archivos, permitiendo cargar, descargar y editar archivos directamente desde la interfaz web.
Modularidad y Extensibilidad:
- Varios módulos y aplicaciones pueden integrarse con alta personalización. Los usuarios pueden agregar sus propias funciones.
Integración de Dispositivos IoT:
- Cuenta con integración de dispositivos IoT (Internet de las Cosas), permitiendo la gestión y control remoto de dispositivos.
Bajos Requisitos de Recursos:
- Opera con recursos del sistema relativamente bajos, haciéndolo utilizable en hardware antiguo o entornos con recursos limitados.

Resumen

ArozOS proporciona un entorno de escritorio basado en web accesible desde ubicaciones remotas, con funcionalidad integral que incluye gestión de archivos, gestión del sistema e integración de dispositivos IoT. Su flexibilidad y personalización son características particularmente atractivas para ingenieros y entusiastas del bricolaje.

ArozOS tiene multifuncionalidad y flexibilidad, permitiendo explicaciones desde varias perspectivas. Por lo tanto, las explicaciones de ArozOS pueden enfatizar diferentes aspectos dependiendo del público objetivo y el contexto. Las explicaciones técnicas para ingenieros se enfocan en detalles de desarrollo, mientras que las explicaciones para usuarios generales se centran en la facilidad de uso y funciones básicas, resultando en diferencias de explicación. A continuación se presenta una explicación técnica.

Desarrollo de Aplicaciones Web en ArozOS

AGI (ArozOS Gateway Interface): Interfaz para facilitar el desarrollo backend de aplicaciones web de ArozOS. Basado en la máquina virtual JavaScript Otto con compatibilidad para sintaxis JavaScript moderna.

Creación de Aplicaciones Web

Para crear nuevas aplicaciones web, crea una nueva carpeta dentro de la carpeta ./web/ bajo la raíz de ArozOS y coloca los archivos requeridos (ej., init.agi, index.html).
Script de Inicio (init.agi): Script que contiene configuración y verificaciones de entorno para hacer que ArozOS reconozca esta carpeta como una aplicación web.

Desarrollo Frontend

El desarrollo frontend de ArozOS no es diferente del desarrollo de aplicaciones web regulares.
Accesible en diferentes modos (modo escritorio web, modo escritorio móvil, modo independiente, modo PWA).

Desarrollo Backend

Ejecución de Scripts AGI: Usa la función agi_run del wrapper ao_module.js para ejecutar scripts AGI desde código JavaScript frontend.

Bibliotecas Relacionadas con AGI

System: Grupo de funciones disponibles en tiempo de ejecución AGI.
User: Grupo de funciones disponibles en ámbito de usuario.
Serverless: Habilita programación dinámica mediante llamadas AGI externas.
FileLib: Usado para interacción con el sistema de archivos.
AppData: Proporciona acceso de solo lectura a archivos dentro de carpetas web.
ImageLib: Proporciona funcionalidad básica de procesamiento de imágenes.
HTTP: Usado para ejecutar solicitudes GET, POST, HEAD y descargas.
Websocket: Usado para actualizar desde solicitudes HTTP regulares a conexiones WebSocket.
IoT: Proporciona fácil acceso a puntos finales de control de dispositivos IoT.
Share: Usado para acceder a la interfaz de compartición de ArozOS y generar UUIDs basados en archivos compartidos.

Ejemplos de Aplicación

Bot de Telegram (Serverless): Usa funcionalidad serverless para procesar solicitudes HTTP externas.
Ejecución en Espacio de Usuario (Serverless): Usado para importación y ejecución dinámica de scripts en espacio de usuario.

Esto explica la visión general del desarrollo de aplicaciones web en ArozOS, varias funciones usando AGI, y métodos de desarrollo frontend y backend. Instalaré este conveniente sistema operativo en un Ubuntu basado en CLI.

Procederé con referencia a la siguiente página.

https://github.com/tobychui/arozos

Según la descripción, se requiere Go versión 1.20 o superior, y FFmpeg también es necesario. Opcionalmente, wpa_supplicant o nmcli también pueden requerirse.

Lo instalaré en mi ubuntu22.04 basado en CLI doméstico. La pantalla LCD es difícil de ver, así que trabajaré mediante conexión SSH.

Primero, instalaré Go. Obtendré el enlace de descarga para Linux desde la página oficial.

https://go.dev/dl

Go (comúnmente llamado Go o Golang) es un lenguaje de programación desarrollado por Google. A continuación se presenta una breve explicación de las características principales de Go y su conveniencia.

Características de Go

Lenguaje Compilado:
- Go es un lenguaje compilado donde el código fuente se convierte a código binario antes de la ejecución. Esto resulta en una velocidad de ejecución más rápida.
Tipado Estático:
- Adopta tipado estático donde los tipos de variables se determinan en tiempo de compilación. Esto reduce los errores en tiempo de ejecución.
Sintaxis Simple y Legible:
- La sintaxis de Go es simple, legible y fácil de entender. Esto facilita el mantenimiento del código.
Soporte de Concurrencia:
- Admite concurrencia eficiente usando el concepto de hilos ligeros llamados “goroutines”.
Biblioteca Estándar Rica:
- Proporciona muchas bibliotecas estándar para redes, cifrado, procesamiento de datos, etc., utilizables para desarrollo de aplicaciones diversas.
Soporte Multiplataforma:
- Se ejecuta en muchos sistemas operativos incluyendo Windows, Linux, macOS.

Conveniencia

Desarrollo y Ejecución Rápidos: La sintaxis simple y la velocidad rápida de compilación y ejecución permiten desarrollo ágil.
Concurrencia Fácil: Implementar concurrencia usando goroutines es relativamente fácil, permitiendo utilización eficiente de procesadores multinúcleo.
Operación Estable: El tipado estático y las bibliotecas estándar potentes permiten construir aplicaciones estables.
Compatibilidad con Microservicios: Las características ligeras y rápidas lo hacen compatible con arquitectura de microservicios.

Resumen

Go se considera muy conveniente en el desarrollo de software moderno debido a su simplicidad, ejecución rápida y facilidad de concurrencia. Es particularmente ampliamente utilizado en campos como servicios web, aplicaciones basadas en la nube y microservicios.

Estos comandos son procedimientos de instalación de Go para entorno Linux. El significado de cada comando es el siguiente:

wget https://go.dev/dl/go1.21.6.linux-amd64.tar.gz
- Este comando descarga archivos binarios de Go desde internet. wget es un comando para descargar archivos desde la web.
sudo tar -C /usr/local -xzf go1.21.6.linux-amd64.tar.gz
- Este comando extrae e instala el archivo de Go descargado (archivo tar.gz). sudo es un comando para ejecutar comandos con privilegios de administrador. tar es un comando usado para crear y extraer archivos. En este caso, la opción -C /usr/local especifica el directorio de destino de extracción, y la opción -xzf extrae archivos comprimidos.
echo 'export PATH=$PATH:/usr/local/go/bin' >> .bashrc
- Este comando agrega la ruta ejecutable de Go a la variable de entorno PATH cuando se inicia el shell. echo es un comando que muestra cadenas especificadas, pero aquí se combina con >> .bashrc para agregar la cadena al final del archivo .bashrc. Esto hace que los comandos de Go estén disponibles en nuevas sesiones de terminal.
source ~/.bashrc
- Este comando carga el archivo .bashrc modificado y lo aplica a la sesión de shell actual. El comando source ejecuta comandos dentro del archivo especificado en la sesión de shell actual.
go version
- Este comando muestra la versión de Go instalado. Esto permite verificar que Go esté correctamente instalado.

Al ejecutar estos pasos, puedes instalar Go en un sistema Linux y prepararlo para su uso. El archivo descargado ya no es necesario, así que elimínalo.

sudo rm go1.21.6.linux-amd64.tar.gz

A continuación, compila arozos desde el código fuente. El contenido es el mismo que se describe en GitHub.

git clone https://github.com/tobychui/arozos
cd ./arozos/src/
go mod tidy
go build
./arozos
#sudo ./arozos para habilitar características de gestión de hardware y WiFi

Permíteme explicar esta secuencia de comandos. Esta es una serie de pasos para clonar código fuente del proyecto “arozos” en GitHub, compilarlo y ejecutarlo. A continuación se presentan explicaciones para cada comando.

git clone https://github.com/tobychui/arozos:
- Este comando copia (clona) código fuente del repositorio “arozos” en GitHub.
- git clone se usa para crear una copia de un repositorio remoto en una máquina local.
cd ./arozos/src/:
- El comando cd (cambiar directorio) se mueve a la carpeta src dentro del repositorio clonado.
- Esta carpeta contiene el código fuente para compilar.
go mod tidy:
- Un comando usado en proyectos de Go que organiza las dependencias del proyecto y descarga módulos necesarios.
- Este comando organiza los archivos go.mod y go.sum del proyecto y resuelve automáticamente las dependencias necesarias.
go build:
- Un comando de Go que compila código fuente y genera archivos binarios ejecutables.
- Este proceso crea archivos para ejecutar realmente programas desde código fuente.
./arozos:
- Este es un comando para ejecutar el archivo ejecutable compilado arozos.
- Si la compilación fue exitosa, el programa arozos se iniciará.
sudo ./arozos:
- Este comando ejecuta arozos con privilegios de superusuario (privilegios root).
- Ejecutar con privilegios de superusuario habilita funciones que requieren privilegios especiales, como características de gestión de hardware y WiFi.

Este procedimiento es un método común para compilar y ejecutar programas directamente desde código fuente. Se requiere comprensión básica de Go y desarrollo de software.

Con las operaciones anteriores, ArozOS está listo para operarse a través de un navegador. http://Dirección-IP-de-la-Máquina:8080

Configura nombre de usuario y contraseña en el primer acceso.

Después de eso, iniciar sesión con esta cuenta permite operar ArozOS.

La transferencia de archivos entre el host y ArozOS también es posible. Como prueba, transferí un archivo de música y lo escuché – salió sonido. El sonido proviene del PC operador, no del lado del servidor.

También puede configurarse como servidor de archivos, con protocolos de transferencia de archivos seleccionables desde WebDAV, SFTP y otros.

ArozOS está equipado con aplicaciones básicas como editores de texto y software de dibujo. Estas herramientas están disponibles para uso directo dentro del entorno de escritorio basado en web de ArozOS. Específicamente, las siguientes funciones están incluidas:

Editor de Texto:
- Proporciona un editor de texto básico para crear y editar archivos de texto simples. Admite procesamiento de texto básico incluyendo edición de código.
Software de Dibujo:
- Cuenta con una aplicación de dibujo con capacidades básicas de dibujo y edición de imágenes. Esto permite creación gráfica simple y modificación de imágenes.
Gestor de Archivos:
- Incluye un gestor de archivos para administrar archivos y carpetas, cargar y descargar archivos.
Otras Utilidades:
- A menudo incluye utilidades básicas para uso diario como calendario, calculadora, reproductor de música.

Además de estas aplicaciones básicas, ArozOS permite varias características adicionales y personalizaciones. Los desarrolladores y usuarios pueden agregar módulos y aplicaciones personalizados para extender la funcionalidad del sistema.

Parece haber una versión para Windows también, pero instalar Ubuntu Server en VirtualBox y seguir el mismo método de instalación que el anterior funcionará. Configura el reenvío de puertos también. El acceso es posible no solo desde PCs sino también desde teléfonos inteligentes con navegadores.

M	T	W	T	F	S	S
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30