secubox-openwrt/package/secubox/secubox-app-smbfs/README.md
CyberMind-FR 79bb3c43f4 feat: Add smbfs mount manager, Jellyfin READMEs, Glances host visibility, planning updates
New secubox-app-smbfs package for SMB/CIFS remote directory management
with smbfsctl CLI (add/remove/mount/umount/test/status), UCI config,
auto-mount init script, and Jellyfin/Lyrion media path integration.

Glances LXC: host bind mounts (/rom, /overlay, /boot, /srv), Docker
socket fix (symlink loop), fs plugin @exit_after patch, hostname/OS
identity, pre-generated /etc/mtab.

KISS READMEs for secubox-app-jellyfin and luci-app-jellyfin. Planning
files updated with Domoticz IoT, AI Gateway strategy, App Store P2P
emancipation, and v2 roadmap items.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 21:02:46 +01:00

102 lines
2.0 KiB
Markdown

# SecuBox SMB/CIFS Remote Mount Manager
Manages SMB/CIFS network shares for media servers (Jellyfin, Lyrion), backups, and general-purpose remote storage.
## Installation
```sh
opkg install secubox-app-smbfs
```
## Configuration
UCI config file: `/etc/config/smbfs`
```
config smbfs 'global'
option enabled '1'
option mount_base '/mnt/smb'
option cifs_version '3.0'
option timeout '10'
config mount 'movies'
option enabled '1'
option server '//192.168.1.100/movies'
option mountpoint '/mnt/smb/movies'
option username 'media'
option _password 'secret'
option read_only '1'
option auto_mount '1'
option description 'NAS movie library'
```
## Usage
```sh
# Add a share
smbfsctl add movies //nas/movies /mnt/smb/movies
# Set credentials
smbfsctl credentials movies user password
# Set options
smbfsctl set movies read_only 1
smbfsctl set movies description 'Movie library'
# Test connectivity
smbfsctl test movies
# Mount / unmount
smbfsctl mount movies
smbfsctl umount movies
# Enable auto-mount at boot
smbfsctl enable movies
# List all shares
smbfsctl list
# Show detailed mount status
smbfsctl status
# Mount all enabled shares
smbfsctl mount-all
```
## Integration with Media Apps
```sh
# Jellyfin: add mounted share as media library
uci add_list jellyfin.media.media_path='/mnt/smb/movies'
uci commit jellyfin
# Lyrion: point music library to mounted share
uci set lyrion.main.media_path='/mnt/smb/music'
uci commit lyrion
```
## Features
- UCI-based share configuration with credentials storage
- Auto-mount at boot for enabled shares
- Read-only or read-write mount modes
- CIFS protocol version selection (2.0, 2.1, 3.0)
- Connectivity test before mounting
- Mount status with disk usage reporting
- Integration with Jellyfin and Lyrion media paths
## Files
- `/etc/config/smbfs` -- UCI configuration
- `/etc/init.d/smbfs` -- procd init script (auto-mount)
- `/usr/sbin/smbfsctl` -- controller CLI
## Dependencies
- `kmod-fs-cifs` -- CIFS kernel module
- `cifsmount` -- mount.cifs utility
## License
Apache-2.0