SWChat/docs/PULSE_PUSH_GATEWAY.md

Pulse Push Gateway

Архитектура

Synapse
    ↓
Pulse Push Gateway
    ↓
Firebase FCM
    ↓
Android Pulse

Серверы

• FastPanel reverse proxy: 192.168.0.221
• Matrix/Core: 192.168.0.141

Gateway

Gateway запускается на Matrix/Core сервере:

192.168.0.141:8509

Установка

cd /opt/swchat
mkdir -p push-gateway
cd push-gateway

Скопировать файлы из репозитория:

push-gateway/main.py
push-gateway/requirements.txt

Установка зависимостей:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Firebase

В Firebase Console:

• Project settings
• Service accounts
• Generate new private key

Файл сохранить:

/opt/swchat/push-gateway/firebase-service-account.json

Запуск

cd /opt/swchat/push-gateway
source venv/bin/activate
uvicorn main:app --host 0.0.0.0 --port 8509

Проверка

На VPS/FastPanel:

curl http://192.168.0.141:8509/health

Ожидаемый ответ:

{
  "status": "ok",
  "service": "pulse-push-gateway"
}

nginx reverse proxy

На FastPanel/nginx:

location /_matrix/push/v1/notify {
    proxy_pass http://192.168.0.141:8509/_matrix/push/v1/notify;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Важно

• Не открывать 8509 наружу.
• Доступ к 8509 только из локальной сети.
• SSL остаётся на FastPanel.
• Synapse использует публичный endpoint:

https://matrix.stackworks.ru/_matrix/push/v1/notify