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 oturum açmanın ardından yönetici kimlik bilgilerini hemen değiştirin.
Kendinden İmzalı Sertifika Bildirimi
Bu kurulumda kendinden imzalı bir TLS sertifikası kullanılır.
Bir tarayıcı SSL uyarısı bekleniyor.
Kullanarak API çağrıları için curl, sertifika doğrulamasını yoksaymalısınız:
curl -k https://<SERVER_IP>:5004
The -k flag, curl'a TLS sertifika doğrulamasını atlamasını söyler.
API jetonunu elde etmek 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, bir belirteç içeren bir JSON yanıtı döndürür.
API jetonunu elde etmek için örnek:
curl -k -i https://<SERVER_IP>:5004/api/v1/<VALID_ENDPOINT>
-H "Authorization: Bearer <TOKEN>"
Üretim ortamları için kendinden imzalı sertifikayı güvenilir bir SSL sertifikasıyla değiştirin (ör. Let's Encrypt).
Önemli Dosyalar ve Dizinler
- Kurulum dizini:
/root/peppermint - Ortam değişkenleri (DB kimlik bilgileri, sırlar, BASE_URL):
/root/peppermint/.env - Docker Compose yapılandırması:
/root/peppermint/docker-compose.yml - PostgreSQL kalıcı verileri (Docker birimi):
/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üzenleyin /root/peppermint/.env Alan adınızı ayarlamak için dosya: BASE_URL=https://your.domain.com
3. Hizmetleri 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
