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
|
# mates-home-nas-tools
|
||||||
|
|
||||||
**Metadata** k projektům uloženým na NAS.
|
Metadata k projektům uloženým na **NAS** (Network Attached Storage).
|
||||||
Toto repo **neobsahuje archivy**, pouze jejich popis, cestu na NAS a velikost.
|
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).
|
Tato cesta je specifická pro **tvůj Mac** s připojeným NAS přes SMB. Na novém stroji musíš:
|
||||||
Na novém stroji musíš připojit NAS nebo zkopírovat archivy ručně.
|
|
||||||
|
|
||||||
## 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)
|
MIT – viz [LICENSE](LICENSE)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Poslední update:** 2026-08-01
|
||||||
|
|||||||
Reference in New Issue
Block a user