Tener la CLI en tu máquina

Se publican dos programas a la vez y se ejecutan en máquinas distintas:

• mikroscope, la CLI y el colector, se ejecuta en tu ordenador —el portátil o el servidor donde escribes las órdenes—. Esta página va de ese.
• mikroscope-agent se ejecuta en el router, dentro de un contenedor. mikroscope install lo pone allí por ti; tú nunca lo ejecutas, y la única vez que lo descargas a mano es en la ruta --agent-tar.

Así que el archivo que quieres aquí lo decide tu sistema operativo y tu CPU, no los del router. La arquitectura del router decide otra cosa, y esa tabla está en Lo que necesita el router.

Qué archivo

Tu máquina	Descarga
Linux, PC o servidor normal	mikroscope_<versión>_linux_x86_64.tar.gz
Linux sobre ARM (Raspberry Pi 4/5, …)	mikroscope_<versión>_linux_arm64.tar.gz
macOS, Apple silicon (M1 y posteriores)	mikroscope_<versión>_darwin_arm64.tar.gz
macOS, Intel	mikroscope_<versión>_darwin_x86_64.tar.gz
Windows	mikroscope_<versión>_windows_x86_64.zip

Están en la última publicación. Todo lo que empiece por mikroscope-agent es el otro programa.

Instalarla

Linux

1. Descarga el archivo y las sumas de verificación:

   VERSION=1.0.4
   curl -fsSLO https://github.com/jmrplens/mikroscope/releases/download/v$VERSION/mikroscope_${VERSION}_linux_x86_64.tar.gz
   curl -fsSLO https://github.com/jmrplens/mikroscope/releases/download/v$VERSION/checksums.txt

2. Compruébalo contra la lista antes de descomprimirlo:

   sha256sum --ignore-missing -c checksums.txt

3. Descomprime y ponlo donde el intérprete mira:

   tar xzf mikroscope_${VERSION}_linux_x86_64.tar.gz mikroscope
   sudo install -m 0755 mikroscope /usr/local/bin/mikroscope

   Sin sudo, mkdir -p ~/.local/bin && install -m 0755 mikroscope ~/.local/bin/ también vale, siempre que ~/.local/bin esté en tu PATH.

macOS

1. Descarga el archivo de tu CPU —darwin_arm64 para Apple silicon, darwin_x86_64 para Intel— y las sumas de verificación:

   VERSION=1.0.4
   curl -fsSLO https://github.com/jmrplens/mikroscope/releases/download/v$VERSION/mikroscope_${VERSION}_darwin_arm64.tar.gz
   curl -fsSLO https://github.com/jmrplens/mikroscope/releases/download/v$VERSION/checksums.txt

2. Compruébalo:

   shasum -a 256 --ignore-missing -c checksums.txt

3. Descomprime, quita la marca de cuarentena que le puso la descarga e instálalo:

   tar xzf mikroscope_${VERSION}_darwin_arm64.tar.gz mikroscope
   xattr -d com.apple.quarantine mikroscope 2>/dev/null || true
   sudo install -m 0755 mikroscope /usr/local/bin/mikroscope

   El binario no está firmado ni notarizado, así que sin esa línea de xattr macOS se niega a ejecutarlo y dice que «no se puede abrir porque no se puede verificar al desarrollador».

Windows

1. Descarga mikroscope_<versión>_windows_x86_64.zip y checksums.txt de la página de la publicación.

2. Compruébalo en PowerShell, contra la línea de tu archivo en checksums.txt:

   Get-FileHash .\mikroscope_1.0.4_windows_x86_64.zip -Algorithm SHA256

3. Descomprímelo en un sitio permanente y pon esa carpeta en tu PATH:

   Expand-Archive .\mikroscope_1.0.4_windows_x86_64.zip -DestinationPath $HOME\mikroscope
   $env:PATH += ";$HOME\mikroscope"

   Esa línea dura lo que la sesión. Para conservarla, añade la carpeta en Configuración → Sistema → Acerca de → Configuración avanzada del sistema → Variables de entorno, o:

   [Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$HOME\mikroscope", "User")

ssh en Windows

Tres de las cuatro rutas de instalación llegan al router por ssh, y la CLI usa el ssh y el scp que haya en tu PATH. Windows 10 y 11 traen OpenSSH: Get-Command ssh debería encontrarlo, y Configuración → Sistema → Características opcionales lo instala si no. La cuarta ruta, un script de RouterOS, no necesita ssh.

Con Go

Si tienes Go 1.27 o posterior y prefieres compilarla:

go install github.com/jmrplens/mikroscope/cmd/mikroscope@latest

Eso deja mikroscope en $(go env GOPATH)/bin, que es ~/go/bin salvo que lo hayas movido, y ese directorio tiene que estar en tu PATH. Un binario compilado así informa de la versión del módulo y no del sello de una publicación.

Un checkout compila los dos programas de una vez, que es la ruta de quien contribuye:

git clone https://github.com/jmrplens/mikroscope
cd mikroscope
make build          # deja bin/mikroscope y bin/mikroscope-agent

Comprobarla

mikroscope version

Imprime la versión, el commit y la fecha de compilación. Después, con un router al que apuntar:

mikroscope doctor --router user@192.168.88.1

doctor no escribe nada. Lee el equipo, imprime qué es y marca cada requisito como ok o MISSING con la orden que lo arregla —incluido el que nadie puede hacer en remoto—. Es lo primero que hay que ejecutar, antes de cualquier ruta de instalación.

Las opciones tienen variables de entorno

--router, --ssh-port, --ssh-key, --arch y casi todas las demás leen su valor por defecto de una variable MIKROSCOPE_*, así que un intérprete que las exporte convierte cada orden de aquí en mikroscope doctor. Variables de entorno es la lista, y .env.example en el repositorio es una plantilla.

Véase también

• Lo que necesita el router: los tres requisitos en el equipo, y la tabla de arquitecturas del router.
• Cuatro formas de instalar: cómo llega la imagen del agente al router una vez tienes la CLI.
• Órdenes y opciones: cada verbo y cada opción.