Com instal·lar EtherCalc a Debian 10 – Clouding.io

Avís

Aquest article és antic i és possible que part de la informació estigui desactualitzada o ja no sigui vàlida actualment.

Si tens qualsevol dubte o necessites confirmar algun detall, et recomanem contactar amb el nostre equip de suport per rebre informació actualitzada i assistència personalitzada.

EtherCalc és un full de càlcul basat en el web que et permet crear fulls de càlcul a través d'un navegador web. Permet editar els fulls de càlcul i que diversos usuaris treballin en el mateix fitxer. És molt similar a Google Sheets i inclou moltes fórmules i funcions matemàtiques.

Aquestes són les seves característiques principals:

És gratuït i de codi obert.
Exporta els teus fitxers al format CSV o XLSX.
Utilitza URL generats de manera aleatòria.
És compatible amb els sistemes operatius Linux, FreeBSD, Mac OS X i Windows.

En aquest tutorial et mostrem com instal·lar EtherCalc amb Nginx com a servidor intermediari invers a Debian 10.

Requisits

Debian 10 instal·lat al teu servidor.
Un nom de domini vàlid que apunti a la IP del teu servidor.
Una contrasenya root establerta al servidor.

Instal·la les dependències requerides

Abans d'instal·lar EtherCalc, necessitaràs instal·lar algunes dependències al teu servidor. Pots fer-ho amb l'ordre següent:

# apt-get install nginx redis curl gnupg2 git wget -y

Un cop tots els paquets estiguin instal·lats, inicia el servei de Redis i Nginx amb l'ordre següent:

# systemctl start redis-server
# systemctl start nginx

Instal·la Node.js

A continuació, necessitaràs instal·lar Node.js i NPM al teu sistema. Per defecte, l'última versió de Node.js no està inclosa al repositori de Debian 10. Per això, necessitaràs instal·lar el repositori d'origen de Node al teu sistema. Fes-ho amb l'ordre següent:

# curl -sL https://deb.nodesource.com/setup_14.x | bash -

Un cop el repositori estigui afegit, instal·la Node.js amb l'ordre següent:

# apt-get install nodejs -y

Després d'instal·lar Node.js, verifica la versió de Node.js i NPM amb l'ordre següent:

# node --version

Aquest és el resultat que hauries d'obtenir:

v14.17.0

Pel que fa a la versió NPM, el resultat hauria de ser el següent:

# npm -v
6.14.13

Instal·la EtherCalc

A continuació, pots instal·lar EtherCalc utilitzant l'ordre NPM com es mostra més avall:

# npm install -g ethercalc

Un cop estigui instal·lat, executa EtherCalc amb l'ordre següent:

# ethercalc

Hauries de veure el resultat següent:

Please connect to: http://debian10:8000/
Starting backend using webworker-threads
Falling back to vm.CreateContext backend
Express server listening on port 8000 in development mode

Per continuar, prem "CTRL+C" per aturar EtherCalc.

Crea un fitxer de servei Systemd per a EtherCalc

En primer lloc, crea un usuari per executar EtherCalc amb l'ordre següent:

# adduser ethercalc

Per continuar, afegeix l'usuari www-data al grup ethercalc amb l'ordre següent:

# usermod -a -G ethercalc www-data

A continuació, crea el fitxer de servei systemd per gestionar el servei d'EtherCalc:

# nano /etc/systemd/system/ethercalc.service

Després, afegeix les línies següents:

[Unit]
Description=Run Ethercalc, the collaborative spreadsheet editor.
After=syslog.target network.target

[Service]
Type=simple
User=ethercalc
ExecStart=/usr/bin/ethercalc --port 8080 --cors --expire 31104000
#RuntimeMaxSec=86400
#Restart=always

[Install]
WantedBy=multi-user.target

Desa i tanca el fitxer i després recarrega el dimoni systemd per aplicar els canvis amb l'ordre següent:

# systemctl daemon-reload

A continuació, inicia i habilita el servei EtherCalc utilitzant l'ordre que es mostra més avall:

# systemctl start ethercalc
# systemctl enable ethercalc

Per al pas següent, verifica l'estat del servei d'EtherCalc amb l'ordre següent:

# systemctl status ethercalc

Més avall hi ha el resultat que hauries d'obtenir:


● ethercalc.service - Run Ethercalc, the collaborative spreadsheet editor.
   Loaded: loaded (/etc/systemd/system/ethercalc.service; disabled; vendor preset: enabled)
   Active: active (running) since Thu 2021-06-03 15:55:58 UTC; 6s ago
 Main PID: 3647 (node)
    Tasks: 11 (limit: 2359)
   Memory: 57.6M
   CGroup: /system.slice/ethercalc.service
           └─3647 node /usr/bin/ethercalc --port 8080 --cors --expire 31104000

Jun 03 15:55:58 debian10 systemd[1]: Started Run Ethercalc, the collaborative spreadsheet editor..
Jun 03 15:55:58 debian10 ethercalc[3647]: Please connect to: http://debian10:8080/
Jun 03 15:55:59 debian10 ethercalc[3647]: Starting backend using webworker-threads
Jun 03 15:55:59 debian10 ethercalc[3647]: Falling back to vm.CreateContext backend
Jun 03 15:55:59 debian10 ethercalc[3647]: Cross-Origin Resource Sharing (CORS) enabled.
Jun 03 15:55:59 debian10 ethercalc[3647]: Express server listening on port 8080 in development mode
Jun 03 15:55:59 debian10 ethercalc[3647]: Zappa 0.5.0 "You can't do that on stage anymore" orchestrating the show
Jun 03 15:55:59 debian10 ethercalc[3647]: Connected to Redis Server: localhost:6379

En aquest punt, EtherCalc s'ha iniciat i està escoltant al port 8080. Pots verificar-ho amb l'ordre següent:

# ss -antpl | grep 8080

Aquest és el resultat que hauries d'obtenir:


LISTEN    0         128                0.0.0.0:8080             0.0.0.0:*        users:(("node",pid=3647,fd=18))

Configura Nginx com a servidor intermediari invers per a EtherCalc

A continuació, crea un fitxer de configuració d'amfitrió virtual de Nginx per servir EtherCalc al port 80:

# nano /etc/nginx/conf.d/ethercalc.conf

I després afegeix les línies següents:

upstream ethercalc {
  server 127.0.0.1:8080;
}

server {
    listen 80;
    server_name ether.example.com;

    location / {
        proxy_pass http://ethercalc/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $http_host;

        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forward-Proto http;
        proxy_set_header X-Nginx-Proxy true;

        proxy_redirect off;
    }
}

Desa el fitxer i després reinicia el servei Nginx per aplicar els canvis amb l'ordre següent:

# systemctl restart nginx

Accedeix a EtherCalc

Ara, accedeix a EtherCalc amb l'URL http://ether.example.com. Hauries de veure EtherCalc com a la imatge següent:

A continuació fes clic a la pestanya "Create Spreadsheet". Hauries de veure la imatge següent:

Ara ja pots crear fàcilment un full de càlcul nou o editar l'existent des del navegador web.

Conclusió

Amb aquest tutorial has après com instal·lar EtherCalc a Debian 10. També t'hem mostrat com configurar Nginx com a servidor intermediari invers per accedir a EtherCalc a través del port 80. Esperem que et sigui útil!

Si tens alguna pregunta, no dubtis a enviar un correu electrònic a soporte@clouding.io. Estarem encantats de respondre't.

Articles en aquesta secció