Files
webmailserver/README_INSTALL.md

61 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🚀 AyrisMail - Hepsi Bir Arada Kurulum Rehberi
Bu proje, Mailcow sunucunuzdaki mailleri anlık olarak izleyen ve Telegram üzerinden bildirim gönderen akıllı bir bildirim sistemidir.
## 📦 Sistem Bileşenleri
1. **Next.js Web Paneli:** Mailbox eşleşmelerini ve bildirim loglarını yönettiğiniz arayüz.
2. **PostgreSQL:** Tüm kullanıcı ve log verilerinin saklandığı veritabanı.
3. **Ayris Worker:** Sunucu seviyesinde mailleri anlık çözen ve Next.js'e sinyal atan motor.
---
## 🛠️ Kurulum Adımları
### 1. Dosya Yapısını Hazırlayın
Projeyi şu klasör yapısında olacak şekilde sunucunuza yerleştirin:
```text
/ayris-project
├── mailserver/ # Bu repo (Next.js)
├── ayristech-worker/ # Worker repo
└── docker-compose.unified.yml
```
### 2. Çevre Değişkenlerini Ayarlayın
`mailserver` klasörü içindeki `.env` dosyasını şu değişkenlerle doldurun:
```env
# Veritabanı (Docker içinde otomatik bağlanır)
DATABASE_URL="postgresql://postgres:ayris_pass_123@db:5432/ayrismail"
# Mailcow Bilgileri
MAILCOW_API_URL="https://mail.alanadiniz.com"
MAILCOW_API_KEY="your-api-key"
# Telegram
TELEGRAM_BOT_TOKEN="your-bot-token"
# Güvenlik
WEBHOOK_SIGNAL_SECRET="guclu-bir-sifre"
AUTH_SECRET="auth-secret-key"
NEXTAUTH_URL="http://localhost:3000"
```
### 3. Sistemi Başlatın
Terminalden ana dizine girin ve şu komutu çalıştırın:
```bash
docker compose -f docker-compose.unified.yml up -d --build
```
---
## 🔒 Güvenlik Notları
- `/var/run/docker.sock` dosyasının bağlanması, Worker'ın Dovecot konteynerine komut göndermesini sağlar.
- `WEBHOOK_SIGNAL_SECRET` bilgisinin hem `.env` hem de Worker konfigürasyonunda aynı olduğundan emin olun.
## 📝 Kullanım
1. `http://sunucu-ip:3000` adresinden panele giriş yapın.
2. Kullanıcı oluşturun ve Telegram ID'sini girin.
3. Mailbox Mapping kısmından hangi mailin kime gideceğini tanımlayın.
4. Worker mailleri yakaladıkça bildirimler anında Telegram'a düşecektir.