feat: config Samba + mDNS para Termux Android
- smb.conf: SMB2/SMB3, cifrado, signing, 6 shares, puerto 4450 - mdns-publish.py: publica SSH + SMB via Zeroconf (movil.local) - README.md: documentacion completa de uso y troubleshooting - Compatible con Windows 11, Kubuntu 24 y macOS Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Andrés Eduardo García Márquez
commit
efc0e2f47f
|
|
@ -0,0 +1,229 @@
|
||||||
|
# Samba en Termux - Documentacion
|
||||||
|
|
||||||
|
> Actualizado: 2026-03-24
|
||||||
|
|
||||||
|
## Resumen
|
||||||
|
|
||||||
|
Samba 4.20.8 corriendo en Termux (Android) con descubrimiento automatico en red local via mDNS. Compatible con Windows 11, Kubuntu 24 y macOS.
|
||||||
|
|
||||||
|
- **Nombre en red:** MOVIL
|
||||||
|
- **Puerto:** 4450 (445 requiere root, no disponible en Termux)
|
||||||
|
- **Protocolo:** SMB2/SMB3 con cifrado y signing
|
||||||
|
- **Usuario:** andres
|
||||||
|
- **Autostart:** Via `.bashrc` al abrir Termux
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Archivos de configuracion
|
||||||
|
|
||||||
|
| Archivo | Proposito |
|
||||||
|
|---------|-----------|
|
||||||
|
| `~/.config/samba/smb.conf` | Config principal de Samba |
|
||||||
|
| `~/.config/samba/private/` | Base de datos de usuarios (tdbsam) |
|
||||||
|
| `~/.config/samba/samba.log` | Log de actividad |
|
||||||
|
| `~/.config/samba/lock/` | Lock files para browsing |
|
||||||
|
| `~/.config/samba/state/` | Estado interno |
|
||||||
|
| `~/.config/samba/cache/` | Cache |
|
||||||
|
| `~/.local/bin/mdns-publish.py` | Script que publica SSH + SMB via mDNS |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Shares disponibles
|
||||||
|
|
||||||
|
| Share | Ruta Android | Contenido |
|
||||||
|
|-------|-------------|-----------|
|
||||||
|
| Archivos | `/storage/emulated/0/Archivos` | Desarrollo, documentos de trabajo |
|
||||||
|
| Home | `$HOME` | Home de Termux (configs, scripts) |
|
||||||
|
| Downloads | `/storage/emulated/0/Download` | Descargas del navegador/apps |
|
||||||
|
| Documents | `/storage/emulated/0/Documents` | Documentos Android |
|
||||||
|
| DCIM | `/storage/emulated/0/DCIM` | Fotos y videos de camara |
|
||||||
|
| Movies | `/storage/emulated/0/Movies` | Peliculas |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Conexion desde otros equipos
|
||||||
|
|
||||||
|
### Kubuntu 24 / KDE Dolphin
|
||||||
|
|
||||||
|
El dispositivo aparece automaticamente en **Red** del panel lateral como **"movil"** gracias al servicio mDNS `_smb._tcp`.
|
||||||
|
|
||||||
|
Tambien se puede acceder manualmente:
|
||||||
|
|
||||||
|
```
|
||||||
|
smb://movil.local:4450/
|
||||||
|
smb://movil.local:4450/Archivos
|
||||||
|
```
|
||||||
|
|
||||||
|
Credenciales: `andres` / `asde71.4`
|
||||||
|
|
||||||
|
### Kubuntu 24 / Terminal
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Descubrir el servicio
|
||||||
|
avahi-browse -rt _smb._tcp
|
||||||
|
|
||||||
|
# Listar shares
|
||||||
|
smbclient -L movil.local -p 4450 -U andres
|
||||||
|
|
||||||
|
# Acceder a un share
|
||||||
|
smbclient //movil.local/Archivos -p 4450 -U andres
|
||||||
|
|
||||||
|
# Montar como filesystem
|
||||||
|
sudo mount -t cifs //movil.local/Archivos /mnt/movil \
|
||||||
|
-o port=4450,username=andres,password=asde71.4,vers=3.0
|
||||||
|
```
|
||||||
|
|
||||||
|
### Windows 11
|
||||||
|
|
||||||
|
Windows no soporta puertos SMB alternativos de forma nativa. Opciones:
|
||||||
|
|
||||||
|
**Opcion A - Mapear con netsh (requiere admin):**
|
||||||
|
```cmd
|
||||||
|
netsh interface portproxy add v4tov4 listenport=445 listenaddress=127.0.0.1 connectport=4450 connectaddress=192.168.1.108
|
||||||
|
net use Z: \\127.0.0.1\Archivos /user:andres asde71.4
|
||||||
|
```
|
||||||
|
|
||||||
|
**Opcion B - Usar la IP directa desde Explorador:**
|
||||||
|
```
|
||||||
|
\\192.168.1.108:4450\Archivos
|
||||||
|
```
|
||||||
|
(Nota: no todos los builds de Win11 soportan esta sintaxis)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Descubrimiento en red (mDNS / DNS-SD)
|
||||||
|
|
||||||
|
### Como funciona
|
||||||
|
|
||||||
|
El script `~/.local/bin/mdns-publish.py` publica dos servicios via Zeroconf (mDNS):
|
||||||
|
|
||||||
|
| Servicio | Tipo DNS-SD | Puerto | Proposito |
|
||||||
|
|----------|------------|--------|-----------|
|
||||||
|
| SSH | `_ssh._tcp.local.` | 8022 | Acceso remoto por SSH |
|
||||||
|
| Samba | `_smb._tcp.local.` | 4450 | Compartir archivos SMB |
|
||||||
|
|
||||||
|
Ambos se publican bajo el hostname **movil.local**.
|
||||||
|
|
||||||
|
### Script: mdns-publish.py
|
||||||
|
|
||||||
|
**Ubicacion:** `~/.local/bin/mdns-publish.py`
|
||||||
|
**Dependencia:** `pip install zeroconf`
|
||||||
|
**Autostart:** Via `.bashrc` (lineas 34-37)
|
||||||
|
|
||||||
|
El script:
|
||||||
|
1. Detecta la IP local del dispositivo
|
||||||
|
2. Registra los servicios SSH y SMB en la red multicast mDNS
|
||||||
|
3. Se mantiene corriendo en background (daemon)
|
||||||
|
4. Limpia los registros al recibir SIGINT/SIGTERM
|
||||||
|
|
||||||
|
### Verificar que esta publicando
|
||||||
|
|
||||||
|
Desde Termux:
|
||||||
|
```bash
|
||||||
|
python3 -c "
|
||||||
|
from zeroconf import Zeroconf, ServiceBrowser
|
||||||
|
import time
|
||||||
|
class L:
|
||||||
|
def add_service(self, zc, t, n):
|
||||||
|
info = zc.get_service_info(t, n)
|
||||||
|
if info:
|
||||||
|
a = '.'.join(str(b) for b in info.addresses[0])
|
||||||
|
print(f'{n} -> {a}:{info.port}')
|
||||||
|
def remove_service(self, *a): pass
|
||||||
|
def update_service(self, *a): pass
|
||||||
|
zc = Zeroconf()
|
||||||
|
ServiceBrowser(zc, '_smb._tcp.local.', L())
|
||||||
|
ServiceBrowser(zc, '_ssh._tcp.local.', L())
|
||||||
|
time.sleep(3)
|
||||||
|
zc.close()
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
Desde Kubuntu:
|
||||||
|
```bash
|
||||||
|
avahi-browse -rt _smb._tcp
|
||||||
|
```
|
||||||
|
|
||||||
|
Resultado esperado:
|
||||||
|
```
|
||||||
|
movil → movil.local → 192.168.1.x:4450
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Autostart en .bashrc
|
||||||
|
|
||||||
|
Samba y mDNS se inician automaticamente al abrir Termux. Extracto relevante de `~/.bashrc`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Iniciar Samba si no esta corriendo
|
||||||
|
if ! pgrep -x smbd > /dev/null; then
|
||||||
|
smbd -D -s ~/.config/samba/smb.conf 2>/dev/null
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Iniciar mDNS (movil.local) si no esta corriendo
|
||||||
|
if ! pgrep -f mdns-publish.py > /dev/null; then
|
||||||
|
nohup python ~/.local/bin/mdns-publish.py > /dev/null 2>&1 &
|
||||||
|
disown
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
|
||||||
|
No se usa Termux:Boot (no funciona). Se inicia al abrir la primera sesion de Termux.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Aliases de gestion
|
||||||
|
|
||||||
|
| Alias | Accion |
|
||||||
|
|-------|--------|
|
||||||
|
| `smb-start` | Iniciar Samba |
|
||||||
|
| `smb-stop` | Detener Samba |
|
||||||
|
| `smb-restart` | Reiniciar Samba |
|
||||||
|
| `smb-status` | Ver si esta corriendo |
|
||||||
|
| `smb-log` | Ver ultimas 50 lineas del log |
|
||||||
|
| `mdns-status` | Ver si mDNS esta corriendo |
|
||||||
|
| `mdns-restart` | Reiniciar mDNS |
|
||||||
|
| `mdns-stop` | Detener mDNS |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Parametros de compatibilidad
|
||||||
|
|
||||||
|
| Parametro | Valor | Motivo |
|
||||||
|
|-----------|-------|--------|
|
||||||
|
| `server min protocol` | SMB2 | Win11 y Kubuntu 24 ya no usan SMB1 |
|
||||||
|
| `server max protocol` | SMB3 | Maximo rendimiento y cifrado |
|
||||||
|
| `smb encrypt` | desired | Win11 lo prefiere, negocia automaticamente |
|
||||||
|
| `server signing` | desired | Win11 lo exige desde 2024 |
|
||||||
|
| `unix charset` | UTF-8 | Acentos en nombres de archivo |
|
||||||
|
| `dos charset` | CP850 | Compatibilidad Windows |
|
||||||
|
| `use sendfile` | yes | Rendimiento en transferencias |
|
||||||
|
| `aio read/write size` | 16384 | I/O asincrono para archivos grandes |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### "Connection refused" desde otro equipo
|
||||||
|
|
||||||
|
1. Verificar que smbd corre: `smb-status`
|
||||||
|
2. Verificar puerto: `ss -tlnp | grep 4450`
|
||||||
|
3. Verificar firewall Android: Abrir ajustes WiFi, verificar que no hay restricciones
|
||||||
|
|
||||||
|
### No aparece en Dolphin (Red)
|
||||||
|
|
||||||
|
1. Verificar mDNS: `mdns-status`
|
||||||
|
2. Desde Kubuntu: `avahi-browse -rt _smb._tcp` (debe mostrar "movil")
|
||||||
|
3. Si no aparece, reiniciar: `mdns-restart`
|
||||||
|
4. Acceso manual: `smb://movil.local:4450/` en barra de Dolphin
|
||||||
|
|
||||||
|
### "NT_STATUS_LOGON_FAILURE"
|
||||||
|
|
||||||
|
Resetear password:
|
||||||
|
```bash
|
||||||
|
printf 'asde71.4\nasde71.4\n' | smbpasswd -L -s -c ~/.config/samba/smb.conf andres
|
||||||
|
```
|
||||||
|
|
||||||
|
### Acentos se ven mal
|
||||||
|
|
||||||
|
Verificar que `unix charset = UTF-8` esta en `smb.conf` seccion `[global]`.
|
||||||
|
|
@ -0,0 +1,73 @@
|
||||||
|
#!/data/data/com.termux/files/usr/bin/python
|
||||||
|
"""Publica servicios via mDNS/Zeroconf: SSH + Samba"""
|
||||||
|
import socket
|
||||||
|
import signal
|
||||||
|
import sys
|
||||||
|
from zeroconf import ServiceInfo, Zeroconf, IPVersion
|
||||||
|
|
||||||
|
HOSTNAME = 'movil'
|
||||||
|
|
||||||
|
SERVICES = [
|
||||||
|
{
|
||||||
|
'type': '_ssh._tcp.local.',
|
||||||
|
'port': 8022,
|
||||||
|
'props': {'description': 'Termux SSH'},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
'type': '_smb._tcp.local.',
|
||||||
|
'port': 4450,
|
||||||
|
'props': {'description': 'Termux Samba', 'path': '/'},
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
def get_local_ip():
|
||||||
|
try:
|
||||||
|
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
|
||||||
|
s.connect(('8.8.8.8', 80))
|
||||||
|
ip = s.getsockname()[0]
|
||||||
|
s.close()
|
||||||
|
return ip
|
||||||
|
except Exception:
|
||||||
|
return '127.0.0.1'
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
ip = get_local_ip()
|
||||||
|
addr = socket.inet_aton(ip)
|
||||||
|
zc = Zeroconf(ip_version=IPVersion.V4Only)
|
||||||
|
infos = []
|
||||||
|
|
||||||
|
for svc in SERVICES:
|
||||||
|
info = ServiceInfo(
|
||||||
|
svc['type'],
|
||||||
|
f'{HOSTNAME}.{svc["type"]}',
|
||||||
|
addresses=[addr],
|
||||||
|
port=svc['port'],
|
||||||
|
properties=svc['props'],
|
||||||
|
server=f'{HOSTNAME}.local.',
|
||||||
|
)
|
||||||
|
zc.register_service(info)
|
||||||
|
infos.append(info)
|
||||||
|
print(f'Publicando {HOSTNAME}.local {svc["type"]} -> {ip}:{svc["port"]}')
|
||||||
|
|
||||||
|
def cleanup(sig, frame):
|
||||||
|
print('Deteniendo mDNS...')
|
||||||
|
for info in infos:
|
||||||
|
zc.unregister_service(info)
|
||||||
|
zc.close()
|
||||||
|
sys.exit(0)
|
||||||
|
|
||||||
|
signal.signal(signal.SIGINT, cleanup)
|
||||||
|
signal.signal(signal.SIGTERM, cleanup)
|
||||||
|
|
||||||
|
try:
|
||||||
|
signal.pause()
|
||||||
|
except AttributeError:
|
||||||
|
import time
|
||||||
|
while True:
|
||||||
|
time.sleep(3600)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
main()
|
||||||
|
|
@ -0,0 +1,111 @@
|
||||||
|
# Samba config para Termux
|
||||||
|
# Compatible: Windows 11 + Kubuntu 24 + macOS
|
||||||
|
# Puerto: 4450 (445 requiere root)
|
||||||
|
# Windows: \\IP:4450\ o net use Z: \\IP\Archivos /user:andres
|
||||||
|
# Linux: smb://IP:4450/Archivos
|
||||||
|
|
||||||
|
[global]
|
||||||
|
workgroup = WORKGROUP
|
||||||
|
server string = Termux Mobile
|
||||||
|
netbios name = MOVIL
|
||||||
|
|
||||||
|
# Puerto alternativo (445 requiere root)
|
||||||
|
smb ports = 4450
|
||||||
|
|
||||||
|
# Seguridad
|
||||||
|
security = user
|
||||||
|
map to guest = never
|
||||||
|
passdb backend = tdbsam
|
||||||
|
|
||||||
|
# Protocolos - Max compatibilidad Win11 + Kubuntu 24
|
||||||
|
client min protocol = SMB2
|
||||||
|
server min protocol = SMB2
|
||||||
|
server max protocol = SMB3
|
||||||
|
client max protocol = SMB3
|
||||||
|
|
||||||
|
# Cifrado (Win11 lo prefiere, Kubuntu 24 lo soporta)
|
||||||
|
smb encrypt = desired
|
||||||
|
|
||||||
|
# Signing (Win11 lo exige por defecto desde 2024)
|
||||||
|
server signing = desired
|
||||||
|
client signing = desired
|
||||||
|
|
||||||
|
# Rutas Termux
|
||||||
|
private dir = /data/data/com.termux/files/home/.config/samba/private
|
||||||
|
lock directory = /data/data/com.termux/files/home/.config/samba/lock
|
||||||
|
state directory = /data/data/com.termux/files/home/.config/samba/state
|
||||||
|
cache directory = /data/data/com.termux/files/home/.config/samba/cache
|
||||||
|
pid directory = /data/data/com.termux/files/home/.config/samba
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
log file = /data/data/com.termux/files/home/.config/samba/samba.log
|
||||||
|
max log size = 500
|
||||||
|
log level = 1
|
||||||
|
|
||||||
|
# Rendimiento
|
||||||
|
socket options = TCP_NODELAY IPTOS_LOWDELAY
|
||||||
|
use sendfile = yes
|
||||||
|
aio read size = 16384
|
||||||
|
aio write size = 16384
|
||||||
|
|
||||||
|
# Charset (acentos y caracteres especiales)
|
||||||
|
unix charset = UTF-8
|
||||||
|
dos charset = CP850
|
||||||
|
|
||||||
|
# Descubrimiento de red
|
||||||
|
server multi channel support = yes
|
||||||
|
mdns name = mdns
|
||||||
|
|
||||||
|
[Archivos]
|
||||||
|
comment = Archivos de trabajo
|
||||||
|
path = /storage/emulated/0/Archivos
|
||||||
|
browseable = yes
|
||||||
|
writable = yes
|
||||||
|
valid users = andres
|
||||||
|
create mask = 0644
|
||||||
|
directory mask = 0755
|
||||||
|
|
||||||
|
[Home]
|
||||||
|
comment = Home Termux
|
||||||
|
path = /data/data/com.termux/files/home
|
||||||
|
browseable = yes
|
||||||
|
writable = yes
|
||||||
|
valid users = andres
|
||||||
|
create mask = 0644
|
||||||
|
directory mask = 0755
|
||||||
|
|
||||||
|
[Downloads]
|
||||||
|
comment = Descargas Android
|
||||||
|
path = /storage/emulated/0/Download
|
||||||
|
browseable = yes
|
||||||
|
writable = yes
|
||||||
|
valid users = andres
|
||||||
|
create mask = 0644
|
||||||
|
directory mask = 0755
|
||||||
|
|
||||||
|
[Documents]
|
||||||
|
comment = Documentos Android
|
||||||
|
path = /storage/emulated/0/Documents
|
||||||
|
browseable = yes
|
||||||
|
writable = yes
|
||||||
|
valid users = andres
|
||||||
|
create mask = 0644
|
||||||
|
directory mask = 0755
|
||||||
|
|
||||||
|
[DCIM]
|
||||||
|
comment = Fotos y Videos
|
||||||
|
path = /storage/emulated/0/DCIM
|
||||||
|
browseable = yes
|
||||||
|
writable = yes
|
||||||
|
valid users = andres
|
||||||
|
create mask = 0644
|
||||||
|
directory mask = 0755
|
||||||
|
|
||||||
|
[Movies]
|
||||||
|
comment = Peliculas
|
||||||
|
path = /storage/emulated/0/Movies
|
||||||
|
browseable = yes
|
||||||
|
writable = yes
|
||||||
|
valid users = andres
|
||||||
|
create mask = 0644
|
||||||
|
directory mask = 0755
|
||||||
Loading…
Reference in New Issue