Google Contacts alternative

Alternativa Google Contacts

=====================

Aceasta solutie prezinta o alternativa la google contacts. Pe propriul server instalati o aplicatie la care se conecteaza telefonul si va hosteaza numerele de telefon din agenda.

Configurarea serverului

In locatia unde instalezi aplicatia(cu docker) trebuie sa ai ip public si un DNS. Ex: example.com
Trebuie sa creati in zona DNS o inregistrare catre IP public cum aveti, sa zicem 11.22.33.44:

A contacts.example.com 11.22.33.44 #DNS pt management web

Aplicatia se numeste Baikal si se pune intr-un folder, de ex /root/contacts:
Se creeaza reteaua docker mai intai pt varianta in care aceasta aplicatie va folosi mysql:

docker network create --driver=bridge --subnet=172.19.10.0/24 marianet

Pe acelasi server asa cum am mai explicat si aici se creeaza fisierul care va porni containerul:

$nano start.sh

#!/bin/bash

CONTAINER_NAME="baikal"
IMAGE="ckulka/baikal"
HOST_PORT=5232
DATA_DIR="$PWD"

#mkdir -p "$DATA_DIR"

# Check
if [ "$(docker ps -q -f name=$CONTAINER_NAME)" ]; then
    echo "Containerul $CONTAINER_NAME ruleaza deja. il opresc..."
    docker stop $CONTAINER_NAME
    docker rm $CONTAINER_NAME
fi

# Run
docker run -d --name $CONTAINER_NAME \
  --network=marianet --link mysql57 \
  -e BAIKAL_DATABASE_TYPE=mysql \
  -e BAIKAL_DATABASE_HOST=172.19.10.10 \
  -e BAIKAL_DATABASE_PORT=3306 \
  -e BAIKAL_DATABASE_NAME=baikal \
  -e BAIKAL_DATABASE_USER=baikal_user \
  -e BAIKAL_DATABASE_PASSWORD=parola_baikal \
  -v /root/contacts/config:/var/www/baikal/config \
  -v /root/contacts/Specific:/var/www/baikal/Specific \
  -p $HOST_PORT:80 \
  --restart unless-stopped \
  $IMAGE

echo "baikal ruleaza pe portul $HOST_PORT"

Deci acesta este start.sh care va porni containerul baikal care depinde de mysql. Vedeti la linkul de mai sus cu bitwarden cum se configureaza containerul mysql si cum se porneste!.
Se poate folosi fara mysql insa e mai safe asa intrucat se poate face un mysqldump, probabilitatea sa pierdeti tot devine nula
Daca se strica ceva pur si simplu importati in mysql un backup.sql si totul revine la normal.

Userul si parola mysql sunt deja setate. Pt acces in consola mysql:

$ docker exec -it mysql57 mysql -u root -p
mysql> CREATE DATABASE baikal CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
mysql> CREATE USER 'baikal_user'@'%' IDENTIFIED BY 'parola_baikal';
mysql> GRANT ALL PRIVILEGES ON baikal.* TO 'baikal_user'@'%';
mysql> FLUSH PRIVILEGES;
mysql> show databases;
+--------------------+
| Database |
+--------------------+
| information_schema |
| mysql |
| performance_schema |
| sys |
| vaultwarden |
| baikal |
+--------------------+
mysql> exit;

Acum ca baza de date si drepturile aferente sunt deja rezolvate, revenim la containerul baikal:

pwd - /root/contacts #(aici facem cele 2 subfoldere:)
mkdir config
mkdir Specific

Dupa ce am facut folderele astea putem porni containerul cu ./start.sh. Evident trebuie sa fie si executabil deci in prealabil trebuie si chmod +x start.sh
Dupa ce se porneste containerul se verifica cu docker logs baikal ca sa ne asiguram ca este functional.

Pt acces securizat avem nevoie si de un reverse proxy nginx unde trebuie sa avem certificat LetsEncrypt.
Am explicat de mai multe ori cum se poate seta un nginx, aici voi atasa doar continutul vhost-ului:

    server {
        listen 443 ssl;
        server_name contacts.example.com;
    
            ssl_certificate /etc/ssl/fullchain.pem;
            ssl_certificate_key /etc/ssl/privkey.pem;
        
        root /var/www/baikal/html;
        index index.php index.html;
    
        location /admin/ {
            proxy_pass http://localhost:5232;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto https;
            
            # Chromium cache
            add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate";
            add_header Pragma "no-cache";
            add_header Expires 0;
        }
    
        location / {
            proxy_pass http://localhost:5232;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto https;
        }
    
        location /card.php {
            proxy_pass http://localhost:5232;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }

Deci se (re)porneste nginx cu acest vhost in plus si se verifica daca functioneaza corect.
Daca nu s-a pornit intre timp baikal, se porneste si la fel, trebuie sa ne asiguram ca toate sunt pornite si merg: nginx, baikal, mysql.
Daca totul functioneaza corect se deschide in browser interfata web pentru configurare initiala: https://contacts.example.com/admin/
Acolo vei vedea pagina de setup initiala unde baikal te va pune sa:
- Configurezi un user si o parola pentru administrator
- Alegi tipul de baza de date (care deja va fi MySQL, fiind definit in docker run si completezi exact ip host samd ca in docker run)
Dupa setup-ul initial, te loghezi in admin si adaugi un utilizator nou, care va fi folosit pentru sincronizarea contactelor(de ex gigel).

In momentul asta este totul configurat pe partea de server insa va trebui sa importam contactele (one time only operation):
Accesam in browser google contacts si exportam toate contactele ca fisier .vcf.
Instaleaza Thunderbird pe PC si deschide-l.
Creezi un adressbook nou (myserver) cu user si pass gigel/parola cu URL: https://contacts.example.com/card.php/addressbooks/gigel/default/
import de jos importa Selecteaza fisierul .vcf. si in lista alegi myserver si apoi butonul de submit, ce o scrie pe el...si dupa import url-ul se schimba, in loc de default va avea un UUID:
se poate verifica in browser dupa import si va arata ceva de genul:
https://contacts.example.com/card.php/addressbooks/gigel/40d0a148-cca2-5a1e-8c21-d43c2e91b8e3/
Aici veti observa ca fiecare contact a fost importat ca .vcf separat, asa functioneaza. Puteti verifica cateva prin sondaj sa fiti sigur ca importul s-a efectuat cu succes.
In momentul asta thunderbird se poate dezinstala. Exista metode direct pe server sa faceti importul dar e putina bataie de cap, e mai simplu cu thunderbird.

Configurarea clientilor (telefoanele mobile)

Se instaleaza pe telefon https://github.com/bitfireAT/davx5-ose/releases/download/v4.4.8-ose/davx5-ose-4.4.8-ose-release.apk
Adaugi un cont CardDAV in davx5 cu:
URL: https://contacts.example.com/card.php/principals/gigel/
User: gigel
Parola: parola
next prima optiune->next a doua optiune (contacte separate) si gata, ai adaugat contul pe care il verifici si observi ca url-ul este:
https://contacts.example.com/card.php/addressbooks/gigel/40d0a148-cca2-5a1e-8c21-d43c2e91b8e3.
Se da sync manual si apoi se verifica ora la care s-a facut syncul dupa care deschizi google contacts si vezi cum iti aduce contactele....
Cel mai bine e ca in momentul in care ajungi aici, contactele din google sa fie deja sterse.

In setarile aplicatiei se poate vedea ca face sync la 4 ore sau cand ai editat un contact. se poate cobora intervalul.
Exita o setare cand porneste aplicatia (Regular sync intervals) care ii da allow for run in the background dar nu am activat-o pe principiul ca poate consuma prea mult. O sa testez.
Pe orice telefon e bine sa ai aplicatia google contacts care vede automat davx5 si dai sa afiseze doar contactele respective. Am testat, merge si cu Samsung Contacts.

Cam asta e tot, acum aplicatia de contacte de pe telefon foloseste davx5 si nu mai ai nicio legatura cu Google Contacts!
Eu am 2 telefoane in care sunt conectat cu 2 conturi google diferite si cum editez pe un telefon un contact, apare si pe al doilea cu mentiunea ca trebuie sa fi facut sync.
Am scris mai sus, poti sa il lasi sa faca permanent dar nu merita, posibil sa manance baterie inutil.
O mica mentiune, se poate pune si poza la contact, pozele sunt stocate in mysql cu base64!

Enjoy!

Last update 28 Mar 2025.