# Nginx Proxy Manager - Site Configurations

Nginx site configurations สำหรับ handle subpath routing ของทุก service ใน Sriphat Data Platform

## 📋 Services และ Subpaths

| Service | Subpath | Backend | Port |
|---------|---------|---------|------|
| API Service | `/apiservice` | apiservice:8000 | 8040 |
| Supabase Studio | `/supabase` | sdp-studio:3000 | - |
| Supabase Kong API | `/supabase-api` | sdp-kong:8000 | - |
| Keycloak | `/keycloak` | keycloak:8080 | 8085 |
| Superset | `/superset` | superset:8088 | 8088 |
| Airflow | `/airflow` | airflow-webserver:8080 | - |
| DBT Docs | `/dbt` | dbt-docs:8080 | - |
| Dozzle | `/dozzle` | dozzle:8080 | 9999 |

## 🚀 การใช้งาน

### วิธีที่ 1: ใช้ Nginx Proxy Manager UI (แนะนำ)

1. เข้า Nginx Proxy Manager: `http://your-server:8021`
2. Login (default: admin@example.com / changeme)
3. ไปที่ **Proxy Hosts** → **Add Proxy Host**
4. กรอกข้อมูล:
   - **Domain Names**: `ai.sriphat.com` (หรือ domain ของคุณ)
   - **Scheme**: `http`
   - **Forward Hostname/IP**: ดูจากตารางด้านบน
   - **Forward Port**: ดูจากตารางด้านบน
5. ไปที่ tab **Advanced**
6. Copy config จากไฟล์ที่เกี่ยวข้อง (เช่น `apiservice.conf`) ไปวางใน **Custom Nginx Configuration**
7. กด **Save**

### วิธีที่ 2: Import Config Files โดยตรง

**⚠️ วิธีนี้ต้องการ access ไปยัง Nginx Proxy Manager data directory**

```bash
# 1. Copy config files ไปยัง Nginx Proxy Manager
cd /path/to/01-infra
docker cp nginx-configs/. nginx-proxy-manager:/data/nginx/custom/

# 2. Restart Nginx Proxy Manager
docker restart nginx-proxy-manager

# 3. ตรวจสอบ logs
docker logs nginx-proxy-manager -f
```

## 📝 Config Files

### `apiservice.conf`
FastAPI service with Keycloak authentication
- Handles `/apiservice/*` paths
- Preserves session cookies
- WebSocket support

### `supabase-studio.conf`
Supabase Studio UI
- Handles `/supabase/*` paths
- Rewrites paths for Studio

### `supabase-kong.conf`
Supabase REST API (Kong Gateway)
- Handles `/supabase-api/*` paths
- API key authentication

### `keycloak.conf`
Keycloak SSO
- Handles `/keycloak/*` paths
- Preserves authentication headers

### `superset.conf`
Apache Superset BI
- Handles `/superset/*` paths
- Session management

### `airflow.conf`
Apache Airflow (if deployed)
- Handles `/airflow/*` paths
- WebServer UI

### `dbt.conf`
DBT Documentation (if deployed)
- Handles `/dbt/*` paths
- Static documentation

## 🔧 การปรับแต่ง

### เปลี่ยน Domain
แก้ไข `server_name` ในแต่ละ config file:
```nginx
server_name ai.sriphat.com;  # เปลี่ยนเป็น domain ของคุณ
```

### เปลี่ยน Backend Host/Port
แก้ไข `proxy_pass` directive:
```nginx
proxy_pass http://apiservice:8000;  # เปลี่ยนตาม service ของคุณ
```

### เพิ่ม SSL/HTTPS
ใช้ Nginx Proxy Manager UI:
1. ไปที่ Proxy Host ที่ต้องการ
2. ไปที่ tab **SSL**
3. เลือก **Request a new SSL Certificate**
4. เลือก **Force SSL**

## 🐛 Troubleshooting

### 502 Bad Gateway
- ตรวจสอบว่า backend service ทำงานอยู่: `docker ps`
- ตรวจสอบ network: `docker network inspect shared_data_network`
- ดู logs: `docker logs <service-name>`

### 404 Not Found
- ตรวจสอบ path rewriting ใน config
- ดู nginx logs: `docker logs nginx-proxy-manager`

### Session/Cookie Issues
- ตรวจสอบ `proxy_cookie_path` directive
- ตรวจสอบ `X-Forwarded-*` headers

### WebSocket Connection Failed
- ตรวจสอบว่ามี WebSocket headers:
  ```nginx
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  ```

## 📚 เอกสารเพิ่มเติม

- [Nginx Proxy Manager Documentation](https://nginxproxymanager.com/guide/)
- [Nginx Reverse Proxy Guide](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/)
- [Nginx Subpath Configuration](https://www.nginx.com/blog/creating-nginx-rewrite-rules/)

## 🔐 Security Notes

1. **ใช้ HTTPS ใน Production** - Request SSL certificate ผ่าน Nginx Proxy Manager
2. **ตั้งค่า Access Lists** - จำกัดการเข้าถึงบาง services (เช่น Keycloak Admin)
3. **Enable Rate Limiting** - ป้องกัน DDoS attacks
4. **Update Regularly** - อัพเดท Nginx Proxy Manager เป็นประจำ

## 📞 Support

หากมีปัญหาหรือข้อสงสัย:
1. ตรวจสอบ logs: `docker logs nginx-proxy-manager -f`
2. ดู Nginx Proxy Manager UI → **Logs**
3. ตรวจสอบ backend service logs