Diferencia entre revisiones de «Ejecución de Bitcoin»

De Bitcoin Wiki
Saltar a: navegación, buscar
(Traducción del artículo inglés Running Bitcoin)
 
m (Corrijo dos erratas)
 
Línea 15: Línea 15:
 
   -pid=<archivo>    Especificar el archivo pid (por defecto: bitcoind.pid)
 
   -pid=<archivo>    Especificar el archivo pid (por defecto: bitcoind.pid)
 
   -gen              Generar bitcoins
 
   -gen              Generar bitcoins
   -gen=0            No generar coins
+
   -gen=0            No generar bitcoins
 
   -min              Iniciarse minimizado
 
   -min              Iniciarse minimizado
 
   -datadir=<dir>    Especificar directorio de datos
 
   -datadir=<dir>    Especificar directorio de datos
Línea 58: Línea 58:
 
Todas las opciones de línea de comandos (excepto -datadir y -conf) pueden ser especificadas mediante un archivo de configuración y todas las opciones del archivo de configuración pueden especificarse también desde la línea de comandos. Las opciones indicadas en línea de comandos tiene prioridad sobre los valores establecidos en el archivo de configuración.
 
Todas las opciones de línea de comandos (excepto -datadir y -conf) pueden ser especificadas mediante un archivo de configuración y todas las opciones del archivo de configuración pueden especificarse también desde la línea de comandos. Las opciones indicadas en línea de comandos tiene prioridad sobre los valores establecidos en el archivo de configuración.
  
El archivo de configuración consiste en una lista de asignaciones con la sintaxis "ajuste=valor", ona por línea, a las que se pueden añadir comentarios, que empiezan por el carácter '#'.
+
El archivo de configuración consiste en una lista de asignaciones con la sintaxis "ajuste=valor", una por línea, a las que se pueden añadir comentarios, que empiezan por el carácter '#'.
  
 
El archivo de configuración no se genera automáticamente. Puede crearlo mediante su editor de texto preferido. Por defecto, Bitcoin (o bitcoind) busca un archivo llamado 'bitcoin.conf' el [[directorio de datos]] de Bitcoin, pero tanto el directorio de datos como la ruta del archivo de configuración pueden ser modificados mediante los argumentos -datadir y -conf desde línea de comandos.
 
El archivo de configuración no se genera automáticamente. Puede crearlo mediante su editor de texto preferido. Por defecto, Bitcoin (o bitcoind) busca un archivo llamado 'bitcoin.conf' el [[directorio de datos]] de Bitcoin, pero tanto el directorio de datos como la ruta del archivo de configuración pueden ser modificados mediante los argumentos -datadir y -conf desde línea de comandos.

Revisión actual del 20:40 9 sep 2012

Existen dos versiones alternativas del programa original de Bitcoin; una que dispone de interfaz gráfica de usuario (a la que a menudo se denomina simplemente “Bitcoin”), y una versión headless, manejada por línea de comandos sin interfaz gráfica, llamada bitcoind. Ambas son totalmente compatibles entre sí, admiten los mismos argumentos desde línea de comandos, leen el mismo archivo de configuración y leen y escriben en los mismos archivos de datos. Por ello, solamente se puede ejecutar uno de los dos programas, Bitcoin o bitcoind, en un mismo sistema en un momento dado (si se intenta ejecutar el otro, aparece un aviso de que el programa, Bitcoin o bitoind, ya está en ejecución y la segunda versión se cierra de inmediato).

Argumentos de línea de comandos

Al ejecutar Bitcoin (o bitcoind) con los argumentos "-?" o "–-help", se mostrará en pantalla una lista con los comandos disponibles:

Uso:

 bitcoind [opciones]                     
 bitcoind [opciones] <comando> [parámetros]  Enviar comando al ejecutable Bitcoin (ejecutado con la opción "-server") o a bitcoind
 bitcoind [opciones] help                Mostrar un listado de comandos
 bitcoind [opciones] help <comando>      Mostrar la ayuda para un comando

Opciones:

 -conf=<archivo>    Especificar el archivo de configuración (por defecto: bitcoin.conf)
 -pid=<archivo>     Especificar el archivo pid (por defecto: bitcoind.pid)
 -gen               Generar bitcoins
 -gen=0             No generar bitcoins
 -min               Iniciarse minimizado
 -datadir=<dir>     Especificar directorio de datos
 -timeout=<n>       Especificar tiempo límite de conexión (en milisegundos)
 -proxy=<ip:puerto> Conectar a través de proxy socks4
 -dns               Permitir la búsqueda de DNS para addnode y connect
 -port=<puerto>     Estar a la escucha de conexiones en <puerto> (por defecto: 8333 o testnet 18333)
 -maxconnections=<n>  Mantener como máximo <n> conexiones con pares (por defecto: 125)
 -addnode=<ip>      Añadir un nodo al que conectarse
 -connect=<ip>      Conectarse solo al nodo especificado
 -nolisten          No aceptar conexiones desde el exterior
 -nodnsseed         No iniciar la lista de pares mediante DNS
 -banscore=<n>      Umbral para la desconexión de pares con mal comportamiento (por defecto: 100)
 -bantime=<n>       Número de segundos en el que evitar la reconexión de pares con mal comportamiento (por defecto: 86400)
 -maxreceivebuffer=<n> Buffer de datos de recepción máximo por conexión, <n>*1000 bytes (por defecto: 10000)
 -maxsendbuffer=<n> Buffer de envío máximo por conexión, <n>*1000 bytes (por defecto: 10000)
 -noupnp            No intentar el uso de UPnP para mapear el puerto de escucha
 -paytxfee=<amt>    Comisión por KB que se ha de añadir a las transacciones enviadas
 -daemon            Ejecutar en segundo plano como daemon y aceptar comandos
 -testnet           Utilizar la red de pruebas testnet (bitcoins no reales)
 -debug             Mostrar información de depuración adicional
 -logtimestamps     Incluir una marca de tiempo (timestamp) con la información de depuración
 -printtoconsole    Enviar la información de trazas/depuración a la consola en lugar de al archivo debug.log
 -rpcuser=<user>    Nombre de usuario para las conexiones JSON-RPC
 -rpcpassword=<pw>  Contraseña para las conexiones JSON-RPC
 -rpcport=<puerto>  Estar a la escucha de conexiones JSON-RPC en <puerto> (por defecto: 8332)
 -rpcallowip=<ip>   Permitir las conexiones JSON-RPC desde la dirección IP especificada
 -rpcconnect=<ip>   Enviar los comandos al nodo que se ejecuta en la <ip> (por defecto: 127.0.0.1)
 -keypool=<n>       Establecer el tamaño de la reserva de claves (key pool) en <n> (por defecto: 100)
 -rescan            Volver a explorar la cadena de bloques para detectar las transacciones que afectan a la cartera local

Opciones SSL: (véanse las instrucciones de instalación de SSL)

 -rpcssl                                  Utilizar OpenSSL (https) para las conexiones JSON-RPC
 -rpcsslcertificatechainfile=<file.cert>  Archivo de certificados de servidor (por defecto: server.cert)
 -rpcsslprivatekeyfile=<file.pem>         Clave privada del servidor (por defecto: server.pem)
 -rpcsslciphers=<ciphers>                 Cifrados aceptables (por defecto: TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH)

Adicionales (válidos pero no listados en -? help):

 -checkblocks       Volver a cargar la cadena de bloques completa (puede llevar muchísimo tiempo)

Archivo de configuración Bitcoin.conf

Todas las opciones de línea de comandos (excepto -datadir y -conf) pueden ser especificadas mediante un archivo de configuración y todas las opciones del archivo de configuración pueden especificarse también desde la línea de comandos. Las opciones indicadas en línea de comandos tiene prioridad sobre los valores establecidos en el archivo de configuración.

El archivo de configuración consiste en una lista de asignaciones con la sintaxis "ajuste=valor", una por línea, a las que se pueden añadir comentarios, que empiezan por el carácter '#'.

El archivo de configuración no se genera automáticamente. Puede crearlo mediante su editor de texto preferido. Por defecto, Bitcoin (o bitcoind) busca un archivo llamado 'bitcoin.conf' el directorio de datos de Bitcoin, pero tanto el directorio de datos como la ruta del archivo de configuración pueden ser modificados mediante los argumentos -datadir y -conf desde línea de comandos.

Operating System Default bitcoin datadir Typical path to configuration file
Windows  %APPDATA%\Bitcoin\ (XP) C:\Documents and Settings\username\Application Data\Bitcoin\bitcoin.conf

(Vista, 7) C:\Users\username\AppData\Roaming\Bitcoin\bitcoin.conf

Linux $HOME/.bitcoin/ /home/username/.bitcoin/bitcoin.conf
Mac OSX $HOME/Library/Application Support/Bitcoin/ /Users/username/Library/Application Support/Bitcoin/bitcoin.conf

Nota: si se ejecuta Bitcoin en modo testnet, el subdirectorio "testnet" se concatenará al directorio de datos automáticamente.

Ejemplo de Bitcoin.conf

He aquí un archivo bitcoin.conf de ejemplo.

 # bitcoin.conf configuration file. Lines beginning with # are comments.
 
 
 # Network-related settings:
 
 # Run on the test network instead of the real bitcoin network.
 #testnet=0
 
 # Connect via a socks4 proxy
 #proxy=127.0.0.1:9050
 
 ##############################################################
 ##            Quick Primer on addnode vs connect            ##
 ##  Let's say for instance you use addnode=4.2.2.4          ##
 ##  addnode will connect you to and tell you about the      ##
 ##    nodes connected to 4.2.2.4.  In addition it will tell ##
 ##    the other nodes connected to it that you exist so     ##
 ##    they can connect to you.                              ##
 ##  connect will not do the above when you 'connect' to it. ##
 ##    It will *only* connect you to 4.2.2.4 and no one else.##
 ##                                                          ##
 ##  So if you're behind a firewall, or have other problems  ##
 ##  finding nodes, add some using 'addnode'.                ##
 ##                                                          ##
 ##  If you want to stay private, use 'connect' to only      ##
 ##  connect to "trusted" nodes.                             ##
 ##                                                          ##
 ##  If you run multiple nodes on a LAN, there's no need for ##
 ##  all of them to open lots of connections.  Instead       ##
 ##  'connect' them all to one node that is port forwarded   ##
 ##  and has lots of connections.                            ##
 ##       Thanks goes to [Noodle] on Freenode.               ##
 ##############################################################
 
 # Use as many addnode= settings as you like to connect to specific peers
 #addnode=69.164.218.197
 #addnode=10.0.0.2:8333
 
 # ... or use as many connect= settings as you like to connect ONLY
 # to specific peers:
 #connect=69.164.218.197
 #connect=10.0.0.1:8333
 
 # Do not use Internet Relay Chat (irc.lfnet.org #bitcoin channel) to
 # find other peers.
 #noirc=0
 
 # Maximum number of inbound+outbound connections.
 #maxconnections=
 
 
 # JSON-RPC options (for controlling a running Bitcoin/bitcoind process)
 
 # server=1 tells Bitcoin-QT to accept JSON-RPC commands.
 #server=0
 
 # You must set rpcuser and rpcpassword to secure the JSON-RPC api
 #rpcuser=Ulysseys
 #rpcpassword=YourSuperGreatPasswordNumber_DO_NOT_USE_THIS_OR_YOU_WILL_GET_ROBBED_385593
 
 # How many seconds bitcoin will wait for a complete RPC HTTP request.
 # after the HTTP connection is established. 
 #rpctimeout=30
 
 # By default, only RPC connections from localhost are allowed.  Specify
 # as many rpcallowip= settings as you like to allow connections from
 # other hosts (and you may use * as a wildcard character):
 #rpcallowip=10.1.1.34
 #rpcallowip=192.168.1.*
 
 # Listen for RPC connections on this TCP port:
 #rpcport=8332
 
 # You can use Bitcoin or bitcoind to send commands to Bitcoin/bitcoind
 # running on another host using this option:
 #rpcconnect=127.0.0.1
 
 # Use Secure Sockets Layer (also known as TLS or HTTPS) to communicate
 # with Bitcoin -server or bitcoind
 #rpcssl=1
 
 # OpenSSL settings used when rpcssl=1
 #rpcsslciphers=TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH
 #rpcsslcertificatechainfile=server.cert
 #rpcsslprivatekeyfile=server.pem
 
 
 # Miscellaneous options
 
 # Set gen=1 to attempt to generate bitcoins
 #gen=0
 
 # Use SSE instructions to try to generate bitcoins faster.
 #4way=1
 
 # Pre-generate this many public/private key pairs, so wallet backups will be valid for
 # both prior transactions and several dozen future transactions.
 #keypool=100
 
 # Pay an optional transaction fee every time you send bitcoins.  Transactions with fees
 # are more likely than free transactions to be included in generated blocks, so may
 # be validated sooner.
 #paytxfee=0.00
 
 # Allow direct connections for the 'pay via IP address' feature.
 #allowreceivebyip=1
   
 # User interface options
 
 # Start Bitcoin minimized
 #min=1
 
 # Minimize to the system tray
 #minimizetotray=1

Plataformas

Windows

Inicio automático

Para configurar el cliente de Bitcoin para que se inicie automáticamente:

Se puede utilizar el archivo de configuración o los ajustes en la interfaz gráfica:

Ajustes -> Opciones

Marcar la casilla que dice:

[X] Ejecutar Bitcoin al iniciar el sistema

Archivo:Client Settings Options windows.png

Automatización por batch

Para programar llamadas desde un archivo batch, tendrá que ejecutar el programa daemon (bitcoind.exe). Si se ejecuta la versión gráfica bitcoin.exe con la opción "-server", el programa responderá a las llamadas con mensajes para la interfaz gráfica y no se podrán procesar las respuestas desde el archivo batch.

Mac

Linux

Archivo:Client Settings Options.png