Saltar al contenido principal

Herramienta de línea de comandos de TinyShield (tinyshield-cli)

tinyshield-cli controla TinyShield desde Terminal y desde tus propios scripts. Ofrece las mismas herramientas que el servidor MCP. Por ejemplo, un script de compilación puede aprobar las herramientas que ejecuta, y una tarea de cron puede exportar tus reglas.

La línea de comandos es una función de TinyShield PRO. Actívala junto con el servidor MCP en TinyShield › Settings › MCP.

1. Configurarla​

La herramienta está dentro de la app:

"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli" --help

Agrega un alias al perfil de tu shell (~/.zshrc), como se muestra en Settings › MCP:

alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'

En la edición de Setapp, usa /Applications/Setapp/Tiny Shield.app. Si TinyShield no está abierto, el comando lo abre primero en segundo plano.

2. Comandos​

ComandoQué hace
tinyshield statusVersión, licencia, modo de conexión, Network Extension y número de reglas
tinyshield mode [allow-all|require-approval|block-all]Muestra o cambia el modo de conexión
tinyshield pending listApps que esperan aprobación y a dónde intentaron conectarse
tinyshield pending allow <app>… / block <app>…Permite o bloquea apps en espera por nombre, bundle ID, ruta, pid o ID (--all para todas)
tinyshield pending wait [--timeout 60]Espera hasta que una app necesite aprobación
tinyshield decisions [list|allow|block|remove]Las App Connection Decisions del modo Require Approval
tinyshield block-list [list|add|remove|enable|disable]La Block List
tinyshield allow-list [list|add|remove]La Allow List
tinyshield apps [--range 1h] [--status blocked]Apps que usaron la red
tinyshield app <app> o --pid <pid>Una app: firma, reglas, actividad y ancho de banda
tinyshield connections <app> o --pid <pid>Los dominios y direcciones IP a los que se conectó una app
tinyshield domain <domain> / tinyshield ip <ip>Quién se conectó a un dominio o una IP, y las reglas que coinciden
tinyshield treeLa lista de la ventana principal, en forma de árbol
tinyshield countriesLos países a los que se conectaron las apps, como en el mapa
tinyshield recently-blocked [--clear]Las últimas conexiones bloqueadas
tinyshield bandwidth [--timeframe day] [--app Safari] / tinyshield liveUso de datos y velocidad actual
tinyshield settings [get|set <setting> on|off]Ajustes como block-list, dns, apple-programs o launch-at-login
tinyshield export <file> / tinyshield import <file> [--replace]Guarda o carga tu configuración
tinyshield open <window> [--search text]Muestra una ventana de TinyShield, por ejemplo main, block_list o mcp_settings
tinyshield clear-activity --yesElimina la actividad de red registrada (las reglas se conservan)
tinyshield tools / tinyshield call <tool> '<json>'Lista todas las herramientas o llama a una con argumentos JSON

Ejecuta tinyshield <command> --help para ver todas las opciones.

En block-list add y allow-list add, un valor que empieza por /, ~ o ./ es una app o un ejecutable. Cualquier otro es un dominio, un comodín (*.example.com) o una dirección IP.

3. Ejemplos​

Aprueba el gestor de paquetes que usa una compilación y luego ejecuta la compilación:

tinyshield pending allow ~/.local/bin/uv
uv pip install -r requirements.txt

Aprueba herramientas por adelantado antes de una tarea larga y desatendida:

tinyshield allow-list add /opt/homebrew/bin/node ~/.local/bin/uv

Avisa a alguien cuando una app necesite aprobación:

if tinyshield pending wait --timeout 600 --only-new; then
osascript -e 'display notification "An app is waiting for approval" with title "TinyShield"'
fi

Bloquea un rastreador en todas partes y revisa quién se conectó a él:

tinyshield block-list add '*.doubleclick.net'
tinyshield domain doubleclick.net --subdomains --range 7d

4. Scripts​

  • Agrega --json a cualquier comando para obtener una salida legible por máquinas.
  • Agrega --no-launch para que falle en lugar de abrir TinyShield.
  • Códigos de salida:
CódigoSignificado
0Éxito
1El comando falló. pending wait también sale con 1 cuando TinyShield no está en modo Require Approval
3No encontrado. pending wait también sale con 3 cuando nada pidió aprobación antes del tiempo límite
4Se necesita TinyShield PRO
69No se puede contactar con TinyShield: el servidor está desactivado, o TinyShield no está instalado o no está abierto (con --no-launch)

Las decisiones tomadas desde la línea de comandos aparecen como Command Line en la lista Decisions de TinyShield.