> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/uk/konfiguraciya/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** розгортання на основі 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-адресу вашого хоста 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,` встановлено у вашому `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,` у вашому `config/variables.env`. Де `` є `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 %} Якщо ви правильно налаштували довірені IP-адреси проксі, ви повинні бачити свою публічну IP-адресу на `/user/sessions` сторінці ось так:
Якщо показана вище IP-адреса все ще схожа на `127.0.0.1` 127.0.1.1 `OVERLEAF_TRUSTED_PROXY_IPS`. або на IP-адресу приватної/локальної мережі, перевірте конфігурацію довіреного проксі, особливо значення `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_TLS_LISTEN_IP` змінні. Порти можна змінити через `NGINX_HTTP_PORT` та `TLS_PORT` змінні. Якщо NGINX не вдається запустити з повідомленням про помилку `Error starting userland proxy: listen tcp4 ... bind: address already in use` переконайтеся, що `OVERLEAF_LISTEN_IP:OVERLEAF_PORT` не перетинається з `NGINX_HTTP_LISTEN_IP:NGINX_HTTP_PORT`. ```mermaid sequenceDiagram participant user as Користувач participant external as Зовнішній хост participant internal as Внутрішній хост participant nginx as nginx participant sharelatex as sharelatex participant git-bridge as git-bridge %% Користувач підключається до зовнішнього хоста через 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 %% Користувач підключається до зовнішнього хоста через 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 %% Користувач підключається до localhost через HTTP user->>+ internal: HTTP note over internal: OVERLEAF_LISTEN_IP:OVERLEAF_PORT internal->>+sharelatex: HTTP note over sharelatex: sharlatex:80 %% sharelatex підключається до 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://ayakaleaf-pro.ayaka.space/on-premises/uk/konfiguraciya/overleaf-toolkit/tls-proxy.md?ask=&goal= ``` `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.