Skip to content

Commit abb5c10

Browse files
committed
Add Spanish translations
1 parent bb17bcd commit abb5c10

11 files changed

Lines changed: 1424 additions & 78 deletions

File tree

docusaurus.config.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,11 +66,11 @@ const config = {
6666
position: 'left',
6767
label: 'Documentation',
6868
to: '/Install',
69-
},/*
69+
},
7070
{
7171
type: 'localeDropdown',
7272
position: 'right',
73-
},*/
73+
},
7474
{
7575
href: 'https://github.com/btcgdl/Mastering-phoenixd',
7676
label: 'GitHub',
Lines changed: 76 additions & 76 deletions
Large diffs are not rendered by default.
File renamed without changes.
File renamed without changes.
Lines changed: 175 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,175 @@
1+
---
2+
slug: /Script
3+
---
4+
# Instalación con un Solo Script
5+
6+
La forma más fácil de instalar phoenixd es usando nuestro script de instalación automatizado. Este script se encarga de la descarga, verificación y configuración de phoenixd en tu sistema Linux.
7+
8+
:::info
9+
**Leer Antes de Instalar**
10+
11+
Por favor, lee esta página completa para entender qué hace el script de instalación, sus requisitos e implicaciones de seguridad antes de ejecutar cualquier comando. El script realizará cambios en el sistema y puede requerir permisos de sudo.
12+
:::
13+
14+
15+
## Instalación Rápida
16+
17+
Ejecuta el siguiente comando en tu terminal:
18+
19+
**Comando único (recomendado):**
20+
```bash
21+
curl -fsSL https://raw.githubusercontent.com/btcgdl/Mastering-phoenixd/master/scripts/install.sh | bash -s -- --yes
22+
```
23+
24+
**Métodos alternativos:**
25+
26+
Si prefieres revisar el script antes de ejecutarlo, puedes descargarlo e inspeccionarlo manualmente primero:
27+
28+
*Descarga el script y hazlo ejecutable:*
29+
```bash
30+
wget https://raw.githubusercontent.com/btcgdl/Mastering-phoenixd/master/scripts/install.sh
31+
chmod +x install.sh
32+
```
33+
34+
*Ejecuta el script:*
35+
```bash
36+
./install.sh
37+
```
38+
39+
## Qué Hace el Script
40+
41+
El script de instalación realiza las siguientes operaciones:
42+
43+
1. **Descarga phoenixd v0.6.2** de los lanzamientos oficiales de ACINQ en GitHub.
44+
2. **Verifica la integridad del paquete** usando firmas GPG y checksums.
45+
3. **Instala en un directorio en tu PATH** (por defecto: `/usr/local/bin`).
46+
4. **Configura tu entorno de shell** para reconocer el comando `phoenixd`.
47+
5. **Opcionalmente, configura un servicio de systemd** para el inicio automático.
48+
49+
## Proceso de Instalación
50+
51+
Cuando ejecutes el script, verás:
52+
53+
```
54+
⚡️ Bienvenido al instalador de Mastering phoenixd
55+
-----------------------------------------
56+
Instalando phoenixd 0.6.2 desde github.com/ACINQ/phoenixd/releases/download/v0.6.2
57+
```
58+
59+
### Verificación del Paquete
60+
61+
El script incluye verificación automática:
62+
63+
```
64+
🔐 Iniciando la verificación del paquete...
65+
✅ Verificación del paquete exitosa.
66+
✅ Verificación exitosa. El paquete es auténtico e intacto.
67+
```
68+
69+
Esto asegura que estás instalando una versión auténtica y no modificada de phoenixd.
70+
71+
### Configuración del Servicio Systemd
72+
73+
Después de la instalación, se te preguntará:
74+
75+
```
76+
¿Quieres configurar un servicio de systemd (requiere permiso de sudo)? (y/n):
77+
```
78+
79+
Si eliges ****:
80+
- Crea un archivo de servicio de systemd en `/etc/systemd/system/phoenixd.service`.
81+
- Habilita e inicia el servicio.
82+
- Configura phoenixd para que se ejecute en mainnet por defecto.
83+
- Configura el reinicio automático en caso de fallo.
84+
85+
Luego puedes gestionar phoenixd usando comandos de systemd:
86+
```bash
87+
sudo systemctl start phoenixd
88+
sudo systemctl stop phoenixd
89+
sudo systemctl restart phoenixd
90+
sudo systemctl status phoenixd
91+
journalctl -u phoenixd -f # Ver registros
92+
```
93+
94+
Si eliges **no**:
95+
- Puedes ejecutar phoenixd manualmente con el comando `phoenixd`.
96+
- Usa `phoenix-cli` para interactuar con el demonio.
97+
98+
## Post-Instalación
99+
100+
Después de una instalación exitosa:
101+
102+
### Operación Manual
103+
```bash
104+
# Iniciar phoenixd manualmente
105+
phoenixd --agree-to-terms-of-service
106+
107+
# En otra terminal, interactuar con phoenixd
108+
phoenix-cli getinfo
109+
```
110+
111+
### Servicio Systemd (si está habilitado)
112+
```bash
113+
# Controlar el servicio
114+
sudo systemctl start phoenixd
115+
sudo systemctl stop phoenixd
116+
sudo systemctl restart phoenixd
117+
118+
# Comprobar el estado del servicio
119+
sudo systemctl status phoenixd
120+
121+
# Ver registros
122+
journalctl -u phoenixd -f
123+
```
124+
125+
## Requisitos
126+
127+
- **Sistema Operativo**: Linux (x64)
128+
- **Dependencias**: `wget`, `gpg`, `unzip`, `sha256sum`
129+
- **Red**: Conexión a internet para las descargas.
130+
- **Permisos**: Acceso de escritura al directorio de instalación, sudo para el servicio de systemd.
131+
132+
## Solución de Problemas
133+
134+
### Comando no encontrado después de la instalación
135+
136+
Si el comando `phoenixd` no es reconocido después de la instalación:
137+
138+
```bash
139+
# Recarga la configuración de tu shell
140+
source ~/.bashrc # o ~/.zshrc
141+
142+
# O reinicia tu terminal
143+
```
144+
145+
### Fallos de verificación
146+
147+
Si la verificación del paquete falla:
148+
- Comprueba tu conexión a internet.
149+
- Asegúrate de que GPG esté instalado correctamente.
150+
- Visita la [página oficial de lanzamientos](https://github.com/ACINQ/phoenixd/releases) para una verificación manual.
151+
152+
### Problemas de permisos
153+
154+
Si encuentras errores de permisos:
155+
- Asegúrate de tener acceso de escritura al directorio de instalación.
156+
- Usa `sudo` para instalaciones a nivel de sistema.
157+
- Considera usar el directorio `~/.local/bin`.
158+
159+
## Notas de Seguridad
160+
161+
El script de instalación:
162+
- ✅ Descarga solo de fuentes oficiales de ACINQ.
163+
- ✅ Verifica los paquetes usando firmas GPG.
164+
- ✅ Valida los checksums antes de la instalación.
165+
- ✅ Usa conexiones HTTPS seguras.
166+
- ✅ Proporciona total transparencia de las operaciones.
167+
168+
Siempre revisa los scripts antes de ejecutarlos con privilegios elevados.
169+
170+
## Próximos Pasos
171+
172+
Después de la instalación, consulta:
173+
- [Guía de Instalación](./2-Install.md) para una configuración detallada.
174+
- [Banderas de Línea de Comandos](./3-Flags.md) para opciones de inicio.
175+
- [Documentación de la API](./5-API.md) para detalles de integración.
Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
slug: /Install
3+
---
4+
5+
# Instalar `phoenixd`
6+
7+
(Consulta la [documentación de Phoenix](https://phoenix.acinq.co/server) para más detalles.)
8+
9+
## 1. Descargar y Configurar `phoenixd`
10+
11+
Descarga y extrae la última versión:
12+
13+
```sh
14+
wget https://github.com/ACINQ/phoenixd/releases/download/v0.6.2/phoenixd-0.6.2-linux-x64.zip
15+
unzip -j phoenixd-0.6.2-linux-x64.zip
16+
```
17+
18+
Mueve los binarios a una ruta global:
19+
20+
```sh
21+
sudo mv phoenixd /usr/local/bin/
22+
sudo mv phoenix-cli /usr/local/bin/
23+
```
24+
25+
Elimina el archivo zip
26+
```sh
27+
rm phoenixd-0.6.2-linux-x64.zip
28+
```
29+
30+
## 2. Crear un Archivo de Servicio de Systemd
31+
32+
Crea un nuevo archivo de servicio de systemd:
33+
34+
```sh
35+
sudo nano /etc/systemd/system/phoenixd.service
36+
```
37+
38+
Añade el siguiente contenido (reemplaza `tu_usuario` con tu nombre de usuario real):
39+
40+
```ini
41+
[Unit]
42+
Description=Demonio de Phoenix
43+
After=network.target
44+
45+
[Service]
46+
ExecStart=phoenixd
47+
User=tu_usuario
48+
Restart=always
49+
RestartSec=5
50+
LimitNOFILE=4096
51+
WorkingDirectory=/home/tu_usuario/
52+
53+
[Install]
54+
WantedBy=multi-user.target
55+
```
56+
57+
## 3. Recargar Systemd y Habilitar el Servicio
58+
59+
```sh
60+
sudo systemctl daemon-reload
61+
sudo systemctl enable phoenixd
62+
```
63+
64+
## 4. Iniciar el Servicio
65+
66+
```sh
67+
sudo systemctl start phoenixd
68+
```
69+
70+
## 5. Comprobar el Estado del Servicio
71+
72+
```sh
73+
sudo systemctl status phoenixd
74+
```
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
slug: /Flags
3+
---
4+
5+
# Banderas Útiles de phoenixd
6+
7+
Aquí hay algunas banderas de línea de comandos útiles que puedes añadir a la línea `ExecStart` en tu archivo `phoenixd.service`:
8+
9+
`--agree-to-terms-of-service`: (Bandera oculta) Acepta los términos de servicio, evitando el aviso interactivo en la primera ejecución.
10+
11+
`--chain <mainnet|testnet>`: Especifica la cadena de Bitcoin a usar. Por defecto es mainnet.
12+
13+
`--mempool-space-url <URL>`: Establece una URL de instancia de mempool.space personalizada.
14+
15+
`--mempool-space-polling-interval-minutes <minutos>`: (Bandera oculta) Define con qué frecuencia se consulta la API de mempool.space (en minutos). Por defecto es 10 minutos.
16+
17+
### Opciones de Liquidez:
18+
19+
`--auto-liquidity <off|2m|5m|10m>`: Establece la cantidad solicitada automáticamente cuando se necesita liquidez entrante. Por defecto es 2m (2,000,000 satoshis).
20+
- off: 0 satoshis
21+
- 2m: 2,000,000 satoshis
22+
- 5m: 5,000,000 satoshis
23+
- 10m: 10,000,000 satoshis
24+
25+
`--max-mining-fee <satoshis>`: Establece la tarifa de minería máxima para operaciones en cadena en satoshis. Restringido de 5,000 a 200,000 satoshis. Por defecto es el 1% de la cantidad de `--auto-liquidity`.
26+
27+
`--max-fee-credit <off|50k|100k>`: Establece el crédito de tarifa máximo. Si se alcanza, los pagos serán rechazados. Por defecto es 100k (100,000 satoshis).
28+
- off: 0 satoshis
29+
- 50k: 50,000 satoshis
30+
- 100k: 100,000 satoshis
31+
32+
`--max-relative-fee-percent <porcentaje>`: (Bandera oculta) Establece la tarifa relativa máxima para operaciones en cadena en porcentaje. Restringido de 1 a 50. Por defecto es 30.
33+
34+
### Opciones HTTP:
35+
36+
`--http-bind-ip <dirección_IP>`: Especifica la dirección IP a la que se vinculará la API HTTP. Por defecto es 127.0.0.1.
37+
38+
`--http-bind-port <número_de_puerto>`: Establece el puerto para la API HTTP. Por defecto es 9740.
39+
40+
`--http-password <contraseña>`: Establece la contraseña para el acceso completo a la API HTTP. Si no se proporciona, se generará una contraseña por defecto.
41+
42+
`--http-password-limited-access <contraseña>`: Establece la contraseña para el acceso limitado a la API HTTP. Si no se proporciona, se generará una contraseña por defecto.
43+
44+
`--webhook <URL>`: Especifica un punto final HTTP de webhook para notificaciones push. Se puede usar varias veces para múltiples webhooks.
45+
46+
`--webhook-secret <secreto>`: Establece el secreto utilizado para autenticar las llamadas de webhook. Si no se proporciona, se generará un secreto por defecto.
47+
48+
### Opciones de Semilla:
49+
50+
`--seed <mnemónico_de_12_palabras>`: Proporciona explícitamente una semilla mnemónica de 12 palabras. Úsalo con extrema precaución, ya que esto expondrá tu semilla en texto plano.
51+
52+
`--seed-path <ruta_al_archivo_de_semilla>`: Sobrescribe la ruta por defecto al archivo de semilla (por defecto es `datadir/seed.dat`).
53+
54+
### Opciones de Registro:
55+
56+
`--log-rotate-size <MB>`: Establece el tamaño de rotación del archivo de registro en megabytes. Por defecto es 10 MB.
57+
58+
`--log-rotate-max-files <número>`: Establece el número máximo de archivos de registro a mantener. Por defecto es 5.
59+
60+
`--silent`: Establece el nivel de verbosidad a silencioso (sin salida en la consola).
61+
62+
`--verbose`: Establece el nivel de verbosidad a detallado (salida detallada en la consola).
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Desinstalar `phoenixd`
2+
3+
:::danger
4+
Este tutorial **no** elimina el directorio `.phoenix/`.
5+
Este directorio contiene tu archivo `seed.dat`.
6+
**Si se elimina, todos tus fondos se perderán permanentemente.** Procede con precaución.
7+
:::
8+
9+
10+
Para eliminar completamente `phoenixd` de tu sistema, sigue estos pasos:
11+
12+
## 1. Detener y Deshabilitar el Servicio
13+
14+
```sh
15+
sudo systemctl stop phoenixd
16+
sudo systemctl disable phoenixd
17+
```
18+
19+
## 2. Eliminar el Archivo de Servicio de Systemd
20+
21+
```sh
22+
sudo rm -v /etc/systemd/system/phoenixd.service
23+
```
24+
25+
## 3. Recargar Systemd
26+
27+
```sh
28+
sudo systemctl daemon-reload
29+
sudo systemctl reset-failed
30+
```
31+
32+
## 4. Eliminar los Binarios de `phoenixd`
33+
34+
```sh
35+
sudo rm -v /usr/local/bin/phoenix*
36+
```
37+
38+
## 5. Verificar que el Servicio se ha Eliminado (Opcional)
39+
40+
```sh
41+
systemctl list-units --type=service | grep phoenixd
42+
```
43+
44+
Después de estos pasos, `phoenixd` se habrá eliminado completamente de tu sistema.

0 commit comments

Comments
 (0)