MasterpieceDockerCompose/README.md

100 lines
6.3 KiB
Markdown

## 📋 Lista
<details><summary>Clicca per visualizzare</summary>
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/archiveteamwarrior.png" width="28" /> [archive warrior](archivewarrior) - un nodo per aiutare l'[archive team](https://archive.org/)
- <img src="https://i.ibb.co/XLPmnnf/borg.png" width="28" /> [borg](borg) - software per i backup 2.0
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/foldingathome.png" width="28" /> [folding@home](folding@home/) - calcolo distrubuito per la ricerca medica
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/dozzle.png" width="28" /> [dozzle](dozzle/) - interfaccia web per controllare i log dei container
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/gitea.png" width="28" /> [gitea](gitea/) - server git con interfaccia web
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/homer.png" width="28" /> [homer](homer/) - semplice pagina per tutti i servizi che avete (e non)
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/jellyfin.png" width="28" /> [jellyfin](jellyfin/) - server per la gestione e la transcodifica di musica, film e serie tv
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/komga.png" width="28" /> [komga](komga/) - server per la lettura e la gestione di manga e comics
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/youtubedl.png" width="28" /> [metube](metube/) - interfaccia web per youtube-dl
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/miniflux.png" width="28" /> [miniflux](miniflux/) - gestore di feed minimale
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/navidrome.png" width="28" /> [navidrome](navidrome/) - server per l'ascolto e la gestione di file musicali
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/podify.png" width="28" /> [podgrab](podgrab/) - server per l'ascolto e la gestione di podcast
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/syncthing.png" width="28" /> [syncthing](syncthing/) - dropbox decentralizzato
- <img src="https://i.ibb.co/9cxYGSF/tor.jpg" width="28" /> [tor-socks-proxy](tor-socks-proxy/) - tor proxy server
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/transmission.png" width="28" /> [transmission](transmission/) - client bittorrent
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/tubesync.png" width="28" /> [tubesync](tubesync/) - pvr per youtube
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/unifi.png" width="28" /> [unifi-controller](unifi-controller/) - interfaccia web per la gestione dell'hardware ubiquiti
- <img src="https://raw.githubusercontent.com/wger-project/wger/master/wger/core/static/images/logos/logo.svg" width="28" /> [wger](wger/) - server per la gestione della vostra alimentazione e allenamenti
- <img src="https://raw.githubusercontent.com/walkxcode/dashboard-icons/master/png/watchtower.png" width="28" /> [watchotwer](watchtower/) - aggiorna automaticamente i container
</details></br>
## 📚 Struttura degli esempi
**Prima di iniziare ad usare gli esempi è necessario:**
- **una conoscenza di base di linux/unix e docker(-compose)/podman**
- **versione minima dei software richiesti: `docker@20.10.0`, `docker-compose@1.29.0`, `podman@v3.0.0`**
Essendo quasi tutto esplicativo e dettagliato non dovrebbero esserci problemi, ma nel caso non esitate ad aprire una [issue](https://gitea.it/miracle091/MasterpieceDockerCompose/issues/new).
- **Descrizione**
- **Struttura file e cartelle**
- **Esempi**
- **Reverse proxy**
- **Aggiornamento**
- **Backup e ripristino**
- **Todo**
## 🧭 Precisazioni ed Extra
### Uso implicito della tag _"latest"_
Buona parte delle immagini sono senza tag, in modo tale che venga usata quella di default `latest`, normalmente [ne è consigliato l'uso](https://web.archive.org/web/20210409095327/https://vsupalov.com/docker-latest-tag/).
### Utilizzo di una rete specifica
Ogni compose prevede l'uso di una rete specifica (attualmente è `custom-bridge`), per una gestione _"interna<->esterna"_ semplificata e migliore, ma avendo comunque un maggiore controllo anche in caso di accesso esterno della vostra rete.
---
### Bind mount
Tutti i file e le cartelle sono montati direttamente dall'host nel container:</br>
**Pro:**
- Creare e/o modificare una cartella/file in modo diretto
- Backup e ripristini molto semplici
**Contro:**
- Maggiore vulnerabilità dell'host, nel caso di un'attacco mirato (in genere dall'esterno)
- Obbligo di impostare e controllare i permessi (lettura/scrittura) per le cartelle/file
---
### ctop
[![Sito ufficiale](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=firefoxbrowser&style=flat&label=&message=Homepage)](https://ctop.sh) [![Sorgente](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=github&style=flat&label=&message=Sorgente)](https://github.com/bcicen/ctop)
![ctop-look](https://raw.githubusercontent.com/bcicen/ctop/master/_docs/img/grid.gif)
Molto simile ad [htop](https://htop.dev/), per una gestione semplice e chiara dei container:
- Scritto in Go, eseguibile singolo e senza librerie esterne
- Disponibile per le maggiori distro linux/unix
- Panoramica generale e informazioni dettagliate su i singoli container
---
### Risorse usate
Molte delle icone sono basate sui lavori di: [walkxcode/dashboard-icons](https://github.com/walkxcode/dashboard-icons), [css.gg](https://css.gg/) e [Simple Icons](https://simpleicons.org/).
Progetti che mi hanno ispirato: [DoTheEvo/selfhosted-apps-docker](https://github.com/DoTheEvo/selfhosted-apps-docker/blob/master/README.md) e [StarWhiz/docker_deployment_notes](https://github.com/StarWhiz/docker_deployment_notes/blob/master/README.md).
---
### Donazioni
Se vi piace quello che faccio, potete [offrirmi](https://coindrop.to/miracle091) un ☕.
---
Licenza: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode.txt)