smbctl 0.0.1

SMB client and server toolkit

SMBCTL

SMBCTL es una herramienta simple para administrar conexiones SMB y levantar servidores SMB utilizando Impacket.

Características

Cliente SMB

• Conectar a recursos SMB
• Desconectar recursos SMB
• Listar conexiones activas
• Ver estado del cliente
• Copiar archivos entre local y SMB
• Soporte Windows y Linux

Servidor SMB

• Iniciar servidor SMB
• Detener servidor SMB
• Consultar estado
• Mostrar información de acceso
• Soporte para autenticación opcional
• Ejecución en background (Linux)

---

Instalación

Desarrollo

git clone https://github.com/kevinzl13/smbctl.git

uv sync

Ejecutar:

uv run smbctl --help

Instalación global

uv tool install smbctl

Después podrás usar:

smbctl

desde cualquier terminal.

---

Comandos Cliente

Conectar a un share SMB

Sin autenticación:

smbctl connect -i 192.168.1.10

Con autenticación:

smbctl connect \
    -i 192.168.1.10 \
    -u usuario \
    -p password

Share personalizado:

smbctl connect \
    -i 192.168.1.10 \
    -s documentos

---

Listar conexiones

smbctl list

Ejemplo:

================ SMB CONNECTIONS ================

SERVER  : 192.168.1.10
SHARE   : smbFolder
CLIENT  : windows
TARGET  : Z:
AUTH    : True
--------------------------------------------------

---

Estado del cliente

smbctl status

---

Desconectar una conexión

Desconectar servidor específico:

smbctl disconnect -i 192.168.1.10

Desconectar todas:

smbctl disconnect

---

Copiar Archivos

La sintaxis está inspirada en SCP.

---

Local → SMB

Copiar archivo local al servidor:

smbctl copy archivo.txt \
    192.168.1.10:/smbFolder/archivo.txt

Copiar a un directorio remoto:

smbctl copy archivo.txt \
    192.168.1.10:/smbFolder/docs/

---

SMB → Local

Copiar archivo remoto al directorio actual:

smbctl copy \
    192.168.1.10:/smbFolder/archivo.txt .

Copiar a una carpeta específica:

smbctl copy \
    192.168.1.10:/smbFolder/archivo.txt \
    ./downloads/

---

Comandos Servidor

Iniciar servidor SMB

Compartir directorio actual:

smbctl server start

Compartir directorio específico:

smbctl server start \
    -d /home/usuario/files

Share personalizado:

smbctl server start \
    -d /home/usuario/files \
    -s documentos

Con autenticación:

smbctl server start \
    -d /home/usuario/files \
    -u usuario \
    -p password

---

Estado del servidor

smbctl server status

Ejemplo:

=== SMB SERVER STATUS ===

PID      : 21344
Share    : smbFolder
Dir      : /home/usuario/files
Alive    : YES
Uptime   : 230s

---

Información de acceso

smbctl server info

Ejemplo:

smb://192.168.1.10/smbFolder

---

Detener servidor

smbctl server stop

---

Funcionamiento por Plataforma

Windows

Las conexiones SMB se montan automáticamente usando:

net use Z: \\IP\SHARE

Por defecto se utiliza:

Z:

Al ejecutar:

smbctl disconnect

la unidad se desmonta automáticamente.

---

Linux

Las conexiones SMB se montan automáticamente usando:

mount -t cifs

Por defecto:

/mnt/smb

Puede personalizarse:

smbctl connect \
    -i 192.168.1.10 \
    -m /mnt/files

---

Requisitos

Cliente

Windows:

net use

Linux:

mount.cifs

---

Servidor

Impacket:

pip install impacket

Verificar:

impacket-smbserver -h

---

Ejemplo Completo

Servidor:

smbctl server start \
    -d /tmp/share \
    -u usuario \
    -p password

Cliente:

smbctl connect \
    -i 192.168.1.10 \
    -u usuario \
    -p password

Copiar archivo:

smbctl copy test.txt \
    192.168.1.10:/smbFolder/test.txt

Descargar archivo:

smbctl copy \
    192.168.1.10:/smbFolder/test.txt .

Desconectar:

smbctl disconnect

Detener servidor:

smbctl server stop