Erişim
Web arayüzü: https://<SERVER_IP>
API uç noktası: https://<SERVER_IP>:5004
Varsayılan yönetici kimlik bilgileri:
- E-posta:
[email protected] - Şifre:
1234
İlk girişin hemen ardından yönetici kimlik bilgilerini değiştirin.
Kendinden İmzalı Sertifika Bildirimi
Bu kurulum, kendinden imzalı bir TLS sertifikası kullanır.
Tarayıcıda bir SSL uyarısı görmeniz normaldir.
Şunu kullanan API çağrıları için curl, sertifika doğrulamasını devre dışı bırakmanız gerekir:
curl -k https://<SERVER_IP>:5004
Bu -k flag, curl'ün TLS sertifika doğrulamasını atlamasını sağlar.
API token almak için örnek:
curl -k https://<SERVER_IP>:5004/api/v1/auth/login
-H "Content-Type: application/json"
-d '{"email":"[email protected]","password":"1234"}'
Bu istek, bir token içeren JSON yanıtı döndürür.
API token almak için örnek:
curl -k -i https://<SERVER_IP>:5004/api/v1/<VALID_ENDPOINT>
-H "Authorization: Bearer <TOKEN>"
Üretim ortamlarında, kendinden imzalı sertifikayı güvenilir bir SSL sertifikasıyla değiştirin (örneğin Let's Encrypt).
Önemli Dosyalar ve Dizinler
- Kurulum dizini:
/root/peppermint - Ortam değişkenleri (DB kimlik bilgileri, gizli anahtarlar, BASE_URL):
/root/peppermint/.env - Docker Compose yapılandırması:
/root/peppermint/docker-compose.yml - PostgreSQL kalıcı verisi (Docker volume):
/var/lib/docker/volumes/pgdata/_data - Nginx ters proxy yapılandırmaları:
/etc/nginx/conf.d/peppermint-client.conf&/etc/nginx/conf.d/peppermint-api.conf - TLS sertifikaları (kendinden imzalı veya Let's Encrypt):
/etc/nginx/ssl/
Bir Alan Adı ile SSL Etkinleştirme
1. Alan adını sunucu IP'sine yönlendir.
2. Düzenle /root/peppermint/.env dosyasını açarak alan adınızı ayarlayın: BASE_URL=https://your.domain.com
3. Servisleri yeniden oluşturun:
cd /root/peppermint/
docker compose up -d
4. Nginx yapılandırmalarını düzenleyin ve değiştirin server_name <IP>; alan adın ile (<your-domain>) hem HTTP (port 80) hem HTTPS (port 443) blokları için:
vim /etc/nginx/conf.d/peppermint-client.conf
vim /etc/nginx/conf.d/peppermint-api.conf
5. Certbot'u yükleyin:
apt install -y certbot python3-certbot-nginx
6. Geçerli bir Let's Encrypt sertifikası oluşturmak için aşağıdaki komutu çalıştır:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
7. Nginx yapılandırmasındaki SSL yollarını değiştir (TLS bölümü):
vim /etc/nginx/conf.d/peppermint-client.conf
vim /etc/nginx/conf.d/peppermint-api.conf
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
8. Değişiklikleri uygulamak için Nginx'i yeniden başlatın:
systemctl restart nginx
9. Tarayıcını aç ve şu adresi ziyaret et: https://yourdomain.com
