Cliente Agave
Agave 4.1.1 es el cliente validador de Solana de Anza: la implementación mainline para votación, reproducción de ledger y RPC. Ejecútalo cuando operes un validador de staking estándar o un nodo RPC privado.
//
Busca en todas las páginas de la documentación
Agave 4.1.1 es el cliente validador de Solana de Anza: la implementación mainline para votación, reproducción de ledger y RPC. Ejecútalo cuando operes un validador de staking estándar o un nodo RPC privado.
Tarjeta de receta de referencia rápida, lista para copiar y pegar.
agave-install init 4.1.1
agave-validator --ledger /mnt/ledger \
--identity ~/.config/solana/identity.json \
--vote-account <CLAVE_PÚBLICA_CUENTA_VOTO> \
--rpc-port 8899 \
--full-rpc-api \
--no-voting # omite --no-voting para validadores que votanCuándo usar esto:
#!/usr/bin/env bash
# Inicio mínimo del validador Agave (ajusta las rutas)
LEDGER=/mnt/nvme/ledger
ACCOUNTS=/mnt/nvme/accounts
IDENTITY=~/.config/solana/identity.json
VOTE_ACCOUNT=Vote111111111111111111111111111111111111111
mkdir -p "$LEDGER" "$ACCOUNTS"
agave-validator \
--ledger "$LEDGER" \
--accounts "$ACCOUNTS" \
--identity "$IDENTITY" \
--vote-account "$VOTE_ACCOUNT" \
--known-validator <PUNTO_DE_ENTRADA_DE_CONFIANZA> \
--entrypoint entrypoint.mainnet-beta.solana.com:8001 \
--expected-genesis-hash <HASH_GENESIS_MAINNET> \
--full-rpc-api \
--rpc-bind-address 127.0.0.1 \
--rpc-port 8899 \
--dynamic-port-range 8000-8020 \
--limit-ledger-size 50000000Lo que esto demuestra:
--vote-account habilita la votación de consenso (omitir para RPC-only con --no-voting).--full-rpc-api está habilitado.| Bandera | Propósito |
|---|---|
--ledger | Ruta del almacén de bloques |
--accounts | Ruta de la base de datos de cuentas |
--vote-account | Clave pública de voto en cadena |
--no-voting | Nodo RPC sin votación |
--limit-ledger-size | Poda de límite de disco |
agave-validator --ledger /mnt/ledger monitor # observar la sincronización
solana catchup --our-localhost--limit-ledger-size + monitoreo.| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Híbrido Frankendancer | Máximo rendimiento | Simplicidad de configuración inicial |
| Jito-Solana | Infraestructura MEV | Preferencia de operador no-MEV |
| Validador Alojado | Sin equipo de operaciones | Requisito de autocustodia completa |
Agave es el cliente validador; Solana CLI 3.0.10 sigue siendo la herramienta del operador de la distribución Anza.
Ejecutar con --no-voting y omitir el requisito de cuenta de voto; aún sincroniza el ledger completo.
Detener el validador, agave-install init <versión>, reiniciar con la misma ruta de ledger después de hacer una copia de seguridad.
Máquina nueva o restauración de instantánea: usar --only-known-rpc para el arranque o instantáneas oficiales.
Desaconsejado en mainnet: contención de recursos; hardware separado por cuenta de voto.
La participación en la cuenta de voto mejora la programación; ver la página de SWQoS.
Salida estándar por defecto; redirigir a journald o archivo para la pila de monitoreo.
Las mismas banderas con puntos de entrada y génesis de devnet; primero financiar la cuenta de voto en devnet.
Coincidir con la fijación del manifiesto en CLI, validador y test-validator local en CI.
Capa de red opcional para la interconexión de validadores; ver página de hardware.
Versiones de la Pila: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.
Revisado por Chris St. John·Última actualización: 16 jul 2026