Compare commits

..

4 Commits

Author SHA1 Message Date
689148fc22 ++ fix 2026-05-14 17:35:51 +02:00
5d4dfd4d15 ++ fix 2026-05-14 17:34:29 +02:00
74636dc619 ++ implementazione MAKE 2026-05-14 17:30:51 +02:00
69556f63eb ++ fix ed implementazioni 2026-05-14 17:26:19 +02:00
5 changed files with 212 additions and 28 deletions

38
.env
View File

@@ -1,21 +1,41 @@
# Immagine Docker da usare
NEXTERM_IMAGE=germannewsmaker/nexterm:latest
IMAGE=germannewsmaker/nexterm:latest
# Nome del container
NEXTERM_CONTAINER_NAME=nexterm
CONTAINER_NAME=nexterm
# Politica di riavvio (no | always | unless-stopped | on-failure)
NEXTERM_RESTART_POLICY=unless-stopped
RESTART_POLICY=unless-stopped
# Porte host/container
NEXTERM_PORT_HOST=8080
# Porta esposta sull'host
PORT=8485
# Percorso dati persistenti sul filesystem locale
NEXTERM_DATA_DIR=./nexterm_data
DATA_DIR=./nexterm_data
# Timezone del container
NEXTERM_TZ=Europe/Rome
# Timezone (condivisa da tutti i servizi)
TZ=Europe/Rome
# Chiave di cifratura usata da Nexterm (obbligatoria)
# Deve essere una stringa esadecimale di 64 caratteri (32 byte).
NEXTERM_ENCRYPTION_KEY=4c4c18e819265ede62496d41dc6511ee4ec107ed0f6115a5d60856ed08ca933e
ENCRYPTION_KEY=crea_una_chiave_esadecimale_di_64_caratteri_per_la_cifratura
# ---------------------------------------------------------------------------
# Watchtower - aggiornamento automatico delle immagini Docker
# ---------------------------------------------------------------------------
# Immagine Watchtower
WATCHTOWER_IMAGE=containrrr/watchtower:latest
# Nome del container Watchtower
WATCHTOWER_CONTAINER_NAME=watchtower
# Rimozione automatica delle vecchie immagini dopo l'aggiornamento
WATCHTOWER_CLEANUP=true
# Schedule cron (secondi minuti ore giorni mese giorno_settimana)
# Default: ogni giorno alle 03:00
WATCHTOWER_SCHEDULE=0 0 3 * * *
# Livello log notifiche (panic | fatal | error | warn | info | debug | trace)
WATCHTOWER_NOTIFICATIONS_LEVEL=warn

12
.gitignore vendored Normal file
View File

@@ -0,0 +1,12 @@
### Windows
# Windows thumbnail cache files
Thumbs.db
# Folder config file
[Dd]esktop.ini
# Recycle Bin used on file shares
$RECYCLE.BIN/
# Windows shortcuts
*.lnk

105
Makefile Normal file
View File

@@ -0,0 +1,105 @@
.DEFAULT_GOAL := help
ENV_FILE := .env
PLACEHOLDER := crea_una_chiave_esadecimale_di_64_caratteri_per_la_cifratura
# ---------------------------------------------------------------------------
# Rileva OS per generazione chiave
# ---------------------------------------------------------------------------
ifeq ($(OS),Windows_NT)
KEYGEN = powershell -NoProfile -Command \
"$$b = New-Object byte[] 32; \
[System.Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($$b); \
($$b | ForEach-Object { $$_.ToString('x2') }) -join ''"
else
KEYGEN = openssl rand -hex 32
endif
# ---------------------------------------------------------------------------
# Legge ENCRYPTION_KEY dal .env per validazione
# ---------------------------------------------------------------------------
-include $(ENV_FILE)
export
# ---------------------------------------------------------------------------
# Targets
# ---------------------------------------------------------------------------
.PHONY: help
help: ## Mostra questo messaggio di aiuto
@echo ""
@echo " Nexterm - guida al deploy"
@echo ""
@echo " 1. make genkey — genera e scrive ENCRYPTION_KEY nel .env"
@echo " 2. make check — verifica prerequisiti e configurazione"
@echo " 3. make up — avvia i container"
@echo ""
@echo " Altri comandi:"
@awk 'BEGIN {FS = ":.*?## "}; /^[a-zA-Z_-]+:.*?## / {printf " %-14s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
@echo ""
.PHONY: genkey
genkey: ## Genera ENCRYPTION_KEY casuale e la scrive nel .env
$(eval NEW_KEY := $(shell $(KEYGEN)))
@if [ -z "$(NEW_KEY)" ]; then \
echo "ERRORE: generazione chiave fallita. Assicurati che openssl sia installato."; \
exit 1; \
fi
ifeq ($(OS),Windows_NT)
@powershell -NoProfile -Command \
"(Get-Content $(ENV_FILE)) -replace '$(PLACEHOLDER)|^ENCRYPTION_KEY=.*', \
{ if ($$_ -match '^ENCRYPTION_KEY=') { 'ENCRYPTION_KEY=$(NEW_KEY)' } else { $$_ } } \
| Set-Content $(ENV_FILE)"
else
@sed -i "s|^ENCRYPTION_KEY=.*|ENCRYPTION_KEY=$(NEW_KEY)|" $(ENV_FILE)
endif
@echo "ENCRYPTION_KEY aggiornata nel file $(ENV_FILE)."
.PHONY: check
check: ## Verifica prerequisiti e configurazione prima del deploy
@echo "==> Controllo Docker..."
@docker info > /dev/null 2>&1 || (echo "ERRORE: Docker non raggiungibile." && exit 1)
@echo " OK"
@echo "==> Controllo docker compose..."
@docker compose version > /dev/null 2>&1 || (echo "ERRORE: docker compose v2 non trovato." && exit 1)
@echo " OK"
@echo "==> Controllo file $(ENV_FILE)..."
@test -f $(ENV_FILE) || (echo "ERRORE: file $(ENV_FILE) non trovato." && exit 1)
@echo " OK"
@echo "==> Controllo ENCRYPTION_KEY..."
@if echo "$(ENCRYPTION_KEY)" | grep -qE '^[0-9a-fA-F]{64}$$'; then \
echo " OK"; \
else \
echo "ERRORE: ENCRYPTION_KEY non valida (deve essere hex di 64 caratteri)."; \
echo " Esegui: make genkey"; \
exit 1; \
fi
@echo ""
@echo "Tutto OK. Puoi eseguire: make up"
.PHONY: up
up: ## Avvia i container in background
docker compose --env-file $(ENV_FILE) up -d
.PHONY: down
down: ## Ferma e rimuove i container
docker compose --env-file $(ENV_FILE) down
.PHONY: restart
restart: ## Riavvia i container
docker compose --env-file $(ENV_FILE) restart
.PHONY: logs
logs: ## Segue i log di nexterm in tempo reale
docker compose --env-file $(ENV_FILE) logs -f nexterm
.PHONY: ps
ps: ## Mostra lo stato dei container
docker compose --env-file $(ENV_FILE) ps
.PHONY: pull
pull: ## Scarica le immagini aggiornate senza riavviare
docker compose --env-file $(ENV_FILE) pull
.PHONY: update
update: pull ## Aggiorna le immagini e ricrea i container
docker compose --env-file $(ENV_FILE) up -d --remove-orphans

View File

@@ -18,17 +18,25 @@ Modifica il file `.env` in base alle tue esigenze.
Variabili principali:
- `NEXTERM_IMAGE`: immagine Docker da usare
- `NEXTERM_CONTAINER_NAME`: nome del container
- `NEXTERM_RESTART_POLICY`: policy di riavvio
- `NEXTERM_PORT_HOST`: porta esposta sull'host
- `NEXTERM_PORT_CONTAINER`: porta interna del container
- `NEXTERM_DATA_DIR`: directory dati persistenti
- `NEXTERM_TZ`: timezone del container
- `NEXTERM_ENCRYPTION_KEY`: chiave di cifratura obbligatoria per Nexterm
- `IMAGE`: immagine Docker da usare
- `CONTAINER_NAME`: nome del container nexterm
- `RESTART_POLICY`: policy di riavvio (condivisa da tutti i servizi)
- `PORT`: porta esposta sull'host
- `DATA_DIR`: directory dati persistenti
- `TZ`: timezone condivisa da tutti i servizi
- `ENCRYPTION_KEY`: chiave di cifratura obbligatoria per Nexterm
> `NEXTERM_ENCRYPTION_KEY` deve essere una stringa esadecimale di **64 caratteri**.
> Esempio rapido (PowerShell):
> `ENCRYPTION_KEY` deve essere una stringa esadecimale di **64 caratteri**.
Variabili Watchtower:
- `WATCHTOWER_IMAGE`: immagine Docker da usare (default: `containrrr/watchtower:latest`)
- `WATCHTOWER_CONTAINER_NAME`: nome del container Watchtower
- `WATCHTOWER_CLEANUP`: rimuove le vecchie immagini dopo l'aggiornamento (`true`/`false`)
- `WATCHTOWER_SCHEDULE`: schedule cron a 6 campi per il controllo aggiornamenti (default: ogni giorno alle 03:00)
- `WATCHTOWER_NOTIFICATIONS_LEVEL`: livello di log (`warn` consigliato)
Esempio rapido (PowerShell):
```powershell
$bytes = New-Object byte[] 32
@@ -36,7 +44,31 @@ $bytes = New-Object byte[] 32
($bytes | ForEach-Object { $_.ToString('x2') }) -join ''
```
## Avvio
Esempio rapido (Linux/macOS):
```bash
openssl rand -hex 32
```
## Avvio rapido con Make
```bash
make genkey # genera e scrive ENCRYPTION_KEY nel .env
make check # verifica prerequisiti e configurazione
make up # avvia i container
```
Altri comandi disponibili:
```bash
make logs # segue i log di nexterm
make ps # stato dei container
make update # aggiorna le immagini e ricrea i container
make down # ferma e rimuove i container
make help # lista completa dei comandi
```
## Avvio manuale
```bash
docker compose up -d
@@ -51,7 +83,7 @@ docker compose logs -f nexterm
Apri poi il browser su:
- `http://localhost:${NEXTERM_PORT_HOST}`
- `http://localhost:${PORT}`
## Stop e rimozione

View File

@@ -1,12 +1,27 @@
services:
nexterm:
image: ${NEXTERM_IMAGE}
container_name: ${NEXTERM_CONTAINER_NAME}
restart: ${NEXTERM_RESTART_POLICY}
image: ${IMAGE}
container_name: ${CONTAINER_NAME}
restart: ${RESTART_POLICY}
ports:
- "${NEXTERM_PORT_HOST}:6989"
- "${PORT}:6989"
volumes:
- ${NEXTERM_DATA_DIR}:/app/data
- ${DATA_DIR}:/app/data
environment:
- TZ=${NEXTERM_TZ}
- ENCRYPTION_KEY=${NEXTERM_ENCRYPTION_KEY}
- TZ=${TZ}
- ENCRYPTION_KEY=${ENCRYPTION_KEY}
labels:
- "com.centurylinklabs.watchtower.enable=true"
watchtower:
image: ${WATCHTOWER_IMAGE}
container_name: ${CONTAINER_NAME}_${WATCHTOWER_CONTAINER_NAME}
restart: ${RESTART_POLICY}
volumes:
- /var/run/docker.sock:/var/run/docker.sock
environment:
- TZ=${TZ}
- WATCHTOWER_CLEANUP=${WATCHTOWER_CLEANUP}
- WATCHTOWER_SCHEDULE=${WATCHTOWER_SCHEDULE}
- WATCHTOWER_LABEL_ENABLE=true
- WATCHTOWER_NOTIFICATIONS_LEVEL=${WATCHTOWER_NOTIFICATIONS_LEVEL}