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
|
||||
|
||||
Docker Compose šablony pro 14 self-hosted služeb.
|
||||
Toto je **přesná kopie** `docker-compose.yml` souborů z běžícího serveru.
|
||||
Docker Compose šablony pro **14 self-hosted služeb**.
|
||||
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
|
||||
cd <sluzba>
|
||||
cp .env.example .env # pokud existuje
|
||||
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)
|
||||
|
||||
---
|
||||
|
||||
**Poslední update:** 2026-08-01
|
||||
|
||||
Reference in New Issue
Block a user