Add chatbot infrastructure documentation
Document Flowise and ngrok configuration on LXC 104, including troubleshooting steps for CORS and version issues. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
141
chatbot/infrastructura.md
Normal file
141
chatbot/infrastructura.md
Normal file
@@ -0,0 +1,141 @@
|
|||||||
|
# Infrastructura Chatbot Maria
|
||||||
|
|
||||||
|
## Componente
|
||||||
|
|
||||||
|
| Componenta | Locație | IP | Port |
|
||||||
|
|------------|---------|-----|------|
|
||||||
|
| Flowise | LXC 104 | 10.0.20.161 | 3000 |
|
||||||
|
| ngrok tunnel | LXC 104 | 10.0.20.161 | - |
|
||||||
|
| Pagina chatbot | romfast.ro | - | 443 |
|
||||||
|
|
||||||
|
## Configurare Flowise
|
||||||
|
|
||||||
|
**Serviciu systemd**: `/etc/systemd/system/flowise.service`
|
||||||
|
|
||||||
|
```ini
|
||||||
|
[Unit]
|
||||||
|
Description=Flowise Service
|
||||||
|
After=network.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
User=root
|
||||||
|
Group=root
|
||||||
|
ExecStart=/usr/bin/npx flowise start
|
||||||
|
Restart=always
|
||||||
|
Environment=PORT=3000
|
||||||
|
Environment=FLOWISE_USERNAME=admin
|
||||||
|
Environment=FLOWISE_PASSWORD=parola28
|
||||||
|
Environment=CORS_ORIGINS=https://www.romfast.ro,https://romfast.ro
|
||||||
|
WorkingDirectory=/root/.flowise
|
||||||
|
Environment=FLOWISE_DATABASE_PATH=/root/.flowise/database.sqlite
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
```
|
||||||
|
|
||||||
|
**Comenzi utile**:
|
||||||
|
```bash
|
||||||
|
# Status
|
||||||
|
pct exec 104 -- systemctl status flowise
|
||||||
|
|
||||||
|
# Restart
|
||||||
|
pct exec 104 -- systemctl restart flowise
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
pct exec 104 -- journalctl -u flowise -f
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configurare ngrok
|
||||||
|
|
||||||
|
**Configurare**: `/root/.config/ngrok/ngrok.yml`
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
version: "2"
|
||||||
|
authtoken: 2mo9quiDc23B6U3TtTqWJEleEfM_jYeD1KYe9u7njaaQMZg2
|
||||||
|
tunnels:
|
||||||
|
web:
|
||||||
|
proto: http
|
||||||
|
addr: http://10.0.20.161:3000
|
||||||
|
domain: mutual-special-koala.ngrok-free.app
|
||||||
|
```
|
||||||
|
|
||||||
|
**Serviciu systemd**: `/etc/systemd/system/ngrok.service`
|
||||||
|
|
||||||
|
**URL public**: https://mutual-special-koala.ngrok-free.app
|
||||||
|
|
||||||
|
**API endpoint chatbot**:
|
||||||
|
```
|
||||||
|
POST https://mutual-special-koala.ngrok-free.app/api/v1/prediction/d4911620-07fe-41f8-adb4-f2f52d6ec766
|
||||||
|
```
|
||||||
|
|
||||||
|
**Comenzi utile**:
|
||||||
|
```bash
|
||||||
|
# Status
|
||||||
|
pct exec 104 -- systemctl status ngrok
|
||||||
|
|
||||||
|
# Restart
|
||||||
|
pct exec 104 -- systemctl restart ngrok
|
||||||
|
|
||||||
|
# Verificare tunel activ
|
||||||
|
pct exec 104 -- curl -s http://localhost:4040/api/tunnels
|
||||||
|
|
||||||
|
# Verificare versiune
|
||||||
|
pct exec 104 -- /usr/local/bin/ngrok --version
|
||||||
|
|
||||||
|
# Actualizare ngrok
|
||||||
|
pct exec 104 -- /usr/local/bin/ngrok update
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Eroare CORS
|
||||||
|
**Simptom**: Browser-ul afișează eroare CORS când se încarcă chatbot-ul.
|
||||||
|
|
||||||
|
**Cauza**: Flowise nu are configurată variabila `CORS_ORIGINS`.
|
||||||
|
|
||||||
|
**Soluție**: Adaugă în `/etc/systemd/system/flowise.service`:
|
||||||
|
```
|
||||||
|
Environment=CORS_ORIGINS=https://www.romfast.ro,https://romfast.ro
|
||||||
|
```
|
||||||
|
Apoi: `systemctl daemon-reload && systemctl restart flowise`
|
||||||
|
|
||||||
|
### Eroare ngrok versiune veche (ERR_NGROK_121)
|
||||||
|
**Simptom**: În logs apare:
|
||||||
|
```
|
||||||
|
Your ngrok-agent version "3.16.0" is too old. The minimum supported agent version is "3.19.0"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Cauza**: ngrok a fost actualizat dar serviciul nu a fost restartat. Procesul vechi continuă să ruleze.
|
||||||
|
|
||||||
|
**Soluție**:
|
||||||
|
```bash
|
||||||
|
# Actualizare (dacă nu e deja făcută)
|
||||||
|
pct exec 104 -- /usr/local/bin/ngrok update
|
||||||
|
|
||||||
|
# IMPORTANT: Restart după actualizare
|
||||||
|
pct exec 104 -- systemctl restart ngrok
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verificare rapidă că totul funcționează
|
||||||
|
```bash
|
||||||
|
# Test local Flowise
|
||||||
|
pct exec 104 -- curl -s http://localhost:3000/ | head -5
|
||||||
|
|
||||||
|
# Test tunel ngrok
|
||||||
|
curl -s "https://mutual-special-koala.ngrok-free.app/api/v1/prediction/d4911620-07fe-41f8-adb4-f2f52d6ec766" \
|
||||||
|
-X POST -H "Content-Type: application/json" \
|
||||||
|
-d '{"question":"test"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Pagina web
|
||||||
|
|
||||||
|
URL: https://www.romfast.ro/chatbot_maria.html
|
||||||
|
|
||||||
|
Pagina încarcă widget-ul Flowise care se conectează la endpoint-ul ngrok.
|
||||||
|
|
||||||
|
## Istoric incidente
|
||||||
|
|
||||||
|
### 2025-12-30: Chatbot nu funcționa (CORS + ngrok versiune)
|
||||||
|
- **Problemă 1**: Flowise nu avea CORS configurat
|
||||||
|
- **Problemă 2**: ngrok rula versiunea 3.16.0 (actualizată dar nerestartat din octombrie)
|
||||||
|
- **Soluție**: Adăugat CORS_ORIGINS și restart la ambele servicii
|
||||||
Reference in New Issue
Block a user