MasterpieceDockerCompose/README.md

86 lines
6.1 KiB
Markdown

## 📋 Lista
<details><summary>Clicca per visualizzare</summary>
* <img src="https://raw.githubusercontent.com/NX211/homer-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/NX211/homer-icons/master/png/foldingathome.png" width="28" /> [folding@home](folding@home/) - calcolo distrubuito per la ricerca medica
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/dozzle.png" width="28" /> [dozzle](dozzle/) - interfaccia web per controllare i log dei container
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/gitea.png" width="28" /> [gitea](gitea/) - server git con interfaccia web
* <img src="https://raw.githubusercontent.com/NX211/homer-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/NX211/homer-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/NX211/homer-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/NX211/homer-icons/master/png/youtubedl.png" width="28" /> [metube](metube/) - interfaccia web per youtube-dl
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/miniflux.png" width="28" /> [miniflux](miniflux/) - gestore di feed minimale
* <img src="https://raw.githubusercontent.com/NX211/homer-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/NX211/homer-icons/master/png/podify.png" width="28" /> [podgrab](podgrab/) - server per l'ascolto e la gestione di podcast
* <img src="https://raw.githubusercontent.com/NX211/homer-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/NX211/homer-icons/master/png/transmission.png" width="28" /> [transmission](transmission/) - client bittorrent
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/tubesync.png" width="28" /> [tubesync](tubesync/) - pvr per youtube
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/unifi.png" width="28" /> [unifi-controller](unifi/) - 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/NX211/homer-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
Le icone sono basate sui lavori di: [Homer Icons (fork di NX211)](https://github.com/NX211/homer-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)