> 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/sv/konfiguration/overleaf-toolkit/tls-proxy.md).

# TLS-proxy

En valfri TLS-proxy för att avsluta HTTPS-anslutningar, med NGINX.

Kör `bin/init --tls` för att initiera lokal konfiguration med NGINX-proxykonfiguration, eller för att lägga till NGINX-proxykonfiguration till en befintlig lokal konfiguration. En **exempel** privat nyckel skapas i `config/nginx/certs/overleaf_key.pem` och ett **testcertifikat** certifikat i `config/nginx/certs/overleaf_certificate.pem`. Antingen ersätter du dessa med din faktiska privata nyckel och certifikat, eller ställer in värdena för `TLS_PRIVATE_KEY_PATH` och `TLS_CERTIFICATE_PATH` variablerna till sökvägarna för din faktiska privata nyckel och certifikat respektive.

En standardkonfiguration för NGINX finns i `config/nginx/nginx.conf` som kan anpassas efter dina behov. Sökvägen till konfigurationsfilen kan ändras med `NGINX_CONFIG_PATH` variabeln.

{% hint style="success" %}
Om du har en **docker-compose.yml** baserad driftsättning, eller hanterar din egen NGINX-reversproxy, kan du se ett exempel på **nginx.conf** fil [här](https://github.com/overleaf/toolkit/blob/master/lib/config-seed/nginx.conf).
{% endhint %}

Lägg till följande avsnitt i din `config/overleaf.rc` fil om det inte redan finns där:

```
# TLS-proxykonfiguration (valfri)
NGINX_ENABLED=false
NGINX_CONFIG_PATH=config/nginx/nginx.conf
NGINX_HTTP_PORT=80

# Ersätt dessa IP-adresser med värdmaskinens externa IP-adress
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" %}
Om du använder en extern TLS-proxy (dvs. inte hanteras av Overleaf Toolkit), se till att `OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>` är inställt i din `config/variables.env`, t.ex. `OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37`.
{% endhint %}

{% hint style="danger" %}
Om du använder ett subnät från `172.16.0.0/12` (standardundernät för Docker-nätverk) för ditt lokala nätverk måste du ställa in `OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network>` i din `config/variables.env`. Där `<network>` är `IPAM -> Config -> Subnet` -värdet i `docker inspect overleaf_default`, t.ex. `OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16`. Detta är för att förhindra förfalskning av `X-Forwarded` rubriker.
{% endhint %}

{% hint style="info" %}
Om `OVERLEAF_TRUSTED_PROXY_IPS` inte anges manuellt, är standardvärdet `loopback`. Om du ställer in det manuellt måste du se till att du inkluderar ett av `loopback`, `localhost` eller `127.0.0.1`, som litar på **nginx** instans som körs inuti **sharelatex** containern.
{% endhint %}

För att köra proxyn, ändra värdet på `NGINX_ENABLED` variabeln i `config/overleaf.rc` avsändaradressen `false` till `true` och kör sedan igen `bin/up`.

Som standard kommer webbgränssnittet via HTTPS att vara tillgängligt på `https://127.0.1.1:443`. Anslutningar till `http://127.0.1.1:80` kommer att omdirigeras till `https://127.0.1.1:443`. För att ändra IP-adressen som NGINX lyssnar på, ställ in `NGINX_HTTP_LISTEN_IP` och `NGINX_TLS_LISTEN_IP` variablerna. Portarna kan ändras via `NGINX_HTTP_PORT` och `TLS_PORT` variablerna.

Om NGINX inte kan starta med felmeddelandet `Error starting userland proxy: listen tcp4 ... bind: address already in use` se till att `OVERLEAF_LISTEN_IP:OVERLEAF_PORT` inte överlappar med `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/sv/konfiguration/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.
