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,39 +1,301 @@
|
|||||||
# mates-docker-services
|
# mates-docker-services
|
||||||
|
|
||||||
Docker Compose šablony pro 14 self-hosted služeb.
|
Docker Compose šablony pro **14 self-hosted služeb**.
|
||||||
Toto je **přesná kopie** `docker-compose.yml` souborů z běžícího serveru.
|
Toto jsou **přesné kopie** `docker-compose.yml` souborů z běžícího serveru.
|
||||||
|
|
||||||
## Služby
|
> **Jsi začátečník?** Čti od [Začínáme](#zaciname) – vše krok za krokem.
|
||||||
|
|
||||||
| Služba | Port | Image |
|
---
|
||||||
|---|---|---|
|
|
||||||
| audiobookshelf | 13378 | advplyr/audiobookshelf |
|
|
||||||
| calibre-web | 8083 | linuxserver/calibre-web |
|
|
||||||
| erugo | 61080 | wardy784/erugo |
|
|
||||||
| gitea | 3000, 222 | gitea/gitea |
|
|
||||||
| jotty | 1122 | mrx23dotcom/jotty |
|
|
||||||
| jswiki | 9180 | linuxserver/wikijs |
|
|
||||||
| nextcloud-aio | 8155 | nextcloud/all-in-one |
|
|
||||||
| nginx-proxy-manager | 80, 443, 81 | jc21/nginx-proxy-manager |
|
|
||||||
| plex | 32400 | linuxserver/plex |
|
|
||||||
| portainer | 9000, 9443 | portainer/portainer-ce |
|
|
||||||
| rustdesk | 21115-21119 | rustdesk/rustdesk-server |
|
|
||||||
| speedtest | 8072 | linuxserver/speedtest-tracker |
|
|
||||||
| vaultwarden | 2999 | vaultwarden/server |
|
|
||||||
| watchtower | – | containrrr/watchtower |
|
|
||||||
|
|
||||||
## Použití
|
## 📦 Služby (14)
|
||||||
|
|
||||||
|
| Služba | Port | Image | Účel |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **audiobookshelf** | 13378 | advplyr/audiobookshelf | Audio knihovna |
|
||||||
|
| **calibre-web** | 8083 | linuxserver/calibre-web | E-knihovna |
|
||||||
|
| **erugo** | 61080 | wardy784/erugo | Sdílení souborů |
|
||||||
|
| **gitea** | 3000, 222 | gitea/gitea | Self-hosted Git |
|
||||||
|
| **jotty** | 1122 | mrx23dotcom/jotty | Poznámky a checklisty |
|
||||||
|
| **jswiki** | 9180 | linuxserver/wikijs | Wiki |
|
||||||
|
| **nextcloud-aio** | 8155 | nextcloud/all-in-one | Cloud (soubory, kalendář) |
|
||||||
|
| **nginx-proxy-manager** | 80, 443, 81 | jc21/nginx-proxy-manager | Reverzní proxy + HTTPS |
|
||||||
|
| **plex** | 32400 | linuxserver/plex | Media server |
|
||||||
|
| **portainer** | 9000, 9443 | portainer/portainer-ce | Docker UI |
|
||||||
|
| **rustdesk** | 21115-21119 | rustdesk/rustdesk-server | Remote desktop |
|
||||||
|
| **speedtest** | 8072 | linuxserver/speedtest-tracker | Speed test tracker |
|
||||||
|
| **vaultwarden** | 2999 | vaultwarden/server | Hesla |
|
||||||
|
| **watchtower** | – | containrrr/watchtower | Auto-update kontejnerů |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Začínáme
|
||||||
|
|
||||||
|
### Krok 1: Naklonuj repo
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone http://<server-ip>:3000/mates/mates-docker-services.git
|
||||||
|
cd mates-docker-services
|
||||||
|
```
|
||||||
|
|
||||||
|
### Krok 2: Vyber službu
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd portainer
|
||||||
|
```
|
||||||
|
|
||||||
|
### Krok 3: Nasaď službu
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd <sluzba>
|
|
||||||
cp .env.example .env # pokud existuje
|
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
## Detailní návody
|
To je vše! Služba se stáhne, nastartuje a běží.
|
||||||
|
|
||||||
Každá služba má `README.md` s odkazem na Jotty knowledge base (kategorie podle typu).
|
### Krok 4: Ověř
|
||||||
|
|
||||||
## Licence
|
```bash
|
||||||
|
docker compose ps # status
|
||||||
|
docker compose logs -f # logy
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 Detail ke každé službě
|
||||||
|
|
||||||
|
### audiobookshelf (`13378`)
|
||||||
|
|
||||||
|
Audio knihovna. Stream audioknih, podcastů. Sledování pokroku.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd audiobookshelf
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:13378 a dokonci setup
|
||||||
|
```
|
||||||
|
|
||||||
|
### calibre-web (`8083`)
|
||||||
|
|
||||||
|
Web čtečka e-knihoven.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd calibre-web
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:8083 a dokonci setup
|
||||||
|
```
|
||||||
|
|
||||||
|
### erugo (`61080`)
|
||||||
|
|
||||||
|
Jednoduché sdílení souborů s heslem a expirací.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd erugo
|
||||||
|
docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### gitea (`3000`, `222`)
|
||||||
|
|
||||||
|
Self-hosted Git server.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd gitea
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:3000 a dokonci install wizard
|
||||||
|
# SSH pristup: ssh://git@<server-ip>:222
|
||||||
|
```
|
||||||
|
|
||||||
|
### jotty (`1122`)
|
||||||
|
|
||||||
|
Poznámky a checklisty (knowledge base).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd jotty
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:1122
|
||||||
|
```
|
||||||
|
|
||||||
|
### jswiki (`9180`)
|
||||||
|
|
||||||
|
Wiki.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd jswiki
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:9180 a dokonci setup
|
||||||
|
```
|
||||||
|
|
||||||
|
### nextcloud-aio (`8155`)
|
||||||
|
|
||||||
|
Cloud (soubory, kalendář, kontakty).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd nextcloud-aio
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:11000 (admin)
|
||||||
|
# Nasleduj install wizard
|
||||||
|
```
|
||||||
|
|
||||||
|
### nginx-proxy-manager (`80`, `443`, `81`)
|
||||||
|
|
||||||
|
Reverzní proxy + HTTPS (Let's Encrypt).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd nginx-proxy-manager
|
||||||
|
docker compose up -d
|
||||||
|
# Admin UI: http://<server-ip>:81
|
||||||
|
# Default login: admin@example.com / changeme (ZMEN!)
|
||||||
|
```
|
||||||
|
|
||||||
|
### plex (`32400`)
|
||||||
|
|
||||||
|
Media server.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd plex
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:32400/web
|
||||||
|
```
|
||||||
|
|
||||||
|
### portainer (`9000`, `9443`)
|
||||||
|
|
||||||
|
Docker UI.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd portainer
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:9000
|
||||||
|
# Vytvor admin ucet
|
||||||
|
```
|
||||||
|
|
||||||
|
### rustdesk (`21115-21119`)
|
||||||
|
|
||||||
|
Remote desktop relay server.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd rustdesk
|
||||||
|
docker compose up -d
|
||||||
|
# Verejny klic z logu hbbs pridej do RustDesk klienta
|
||||||
|
```
|
||||||
|
|
||||||
|
### speedtest (`8072`)
|
||||||
|
|
||||||
|
Speed test tracker.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd speedtest
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri http://<server-ip>:8072
|
||||||
|
```
|
||||||
|
|
||||||
|
### vaultwarden (`2999`)
|
||||||
|
|
||||||
|
Správce hesel (Bitwarden kompatibilní).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd vaultwarden
|
||||||
|
docker compose up -d
|
||||||
|
# Otevri https://vault.example.com (za HTTPS pres NPM)
|
||||||
|
```
|
||||||
|
|
||||||
|
### watchtower
|
||||||
|
|
||||||
|
Auto-update všech kontejnerů (monitor-only mode).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd watchtower
|
||||||
|
docker compose up -d
|
||||||
|
# Defaultne jen upozornuje, neaktualizuje
|
||||||
|
# Zmen WATCHTOWER_MONITOR_ONLY=false pro auto-update
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏗 Struktura
|
||||||
|
|
||||||
|
```
|
||||||
|
mates-docker-services/
|
||||||
|
├── README.md # Tento soubor
|
||||||
|
├── LICENSE # MIT
|
||||||
|
├── audiobookshelf/
|
||||||
|
│ ├── docker-compose.yml # Compose soubor
|
||||||
|
│ └── README.md # Detailní návod
|
||||||
|
├── calibre-web/
|
||||||
|
│ ├── docker-compose.yml
|
||||||
|
│ └── README.md
|
||||||
|
├── ... (12 dalsich sluzeb)
|
||||||
|
└── (kazda sluzba ma docker-compose.yml + README.md)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 Správa služeb
|
||||||
|
|
||||||
|
### Update jedné služby
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <sluzba>
|
||||||
|
docker compose pull
|
||||||
|
docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### Update všech služeb
|
||||||
|
|
||||||
|
```bash
|
||||||
|
for d in */; do
|
||||||
|
cd "$d"
|
||||||
|
docker compose pull
|
||||||
|
docker compose up -d
|
||||||
|
cd ..
|
||||||
|
done
|
||||||
|
```
|
||||||
|
|
||||||
|
### Zastavit službu
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <sluzba>
|
||||||
|
docker compose stop
|
||||||
|
```
|
||||||
|
|
||||||
|
### Restart
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose restart
|
||||||
|
```
|
||||||
|
|
||||||
|
### Logy
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose logs -f --tail=100
|
||||||
|
```
|
||||||
|
|
||||||
|
### Smazat (data jsou v ./data/)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose down -v # POZOR: smaze i volumes
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔐 Bezpečnost
|
||||||
|
|
||||||
|
- ✅ **Žádné hesla v `docker-compose.yml`** – vše v `.env`
|
||||||
|
- ✅ **Restart policy `unless-stopped`** – kontejner se nespustí po rebootu
|
||||||
|
- ✅ **Health checks** – monitoring přes Portainer
|
||||||
|
- ✅ **Log rotation** – max 10 MB × 3 soubory
|
||||||
|
- ✅ **Bridge networks** – izolace mezi službami
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 Související
|
||||||
|
|
||||||
|
- **Jotty:** knowledge base (detailní návody pro každou službu)
|
||||||
|
- **mates-ansible:** automatické nasazení přes Ansible
|
||||||
|
- **mates-install-scripts:** Docker zálohy a cleanup
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📜 Licence
|
||||||
|
|
||||||
MIT – viz [LICENSE](LICENSE)
|
MIT – viz [LICENSE](LICENSE)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Poslední update:** 2026-08-01
|
||||||
|
|||||||
Reference in New Issue
Block a user