Instal·lació de Mastodon a CentOS 7

Mastodon és un servidor de xarxes socials i de microblogging autoallotjat de codi obert. Proporciona funcions semblants a Twitter; però en lloc de ser controlat per una única empresa, és una federació de servidors descentralitzats que es connecten entre si per fer tot un sistema de xarxes socials. Un petit equip pot iniciar la seva instància del servidor Mastodon per comunicar-se entre ells, així com amb els altres usuaris de la comunitat federada. També us permet triar les vostres pròpies polítiques de privadesa i moderació i definir com us comuniqueu amb altres usuaris de diferents servidors. El contingut que un usuari individual crea i al qual es subscriu està allotjat al servidor on es crea el seu compte. Els usuaris poden seguir-se els uns als altres encara que no estiguin allotjats al mateix servidor. Cada usuari de la xarxa Mastodon té el seu nom o identificació únic que es troba a la xarxa@[email protected]format. Les aplicacions de client per a Mastodon estan disponibles per a gairebé totes les plataformes.

Requisits previs

• Una instància del servidor Vultr CentOS 7.
• Un usuari de sudo .

Nota: utilitzarem social.example.comcom a nom de domini utilitzat per a la instància Mastodon. Substituïu totes les ocurrències de social.example.compel vostre nom de domini real que voleu utilitzar per a la vostra aplicació Mastodon .

Actualitzeu el vostre sistema base mitjançant la guia Com actualitzar CentOS 7 , si cal. Un cop actualitzat el vostre sistema, procediu a instal·lar les dependències necessàries.

Instal·lació de dependències

Mastodon requereix diverses dependències per funcionar. Instal·leu la darrera versió de Node.js, que s'utilitzarà per compilar els fitxers JavaScript.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum -y install nodejs

Install Yarn, que és una aplicació de gestió de dependències ràpida, fiable i segura. Utilitzarem Yarn per instal·lar les dependències de Node.js.

sudo wget https://dl.yarnpkg.com/rpm/yarn.repo -O /etc/yum.repos.d/yarn.repo
sudo yum -y install yarn

Instal·lar Redis. Redis és una aplicació de memòria cau i magatzem d'estructura de dades a la memòria.

sudo yum -y install redis

Inicieu Redis i activeu-lo perquè s'iniciï automàticament a l'arrencada.

sudo systemctl start redis
sudo systemctl enable redis

Instal·leu algunes dependències més que són necessàries per crear la Rubyinstal·lació i altres dependències.

sudo yum -y install ImageMagick git libxml2-devel libxslt-devel gcc bzip2 openssl-devel zlib-devel gdbm-devel ncurses-devel autoconf automake bison gcc-c++ libffi-devel libtool patch readline-devel sqlite-devel glibc-headers glibc-devel libyaml-devel libicu-devel libidn-devel

També caldrà instal·lar les eines de desenvolupament.

sudo yum -y groupinstall 'Development Tools'

Instal·lació i configuració de PostgreSQL

PostgreSQL és un sistema de bases de dades relacionals d'objectes. Haureu d'afegir el dipòsit PostgreSQL al vostre sistema, ja que el yumdipòsit predeterminat conté una versió anterior de l'aplicació.

sudo rpm -Uvh https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-centos96-9.6-3.noarch.rpm

Instal·leu el servidor de bases de dades PostgreSQL.

sudo yum -y install postgresql96-server postgresql96-contrib postgresql96-devel

Inicialitzar la base de dades.

sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb

Editeu el pg_hba.conffitxer per habilitar l' MD5autenticació basada.

sudo nano /var/lib/pgsql/9.6/data/pg_hba.conf

Busca les línies següents i canvia peera trusti identa md5.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident

Un cop actualitzada, la configuració hauria de ser així.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

Inicieu el servidor PostgreSQL i activeu-lo perquè s'iniciï automàticament a l'arrencada.

sudo systemctl start postgresql-9.6
sudo systemctl enable postgresql-9.6

Canvieu la contrasenya de l'usuari PostgreSQL predeterminat.

sudo passwd postgres

Inicieu sessió al shell com a PostgreSQLusuari.

sudo su - postgres

Crea un PostgreSQLusuari nou per a Mastodon.

createuser mastodon

PostgreSQL proporciona l' psqlintèrpret d'ordres per executar consultes a la base de dades. Canvieu a l'intèrpret d'ordres PostgreSQL executant.

psql

Establiu una contrasenya per a l'usuari acabat de crear per a la base de dades Mastodon i proporcioneu el permís per afegir bases de dades noves.

ALTER USER mastodon WITH ENCRYPTED password 'DBPassword' CREATEDB;

Substituïu-la DBPasswordper una contrasenya segura. Sortida de la psqlclosca:

\q

Canvia a l' sudousuari.

exit

Instal·leu algunes dependències més necessàries de PostgreSQL.

sudo yum -y install libpqxx-devel protobuf-devel

Instal·leu Ruby

Creeu un usuari nou per a Mastodon i canvieu a l'usuari acabat de crear.

sudo adduser mastodon -d /opt/mastodon
sudo su - mastodon

Instal·larem la darrera versió de Ruby mitjançant Ruby Version Manager o RVM. S'utilitza per instal·lar i gestionar diverses versions de Ruby.

Afegiu la GPGclau de RVM al vostre servidor.

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Instal·leu RVM.

curl -sSL https://get.rvm.io | bash -s stable
source /opt/mastodon/.rvm/scripts/rvm

Ara obteniu la llista de les versions disponibles de Ruby.

rvm list known

Veureu la següent sortida.

[mastodon@vultr ~]$ rvm list known
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head

...

Ara instal·leu la darrera versió de Ruby de la llista.

rvm install 2.4

Utilitzeu la versió instal·lada de Ruby.

rvm use 2.4

Hauríeu de poder verificar la seva versió.

ruby -v

Hauríeu de veure una sortida similar.

[mastodon@vultr ~]$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]

Install bundler, que és el gestor de dependències de l'aplicació Ruby.

gem install bundler

Ara canvieu al directori d'inici de l'usuari Mastodon i cloneu els fitxers del repositori d'aplicacions de Github.

cd ~
git clone https://github.com/tootsuite/mastodon.git app

Move the application directory and checkout the latest releases of the application.

cd ~/app
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

Configure the bundle to use a custom path for the PostgreSQL configuration. Also, install the Ruby dependencies.

bundle config build.pg --with-pg-config=/usr/pgsql-9.6/bin/pg_config
bundle install --deployment --without development test

Install the Node.js dependencies using Yarn.

yarn install --pure-lockfile

You will need to create a configuration file for the Mastodon application. Copy the sample configuration file.

cd ~/app
cp .env.production.sample .env.production

Before editing the file, generate three different secrets by running the following command three times. You will need to set these secrets in the configuration file.

RAILS_ENV=production bundle exec rake secret

You should get a similar output.

[mastodon@vultr app]$ RAILS_ENV=production bundle exec rake secret
0f17dab1cf4a07f6fac671ecd5815adcb59d012b338dae9350c66402250c6c729dccd6182b1a8f75c4fde55453ce283ea66e07ed4466cdc6d4d6974c98512967

Edit the configuration file using the nano editor.

nano .env.production

Find the following lines and change the values accordingly.

REDIS_HOST=127.0.0.1
REDIS_PORT=6379

Provide the database credentials, according to database user you have created during installation of PostgreSQL. Provide any name for database name as Mastodon will automatically create the database with the name you provide.

DB_HOST=127.0.0.1
DB_USER=mastodon
DB_NAME=mastodon
DB_PASS=DBPassword
DB_PORT=5432

Set the domain name of the application.

LOCAL_DOMAIN=social.example.com

Find the following lines and set its value to the secrets you have generated.

PAPERCLIP_SECRET=
SECRET_KEY_BASE=
OTP_SECRET=

Save the file and exit from the editor.

Now, run the following command to generate Web Push VAPID keys. You will get an error while generating the Web Push VAPID keys if you have not set the secrets in the configuration file mentioned above.

RAILS_ENV=production bundle exec rake mastodon:webpush:generate_vapid_key

You should see the following output.

[mastodon@vultr app]$ RAILS_ENV=production bundle exec rake mastodon:webpush:generate_vapid_key
VAPID_PRIVATE_KEY=DCMQdSPkdm-mepsNh4F3suc-UIvsABCvwFd03jSVemM=
VAPID_PUBLIC_KEY=BMMVcVXmqnV0C8S_ybZ7eQH-MXBEX2exqfdPSYQiMMUF2rRxfhoEtVF931i26ebMgmslHB_nvVadOdcBPhaFEjw=

Open the configuration file again and set the generated keys in their respective lines.

VAPID_PRIVATE_KEY=
VAPID_PUBLIC_KEY=

Finally, provide the information of your SMTP mail server so that the application can send emails to users. It is important that you use a working SMTP server as, upon new registration, users will be sent an email with an activation link. New users will have to click on the activation link to activate their account.

SMTP_SERVER=mail.example.com
SMTP_PORT=456
[email protected]
SMTP_PASSWORD=MailPassword
[email protected]
SMTP_TLS=true

Once done, save the file and exit from the editor. You have done the basic configuration of Mastodon instance.

Setup the PostgreSQL database for the first time.

RAILS_ENV=production bundle exec rails db:setup

First, the above command will create a new database with the name mentioned in the configuration. Then, it will write the database according to the configuration.

Precompile all CSS and JavaScript files to create the cache.

RAILS_ENV=production bundle exec rails assets:precompile

Mastodon is now installed on your server. Now you will need to setup an Nginx web server to serve the application and setup Systemd services to run the Mastodon services.

From now on, we will need to execute the commands using the sudo user.

Install Nginx with Let's Encrypt SSL

We will use the Nginx web server as a reverse proxy to serve the application to the users. We will also obtain and install SSL certificates from Let's Encrypt.

Install Nginx and Certbot. Certbot is the official certificates issuing client for Let's Encrypt CA.

sudo yum -y install nginx certbot

Adjust your firewall setting to allow the standard HTTP and HTTPS ports through the firewall as Certbot needs to make an HTTP connection for verifying the domain authority.

sudo firewall-cmd --permanent --zone=public --add-service=http
sudo firewall-cmd --permanent --zone=public --add-service=https
sudo firewall-cmd --reload

Note: To obtain certificates from Let's Encrypt CA, you must ensure that the domain for which you wish to generate the certificates is pointed towards the server. If not, then make the necessary changes to the DNS records of your domain and wait for the DNS to propagate before making the certificate request again. Certbot checks the domain authority before providing the certificates.

Now use the builtin web server in Certbot to generate the certificates for your domain.

sudo certbot certonly --standalone -d social.example.com

The generated certificates are likely to be stored in the /etc/letsencrypt/live/social.example.com/ directory. The SSL certificate will be retained as fullchain.pem and the private key will be saved as privkey.pem.

Els certificats de Let's Encrypt caduquen en 90 dies, per la qual cosa es recomana configurar la renovació automàtica dels certificats mitjançant treballs de Cron. Cron és un servei del sistema que s'utilitza per executar tasques periòdiques.

Obriu el fitxer de treball cron.

sudo crontab -e

Afegiu la línia següent.

0 0 * * * /usr/bin/certbot renew --quiet

El treball cron anterior s'executarà diàriament a mitjanit. Si el certificat ha de caducar, els renovarà automàticament.

Ara creeu un nou bloc de servidor Nginx per al lloc Mastodon.

sudo nano /etc/nginx/conf.d/mastodon.conf

Omple el fitxer amb això.

map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      close;
}

server {
  listen 80;
  listen [::]:80;
  server_name social.example.com;
  return 301 https://$host$request_uri;
}

server {
  listen 443 ssl http2;
  listen [::]:443 ssl http2;
  server_name social.example.com;

  ssl_protocols TLSv1.2;
  ssl_ciphers HIGH:!MEDIUM:!LOW:!aNULL:!NULL:!SHA;
  ssl_prefer_server_ciphers on;
  ssl_session_cache shared:SSL:10m;

  ssl_certificate     /etc/letsencrypt/live/social.example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/social.example.com/privkey.pem;

  keepalive_timeout    70;
  sendfile             on;
  client_max_body_size 0;

  root /opt/mastodon/app/public;

  gzip on;
  gzip_disable "msie6";
  gzip_vary on;
  gzip_proxied any;
  gzip_comp_level 6;
  gzip_buffers 16 8k;
  gzip_http_version 1.1;
  gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

  add_header Strict-Transport-Security "max-age=31536000";

  location / {
    try_files $uri @proxy;
  }

  location ~ ^/(emoji|packs|system/accounts/avatars|system/media_attachments/files) {
    add_header Cache-Control "public, max-age=31536000, immutable";
    try_files $uri @proxy;
  }

  location @proxy {
    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;
    proxy_set_header Proxy "";
    proxy_pass_header Server;

    proxy_pass http://127.0.0.1:3000;
    proxy_buffering off;
    proxy_redirect off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

    tcp_nodelay on;
  }

  location /api/v1/streaming {
    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;
    proxy_set_header Proxy "";

    proxy_pass http://127.0.0.1:4000;
    proxy_buffering off;
    proxy_redirect off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

    tcp_nodelay on;
  }

  error_page 500 501 502 503 504 /500.html;
}

Assegureu-vos de canviar el nom de domini i la ruta als certificats SSL.

Ara podeu iniciar el servidor web Nginx i habilitar-lo per iniciar-se automàticament a l'arrencada.

sudo systemctl start nginx
sudo systemctl enable nginx

També se us demanarà que permeteu el port a 4000través del tallafoc, ja que el port proporcionarà el servei d'API de transmissió.

sudo firewall-cmd --permanent --zone=public --add-port=4000/tcp
sudo firewall-cmd --reload

Proporcioneu els permisos d'execució per al directori Mastodon.

sudo chmod +x /opt/mastodon

Configuració del servei Systemd

Haureu d'iniciar tres processos diferents per iniciar el servidor Mastodon amb èxit. L'ús del servei Systemd garantirà que el servidor Mastodon s'iniciï automàticament a l'arrencada i processi els errors.

Creeu un nou servei systemd per executar el servei web Mastodon. Aquest servei llançarà el servidor web integrat al port 3000.

sudo nano /etc/systemd/system/mastodon-web.service

Omple el fitxer amb el contingut següent.

[Unit]
Description=Mastodon Web Service
After=network.target

[Service]
Type=simple
User=mastodon
Group=mastodon
WorkingDirectory=/opt/mastodon/app
Environment="RAILS_ENV=production"
Environment="PORT=3000"
ExecStart=/bin/bash -lc 'bundle exec puma -C config/puma.rb'
TimeoutSec=15
Restart=always

[Install]
WantedBy=multi-user.target

Creeu el segon servei Systemd per executar el servei de cua de fons de Mastodon. El servei de cues Mastodon s'encarrega de totes les tasques de fons.

sudo nano /etc/systemd/system/mastodon-queue.service

Omple el fitxer amb el contingut següent.

[Unit]
Description=Mastodon Queue Service
After=network.target

[Service]
Type=simple
User=mastodon
WorkingDirectory=/opt/mastodon/app
Environment="RAILS_ENV=production"
Environment="DB_POOL=5"
ExecStart=/bin/bash -lc 'bundle exec sidekiq -c 5 -q default -q mailers -q pull -q push'
TimeoutSec=15
Restart=always

[Install]
WantedBy=multi-user.target

Finalment, creeu l'últim fitxer de servei per al servei de l'API de transmissió de Mastodon.

sudo nano /etc/systemd/system/mastodon-api.service

Omple el fitxer amb el contingut següent.

[Unit]
Description=Mastodon Streaming
After=network.target

[Service]
Type=simple
User=mastodon
WorkingDirectory=/opt/mastodon/app
Environment="NODE_ENV=production"
Environment="PORT=4000"
ExecStart=/bin/npm run start
TimeoutSec=15
Restart=always

[Install]
WantedBy=multi-user.target

Habiliteu els serveis Mastodon perquè s'iniciïn automàticament en el moment de l'arrencada.

sudo systemctl enable mastodon-web mastodon-queue mastodon-api 

Per iniciar els serveis de Mastodon, podeu executar-lo.

sudo systemctl start mastodon-web mastodon-queue mastodon-api 

Per comprovar l'estat dels serveis, podeu executar-lo.

sudo systemctl status mastodon-web mastodon-queue mastodon-api 

Conclusió

Ara podeu accedir a l'aplicació Mastodon anant a https://social.example.com. Creeu un compte d'usuari nou al vostre servidor i verifiqueu-lo obrint l'enllaç enviat al correu electrònic. Per proporcionar privilegis d'administrador al compte que acabeu de crear, executeu-ho.

sudo su - mastodon && cd ~/app
RAILS_ENV=production bundle exec rails mastodon:make_admin USERNAME=<user_name>

Substituïu <user_name>-lo pel nom d'usuari real que heu utilitzat per crear el compte a la interfície de Mastodon.

La vostra instància de Mastodon ara està instal·lada i configurada per executar-se. Comenceu convidant els vostres amics a unir-se a la vostra instància i explorar les funcions que ofereix Mastodon. Podeu utilitzar el vostre lloc de xarxes socials al mòbil descarregant qualsevol de les aplicacions disponibles per a diverses plataformes.