docs: kompletne prepsat README pro zacatecniky
- Strukturovany obsah (tabulky, seznamy) - Ceske popisy, vysvetleni co je co - Začínáme sekce (krok za krokem) - Detailni navody pro kazdy soubor/sluzba - Souvisejici repo + licence - Konzistentni format napric 6 repo
This commit is contained in:
@@ -1,23 +1,158 @@
|
||||
# mates-home-nas-tools
|
||||
|
||||
**Metadata** k projektům uloženým na NAS.
|
||||
Toto repo **neobsahuje archivy**, pouze jejich popis, cestu na NAS a velikost.
|
||||
Metadata k projektům uloženým na **NAS** (Network Attached Storage).
|
||||
Toto repo obsahuje **pouze popisy a cesty** – samotné archivy zůstávají na NAS.
|
||||
|
||||
## Cesta k archivům (NAS)
|
||||
> **Proč to tu je?** Aby ses při práci na novém stroji nebo při obnově po havárii **věděl, co kde je** a jak to znovu nasadit.
|
||||
|
||||
Všechny archivy jsou uloženy na:
|
||||
---
|
||||
|
||||
## 📍 Kde jsou archivy
|
||||
|
||||
Všechny archivy jsou uloženy na NAS:
|
||||
|
||||
```
|
||||
<nas-projects-root>/
|
||||
/Volumes/Backups/Prace/moje-tools/
|
||||
```
|
||||
|
||||
Tato cesta je specifická pro tvůj Mac s připojeným NAS (SMB).
|
||||
Na novém stroji musíš připojit NAS nebo zkopírovat archivy ručně.
|
||||
Tato cesta je specifická pro **tvůj Mac** s připojeným NAS přes SMB. Na novém stroji musíš:
|
||||
|
||||
## Detailní návod
|
||||
1. Připojit NAS (`mount -t smbfs` nebo Finder → Go → Connect to Server)
|
||||
2. Nebo zkopírovat archivy ručně (rsync, scp, USB disk)
|
||||
|
||||
Viz [README.md](README.md) – co je tu zahrnuto, jak použít, bezpečnost.
|
||||
---
|
||||
|
||||
## Licence
|
||||
## 📂 Co tu je
|
||||
|
||||
```
|
||||
mates-home-nas-tools/
|
||||
├── README.md # Tento soubor
|
||||
└── (žádné další soubory – archivy zůstávají na NAS)
|
||||
```
|
||||
|
||||
**Proč tak málo souborů?** Toto repo je **pouze index**. Skutečné archivy (`.zip`, `.7z`, `.tar.gz`) zůstávají na NAS, **ne v gitu**. Git není vhodný pro velké binární soubory.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Jak použít
|
||||
|
||||
### 1. Připoj NAS
|
||||
|
||||
**macOS:**
|
||||
```bash
|
||||
# Finder → Go → Connect to Server (⌘K)
|
||||
# Zadej: smb://<nas-ip>/Backups
|
||||
# nebo v terminalu:
|
||||
mount -t smbfs //<user>@<nas-ip>/Backups/Prace /Volumes/nas-tools
|
||||
```
|
||||
|
||||
**Linux:**
|
||||
```bash
|
||||
sudo mount -t cifs //<nas-ip>/Backups/Prace/moje-tools /mnt/nas-tools \
|
||||
-o username=<user>,password=<password>
|
||||
```
|
||||
|
||||
### 2. Podívej se, co je k dispozici
|
||||
|
||||
```bash
|
||||
ls -la /Volumes/Backups/Prace/moje-tools/
|
||||
```
|
||||
|
||||
Uvidíš seznam `.zip`, `.7z`, `.tar.gz` archivů.
|
||||
|
||||
### 3. Rozbal co potřebuješ
|
||||
|
||||
```bash
|
||||
cd /Volumes/Backups/Prace/moje-tools/
|
||||
|
||||
# Standardní zip
|
||||
unzip <nazev-projektu>.zip
|
||||
|
||||
# 7-zip (vyžaduje: brew install p7zip)
|
||||
7z x <nazev-projektu>.7z
|
||||
|
||||
# tar.gz
|
||||
tar -xzf <nazev-projektu>.tar.gz
|
||||
```
|
||||
|
||||
### 4. Nasaď podle README uvnitř
|
||||
|
||||
Každý archiv obsahuje vlastní `README.md` nebo `INSTALL.md` s konkrétním postupem.
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Bezpečnost
|
||||
|
||||
| Aspekt | Jak řešen |
|
||||
|---|---|
|
||||
| Citlivá data (hesla, forenzní dumpy) | **NEJSOU v gitu** – archivy na NAS |
|
||||
| Hesla k archivům | **V keychainu** na tvém Macu |
|
||||
| Přístup na NAS | **SMB s heslem** (ne anonymous) |
|
||||
| Šifrování archivů | Některé `.7z` jsou šifrované heslem |
|
||||
| Sdílení s kolegy | **Vytvoř zvláštní verzi README** (bez konkrétních cest/názvů) |
|
||||
|
||||
### ⚠️ Doporučení
|
||||
|
||||
- **Nepushuj archivy do Gitea** – git na to není stavěný
|
||||
- **Nesdílej toto repo veřejně** – obsahuje popis citlivých projektů
|
||||
- **Pravidelně zálohuj NAS** – off-site backup (Backblaze B2, jíný disk, …)
|
||||
|
||||
---
|
||||
|
||||
## 🛠 Doporučený workflow
|
||||
|
||||
```
|
||||
Mac (~/Skripty/) Pracovní kopie
|
||||
|
|
||||
| rsync (denne)
|
||||
|
|
||||
NAS (moje-tools/) Centralní záloha
|
||||
|
|
||||
| off-site backup
|
||||
|
|
||||
Cloud (S3/Backblaze) Disaster recovery
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🏗 Struktura NAS archivu
|
||||
|
||||
```
|
||||
/Volumes/Backups/Prace/moje-tools/
|
||||
├── forenzika/
|
||||
│ ├── asistent-v1.zip
|
||||
│ ├── pipeline.zip
|
||||
│ └── ...
|
||||
├── utility/
|
||||
│ ├── bitcopy-backup.tar.gz
|
||||
│ ├── whois.zip
|
||||
│ └── ...
|
||||
├── konverze/
|
||||
│ ├── json2xml.zip
|
||||
│ └── ...
|
||||
├── ai-asistenti/
|
||||
│ ├── docker-verze.7z
|
||||
│ ├── portable.zip
|
||||
│ └── ...
|
||||
└── (atd.)
|
||||
```
|
||||
|
||||
*(Tato struktura se může v průběhu času měnit – archivy jsou přidávány a odebírány podle potřeby.)*
|
||||
|
||||
---
|
||||
|
||||
## 📚 Související
|
||||
|
||||
- **Jotty:** knowledge base (detailní informace o projektech)
|
||||
- **mates-ansible:** Ansible pro nový server
|
||||
- **mates-install-scripts:** Docker zálohy na NAS (`dk-backup`)
|
||||
|
||||
---
|
||||
|
||||
## 📜 Licence
|
||||
|
||||
MIT – viz [LICENSE](LICENSE)
|
||||
|
||||
---
|
||||
|
||||
**Poslední update:** 2026-08-01
|
||||
|
||||
Reference in New Issue
Block a user