2021-05-25 11:36:01 +02:00
|
|
|
|
# Unifi Controller
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-21 12:55:29 +02:00
|
|
|
|
<div align="center">
|
2021-09-18 12:03:21 +02:00
|
|
|
|
<img src="https://i.ibb.co/W3CMvL4/unifi.png" />
|
2021-05-21 12:55:29 +02:00
|
|
|
|
</div>
|
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Descrizione
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-11-25 10:54:46 +01:00
|
|
|
|
[![Sito ufficiale](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=firefoxbrowser&style=flat&label=&message=Homepage)](https://www.ui.com/software/) [![Sorgente](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=github&style=flat&label=&message=Sorgente)](https://github.com/linuxserver/docker-unifi-controller) [![Docker Hub](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=docker&style=flat&label=&message=Docker Hub)](https://hub.docker.com/r/linuxserver/unifi-controller) [![Docs](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=readthedocs&style=flat&label=&message=Docs)](https://docs.linuxserver.io/images/docker-unifi-controller) [![Demo](https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=jekyll&style=flat&label=&message=Demo)](https://demo.ui.com/manage/site/default/dashboard) ![RPI Friendly](<https://img.shields.io/static/v1.svg?color=555555&logoColor=ffffff&logo=raspberrypi&style=flat&label=&message=RPi Friendly>)
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-06-06 11:32:56 +02:00
|
|
|
|
Unfi Controller è un controller per la gestione dell'hardware Ubiquiti:
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-06-06 11:32:56 +02:00
|
|
|
|
- Gestione di tutto solo tramite interfaccia web
|
|
|
|
|
- Aggiornare, configurare e personalizzare tutto l'hardware compatibile
|
|
|
|
|
- Backup della configurazione, sia del controller che dell'hardware
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Struttura file e cartelle
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-21 12:55:29 +02:00
|
|
|
|
```
|
|
|
|
|
/home/
|
2021-05-22 14:55:19 +02:00
|
|
|
|
└── docker/
|
2021-11-12 11:50:29 +01:00
|
|
|
|
└── unifi-controller/
|
2021-05-22 14:55:19 +02:00
|
|
|
|
├── config/
|
|
|
|
|
├── .env
|
|
|
|
|
└── docker-compose.yml
|
2021-05-21 12:55:29 +02:00
|
|
|
|
```
|
|
|
|
|
|
2021-11-12 15:57:16 +01:00
|
|
|
|
- `config/` - cartella dove risiedono i dati che servono a unifi
|
|
|
|
|
- `.env` - file contenenti le variabili environment per il docker-compose
|
|
|
|
|
- `docker-compose.yml` - file usato per creare il container
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-11-22 10:23:03 +01:00
|
|
|
|
**N.B. Tutti i file e le cartelle devono essere creati a mano**
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Esempi
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
Semplice esempio per iniziare ad usare subito il container
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-06-18 10:11:53 +02:00
|
|
|
|
### network
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-10-28 15:35:15 +02:00
|
|
|
|
`docker`
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-06-18 10:11:53 +02:00
|
|
|
|
```bash
|
|
|
|
|
docker network create custom-bridge
|
|
|
|
|
```
|
2021-10-28 15:35:15 +02:00
|
|
|
|
|
|
|
|
|
`podman`
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-06-18 10:11:53 +02:00
|
|
|
|
```bash
|
|
|
|
|
podman network create custom-bridge
|
|
|
|
|
```
|
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
### docker-compose
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-21 12:55:29 +02:00
|
|
|
|
`docker-compose.yml`
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-21 12:55:29 +02:00
|
|
|
|
```yml
|
2021-06-03 09:54:35 +02:00
|
|
|
|
version: "3.5"
|
2021-05-21 12:55:29 +02:00
|
|
|
|
services:
|
|
|
|
|
unifi:
|
2021-11-12 11:50:29 +01:00
|
|
|
|
container_name: linuxserver-unifi-controller
|
2021-11-03 17:11:37 +01:00
|
|
|
|
image: lscr.io/linuxserver/unifi-controller
|
2021-06-10 09:56:26 +02:00
|
|
|
|
security_opt:
|
|
|
|
|
- no-new-privileges:true
|
2021-06-14 09:09:17 +02:00
|
|
|
|
networks:
|
2021-06-03 09:54:35 +02:00
|
|
|
|
- custom-bridge
|
2021-05-21 12:55:29 +02:00
|
|
|
|
restart: unless-stopped
|
|
|
|
|
ports:
|
2021-06-14 09:09:17 +02:00
|
|
|
|
- ${UNIFI_STUN_PORT:-3478}:3478/udp
|
2021-05-21 12:55:29 +02:00
|
|
|
|
- ${UNIFI_WEBUI_PORT:-8080}:8080
|
|
|
|
|
- ${UNIFI_HTTPS_PORT:-8443}:8443
|
2021-06-14 09:09:17 +02:00
|
|
|
|
- ${UNIFI_AP_DSV_PORT:-10001}:10001/udp
|
2021-05-21 12:55:29 +02:00
|
|
|
|
env_file: .env
|
|
|
|
|
volumes:
|
2021-11-12 11:50:29 +01:00
|
|
|
|
- ${UNIFI_CONFIG:-/home/docker/unifi-controller/config}:/config
|
2021-06-03 09:54:35 +02:00
|
|
|
|
|
|
|
|
|
networks:
|
|
|
|
|
custom-bridge:
|
|
|
|
|
name: custom-bridge
|
|
|
|
|
driver: bridge
|
2021-05-21 12:55:29 +02:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
`.env`
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-21 12:55:29 +02:00
|
|
|
|
```bash
|
|
|
|
|
# Generale
|
2021-06-14 09:09:17 +02:00
|
|
|
|
UNIFI_STUN_PORT=3478
|
2021-05-21 12:55:29 +02:00
|
|
|
|
UNIFI_WEBUI_PORT=8080
|
|
|
|
|
UNIFI_HTTPS_PORT=8443
|
|
|
|
|
UNIFI_AP_DSV_PORT=10001
|
|
|
|
|
UNIFI_CONFIG=/config
|
|
|
|
|
|
|
|
|
|
# Unifi
|
2021-05-25 11:36:01 +02:00
|
|
|
|
MEM_LIMIT=1024M # opzionale, di base è un 1 GB di ram massima allocata
|
2021-05-21 12:55:29 +02:00
|
|
|
|
```
|
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Reverse proxy
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-10-28 15:35:15 +02:00
|
|
|
|
Vedi [Todo](#Todo)
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Aggiornamento
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
### Automatico
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
Se usate [watchtower](../watchtower) il container si aggiorna automaticamente
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
### Manuale
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
1. `docker-compose pull`
|
|
|
|
|
2. `docker-compose up -d`
|
|
|
|
|
3. `docker image prune`
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Backup e ripristino
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
### Backup
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-11-02 11:20:09 +01:00
|
|
|
|
Usado [borg](../borg) per fare i backup giornalieri dell'intera cartella `unifi`
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
### Ripristino
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-11-02 11:20:09 +01:00
|
|
|
|
Per una maggiore spiegazione sui passaggi da fare, controllate [qua](../borg#user-content-controllare-la-cartella-dei-backup)
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
1. fermare il container `docker-compose down`
|
2021-11-12 11:50:29 +01:00
|
|
|
|
2. cancellare l'intera cartella `unifi-controller`
|
|
|
|
|
3. dal backup copiare la cartella `unifi-controller`
|
2021-05-25 11:36:01 +02:00
|
|
|
|
4. far ripartire il container `docker-compose up -d`
|
2021-05-21 12:55:29 +02:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
## Todo
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-21 12:55:29 +02:00
|
|
|
|
Implementare:
|
2021-11-12 15:57:16 +01:00
|
|
|
|
|
2021-05-25 11:36:01 +02:00
|
|
|
|
- reverse proxy: **[caddy](https://caddyserver.com/)** o **[traefik](https://doc.traefik.io/traefik/)**
|
2021-10-27 15:08:41 +02:00
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
2021-11-12 15:57:16 +01:00
|
|
|
|
Licenza: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode.txt)
|