Files
Unraid-Navigator/README.md
T
2026-06-22 22:21:49 +02:00

69 lines
1.6 KiB
Markdown

# U-Navigator
Unraid File Navigator.
Ziel: Eine optische Dateiverwaltung fuer Unraid, inspiriert von Synology File Station.
Aktueller Stand:
- Machbarkeitsstudie: [docs/MACHBARKEITSSTUDIE.md](docs/MACHBARKEITSSTUDIE.md)
- Prototyp: In-App-Fenstermanager, Explorer-Fenster, Eigenschaften-Fenster, Transfer-Queue, lokaler Upload und interne Move/Copy-Jobs.
Kurzentscheidung:
U-Navigator ist als natives Unraid-Dynamix-Plugin umgesetzt. Die Weboberflaeche wird direkt im Unraid-WebGUI geladen; die API-Endpunkte laufen als PHP-Dateien im Plugin.
Naechster sinnvoller Schritt:
Robuste Hintergrundjobs fuer grosse Copy/Move-Operationen und eine Konfigurationsseite fuer erlaubte Roots.
## Unraid Plugin installieren
Plugin-URL:
```text
https://git.casaderoll.de/michael/Unraid-Navigator/raw/branch/main/u-navigator.plg
```
Installation per Unraid Terminal:
```sh
installplg https://git.casaderoll.de/michael/Unraid-Navigator/raw/branch/main/u-navigator.plg
```
Oder im WebGUI:
```text
Plugins -> Install Plugin -> URL einfuegen -> Install
```
Danach oeffnen:
```text
Tools -> U-Navigator
```
Es wird kein extra Webserver und kein Node.js auf Unraid benoetigt.
## Lokal testen
Der historische Node-Prototyp ist fuer lokale API-Tests noch im Repo. Auf Entwicklungsmaschinen ohne `/mnt/user` kann ein Root gesetzt werden:
```sh
U_NAV_ROOT="$PWD" PORT=8088 npm start
```
Danach im Browser oeffnen:
```text
http://127.0.0.1:8088
```
## Tests
```sh
npm test
```
Die Tests starten einen lokalen HTTP-Server und pruefen Listing, Upload, Move-Jobs, Zielkonflikte und Pfad-Sandboxing.