kolo docsbeta

kolo-node

Un servidor de bootstrap para la red kolo-dht, la dirección por la que entran los peers nuevos de Kolo.

En esta página

kolo-node es un comando, no un paquete de Go. Ejecuta un servidor de kolo-dht en un puerto UDP: responde a las consultas de la DHT, guarda los registros firmados de los topics y retransmite las peticiones de conexión para que los peers puedan atravesar sus NATs. No transporta datos de aplicación. kolo-node relay ejecuta en cambio un servidor de kolo-relay, para peers que no pueden conectarse directamente; copia su tráfico cifrado, que no puede leer. Guarda su clave de kolo-id en un archivo, se apaga de forma limpia con SIGINT y SIGTERM, y registra unos pocos eventos estructurados con slog. Ejecuta unos cuantos en hosts distintos y da sus direcciones a los peers.

Instalación

go install github.com/ciranda-dev/kolo-node/cmd/kolo-node@latest

Compila sin cgo; CGO_ENABLED=0 da un binario estático.

Inicio rápido

Arranca una red nueva en loopback: su primer nodo, con -first (todavía sin nodos de entrada) y su clave en un directorio temporal nuevo:

Terminal
dir=$(mktemp -d)
kolo-node run -listen 127.0.0.1:7447 -identity "$dir/state/node.key" -first

Compruébalo desde un segundo terminal. Imprime ok 127.0.0.1:7447:

Terminal
kolo-node check 127.0.0.1:7447

Un peer hace bootstrap desde el nodo pasando su dirección a (*kolodht.Node).Bootstrap. Este programa recibe las direcciones como argumentos, por ejemplo go run . 127.0.0.1:7447:

main.go
package main

import (
	"context"
	"fmt"
	"log"
	"net/netip"
	"os"
	"time"

	kolodht "github.com/ciranda-dev/kolo-dht"
	koloid "github.com/ciranda-dev/kolo-id"
)

func main() {
	if len(os.Args) < 2 {
		log.Fatal("usage: join IP:PORT...")
	}
	var servers []netip.AddrPort
	for _, a := range os.Args[1:] {
		ap, err := netip.ParseAddrPort(a)
		if err != nil {
			log.Fatal(err)
		}
		servers = append(servers, ap)
	}
	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
	defer cancel()

	id, err := koloid.Generate()
	if err != nil {
		log.Fatal(err)
	}
	n, err := kolodht.New(ctx, "127.0.0.1:0", id, nil)
	if err != nil {
		log.Fatal(err)
	}
	defer n.Close()
	if err := n.Bootstrap(ctx, servers); err != nil {
		log.Fatal(err)
	}
	fmt.Println("joined:", n.Stats().Servers, "servers in the routing table")
}

Imprime cuántos servidores hay en la tabla de enrutamiento del cliente. Otro kolo-node se une con -bootstrap, una lista de entradas host:port (direcciones IPv4 o nombres DNS), con -bootstrap-file, un archivo con una entrada por línea, o con ambos:

Terminal
kolo-node run -listen 127.0.0.1:7448 -identity "$dir/state2/node.key" -bootstrap 127.0.0.1:7447

Para un nodo con Ctrl-C: registra stopping, una última línea stats y stopped, y sale con 0. Si lo vuelves a arrancar con el mismo -identity, conserva la misma clave.

Sin -bootstrap, -bootstrap-file, la variable de entorno KOLO_BOOTSTRAP ni -first, run sale con 2, de modo que una lista que se dejó vacía por error nunca arranca un nodo solitario. kolo-node no incluye ninguna lista de nodos públicos; consulta Redes públicas y privadas.

Referencia de la API

La referencia de la API se genera a partir del código Go y está en inglés.

Paquete main · github.com/ciranda-dev/kolo-node/cmd/kolo-node · v0.1.0

Command kolo-node runs a kolo-dht bootstrap server or a kolo-relay; see the README for its commands, flags and config file.

Comando

kolo-node
usage:
  kolo-node run -identity FILE [flags]       run a kolo-dht bootstrap server
  kolo-node relay -identity FILE -listen ADDR [flags]
                                             run a kolo-relay server
  kolo-node check [-timeout 5s] [-relay HOST:PORT@KEY] [-relay-file FILE] [HOST:PORT...]
                                             check that kolo-dht servers and kolo-relays answer from here
  kolo-node version                          print the version

Run "kolo-node run -h" or "kolo-node relay -h" for their flags.

kolo-node run

kolo-node run
Usage of kolo-node run:
  -bootstrap host:port
    	comma-separated host:port list of entry nodes, repeatable
  -bootstrap-file file
    	file of entry nodes, one host:port per line, repeatable
  -config file
    	JSON config file; flags set on the command line override it
  -dht-max-inflight int
    	kolodht.Config.MaxInflight; 0 means the kolo-dht default
  -dht-max-records int
    	kolodht.Config.MaxRecords; 0 means the kolo-dht default
  -dht-max-records-per-ip int
    	kolodht.Config.MaxRecordsPerIP; 0 means the kolo-dht default
  -dht-max-records-per-topic int
    	kolodht.Config.MaxRecordsPerTopic; 0 means the kolo-dht default
  -dht-max-relays int
    	kolodht.Config.MaxRelays; 0 means the kolo-dht default
  -dht-max-requests int
    	kolodht.Config.MaxRequests; 0 means the kolo-dht default
  -dht-max-requests-per-ip int
    	kolodht.Config.MaxRequestsPerIP; 0 means the kolo-dht default
  -dht-max-requests-per-prefix int
    	kolodht.Config.MaxRequestsPerPrefix; 0 means the kolo-dht default
  -dht-punch-timeout duration
    	kolodht.Config.PunchTimeout; 0 means the kolo-dht default
  -dht-request-timeout duration
    	kolodht.Config.RequestTimeout; 0 means the kolo-dht default
  -first
    	start a new network: no entry nodes yet
  -identity file
    	key file, created on the first run (required)
  -listen address
    	IPv4 UDP address to listen on (default ":7447")
  -log-addrs
    	log full peer addresses instead of their /24
  -log-format format
    	log format: text or json (default "text")
  -log-level level
    	log level: info, warn or error (default "info")
  -stats-interval duration
    	interval between stats events, 1s to 24h (default 5m0s)

kolo-node relay

kolo-node relay
Usage of kolo-node relay:
  -allow-file file
    	file of the hex keys that may reserve, one per line; without it any key may
  -config file
    	JSON config file; flags set on the command line override it
  -identity file
    	key file of the relay, created on the first run (required)
  -listen address
    	IPv4 UDP address to listen on (required)
  -log-format format
    	log format: text or json (default "text")
  -log-level level
    	log level: info, warn or error (default "info")
  -relay-connect-timeout duration
    	kolorelay.ServerConfig.ConnectTimeout; 0 means the kolo-relay default
  -relay-control-timeout duration
    	kolorelay.ServerConfig.ControlTimeout; 0 means the kolo-relay default
  -relay-flush-interval duration
    	kolorelay.ServerConfig.FlushInterval; 0 means the kolo-relay default
  -relay-max-conns int
    	the listener's kolo-transport MaxConns; 0 means 128, kolo-relay's listener default
  -relay-max-conns-per-ip int
    	the listener's kolo-transport MaxConnsPerIP; 0 means 4, kolo-relay's listener default
  -relay-max-reservations int
    	kolorelay.ServerConfig.MaxReservations; 0 means the kolo-relay default
  -relay-max-session-bytes int
    	kolorelay.ServerConfig.MaxSessionBytes; 0 means the kolo-relay default
  -relay-max-session-duration duration
    	kolorelay.ServerConfig.MaxSessionDuration; 0 means the kolo-relay default
  -relay-max-sessions int
    	kolorelay.ServerConfig.MaxSessions; 0 means the kolo-relay default
  -relay-max-sessions-per-peer int
    	kolorelay.ServerConfig.MaxSessionsPerPeer; 0 means the kolo-relay default
  -relay-max-sessions-per-target int
    	kolorelay.ServerConfig.MaxSessionsPerTarget; 0 means the kolo-relay default
  -relay-rate-burst int
    	kolorelay.ServerConfig.RateBurst; 0 means the kolo-relay default
  -relay-rate-bytes int
    	kolorelay.ServerConfig.RateBytes, per second; 0 means the kolo-relay default
  -relay-reservation-lifetime duration
    	kolorelay.ServerConfig.ReservationLifetime; 0 means the kolo-relay default
  -relay-session-idle-timeout duration
    	kolorelay.ServerConfig.SessionIdleTimeout; 0 means the kolo-relay default

kolo-node a

kolo-node a
kolonode: unknown command "a"
usage:
  kolo-node run -identity FILE [flags]       run a kolo-dht bootstrap server
  kolo-node relay -identity FILE -listen ADDR [flags]
                                             run a kolo-relay server
  kolo-node check [-timeout 5s] [-relay HOST:PORT@KEY] [-relay-file FILE] [HOST:PORT...]
                                             check that kolo-dht servers and kolo-relays answer from here
  kolo-node version                          print the version

Run "kolo-node run -h" or "kolo-node relay -h" for their flags.

kolo-node check

kolo-node check
usage: kolo-node check [-timeout 5s] [-relay HOST:PORT@KEY] [-relay-file FILE] [HOST:PORT...]
  -relay host:port@key
    	comma-separated host:port@key list of kolo-relays, repeatable
  -relay-file file
    	file of kolo-relays, one host:port@key per line, repeatable
  -timeout duration
    	time allowed per address, 1s to 60s (default 5s)

kolo-node that

kolo-node that
kolonode: unknown command "that"
usage:
  kolo-node run -identity FILE [flags]       run a kolo-dht bootstrap server
  kolo-node relay -identity FILE -listen ADDR [flags]
                                             run a kolo-relay server
  kolo-node check [-timeout 5s] [-relay HOST:PORT@KEY] [-relay-file FILE] [HOST:PORT...]
                                             check that kolo-dht servers and kolo-relays answer from here
  kolo-node version                          print the version

Run "kolo-node run -h" or "kolo-node relay -h" for their flags.

Conviene saber

Redes públicas y privadas

Una red es el conjunto de servidores de kolo-dht que se conocen entre sí, y un nodo pertenece a la red de los nodos de entrada desde los que hace bootstrap. kolo-node no incluye ninguna lista de nodos de entrada, y run necesita una de estas:

  • -bootstrap host:port,...: nodos de entrada separados por comas; el flag se puede repetir.
  • -bootstrap-file ruta: un archivo de texto con nodos de entrada, un host:port por línea. # inicia un comentario hasta el final de la línea; las líneas en blanco se ignoran; se aceptan un BOM UTF-8 y finales de línea CRLF. Solo se lee un archivo regular de como mucho 64 KiB: un directorio, un dispositivo o un FIFO se rechazan antes de abrirlos. El flag se puede repetir y se suma a -bootstrap: primero las entradas de -bootstrap, luego las de cada archivo por orden, sin duplicados, como mucho 16 en total.
  • KOLO_BOOTSTRAP=host:port,...: se lee solo cuando ni -bootstrap ni -bootstrap-file están definidos (en la línea de comandos o en el archivo de configuración, aunque sea con una lista vacía) y -first no está definido. Si hay una KOLO_BOOTSTRAP definida que no se lee, se registra el aviso KOLO_BOOTSTRAP ignored.
  • -first: arranca una red nueva, todavía sin nodos de entrada. No se puede combinar con -bootstrap ni con -bootstrap-file.

Con ninguna de ellas, o solo con listas vacías, run sale con 2: una lista que se dejó vacía por error nunca arranca un nodo solitario, y un flag o una clave definidos con una lista vacía nunca recurren a KOLO_BOOTSTRAP. Una ruta relativa de -bootstrap-file, también en el archivo de configuración, es relativa al directorio de trabajo de kolo-node, no al archivo de configuración; las unidades de systemd deben usar rutas absolutas. Cada elemento del array de configuración es una entrada: un elemento con una coma se rechaza. El evento de log network indica el mode (first o join), las entries listadas y, con join, de dónde vienen (from: -bootstrap, -bootstrap-file o KOLO_BOOTSTRAP).

Una entrada es una dirección IPv4 o un nombre DNS, con un puerto de 1 a 65535. IPv6 en cualquier forma, incluida la IPv4-mapped, se rechaza. Un archivo de bootstrap:

Texto
# entry nodes of our network
203.0.113.10:7447
node2.example.org:7447   # resolved to IPv4 at each attempt

Una red pública es aquella cuyos operadores publican sus nodos de entrada; los miembros los listan. Una red privada ejecuta los suyos: arranca su primer nodo con -first, los demás con -bootstrap (o un archivo) que apunte a él, y da a los miembros solo esas direcciones. Ejecuta al menos dos nodos de entrada en hosts que se mantengan encendidos, con su puerto UDP abierto. Dos nodos de una red privada en loopback:

Terminal
dir=$(mktemp -d)
kolo-node run -listen 127.0.0.1:7447 -identity "$dir/a/node.key" -first
kolo-node run -listen 127.0.0.1:7448 -identity "$dir/b/node.key" -bootstrap 127.0.0.1:7447

Qué es: separación por topología. Un servidor de kolo-dht solo conoce otros servidores por los servidores a los que consulta y por los que le envían peticiones, así que dos redes con nodos de entrada distintos nunca ven los servidores, los registros ni los peers de la otra.

Qué no es: control de acceso. La lista no es un secreto. Cualquiera que conozca una dirección de entrada puede hacer bootstrap desde ella, buscar topics y anunciarse en ellos, y un nodo que lista nodos de entrada de dos redes las une. Decide quién puede conectarse con las claves de kolo-secure y el Allow de kolo-swarm, admite miembros con kolo-invite y confía solo en registros firmados.

run sin nodos de entrada y sin -first sale con 2, de modo que una lista que se dejó vacía por error nunca arranca un nodo solitario; lo mismo ocurre con -bootstrap, -bootstrap-file o su clave de configuración definidos con una lista vacía. Da al primer nodo -first, o "first": true en el archivo de configuración, y a todos los demás nodos -bootstrap, -bootstrap-file o KOLO_BOOTSTRAP.

Ejecutar un relay

kolo-node relay ejecuta un kolo-relay: los peers que no pueden conectarse directamente, como dos ordenadores detrás de cortafuegos que solo dejan salir tráfico, hacen una reserva en él y se encuentran a través de él. Cada lado mantiene su propia conexión de kolo-secure a través del relay, así que este copia bytes que no puede leer. kolo-swarm lo usa cuando su Config.Relays lo incluye. Un relay tiene su propio archivo de clave y su propio puerto UDP; un proceso es un relay. Por loopback, con su clave en un directorio temporal nuevo:

Terminal
dir=$(mktemp -d)
kolo-node relay -listen 127.0.0.1:7448 -identity "$dir/relay/relay.key"

Registra identity con su key y started con su addr. Los peers lo indican como host:port@key, por ejemplo 203.0.113.20:7448@<key> con la clave registrada. Compruébalo desde un segundo terminal con kolo-node check -relay 127.0.0.1:7448@<key>, que imprime ok relay 127.0.0.1:7448@<key>: check le pide al relay una clave aleatoria con una identidad nueva, lo que demuestra su dirección, su clave y el protocolo sin reservar nada.

Sin -allow-file el relay está abierto: cualquier clave puede reservar y ser alcanzada, a costa de quien lo opera, y 16 direcciones pueden llenar sus 64 reservas por defecto con 4 conexiones por dirección; registra el aviso open relay. Con -allow-file path, solo las claves del archivo pueden reservar: una clave por línea en 64 caracteres hexadecimales, comentarios #, líneas en blanco ignoradas, un archivo normal de como mucho 64 KiB, leído al arrancar. Un archivo sin ninguna clave se rechaza. check recibe relays de -relay (separados por comas, repetible), -relay-file (uno por línea) o KOLO_RELAYS, como mucho 16 en total. Para los comandos de una red completa, consulta Ejecuta tu propia infraestructura.

Ejecutar en un VPS

Para ejecutarlo en un VPS Linux con systemd (el README tiene todos los pasos):

  • Instala la unidad deploy/kolo-node.service. Se ejecuta como un usuario de sistema estático con StateDirectoryMode=0700, que es obligatorio: kolo-id rechaza un directorio de claves que otros puedan leer o que sea un symlink.
  • El archivo de configuración /etc/kolo-node/config.json no contiene ningún secreto (modo 0644). Lista los demás nodos de entrada de tu red en bootstrap, o en un archivo indicado por bootstrap-file. Es válido usar la misma lista en todos los nodos: un nodo ignora su propia dirección. El primer nodo de una red nueva todavía no tiene lista: dale "first": true en lugar de bootstrap.
  • Sube net.core.rmem_max y net.core.wmem_max a 7500000 para que el socket UDP obtenga los búferes que pide.
  • Abre el puerto UDP 7447 en el cortafuegos del host y en el del proveedor. Descarta la entrada IPv6 nueva y conéctate al host por IPv4.
  • La unidad define MemoryMax=512M y GOMEMLIMIT=480MiB. El peor caso de heap vivo es de unos 416 MiB (un almacén de registros lleno más las 16 conexiones del listener que rechaza). Sube los dos a la vez que los límites de registros.
  • La salida 2 no se reinicia (RestartPreventExitStatus=2); los demás fallos se reinician al cabo de 5s.
  • RestrictAddressFamilies=AF_INET AF_UNIX también bloquea el DNS sobre IPv6, así que en un host cuyos servidores de nombres sean todos IPv6, usa direcciones IP literales en -bootstrap o un resolvedor IPv4.
  • Comprueba el puerto desde otra máquina con kolo-node check 203.0.113.10:7447, donde 203.0.113.10 representa la dirección pública.

Límites

  • Solo IPv4. Una dirección IPv6 en -listen, -bootstrap, -bootstrap-file, KOLO_BOOTSTRAP, -relay, -relay-file, KOLO_RELAYS o check, incluidas las formas IPv4-mapped, es un error de configuración (salida 2), y los nombres solo se resuelven a direcciones IPv4.
  • -listen: :7447 por defecto.
  • -config: un único objeto JSON de 64 KiB como máximo. Las claves deben coincidir exactamente y aparecer una sola vez; una clave desconocida, repetida o con otras mayúsculas, null, un número que no sea entero o cualquier cosa después del objeto es un error. Las duraciones son cadenas como "30s".
  • -bootstrap: entradas host:port separadas por comas (direcciones IPv4 o nombres DNS), repetible. Junto con -bootstrap-file y KOLO_BOOTSTRAP, como mucho 16 entradas distintas en total. Un nombre da como mucho 8 direcciones, y hay como mucho 64 direcciones de bootstrap en total. Cada nombre se resuelve en menos de 5s, en paralelo, y después Bootstrap tiene 30s.
  • -bootstrap-file: un archivo de texto de como mucho 64 KiB, un host:port por línea, repetible (en el archivo de configuración, un array de rutas). 16 entradas de la forma más larga (un nombre de 253 bytes, dos puntos y un puerto de 5 dígitos) ocupan unos 4 KiB, y el resto deja sitio para comentarios.
  • -first: falso por defecto; verdadero significa sin nodos de entrada, y se rechaza junto con -bootstrap o -bootstrap-file.
  • KOLO_BOOTSTRAP: sin definir por defecto; como -bootstrap, se lee solo cuando -bootstrap, -bootstrap-file (aunque sea una lista vacía) y -first están todos sin definir.
  • -stats-interval: 5m, de 1s a 24h (288 líneas al día con el valor por defecto).
  • -log-format es text o json; -log-level es info, warn o error.
  • Los flags -dht- definen límites de kolo-dht. Si se dejan a 0, cada uno toma el valor por defecto de kolo-dht, y kolo-dht comprueba el rango:
    • -dht-max-records: 65536, de 16 a 1.000.000. Un almacén lleno ocupa unos 710 bytes de heap por registro, 44 MiB con el valor por defecto.
    • -dht-max-records-per-topic: 512, de 1 a 65536.
    • -dht-max-records-per-ip: 256, de 1 a 65536.
    • -dht-max-inflight: 160, de 8 a 4096, y como mínimo 75 con -bootstrap.
    • -dht-max-relays: 64, de 1 a 4096.
    • -dht-max-requests-per-ip: 50 por segundo, de 1 a 10.000.
    • -dht-max-requests-per-prefix: 200 por segundo, o -dht-max-requests-per-ip si es mayor, hasta 100.000.
    • -dht-max-requests: 10.000 por segundo, o el límite por prefijo si es mayor, hasta 1.000.000.
    • -dht-request-timeout: 1s, de 100ms a 10s.
    • -dht-punch-timeout: 45s, de 1s a 2m.
  • Hasta que se une, el nodo lo vuelve a intentar al cabo de 1 minuto, duplicando la espera tras cada fallo hasta 5 minutos. Una vez unido, vuelve a resolver y a hacer bootstrap cada 5 minutos mientras su tabla tenga menos de 20 servidores.
  • El apagado tiene 10s; después, el proceso sale con 1. Una segunda señal durante el apagado termina el proceso al instante.
  • Se rechazan todas las conexiones entrantes de kolo-secure. El listener que las rechaza tiene un tope de 16 conexiones, 16 pendientes, 1 saliente, 1 stream entrante y ventanas de recepción de 64 KiB por stream y por conexión.
  • check: de 1 a 16 direcciones, -timeout de 5s por dirección, de 1s a 1m. Cada petición espera como mucho la mitad de -timeout. check -relay, -relay-file y KOLO_RELAYS: como mucho 16 relays distintos en total; una clave en dos direcciones o una dirección con dos claves sale con 2.
  • relay -listen y relay -identity son obligatorios; kolo-relay no tiene ningún puerto asignado, así que elige uno. relay -allow-file: ninguno por defecto (un relay abierto), un archivo de texto de como mucho 64 KiB con al menos una clave.
  • Los flags -relay- fijan límites de kolo-relay. Con 0, cada uno toma el valor por defecto de kolo-relay, y kolo-relay comprueba el rango:
    • -relay-max-reservations: 64, de 1 a 100000.
    • -relay-max-sessions: 16, de 1 a 10000. -relay-max-sessions-per-peer: 4 y -relay-max-sessions-per-target: 8, o -relay-max-sessions si es menor.
    • -relay-reservation-lifetime y -relay-max-session-duration: 1h, de 1s a 24h.
    • -relay-max-session-bytes: 1 GiB en cada sentido, de 64 KiB a 1 TiB.
    • -relay-session-idle-timeout: 60s, de 1s a 10m. -relay-connect-timeout y -relay-control-timeout: 15s, de 1s a 60s.
    • -relay-rate-bytes: 1 MiB por segundo por conexión de cliente, de 16 KiB a 1 GiB. -relay-rate-burst: 256 KiB, de 16 KiB a 64 MiB. -relay-flush-interval: 1ms, de 100µs a 100ms.
    • -relay-max-conns: 128, de 1 a 10000, y -relay-max-conns-per-ip: 4, o -relay-max-conns si es menor: los límites del listener. El límite de memoria del listener sube a (-relay-max-conns + 1) × 256 KiB de ventana de recepción cuando eso pasa de 1 GiB, unos 2,4 GiB con 10000.

Seguridad

  • Los logs nunca contienen la semilla, el contenido de los paquetes, los topics, las claves de los registros ni la dirección de un peer más allá de su /24, salvo que se active -log-addrs. No se registra nada por paquete, así que una avalancha no puede llenar el disco.
  • Un nombre DNS en -bootstrap solo lleva a direcciones públicas, o a direcciones del ámbito de la dirección de escucha, así que quien controle el nombre no puede dirigir el nodo hacia una red privada. Las direcciones literales se usan tal como están configuradas.
  • La ruta del archivo de configuración debe apuntar a un archivo normal antes de abrirlo, así que nunca se abre un dispositivo.
  • El archivo de clave solo se crea después de abrir el socket, así que un error de configuración o de escucha no deja nada en disco.
  • relay no registra ninguna dirección ni ninguna clave de sus clientes. Lo que un relay aún puede llegar a saber está en la página de kolo-relay.
  • run nunca transporta tráfico de aplicación: retransmitir es el comando aparte relay, con su propia clave y su propio puerto.

Límites conocidos

  • kolo-dht v0.1.x deriva el ID de DHT de un servidor de su IP y de una elección aleatoria hecha en cada arranque, y sus PINGs no están autenticados, así que la clave estable identifica el nodo del operador, pero ningún peer la comprueba.
  • No hay ningún endpoint HTTP. El estado de salud es el evento stats, y la accesibilidad se prueba desde fuera con kolo-node check, que usa el camino UDP real.
  • kolo-node es experimental. La línea de comandos y el archivo de configuración pueden cambiar antes de v1.0.0.

Errores

Este paquete no exporta variables de error.

kolo-node informa de los errores con eventos de log y códigos de salida: 0 tras SIGINT o SIGTERM, una vez que todo se ha cerrado; 1 si no se puede preparar la identidad o el socket, o si el apagado falla o tarda más de 10s; 2 para un comando, flag, archivo de configuración o límite de kolo-dht no válidos, para la falta de nodos de entrada sin -first, y para un archivo de clave o directorio de claves que kolo-id rechaza. check imprime ok ADDRESS o failed ADDRESS: reason para cada dirección, luego ok relay ADDRESS@KEY o failed relay ADDRESS@KEY: reason para cada relay, y sale con 0 solo si respondieron todos los servidores y relays.

Referencias