Documentación

Todo lo que necesitas para monitorear y controlar tu flota Bitmain Antminer desde cualquier lugar — sin abrir puertos, sin VPN.

Resumen

AntminerTools es un dashboard en la nube para mineros Bitmain Antminer. Ejecutas un pequeño connector agent en cualquier PC o Raspberry Pi de la red de tu granja; establece una conexión saliente segura con nuestra nube y transmite comandos a tus mineros. Desde tu navegador o teléfono obtienes hashrate en vivo, temperaturas, alertas, reinicio remoto, rentabilidad y más — sin abrir un solo puerto en tu red.

Las tres piezas:

  • Tus mineros — permanecen en tu LAN privada, intactos, con firmware de fábrica de Bitmain.
  • El connector agent — un programa ligero en un PC/Pi de la granja que habla con tus mineros localmente y crea un túnel hacia la nube.
  • El dashboard — donde observas y controlas todo, desde cualquier dispositivo.

Primeros pasos

  1. Crea una cuenta gratuita en antminertools.com/register.
  2. Crea una granja — ve a Dashboard → Granjas → “+ Nueva granja”. Una granja representa una ubicación física. Cada granja obtiene su propio token seguro.
  3. Descarga el agente — pulsa “⬇ Agent” en la tarjeta de la granja y luego “📦 Descargar ZIP del agente”. Viene preconfigurado para esa granja.
  4. Ejecuta el agente en cualquier PC o Raspberry Pi de la misma red que tus mineros (detalles abajo). La tarjeta de la granja cambia a ● Conectado en segundos.
  5. Escanea la red — pulsa “🔍 Escanear” y añade los mineros que encuentre.
✅ Eso es todo — verás estadísticas en vivo en un minuto, y el agente se mantiene en ejecución y actualizado para siempre.

El connector agent

El agente es un único programa ligero. Habla con tus mineros por la red local (la API web de Bitmain) y mantiene una conexión saliente cifrada con AntminerTools. Nunca acepta conexiones entrantes, así que no hay nada que exponer con puertos ni nada expuesto a internet.

Instalación en Windows

  1. Descomprime la carpeta descargada en cualquier lugar (p. ej. el Escritorio).
  2. Doble clic en START_AGENT.bat.
  3. Python y las bibliotecas necesarias se instalan automáticamente la primera vez. Deja la ventana abierta — o déjalo correr en segundo plano; se relanza en cada inicio de sesión.

Instalación en Linux / Raspberry Pi

cd AntminerTools-Agent-YourFarm
python3 antminer_agent.py

Se requiere Python 3.8+ (preinstalado en Raspberry Pi OS). Las dependencias se instalan automáticamente.

Inicio automático al reiniciar

El agente se instala para iniciarse automáticamente tras un reinicio — la carpeta de Inicio en Windows, y un servicio systemd (o una tarea cron @reboot) en Linux y Raspberry Pi. Si el PC de la granja pierde energía o se reinicia, el agente vuelve por sí solo.

Actualizaciones automáticas

Cuando lanzamos una versión nueva, los agentes en ejecución la descargan, la verifican, guardan una copia de seguridad, conservan tu token y se reinician en la versión nueva — no vuelves a tocar el PC de la granja. Las versiones antiguas se limpian automáticamente.

Comprobar el estado

En el PC de la granja puedes ejecutar python antminer_agent.py --status para ver si está conectado, su versión y su tiempo activo.

Un agente por granja. Si tienes varios sitios, crea una granja para cada uno y ejecuta un agente en cada uno — todo llega al mismo dashboard.

Encontrar tus mineros

Una vez que el agente muestra Conectado, pulsa “🔍 Escanear” en la tarjeta de la granja. AntminerTools detecta automáticamente tu subred desde el agente y la escanea en busca de dispositivos Antminer.

  • Observa el contador en vivo — “⛏ 1 encontrado… 2… 3…” — mientras recorre cada IP.
  • Al terminar, obtienes una tabla de cada minero encontrado: IP, modelo, nombre de worker (del pool), número de serie y MAC.
  • Renombra cualquiera de ellos y pulsa “➕ Añadir todos los nuevos” (o añade uno a uno).

También puedes añadir un minero manualmente (Mineros → “+ Añadir minero”) si está en una subred distinta — solo introduce su IP, puerto y login. El login por defecto de Antminer es root / root.

Monitoreo

El Resumen se actualiza cada 10 segundos y muestra toda tu flota: mineros en línea/sin conexión, hashrate total, consumo, temperatura más alta, precio de BTC e ingresos y ganancia diarios.

Detalle del minero

Pulsa cualquier minero para abrir su página de detalle: hashrate en vivo de 5 segundos y 30 minutos, un gráfico de 24 horas, temperaturas de chip y PCB por cadena, velocidad de ventiladores (o detección de refrigeración líquida), consumo, eficiencia en J/TH, tiempo activo, firmware, número de serie y estado del pool en vivo con shares aceptados/rechazados.

Vista de granja

Cada tarjeta de granja muestra el hashrate y el consumo totales, más una insignia de salud térmica: verde Normal, ámbar Templado, y una alarma roja parpadeante 🔥 ANORMAL si cualquier minero alcanza los 85 °C. Pulsa el conteo de mineros para abrir una ventana emergente en vivo de cada minero de esa granja.

Los datos se sondean cada 15 segundos y se muestran automáticamente en tu moneda y zona horaria seleccionadas.

Control remoto

La página de detalle de cada minero tiene un panel de control:

  • 🔄 Reiniciar — reinicia un minero colgado desde cualquier lugar.
  • ▶ Normal / 😴 Reposo / 🚀 Turbo / 🌿 Eco — cambia el modo de trabajo. Reposo en horas de energía cara, Eco para reducir el calor, Turbo cuando la ganancia es alta.
  • 💡 Parpadear LED — haz parpadear la luz para localizar una unidad en el rack.
  • 🔃 Actualizar estadísticas — fuerza un sondeo inmediato.

Para reiniciar muchos a la vez, el botón “🔄 Reiniciar” de la tarjeta de la granja abre un panel con el hashrate actual, la media de 24 horas y la última vez visto de cada minero — reinicia uno o Reiniciar TODOS con un clic.

Alertas y automatización

Ve a Alertas → “+ Nueva regla”. Elige un disparador, un umbral y una acción:

Disparadores

  • 🌡️ Temperatura por encima del umbral (p. ej. 85 °C)
  • ⚠️ Hashrate cae a cero (minero colgado o pool perdido)
  • 📉 Hashrate por debajo del umbral (placa degradándose)
  • 🔌 El minero queda sin conexión

Acciones

  • 📨 Solo alertar — se registra en tu página de Alertas.
  • 😴 Reposo automático — pone en reposo automáticamente un minero sobrecalentado antes de que dañe una placa.
  • 🔄 Reinicio automático — reinicia un minero atascado sin acción manual.

Las reglas se aplican a todos tus mineros, se comprueban en cada sondeo y tienen un enfriamiento configurable para que nunca te saturen. En el plan Unlimited, las alertas también se envían a tu correo.

💡 Configura una regla de reposo automático a 85 °C en cada minero hydro el día que lo añades — así una máquina de $5,000 se protege sola mientras duermes.

Escritorio remoto · plan Unlimited

En el plan Unlimited, las tarjetas de granja conectadas muestran un botón “🖥️ Remoto”. Púlsalo para abrir el escritorio completo del PC de tu granja directamente en el dashboard — mueve el ratón, escribe, edita configuraciones, reinicia Windows — desde cualquier lugar. Funciona por el mismo túnel del agente, así que sigue sin haber apertura de puertos ni nada extra que instalar.

  • Pulsa y escribe para controlar el PC; usa el botón Ctrl+Alt+Del cuando lo necesites.
  • En móvil, toca para hacer clic y usa el botón ⌨ Teclas para el teclado en pantalla.
  • Cada sesión es privada de tu cuenta y termina cuando cierras la ventana; cada sesión queda registrada.
La primera vez que lo usas, el agente instala un pequeño ayudante de captura de pantalla (unos 15 segundos) y luego aparece la pantalla. El escritorio remoto está optimizado para gestión (unos pocos fotogramas por segundo) — perfecto para control, no para vídeo fluido.

Rentabilidad y moneda

En Ajustes → Economía de minería, elige tu moneda de visualización (166 disponibles, actualizadas cada hora con tipos de cambio en vivo) e introduce tu precio de electricidad y tu comisión del pool. El Resumen muestra entonces los ingresos, el coste de electricidad y la ganancia diarios reales — por día, semana, mes y año — más tu precio de electricidad de equilibrio y el coste por BTC minado, calculados en vivo a partir de la dificultad de la red y el precio de BTC.

La calculadora de rentabilidad te permite simular hipótesis (otro precio de energía, más mineros) sin cambiar tus ajustes guardados.

Planes y facturación

PlanPrecioGranjasMinerosAlertas por correoEscritorio remoto
Free$014
Starter$3/mo210
Pro$6/mo520
Unlimited$10/mo

Mejorar de plan

Las mejoras se aplican de inmediato. Antes de cualquier cargo se te muestra el importe prorrateado exacto y se te pide confirmar; tus nuevos límites se desbloquean en el momento en que el pago tiene éxito.

Bajar de plan

Las bajadas de plan se programan para el fin de tu período de facturación actual — conservas tu plan actual y todas sus funciones hasta entonces, sin coste adicional. La página de Planes muestra la fecha exacta y marca tu próximo plan. Puedes cancelar una bajada programada cuando quieras con “Mantener [plan actual]”.

Pago e historial

Los pagos los gestiona Stripe de forma segura — los datos de la tarjeta nunca tocan nuestros servidores. En la página de Planes puedes ver la tarjeta registrada y actualizarla, y consultar tu historial de pedidos completo con recibos descargables. Cancela cuando quieras; tus mineros e historial nunca se eliminan al cambiar de plan.

Seguridad

  • Túnel solo saliente — el agente marca hacia fuera por TLS (el mismo puerto que HTTPS). Nada en tu red escucha conexiones entrantes.
  • Tokens por granja — cada granja se autentica con su propio token firmado que puedes revocar y regenerar cuando quieras.
  • Credenciales cifradas — las contraseñas de los mineros se cifran en reposo con AES-256-GCM y solo se descifran en memoria al enviar un comando.
  • Resistente — la reconexión automática con retroceso y varios endpoints de relay con conmutación mantienen tu dashboard vivo pese a los cortes del ISP y del CDN.

Mineros compatibles

Todo Bitmain Antminer con firmware de fábrica y la interfaz web estándar: el S23, la familia S21 (incluidos XP y Hydro), la familia S19, T21, L9, L7, Kaspa KS5/KS7, KA3 y más. Los modelos hydro e inmersión reciben manejo especial para sensores de temperatura de refrigeración líquida y detección de ausencia de ventiladores. El firmware de terceros que mantiene la API compatible con Bitmain suele funcionar también.

Resolución de problemas

La granja muestra “Sin conexión”

El agente no está en ejecución o no puede llegar a internet. En el PC de la granja, asegúrate de que la ventana/servicio del agente esté en ejecución (python antminer_agent.py --status) y de que el PC tenga internet. El agente se reconecta solo en cuanto vuelve la conectividad.

El escaneo no encuentra nada

Comprueba que la subred coincida con tus mineros (el escaneo la detecta solo, pero puedes editarla) y que el login sea correcto (por defecto root/root). El PC del agente debe estar en la misma LAN que los mineros.

Un minero aparece sin conexión pero está hasheando

Su API web puede ser inalcanzable o las credenciales cambiaron. Abre la IP del minero directamente en la LAN para confirmarlo y actualiza su usuario/contraseña en AntminerTools si hace falta.

No se puede eliminar una granja

Apaga primero el agente en el PC de esa granja, espera unos 90 segundos a que la tarjeta muestre Sin conexión y luego elimínala. Esto evita que un agente aún en ejecución reaparezca como un fantasma.

El escritorio remoto no arranca

Requiere el plan Unlimited y un agente conectado. El primer arranque instala un ayudante de captura de pantalla (~15 s). En una Raspberry Pi sin monitor y sin escritorio, el escritorio remoto no está disponible.

Preguntas frecuentes

¿Necesito abrir puertos o usar una VPN?

No. El agente establece solo una conexión saliente — funciona tras cualquier router, CGNAT, 4G/5G o Starlink con cero configuración de red.

¿Funciona en mi teléfono?

Sí — todo el dashboard es totalmente adaptable. Puedes monitorear, recibir alertas, reiniciar mineros, gestionar la facturación e incluso usar escritorio remoto desde un teléfono.

¿Con qué frecuencia se actualizan las estadísticas?

Cada 15 segundos por minero en línea; el dashboard refresca la pantalla cada 10 segundos.

¿Hay un plan gratuito?

Sí — 1 granja y hasta 4 mineros con monitoreo completo, control remoto y alertas en el dashboard. Los planes de pago añaden capacidad y funciones.

¿Sigues atascado? Crea una cuenta y escríbenos desde tu dashboard, o lee el blog para guías y consejos.