> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/el/rythmisi/overleaf-toolkit/tls-proxy.md).

# Μεσολαβητής TLS

Ένας προαιρετικός μεσολαβητής TLS για τον τερματισμό συνδέσεων HTTPS, χρησιμοποιώντας το NGINX.

Εκτελέστε `bin/init --tls` για να αρχικοποιήσετε την τοπική διαμόρφωση με τη διαμόρφωση του μεσολαβητή NGINX, ή για να προσθέσετε τη διαμόρφωση του μεσολαβητή NGINX σε μια υπάρχουσα τοπική διαμόρφωση. Ένα **παράδειγμα** ιδιωτικό κλειδί δημιουργείται στο `config/nginx/certs/overleaf_key.pem` και ένα **δοκιμαστικό** πιστοποιητικό στο `config/nginx/certs/overleaf_certificate.pem`. Είτε αντικαταστήστε αυτά με το πραγματικό ιδιωτικό κλειδί και πιστοποιητικό σας, είτε ορίστε τις τιμές των `TLS_PRIVATE_KEY_PATH` και `TLS_CERTIFICATE_PATH` μεταβλητών στις διαδρομές του πραγματικού ιδιωτικού κλειδιού και πιστοποιητικού σας, αντίστοιχα.

Μια προεπιλεγμένη διαμόρφωση για το NGINX παρέχεται στο `config/nginx/nginx.conf` η οποία μπορεί να προσαρμοστεί στις απαιτήσεις σας. Η διαδρομή προς το αρχείο ρυθμίσεων μπορεί να αλλάξει με τη `NGINX_CONFIG_PATH` μεταβλητή.

{% hint style="success" %}
Αν έχετε μια **docker-compose.yml** βασισμένη εγκατάσταση, ή διαχειρίζεστε τον δικό σας αντίστροφο μεσολαβητή NGINX, μπορείτε να δείτε ένα παράδειγμα **nginx.conf** αρχείο [εδώ](https://github.com/overleaf/toolkit/blob/master/lib/config-seed/nginx.conf).
{% endhint %}

Προσθέστε την ακόλουθη ενότητα στο `config/overleaf.rc` αρχείο σας, αν δεν υπάρχει ήδη:

```
# Διαμόρφωση μεσολαβητή TLS (προαιρετική)
NGINX_ENABLED=false
NGINX_CONFIG_PATH=config/nginx/nginx.conf
NGINX_HTTP_PORT=80

# Αντικαταστήστε αυτές τις διευθύνσεις IP με την εξωτερική διεύθυνση IP του host σας
NGINX_HTTP_LISTEN_IP=127.0.1.1 
NGINX_TLS_LISTEN_IP=127.0.1.1
TLS_PRIVATE_KEY_PATH=config/nginx/certs/overleaf_key.pem
TLS_CERTIFICATE_PATH=config/nginx/certs/overleaf_certificate.pem
TLS_PORT=443
```

{% hint style="danger" %}
Αν χρησιμοποιείτε έναν εξωτερικό μεσολαβητή TLS (δηλ. δεν διαχειρίζεται από το Overleaf Toolkit), παρακαλούμε βεβαιωθείτε ότι `OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>` έχει οριστεί στο `config/variables.env`, π.χ. `OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37`.
{% endhint %}

{% hint style="danger" %}
Αν χρησιμοποιείτε ένα υποδίκτυο από `172.16.0.0/12` (προεπιλεγμένο υποδίκτυο για δίκτυα Docker) για το τοπικό σας δίκτυο, θα χρειαστεί να ορίσετε `OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network>` στο `config/variables.env`. Όπου `<network>` είναι η `IPAM -> Config -> Subnet` στην `docker inspect overleaf_default`, π.χ. `OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16`. Αυτό γίνεται για να αποτραπεί η πλαστογράφηση των `X-Forwarded` κεφαλίδες.
{% endhint %}

{% hint style="info" %}
Αν το `OVERLEAF_TRUSTED_PROXY_IPS` δεν έχει οριστεί χειροκίνητα, προεπιλέγεται σε `loopback`. Αν το ορίσετε χειροκίνητα, πρέπει να βεβαιωθείτε ότι περιλαμβάνετε ένα από τα `loopback`, `localhost` ή `127.0.0.1`, το οποίο εμπιστεύεται το **nginx** στιγμιότυπο που εκτελείται μέσα στο **sharelatex** κοντέινερ.
{% endhint %}

Για να εκτελέσετε τον μεσολαβητή, αλλάξτε την τιμή της `NGINX_ENABLED` μεταβλητή στο `config/overleaf.rc` από `false` σε `true` και εκτελέστε ξανά `bin/up`.

Από προεπιλογή, η διεπαφή ιστού HTTPS θα είναι διαθέσιμη στο `https://127.0.1.1:443`. Οι συνδέσεις στο `http://127.0.1.1:80` θα ανακατευθύνονται στο `https://127.0.1.1:443`. Για να αλλάξετε τη διεύθυνση IP στην οποία ακούει το NGINX, ορίστε τις `NGINX_HTTP_LISTEN_IP` και `NGINX_TLS_LISTEN_IP` μεταβλητές. Οι θύρες μπορούν να αλλάξουν μέσω των `NGINX_HTTP_PORT` και `TLS_PORT` μεταβλητών.

Αν το NGINX αποτύχει να ξεκινήσει με το μήνυμα σφάλματος `Σφάλμα κατά την εκκίνηση του userland proxy: listen tcp4 ... bind: η διεύθυνση χρησιμοποιείται ήδη` βεβαιωθείτε ότι `OVERLEAF_LISTEN_IP:OVERLEAF_PORT` δεν επικαλύπτεται με `NGINX_HTTP_LISTEN_IP:NGINX_HTTP_PORT`.

{% @mermaid/diagram content="sequenceDiagram
participant user as User
participant external as Host External
participant internal as Host Internal
participant nginx as nginx
participant sharelatex as sharelatex
participant git-bridge as git-bridge
%% User connects to external host HTTP
user->>+ external: HTTP
note over external: NGINX\_HTTP\_LISTEN\_IP:NGINX\_HTTP\_PORT
external->>+ nginx: HTTP
note over nginx: nginx:80
nginx-->>-external: 301
%% User connects to external host HTTPS
user->>+ external: HTTPS
note over external: NGINX\_TLS\_LISTEN\_IP:TLS\_PORT
external->>+ nginx: HTTPS
note over nginx: nginx:443
nginx->>+ sharelatex: HTTP
note over sharelatex: sharlatex:80
%% User connects to localhost HTTP
user->>+ internal: HTTP
note over internal: OVERLEAF\_LISTEN\_IP:OVERLEAF\_PORT
internal->>+sharelatex: HTTP
note over sharelatex: sharlatex:80
%% sharelatex connects to git-bridge
sharelatex->>+git-bridge: HTTP /git/
note over git-bridge: git-bridge:8000
note over sharelatex: GIT\_BRIDGE\_HOST:GIT\_BRIDGE\_PORT
git-bridge->>+sharelatex: WEB/WEB-API:3000
git-bridge->>+sharelatex: HISTORY-V1:3100" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/el/rythmisi/overleaf-toolkit/tls-proxy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
