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
- Yükleme 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ıyla SSL Etkinleştirme
1. Alan adınızı sunucu IP adresine yönlendirin.
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ızla (<your-domain>) hem HTTP (port 80) hem de 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ın:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
7. Nginx yapılandırmasındaki SSL yollarını değiştirin (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ızı açın ve şu adresi ziyaret edin: https://yourdomain.com
