From cc8c5486e880451896108bcc3618799fc34fefa9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80?=
 <78488229+viktor138irk@users.noreply.github.com>
Date: Fri, 8 May 2026 22:57:05 +0900
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=D1=8B=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=B0=20Fas?=
 =?UTF-8?q?tPanel=20proxy?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/FASTPANEL_PROXY.md | 66 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 docs/FASTPANEL_PROXY.md

diff --git a/docs/FASTPANEL_PROXY.md b/docs/FASTPANEL_PROXY.md
new file mode 100644
index 0000000..be93bb7
--- /dev/null
+++ b/docs/FASTPANEL_PROXY.md
@@ -0,0 +1,66 @@
+# FastPanel Proxy Rules
+
+## Главное правило
+
+WSMessenger не должен автоматически менять FastPanel.
+
+Любые изменения:
+- вручную;
+- или только после отдельной явной команды пользователя.
+
+## Safe Proxy Architecture
+
+```text
+Internet
+   ↓
+FastPanel/Nginx
+   ↓
+Reverse Proxy
+   ↓
+WSMessenger Services
+```
+
+## Matrix Proxy
+
+Пример:
+
+```nginx
+location / {
+    proxy_pass http://127.0.0.1:8008;
+    proxy_set_header Host $host;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+}
+```
+
+## Web Client Proxy
+
+```nginx
+location / {
+    proxy_pass http://127.0.0.1:3000;
+}
+```
+
+## Admin Panel Proxy
+
+```nginx
+location / {
+    proxy_pass http://127.0.0.1:3100;
+}
+```
+
+## Запрещено
+
+- перезаписывать nginx.conf;
+- менять production vhost;
+- трогать ArtistFlow configs;
+- трогать widget.stackworks.ru configs;
+- перезапускать FastPanel без команды.
+
+## Перед изменениями
+
+Всегда делать backup:
+
+```bash
+cp -r /etc/nginx /opt/swmessenger/backups/nginx_$(date +%F_%H-%M-%S)
+```