feat: Add presence heartbeat for Matrix online status
- matrix-gateway: POST /internal/matrix/presence/online endpoint - usePresenceHeartbeat hook with activity tracking - Auto away after 5 min inactivity - Offline on page close/visibility change - Integrated in MatrixChatRoom component
This commit is contained in:
Apple
234
docs/DEPLOY_DNS_SETUP.md
Normal file
234
docs/DEPLOY_DNS_SETUP.md
Normal file
@@ -0,0 +1,234 @@
|
||||
# DNS Setup для DAARION Production
|
||||
|
||||
**Домен:** `daarion.space`
|
||||
**Цільовий сервер:** VPS з Ubuntu 22.04 LTS
|
||||
|
||||
---
|
||||
|
||||
## 📋 Обов'язкові DNS записи
|
||||
|
||||
### 1. Головний домен (Landing / Redirect)
|
||||
```
|
||||
Type: A
|
||||
Name: @
|
||||
Value: <SERVER_IP_ADDRESS>
|
||||
TTL: 3600
|
||||
```
|
||||
|
||||
**Призначення:** `https://daarion.space` → redirect на `https://app.daarion.space`
|
||||
|
||||
---
|
||||
|
||||
### 2. Application субдомен (MVP Product)
|
||||
```
|
||||
Type: A
|
||||
Name: app
|
||||
Value: <SERVER_IP_ADDRESS>
|
||||
TTL: 3600
|
||||
```
|
||||
|
||||
**Призначення:** `https://app.daarion.space` → головний MVP-продукт (microDAO + City + Agents)
|
||||
|
||||
---
|
||||
|
||||
## 📋 Опціональні DNS записи
|
||||
|
||||
### 3. Grafana моніторинг
|
||||
```
|
||||
Type: A
|
||||
Name: grafana
|
||||
Value: <SERVER_IP_ADDRESS>
|
||||
TTL: 3600
|
||||
```
|
||||
|
||||
**Призначення:** `https://grafana.daarion.space` → прямий доступ до Grafana
|
||||
|
||||
**Альтернатива:** Використовувати path-based routing через app: `https://app.daarion.space/grafana/`
|
||||
|
||||
---
|
||||
|
||||
### 4. API субдомен (майбутнє)
|
||||
```
|
||||
Type: A
|
||||
Name: api
|
||||
Value: <SERVER_IP_ADDRESS>
|
||||
TTL: 3600
|
||||
```
|
||||
|
||||
**Призначення:** `https://api.daarion.space` → окремий субдомен для API
|
||||
|
||||
**Статус:** Не потрібно для MVP, але можна зарезервувати
|
||||
|
||||
---
|
||||
|
||||
### 5. Matrix субдомен (Phase 4+)
|
||||
```
|
||||
Type: A
|
||||
Name: matrix
|
||||
Value: <SERVER_IP_ADDRESS>
|
||||
TTL: 3600
|
||||
```
|
||||
|
||||
**Призначення:** `https://matrix.daarion.space` → Matrix homeserver (Phase 4+)
|
||||
|
||||
**Статус:** Буде потрібно в PHASE MATRIX FULL
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Перевірка DNS
|
||||
|
||||
Після додавання записів перевірити:
|
||||
|
||||
```bash
|
||||
# Перевірка A-запису для головного домену
|
||||
dig daarion.space +short
|
||||
|
||||
# Перевірка A-запису для app субдомену
|
||||
dig app.daarion.space +short
|
||||
|
||||
# Перевірка всіх записів
|
||||
dig daarion.space ANY
|
||||
|
||||
# Через nslookup
|
||||
nslookup app.daarion.space
|
||||
|
||||
# Через host
|
||||
host app.daarion.space
|
||||
```
|
||||
|
||||
**Очікуваний результат:** IP-адреса вашого VPS
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ Час propagation
|
||||
|
||||
- **Середній час:** 15-60 хвилин
|
||||
- **Максимальний:** 24-48 годин (рідко)
|
||||
- **TTL:** 3600 секунд (1 година)
|
||||
|
||||
**Рекомендація:** Почекати хоча б 15 хвилин перед налаштуванням SSL.
|
||||
|
||||
---
|
||||
|
||||
## 🌐 DNS Providers інструкції
|
||||
|
||||
### Cloudflare
|
||||
1. Dashboard → DNS → Add record
|
||||
2. Type: A, Name: app, IPv4 address: `<SERVER_IP>`
|
||||
3. Proxy status: DNS only (сіра хмарка) для MVP
|
||||
4. TTL: Auto
|
||||
5. Save
|
||||
|
||||
### Google Domains
|
||||
1. DNS → Manage custom records
|
||||
2. Host name: app, Type: A, TTL: 3600, Data: `<SERVER_IP>`
|
||||
3. Add
|
||||
|
||||
### Namecheap
|
||||
1. Advanced DNS → Add New Record
|
||||
2. Type: A Record, Host: app, Value: `<SERVER_IP>`, TTL: Automatic
|
||||
3. Save
|
||||
|
||||
### DigitalOcean
|
||||
1. Networking → Domains → daarion.space → Create new record
|
||||
2. Type: A, Hostname: app, Will direct to: `<SERVER_IP>`, TTL: 3600
|
||||
3. Create Record
|
||||
|
||||
---
|
||||
|
||||
## 🔒 SSL Certificate Requirements
|
||||
|
||||
Після налаштування DNS, для SSL потрібно:
|
||||
|
||||
1. ✅ DNS A-записи propagated
|
||||
2. ✅ Порт 80 відкритий на сервері
|
||||
3. ✅ Порт 443 відкритий на сервері
|
||||
4. ✅ Домен вказує на правильний IP
|
||||
|
||||
**Команда для перевірки портів:**
|
||||
```bash
|
||||
# На сервері
|
||||
sudo ufw status
|
||||
sudo ufw allow 80/tcp
|
||||
sudo ufw allow 443/tcp
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 DNS Health Check
|
||||
|
||||
```bash
|
||||
# Перевірка DNS propagation globally
|
||||
# Використати онлайн інструменти:
|
||||
# - https://dnschecker.org/
|
||||
# - https://www.whatsmydns.net/
|
||||
|
||||
# Або через CLI:
|
||||
for server in 8.8.8.8 1.1.1.1 208.67.222.222; do
|
||||
echo "Testing with DNS server: $server"
|
||||
dig @$server app.daarion.space +short
|
||||
done
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚨 Troubleshooting
|
||||
|
||||
### Проблема: DNS не резолвиться
|
||||
**Рішення:**
|
||||
1. Перевірити синтаксис DNS запису
|
||||
2. Очистити локальний DNS cache:
|
||||
```bash
|
||||
# macOS
|
||||
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
|
||||
|
||||
# Linux
|
||||
sudo systemd-resolve --flush-caches
|
||||
|
||||
# Windows
|
||||
ipconfig /flushdns
|
||||
```
|
||||
3. Почекати 15-60 хвилин
|
||||
|
||||
### Проблема: Propagation занадто повільна
|
||||
**Рішення:**
|
||||
1. Зменшити TTL до 300 секунд (5 хвилин)
|
||||
2. Почекати старий TTL (якщо був 3600 - почекати годину)
|
||||
3. Використати публічні DNS (8.8.8.8, 1.1.1.1)
|
||||
|
||||
### Проблема: Subdomain не працює
|
||||
**Рішення:**
|
||||
1. Перевірити що створили запис саме для субдомену (app), а не для @ (root)
|
||||
2. Для Cloudflare: перевірити Proxy status (має бути DNS only для MVP)
|
||||
|
||||
---
|
||||
|
||||
## ✅ Pre-deployment Checklist
|
||||
|
||||
Перед запуском SSL/HTTPS налаштування:
|
||||
|
||||
- [ ] DNS A-запис для `daarion.space` створено
|
||||
- [ ] DNS A-запис для `app.daarion.space` створено
|
||||
- [ ] DNS propagated (перевірено через `dig` або онлайн tools)
|
||||
- [ ] Порти 80 та 443 відкриті на сервері
|
||||
- [ ] Firewall налаштований (ufw/iptables)
|
||||
- [ ] Сервер доступний через SSH
|
||||
- [ ] Docker та Docker Compose встановлені
|
||||
|
||||
---
|
||||
|
||||
## 📚 Наступні кроки
|
||||
|
||||
Після успішного налаштування DNS:
|
||||
|
||||
1. ➡️ **SSL/HTTPS Setup** (`docs/DEPLOY_SSL_SETUP.md`)
|
||||
2. ➡️ **Environment Configuration** (`docs/DEPLOY_ENV_CONFIG.md`)
|
||||
3. ➡️ **Database Migrations** (`docs/DEPLOY_MIGRATIONS.md`)
|
||||
4. ➡️ **Services Startup** (`docs/DEPLOY_SERVICES.md`)
|
||||
|
||||
---
|
||||
|
||||
**Статус:** ✅ DNS Setup Guide Complete
|
||||
**Версія:** 1.0.0
|
||||
**Дата:** 24 листопада 2025
|
||||
|
||||
Reference in New Issue
Block a user