wings

command module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2026 License: MIT Imports: 3 Imported by: 0

README

╦ ╦╦╔╗╔╔═╗╔═╗  ╔╦╗╔═╗╔═╗╔╦╗╔═╗╔╗╔
║║║║║║║║ ╦╚═╗   ║║╠═╣║╣ ║║║║ ║║║║
╚╩╝╩╝╚╝╚═╝╚═╝  ═╩╝╩ ╩╚═╝╩ ╩╚═╝╝╚╝
  

// HIGH-PERFORMANCE GO CONTAINER ENGINE & ISOLATED RUNTIME DAEMON //

Golang 1.23 Docker API SFTP Subsystem Sub-millisecond


⚡ // 01. DAEMON TELEMETRY & RUNTIME VISUALS

🚀 REAL-TIME STREAMING & LOW-LATENCY TELEMETRY

Wings Telemetry Stream

Flujo bidireccional mediante WebSockets a 60 FPS: comandos stdin, streams stdout/stderr filtrados y estados de contenedor.


🛰️ NODE CLUSTERING & HEARTBEATS

Node Clustering
Sincronización de credenciales JWT, puertos SFTP y certificados TLS por nodo.
📊 HARDWARE QUOTA & CGROUPS MONITOR

Cluster Health
Control estricto de cgroups v1/v2: CPU throttling, contención de RAM y cuotas de disco.

🛰️ // 02. INTERNALS & DAEMON ARCHITECTURE

flowchart TD
    Panel["⚡ Cinammon Panel (HTTP API / WebSockets)"] -->|JWT Bearer Token| Router["🌐 HTTP/WS Router"]
    
    subgraph Wings[" 🚀 CINAMMON WINGS RUNTIME ENGINE "]
        Router --> Sched["⏱️ Task Scheduler & Cron"]
        Router --> Sys["💻 System Telemetry (/api/system)"]
        Router --> ServMgt["🎮 Server Instance Controller"]
        
        ServMgt --> IO["🔄 In-Memory IO Multiplexer"]
        ServMgt --> Cgroups["🛡️ Linux cgroups Limits (RAM/CPU/IO)"]
        
        SFTP["🔒 Embedded SFTP Server (Port 2022)"] --> Disk["💾 /var/lib/cinammon/volumes"]
    end
    
    ServMgt -->|Docker Engine API / UNIX Socket| Docker["🐳 Docker Engine Containers"]
    IO <-->|Bidirectional Stream| Docker

🔮 // 03. CYBERNETIC CAPABILITIES

  • ⚡ Zero Overhead Go Core: Construido enteramente en Golang nativo, optimizado para concurrencia masiva con miles de goroutines y consumo mínimo de memoria RAM (< 50 MB en reposo).
  • 🔒 Servidor SFTP Nativo Embebido: Olvídate de configurar OpenSSH o demonios externos. Wings integra un subsistema SFTP criptográfico que autentica usuarios directamente contra el token del Cinammon Panel.
  • 🛡️ Cgroups v1 & v2 Hard Isolation: Cumplimiento riguroso de límites de hardware. Si un servidor excede su cuota de memoria, el kernel es instruido para prevenir kernel panics en el nodo host.
  • 🌐 WebSockets Multiplexados: Transmisión de consola en tiempo real, eventos de arranque/parada, monitoreo de uso de recursos y control de energía sin recargas ni latencia.
  • 📦 Copias de Seguridad Cifradas: Creación de archivos comprimidos de alta velocidad transmitidos a almacenamiento local o proveedores S3 compatibles.

🛠️ // 04. COMPILATION & DAEMON SETUP

Requisitos del Nodo Host

  • Sistema Operativo: Linux (Debian 12+, Ubuntu 22.04+, RHEL 9+, Alpine Linux) o macOS (desarrollo con Lima VM)
  • Kernel: Linux 5.15+ con módulos cgroups habilitados
  • Go: 1.23+ (solo para compilación desde fuente)
  • Docker: Docker Engine 24.0+ con systemd cgroup driver

Compilación desde Fuente

# 1. Clonar el repositorio
git clone https://github.com/cinammon-net/wings.git
cd wings

# 2. Descargar módulos de Go
go mod download

# 3. Compilar el binario optimizado
make build

# O compilar directamente con el compilador de Go:
CGO_ENABLED=0 go build -ldflags="-s -w" -o build/wings .

Configuración del Daemon (/etc/cinammon/config.yml)

Descarga el archivo YAML desde el Panel de Cinammon (Nodos -> Tu Nodo -> Configuration File):

debug: false
uuid: 1337cafe-0000-0000-0000-000000000001
token_id: cinammon_token_id
token: cinammon_cluster_secret_key
api:
  host: 0.0.0.0
  port: 8080
  ssl:
    enabled: false
system:
  data: /var/lib/cinammon/volumes
  sftp:
    bind_port: 2022
remote: 'http://127.0.0.1:8000'

Servicio Systemd (/etc/systemd/system/wings.service)

[Unit]
Description=Cinammon Wings Daemon
After=docker.service
Requires=docker.service

[Service]
User=root
WorkingDirectory=/etc/cinammon
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now wings

📡 // 05. ECOSYSTEM MATRIX

Repositorio Función Stack Tecnológico
cinammon-net/wings Daemon de alto rendimiento, comunicación WebSocket y SFTP Golang 1.23, Docker Engine API, WebSockets
cinammon-net/panel Orquestador principal, interfaz de administración y consola cyber Laravel 11, React 18, Inertia.js, TailwindCSS
cinammon-net/billing Portal de clientes, tienda de planes automatizada y pasarelas Laravel 11, Inertia.js, TailwindCSS, Fortify 2FA
cinammon-net/eggs Catálogo de más de 129 plantillas de instalación y ejecución Dockerfiles, Bash Scripts, JSON Blueprints

Cinammon.net // Low-Latency Go Virtualization // 2026

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
internal
ufs
Package ufs provides an abstraction layer for performing I/O on filesystems.
Package ufs provides an abstraction layer for performing I/O on filesystems.
loggers
cli
transfer
Package transfer handles all logic related to transferring servers between two nodes.
Package transfer handles all logic related to transferring servers between two nodes.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL