ShareLaTeX installeren (2023)

• berekenen
• mediaserver
• media
• Deel LaTex
• documenten
• editor

DeelLaTeXis een open-source online real-time collaboratieve LaTeX-editor. In deze tutorial wordt uitgelegd hoe u een beveiligde ShareLaTeX-instantie installeert met een NGINX reverse proxy.

Docker installeren

Installeer ShareLaTeX op een versUbuntu Xenial (16.04)voorbeeld. De software draait doorDokwerker. Daarom moet de Docker-omgeving in een eerste stap worden geïnstalleerd. Docker bestaat in twee versies: Docker EE (Enterprise Edition) en Docker CE (Community Edition).EC Dockerwordt gebruikt in deze tutorial.

1. Begin met het installeren van de vereiste pakketten, de GPG-sleutel en de repository van docker op onze instantie:

   apt-get install apt-transport-https ca-certificates curl software-properties-common python-pip letsencrypt nginx exim4
   krul -fsSL https://download.docker.com/linux/debian/gpg | apt-toets toevoegen -
   add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

2. Updategeschikten start de installatie van Docker:

   apt-get-update
   apt-get install docker-ce

3. Installerendocker-componeren, een python-tool die kan worden geïnstalleerd viaPip:

   pip install docker-compose

   De tool wordt gebruikt om de verschillende services die we nodig hebben op onze server te beheren.

   Docker Community Edition is nu op de server geïnstalleerd.

ShareLaTeX vertrouwt op twee externe services die niet standaard zijn geïnstalleerd. Ze worden ook geleverd via Docker:MongoDBEnRedis.

Docker-composerenis op de server geïnstalleerd om de afhankelijkheden tussen de verschillende services te beheren. Het zal alle vereiste applicaties starten en stoppen.

ShareLaTeX biedt een vooraf geconfigureerd configuratiebestand dat kan worden gebruikt metdocker-componeren.

1. Maak een map aan en download het bestand:

   mkdir /etc/sharelatex
   cd /etc/sharelatex
   wget https://raw.githubusercontent.com/sharelatex/sharelatex/master/docker-compose.yml

   De software slaat alle bestanden standaard op in de homedirectory van de gebruiker.

2. Maak een map om de gegevens van elke service in een speciale map op te slaan/var/lib/sharelatexmet de volgende submappen:

   mkdir /var/lib/sharelatex
   mkdir /var/lib/sharelatex/data
   mkdir /var/lib/sharelatex/mongodb
   mkdir /var/lib/sharelatex/redis

3. Vertellendocker-componerenom de gegevens in deze mappen op te slaan.

4. Open het bestand/etc/sharelatex/docker-compose.ymlin een teksteditor en wijzig het als volgt:

   volumes:
   - ~/sharelatex_data:/var/lib/sharelatex

   (Video) LaTeX Tutorial pt 1 - Creating Your First Document

   Deze regels geven de informatie waar ShareLateX de gegevens zal opslaan. Het gedeelte voor de:vertegenwoordigt het pad op de host, het deel na het dubbele punt vertegenwoordigt het pad in de container. Bewerk het lokale gedeelte zodat het er zo uitziet:

   volumes:
   - /var/lib/sharelatex/data:/var/lib/sharelatex

   Belangrijk:

   Bewerk nooit het tweede pad, aangezien dit het pad in de container vertegenwoordigt. Als u het wijzigt, worden uw gegevens niet correct opgeslagen en urisico gegevensverlies!

5. Breng dezelfde wijziging aan voor MongoDB en Redis. Het bestand zou er als volgt uit moeten zien:

   volumes:
   - /var/lib/sharelatex/mongodb:/data/db
   volumes:
   - /var/lib/sharelatex/redis:/data

   See Also

   10 Beste LaTeX-editors voor Linux - WebSetNetDockerTemplateSchema - Unraid | DocumentenAan de slag met Docker

6. Om ShareLaTeX achter een NGINX reverse proxy uit te voeren, bewerkt u de poort waarop de toepassing luistert:

   poorten:
   - 80:80

7. Zorg ervoor dat de applicatie op poort luistert4242en is alleen beschikbaar vanaf het IP127.0.0.1, de gastheer zelf. Dit zorgt ervoor dat de applicatie om veiligheidsredenen alleen toegankelijk is via onze HTTPS-proxy van de buitenwereld. Daarom passen we het als volgt aan:

   poorten:
   - 127.0.0.1:4242:80

8. Scroll naar beneden in het bestand, naar een onderdeel met de naamomgeving. Dit deel bevat de configuratie van ShareLateX, pas het als volgt aan:

   omgeving:
   SHARELATEX_MONGO_URL: mongodb://mongo/sharelatex
   SHARELATEX_REDIS_HOST: redis
   SHARELATEX_APP_NAME: DeelLaTeX
   # Zet hier de informatie over uw ShareLaTeX-site:
   SHARELATEX_SITE_URL: https://my.sharelatex.tld
   SHARELATEX_NAV_TITLE: ShareLaTeX - Mijn prachtige ShareLaTeX-installatie
   # Verwijder het commentaar op de volgende regel als u een logo wilt weergeven (d.w.z. van uw school of universiteit)
   # SHARELATEX_HEADER_IMAGE_URL: http://somewhere.com/mylogo.png
   # Vul hier je e-mailadres in:
   SHARELATEX_ADMIN_EMAIL: mijn@email.com
   SHARELATEX_LEFT_FOOTER: '[{"text": "Mogelijk gemaakt door ShareLaTeX"}]'
   SHARELATEX_RIGHT_FOOTER: '[{"text": "Voer uw eigen instantie uit op Scaleway"} ]'
   # Configureer het e-mailadres dat wordt weergegeven in e-mails verzonden door ShareLaTeX
   SHARELATEX_EMAIL_FROM_ADDRESS: "mijn@email.com"
   # Schakel de installatie achter een proxy in
   SHARELATEX_BEHIND_PROXY: 'waar'
   SHARELATEX_SECURE_COOKIE: 'waar'
   # Stel de taal van de installatie in. Bijvoorbeeld 'en' English, 'de' German, 'fr' French ...
   SHARELATEX_SITE_LANGUAGE: 'nl'
   # Configureer de instellingen voor uitgaande mails
   (Video) How to Write a Thesis in LaTeX pt 1 - Basic Structure
   SHARELATEX_EMAIL_SMTP_HOST: 'lokale host'
   SHARELATEX_EMAIL_SMTP_PORT: '465'
   SHARELATEX_EMAIL_SMTP_SECURE: 'waar'
   SHARELATEX_EMAIL_SMTP_USER: 'sharelatex'
   SHARELATEX_EMAIL_SMTP_PASS: 'JE_WACHTWOORD'
   # SHARELATEX_EMAIL_SMTP_TLS_REJECT_UNAUTH: 'waar'
   # SHARELATEX_EMAIL_SMTP_IGNORE_TLS: 'false'
   # Stel een voettekst in voor uitgaande e-mails:
   SHARELATEX_CUSTOM_EMAIL_FOOTER: "
   Mogelijk gemaakt door ShareLaTeX
   "
   

   Opmerking:

   Het configuratiebestand is geschrevenYAML. Zorg ervoor dat u deYAML-opmaak, anders kan het starten van ShareLaTeX mislukken.

Nginx configureren

Deze zelfstudie gebruiktNGINXmetLaten we versleutelenEnCertBotals een SSL-enabled reverse proxy om de verbinding tussen de client en onze server te beveiligen.

1. Installeer Certbot op de server:

   apt installeer python3-certbot-nginx

2. Genereer het certificaat door de volgende opdracht uit te voeren:

   sudo certbot --nginx certonly

   SSL-certificaten uitgegeven door Let's Encrypt zijn 90 dagen geldig. Certbot wordt geleverd met de optie om het certificaat automatisch te verlengen.

3. Configureer een cron-taak die Certbot dagelijks start om de status van het certificaat te controleren. Open de crontab door te typen:

   crontab -e

4. Voeg de volgende regel toe die Nginx stopt, het certificaat vernieuwt en de webserver dagelijks om 4.30 uur 's ochtends opnieuw start:

   30 4 * * * /opt/letsencrypt/certbot-auto renew --pre-hook "service nginx stop" --post-hook "service nginx start"

5. Bewerk het bestand/etc/nginx/sites-enabled/defaultzodat het lijkt op het volgende voorbeeld, om Nginx zo te configureren dat het onze ShareLaTeX-site als standaardsite zal dienen:

   server {
   luister 80;
   luister [::]:80;
   servernaam mijn.sharelatex.tld;
   plaats / {
   retourneer 301 https://$server_name$request_uri;
   }
   }
   server {
   luisteren [::]:443 ssl ipv6only=aan;
   luister 443 ssl;
   servernaam mijn.sharelatex.tld;
   ssl_certificaat /etc/letsencrypt/live/my.sharelatex.tld/fullchain.pem;
   ssl_certificate_key /etc/letsencrypt/live/my.sharelatex.tld/privkey.pem;
   inclusief /etc/letsencrypt/options-ssl-nginx.conf;
   ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
   proxy_set_header X-doorgestuurd-voor $remote_addr;
   (Video) Getting Started with ShareLatex
   add_header Strikte transportbeveiliging "max-age=31536000; includeSubDomains";
   server_tokens uit;
   add_header X-Frame-Opties SAMEORIGIN;
   add_header X-Content-Type-Opties nosniff;
   client_max_body_size 50M;
   plaats / {
   proxy_pass http://localhost:4242;
   proxy_set_header X-Forwarded-Proto $schema;
   proxy_http_versie 1.1;
   proxy_set_header Opwaarderen $http_upgrade;
   proxy_set_header Verbinding "upgrade";
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_read_timeout 3m;
   proxy_send_timeout 3m;
   access_log /var/log/nginx/sharelatex.access.log;
   error_log /var/log/nginx/sharelatex.error.log;
   }
   }

6. Herstart Nginx met de volgende opdracht:

   service nginx opnieuw opstarten

Systemd configureren

Alles is nu klaar voor de eerste start van de ShareLaTeX-instantie. Om ervoor te zorgen dat ShareLaTeX automatisch start bij elke herstart van de server, maakt u eensysteemdscript ervoor.

1. Maak het bestand aan/etc/systemd/system/sharelatex.serviceen open het in een teksteditor. Desysteemdscript zou er uit moeten zien als in het volgende voorbeeld:

   [Eenheid]
   Description=ShareLaTeX-service
   Na=docker.service
   [Dienst]
   Typ=eenvoudig
   WorkingDirectory=/etc/sharelatex
   ExecStart=/usr/local/bin/docker-compose -f /etc/sharelatex/docker-compose.yml omhoog
   ExecStop=/usr/local/bin/docker-compose -f /etc/sharelatex/docker-compose.yml naar beneden
   [Installeren]
   WantedBy=multi-user.target

2. Sla het bestand op en maak de nieuwe service bekend aan het systeem:

   systemctl schakelt sharelatex.service in
   systemctl daemon-herladen

3. Start de dienstdienst sharelatex starten toegang krijgen tot ShareLaTeX met een webbrowser:https://mijn.instantie.ip.adres/

   De volgende interface verschijnt:

De eerste gebruiker aanmaken

De instantie is nu actief, maar heeft nog geen gebruiker.

1. Maak de eerste admin-gebruiker aan met de volgende opdracht:

   docker exec sharelatex /bin/bash -c "cd /var/www/sharelatex; grunt user:create-admin --email my@email.address"

   Sommige berichten verschijnen tijdens het aanmaken van de gebruiker, het is voltooid wanneer het volgende bericht verschijnt:

   Met succes mijn@email.adres aangemaakt als admin-gebruiker.
   Ga naar de volgende URL om een ​​wachtwoord in te stellen voor my@email.address en log in:
   https://my.sharelatex.tld/user/password/set?passwordResetToken=79d16b0b75a24e2f7cb3174df638d492f4a427e5f88f8fe34aa14373fe6c8630

   (Video) LaTeX - Introduction | First Latex code | Learn using ShareLaTeX | Hello World | Learning LaTeX 01

   Nadat het wachtwoord voor de gebruiker is ingesteld, logt u in met uw e-mailadres en uw wachtwoord.

2. Maak een eerste project aan:

Extra LaTex-pakketten installeren

De installatie is volledig operationeel, maar er zijn slechts enkele LaTeX-pakketten geïnstalleerd om schijfruimte te besparen. Het is mogelijk om de ontbrekende pakketten (d.w.z.beamer,XeTeXofAMS-Wiskunde), om bijna elk LaTeX-document te kunnen compileren.

1. Installerenscherm, voer de volgende opdracht uit:

   apt-get installatiescherm

2. Start de installatie van de aanvullende pakketten:

   scherm
   docker exec sharelatex tlmgr installatieschema vol

   Het is mogelijk om de SSH-client af te sluiten en de sessie later te herstellenscherm -rvoor het controleren van de status van de installatie.

   Als het klaar is, verlaat u de schermsessie metUitgang.

   Aangezien wijzigingen aan Docker-containers niet permanent zijn, is dit verplichtverbinden*een nieuwe versie van de ShareLaTeX-container die de wijziging bevat.

   Hiervoor is het ID van de container vereist.

3. Om het te krijgen, typt u de volgende opdracht:

   havenarbeider ps

   De volgende uitvoer van actieve docker-containers op het systeem verschijnt:

   CONTAINER-ID AFBEELDING COMMAND GEMAAKTE STATUS HAVENNAMEN
   266d633cb0d9 sharelatex/sharelatex "/sbin/my_init" Ongeveer een uur geleden Omhoog Ongeveer een uur 127.0.0.1:4242->80/tcp sharelatex
   f50df9f39bbd mongo "docker-entrypoint.s…" Ongeveer een uur geleden Omhoog Ongeveer een uur 27017/tcp mongo
   b886c9d0f3da redis "docker-entrypoint.s…" Ongeveer een uur geleden Omhoog Ongeveer een uur 6379/tcp redis

   Dedeellatexcontainer heeft de ID266d633cb0d94.

4. Bouw een nieuwe container met de LaTeX-modules geïnstalleerd door te typen:

   docker commit -m "alle latexpakketten installeren" 266d633cb0d9 sharelatex/sharelatex:v3

   Dit kan enkele minuten duren voordat de nieuwe container klaar is.

   Vertel het zodra de container is gebouwddocker-componerenom deze nieuwe container standaard te gebruiken.

5. Bewerk hiervoor deafbeeldinginformatie in het dossier/etc/sharelatex/docker-compose.yml:

   versie 2'
   Diensten:
   deellatex:
   opnieuw opstarten: altijd
   afbeelding: sharelatex/sharelatex:v3