Lähdekoodi sivulle Unifi Controller

Unifi Controller on Uniquiti Unifi -sarjalle tarkoitettu hallintaohjelmisto. Ohjelmiston avulla on helppo hallinnoida keskitetystä Ubiquitin Unifi-sarjan tuotteista.

== Asennus ==

Mikäli käytössäsi on Ubuntu 18.04 LTS, varmista että asennat Mongodb-version 3.4:sen. 3.6:sella ei toimi kunnolla.

<pre>
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 0C49F3730359A14518585931BC711F9BA15703C6
echo "deb http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
sudo apt update
</pre>

Asenna pakettihallinnasta

 echo 'deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
 sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50 
 sudo apt-get update 
 sudo apt-get install unifi

Kirjaudu hallintaan https://ip-osoite:8443

== Konfigurointi ==

=== Let's Encrypt ===

Pikaohje Let's Encrypt sertifikaatin asennukseen Unifi Controlleriin 

Asenna letsencrypt

 sudo apt install letsencrypt

Kloonaa Githubista

<pre>
git clone https://github.com/stevejenkins/unifi-linux-utils.git
cd unifi-linux-utils
</pre>

Avaa unifi_ssl_import.sh tiedosto

 nano unifi_ssl_import.sh 

Muokkaa tiedostosta:

* UNIFI_HOSTNAME vastaamaan omaa isäntänimeä
* Mikäli käytössä on Ubuntu/Debian, kommentoi ja poista kommentit riveiltä UNIFI_DIR, JAVA_DIR, KEYSTORE
* Ota käyttöön LE_mode vaihtamalla "no" -> "yes"

Sulje tiedosto

 chmod +x unifi_ssl_import.sh 

Asenna Let's Encrypt sertifikaatti palvelimelle. Suosittelen esimerkiksi asentamaan Nginx, jotta saat asennettua sertifikaatin [[Letsencrypt#Webroot_menetelm.C3.A4|webroot-mentelmällä]] ja kun sertifikaatti on asennettu omalla isäntänimellä, aja unifi_ssl_import.sh työkalu.

Uusi automaattisesti cronilla

 0 3 1   */2 *   root    /usr/lib/letsencrypt renew --quiet && sh /root/unifi-linux-utils/upgrade_unifi_controller.sh

=== Nginx reverse proxy ===

Esimerkki konfiguraatio

<pre>
server {
        listen 80 default_server;

        include /etc/nginx/snippets/letsencryptauth.conf;

        ssl_dhparam /etc/ssl/certs/dhparam.pem;

        root /var/www/html;

        server_name xxxxx.xxxxx.xxxxx;

        location /inform {
                proxy_pass http://localhost:8080/inform;
                include /etc/nginx/proxy_params;
        }
 
        location / {
                return 301 https://localhost$request_uri;
        }
}

server {
        listen 443 ssl http2;
        server_name xxxxx.xxxxx.xxxxx;

        ssl on;

        ssl_certificate /etc/letsencrypt/live/xxxxx.xxxxx.xxxxx/fullchain.pem;
        ssl_certificate_key /etc/letsencrypt/live/xxxxx.xxxxx.xxxxx/privkey.pem;
        ssl_trusted_certificate /etc/nginx/ssl/default/unifi.pem;
        ssl_dhparam /etc/ssl/certs/dhparam.pem;

        ssl_ciphers ECDH+AESGCM:ECDH+AES256:ECDH+AES128:DH+3DES:!ADH:!AECDH:!MD5;
        ssl_prefer_server_ciphers on;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 5m;
        add_header Strict-Transport-Security "max-age=31536000" always;

        server_tokens off;

        proxy_ssl_verify off;
        proxy_ssl_session_reuse on;
        proxy_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        proxy_cache off;
        proxy_store off;


        location /wss {
            proxy_pass https://localhost:8443/wss;
            proxy_redirect off;
            proxy_buffering off;
            proxy_set_header Host $http_host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "Upgrade";
            proxy_ssl_verify off;
        }

        location / {
            proxy_pass https://127.0.0.1:8443;
            proxy_set_header Host             $host;
            proxy_set_header        X-Forwarded-Proto   $scheme;
            proxy_intercept_errors  on;
            proxy_http_version      1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "Upgrade";
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
}
</pre>

== Sivustokohtaiset konfiguraatiot ==

Sivustokohtaiset konfiguraatiot (Site) tehdään config.properties tiedostoon. Tämä tulee jokaiselle sivustolle erikseen. Osa Unifi:n konfiguroinneista ei löydy graafisesta näkymästä vaan tulee tehdä konfigurointitiedostoon. Lisätietoa tästä: https://help.ubnt.com/hc/en-us/articles/205146040-UniFi-config-properties-File-Explanation

Sivustot löytyvät Debian/Ubuntu-palvelimella /var/lib/unifi/sites/ hakemistosta. 

Voit tarkistaa konfiguraatiot aina Unifi-laitteella avaamalla sinne konsoliyhteyden ja tarkistamaan /tmp/running.cfg tiedoston sisällön.

=== Ota käyttöön Beamforming ===

Beamforming on tekniikka joka auttaa automaattisesti antennien suuntauksessa kun on asiakaslaite heikkommassa signaalissa tarjoten näin paremman yhteyden. Oletuksena toiminto on pois käytöstä.

Saat lisättyä tämän toiminnon käyttöön seuraavanlaisella komennolla. Korvaa {site_name] sivuston nimellä. default on oletussivu.

 echo 'config.system_cfg.1=radio.1.txbf=3' >> /var/lib/unifi/sites/[site_name]/config.properties

Tämän jälkeen sinun tulee uudelleen provisioida asetukset asiakaslaitteille.