Leggeri cambiamenti per una migliore leggibilità

This commit is contained in:
miracle091 2021-10-27 12:55:26 +02:00
parent de74f1c80f
commit ea44414b58
Signed by: miracle091
GPG Key ID: 73D6D9792AD73C84
1 changed files with 38 additions and 32 deletions

View File

@ -1,31 +1,33 @@
## Lista
## 📋 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) - semplice programma per i backup
* <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/amir20/dozzle/master/assets/favicon.svg" 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/) - un'alternativa a github/gitlab locale
* <img src="https://raw.githubusercontent.com/bastienwirtz/homer/main/public/logo.png" width="28" /> [homer](homer/) - semplice pagina per tutti i servizi che volete
* <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 gestione di manga e comics
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/youtubedl.png" width="28" /> [metube](metube/) - frontend moderno per youtube-dl
* <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/) - ascolto e gestione di file musicali (MP3/M4A/etc)
* <img src="https://raw.githubusercontent.com/WalkxCode/dashboard-icons/master/png/podify.png" width="28" /> [podgrab](podgrab/) - server per l'ascolto e gestione di podcast
* <img src="https://raw.githubusercontent.com/NX211/homer-icons/master/png/syncthing.png" width="28" /> [syncthing](syncthing/) - simil-dropbox ma decentralizzato
* <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/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/containrrr/watchtower/main/logo.png" width="28" /> [watchotwer](watchtower/) - aggiornamento automatico dei container
* <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 procedere con gli esempi è necessario avere conoscenza di base di linux e docker(-compose)/podman**</br>
Versione minima dei software richiesti: **docker@20.10.0**, **docker-compose@1.29.0**, **podman@v3.0.0**</br>
È quasi tutto semi-esplicativo e abbastanza dettagliato, nel caso di problemi e/o dubbi non esitate a contattarmi in privato su [telegram](https://t.me/ghostakilla) o aprire una [issue](https://gitea.it/miracle091/MasterpieceDockerCompose/issues/new)
## 📚 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**
@ -35,24 +37,24 @@ Versione minima dei software richiesti: **docker@20.10.0**, **docker-compose@1.2
* **Backup e ripristino**
* **Todo**
## Precisazioni ed Extra
### Uso della tag *"latest"*
Quasi tutte le immagini sono senza tag, così che venga usata quella di default `latest`, molti ne [consigliano](https://web.archive.org/web/20210409095327/https://vsupalov.com/docker-latest-tag/) l'uso ma siete comunque liberi di usare una versione specifica dell'immagine, in caso di problemi noti o se notate poca stabilità dell'immagine
## 🧭 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 locale.
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, modificare e salvare, come se fosse una qualsiasi cartella/file
- 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 (esterno per lo più)
- Obbligo di impostare/controllare i permessi (lettura/scrittura) per le cartelle e/o i file
- 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
---
@ -61,15 +63,19 @@ Tutti i file e le cartelle sono montati direttamente dall'host nel container:</b
![ctop-look](https://ctop.sh/img/screencap.gif)
Programma simile ad [htop](https://htop.dev/) per una gestione semplice dei container:
* Scritto in Go, singolo binario e senza dipendenze extra
* Disponibile per le maggiori distro linux/unix, probabilmente è già nel vostro package manager
* Panoramica dell'uso dell'hardware: CPU, RAM, utilizzo della rete per singolo contenitore
* Informazioni dettagliate sul contenitore: IP, porte, healthcheck, utilizzo del disco e della rete
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 sul container
---
### Risorse usate e ispirazione
Le icone sono prese dalle seguenti risorse: [Homer Icons](https://github.com/NX211/homer-icons), [dashboard-icons](https://github.com/WalkxCode/dashboard-icons), [css.gg](https://css.gg/) e [Simple Icons](https://simpleicons.org/)</br></br>
[DoTheEvo/selfhosted-apps-docker](https://github.com/DoTheEvo/selfhosted-apps-docker/blob/master/README.md)</br>
[StarWhiz/docker_deployment_notes](https://github.com/StarWhiz/docker_deployment_notes/blob/master/README.md)
### 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 ☕.