Platypus

Un centro de gestión de hosts para flotas de máquinas Linux. Instala el agente Platypus en cada host que poseas; el agente se conecta de vuelta a tu servidor Platypus a través de TLS + protobuf; desde el servidor obtienes una shell interactiva, gestión de archivos y túneles de red en cada host gestionado — todo desde un único plano de control central.

Capturas de pantalla

Una interfaz de navegación plana estilo Vercel con un panel de proyecto, un navegador de hosts/listeners/sesiones, una consola de envío multi-host y un gestor de usuarios administrador. Consulta la galería completa en docs/screenshots/. Vuelve a ejecutar make screenshots para regenerarlas desde la aplicación en vivo.

Arquitectura

Platypus se distribuye como dos binarios de backend más un cliente de escritorio independiente:

Binario	Rol
platypus-server	Demonio. Acepta conexiones entrantes de agentes en puertos TLS de ingreso; expone una API REST + WebSocket para herramientas de administración; sirve los binarios del agente para su distribución.
platypus-agent	El proceso que se ejecuta en cada host gestionado. Se conecta al servidor a través de TLS + protobuf.
platypus-desktop	GUI de escritorio nativo (Wails v2). Conéctate a cualquier servidor accesible mediante URL + secreto; interfaz con pestañas para sesiones, terminales, listeners, archivos, túneles. Consulta desktop/.

El servidor es puramente una API — no tiene interfaz web integrada. Varios escritorios pueden conectarse al mismo servidor simultáneamente.

Características

• Canal TLS + protobuf entre agente y servidor
• Múltiples puertos de ingreso para que flotas en diferentes redes compartan un mismo hub
• Shell interactiva por host, transmitida a través de WebSocket
• Lectura / escritura / subida / bajada de archivos con transferencia por fragmentos
• Túneles de red: reenvío de puerto local, reenvío de puerto remoto, SOCKS5 dinámico
• API REST autenticada con token Bearer
• Python SDK
• Listeners de inicio automático desde config.yml
• Apagado ordenado (drena conexiones en SIGINT/SIGTERM en 30 segundos)

Documentos

• Chino | 中文文档

Inicio rápido

Despliegue con un clic (Recomendado)

La forma más rápida de poner en marcha un sistema Platypus completo (incluyendo el Servidor, la Interfaz Web y un Distribuidor de Agentes respaldado por MinIO) es usando Docker Compose:

git clone https://github.com/WangYihang/Platypus
cd Platypus
docker-compose up -d

• Interfaz Web: Abre https://localhost:9443 en tu navegador (el contenedor incluye un certificado autofirmado; tu navegador te pedirá que lo aceptes en la primera visita).
• Inicio de sesión: El bootstrap_secret se escribe en /app/data/bootstrap.secret dentro del contenedor en el primer arranque (modo 0600). Léelo con docker compose exec platypus-server cat /app/data/bootstrap.secret, úsalo una vez para crear el primer administrador y luego elimina el archivo. Tras completar el bootstrap, el secreto ya no será aceptado.
• Añadir Agentes: Haz clic en "Add Agent" en la interfaz para obtener un comando de una línea curl ... | sh, firmado y vinculado a la CA del proyecto, para desplegar agentes en tu flota.

Compilar desde el código fuente

Requiere Go 1.24+ y protoc (solo si se regenera el código protobuf).

git clone https://github.com/WangYihang/Platypus
cd Platypus
make build              # → ./build/{platypus-server,platypus-agent}

Otros targets útiles: make test, make lint, make snapshot (multiplataforma mediante goreleaser), make help.

Desarrollo (ganchos pre-commit)

Los colaboradores deben instalar los ganchos de git para que gofmt / goimports / go vet / golangci-lint se ejecuten antes de cada commit:

pip install pre-commit   # o: pipx install pre-commit
make hooks               # una vez: configura .git/hooks/pre-commit
make pre-commit          # opcional: ejecuta todos los ganchos sobre todos los archivos ahora

Compilar la aplicación de escritorio

Requiere Node 22+, dependencias de Wails CLI (wails doctor) y las bibliotecas WebView de la plataforma (webkit2gtk-4.1 en Linux, WebView2 en Windows, WKWebView en macOS).

make desktop-deps       # una vez: instala Wails CLI + paquetes pnpm
make desktop-build      # → desktop/build/bin/platypus-desktop
make desktop-dev        # modo desarrollo con recarga en caliente

O: usar la interfaz web independiente (sin instalación)

Las mismas páginas, las mismas funciones (excepto la notificación de eventos en tiempo real), funciona en cualquier navegador:

make web-ui             # → desktop/frontend/dist-web/ (paquete estático)
make web-ui-serve       # vista previa en http://localhost:8080

dist-web/ es completamente estático; súbelo a GitHub Pages / S3 / nginx. Apúntalo a cualquier platypus-server mediante el formulario de inicio de sesión.

Notas completas en desktop/README.md.

Instalar desde los binarios de las versiones

Descarga el archivo adecuado para tu sistema operativo/arquitectura desde la página de versiones, extráelo y ejecútalo.

Ejecutar con Docker

docker build -t platypus-server .
docker run --rm -p 9443:9443 \
  -e PLATYPUS_DEV=1 \
  -v $(pwd)/config.yml:/config.yml \
  platypus-server

PLATYPUS_DEV=1 habilita la alternativa de KEK en disco para que un inicio fresco "funcione sin más"; para producción, elimina esa variable de entorno y establece PLATYPUS_CA_KEK (32 bytes en hex; openssl rand -hex 32) para que la clave de cifrado de la clave privada de la CA nunca se escriba junto a la base de datos cifrada.

Ejecutar

./build/platypus-server                # en primer plano; Ctrl-C para apagado ordenado

Para producción, ejecuta el servidor bajo systemd en lugar de ponerlo en segundo plano manualmente.

Advertencias de producción