Navigasyon
clmBot, iç ağ sunucunuzda dağıtılan hafif bir istemcidir; SSL sertifikalarının dağıtımını ve güncellenmesini otomatik olarak tamamlamak için kullanılır: buluttan en son sertifikayı alır, sunucudaki sertifika kurulum noktasına yazar ve yapılandırmaya göre ara katman hizmetini yeniden yüklemek için betiği çalıştırır.
Çalışma Şekli
clmBot'un sertifika güncelleme süreci şu şekildedir:
- Sertifika süresi dolmadan önce bulut otomatik olarak sertifika yeniden imzalamasını tamamlar ve yeni bir sertifika oluşturur.
- clmBot, bulut anında iletimi veya zamanlanmış çekme yoluyla en son sertifikayı alır.
- clmBot, sunucudaki yerel sertifika dosyalarını yedeklemeyi ve değiştirmeyi dener; yedekleme başarısız olursa hata kaydedilir ancak sonraki güncellemeyi engellemez.
- clmBot, yapılandırmaya göre yeniden yükleme betiğini çalıştırır (
after_script); etkili olup olmadığı, betiğin çalışma sonucuna ve ara katman durumuna bağlıdır.
Tüm süreç boyunca sertifika değiştirmek için sunucuya manuel olarak giriş yapmanız gerekmez ve sunucunun yönetim girişi dışarıya açılmaz.
Desteklenen Güncelleme Yöntemleri
clmBot iki sertifika güncelleme yöntemini destekler; farklı sunucularda ayrı ayrı seçilebilir:
| Güncelleme yöntemi | Çalışma modu | Port gereksinimi | Uygun senaryo |
|---|---|---|---|
| Bulut anında iletimi | Yönetim arka panelinden iletim başlatılır, sunucudaki clmBot hizmeti alır ve sertifikayı günceller | 8862/tcp gelen portunun açılması gerekir | Ağ politikası gelen portu açmaya izin veriyorsa, güncellemenin anında etkili olması isteniyorsa |
| Zamanlanmış çekme | crontab veya Windows zamanlanmış görev aracılığıyla clmBot zamanlanmış olarak çalıştırılır, en son sertifikayı kontrol eder ve çeker | Gelen portun açılması gerekmez, yalnızca buluta giden erişim gerekir | Gelen portun açılamadığı sunucular (önerilen varsayılan yöntem) |
Ayrıntılı yapılandırma yöntemleri için bkz. Sertifika güncelleme yöntemleri.
Desteklenen Platformlar ve Ara Katmanlar
Desteklenen işletim sistemleri:
- Linux (amd64, arm64)
- macOS (amd64, arm64)
- Windows (amd64; eski Windows için legacy uyumluluk paketi)
Desteklenen ara katmanlar ve sertifika biçimleri:
| Ara katman | Sertifika biçimi | Açıklama |
|---|---|---|
| nginx | PEM | Sertifika, CA zinciri, özel anahtar ayrı dağıtım |
| Apache HTTP Server | PEM | Sertifika, CA zinciri, özel anahtar ayrı dağıtım |
| Tomcat | PEM / JKS | PEM sertifikasını veya JKS keystore'u destekler |
| IIS | IIS | Yerleşik betik aracılığıyla PFX içe aktarılır ve site bağlaması güncellenir, yönetici yetkisi gerekir |
| Exchange | Exchange | Yalnızca güncelleme desteklenir; keşif, sorgulama veya sync-server desteklenmez, yönetici yetkisi gerekir |
| Diğer (özel betik) | PFX vb. | Özel after_script aracılığıyla her türlü senaryo desteklenir |
Doküman Nasıl Seçilir
| Kullanım senaryosu | Önerilen sayfa |
|---|---|
| İlk kez kullanım, hızlı dağıtım ve tek seferlik sertifika güncellemesi yapılmak isteniyor | Hızlı başlangıç |
| İki güncelleme yönteminin ayrıntılı yapılandırması hakkında bilgi edinmek | Sertifika güncelleme yöntemleri |
| Kurulum noktalarını manuel eklemek, arka panelden kurulum noktalarını senkronize etmek, yerel Web yapılandırma sayfasını kullanmak | Kurulum noktası yönetimi |
| config.yaml alan anlamlarını ve script şablon değişkenlerini görüntüleme | Yapılandırma Referansı |
| nginx, Apache, Tomcat gibi ara katmanlarda sertifika kurulumu ve yeniden yükleme komut örneklerini görüntüleme | Yapılandırma Örnekleri |
| Üretim ortamında clmBot çalıştırma izinlerini kısıtlama ve sudoers yapılandırma | Çalıştırma İzin Gereksinimleri |
| clmBot'u sistem hizmeti olarak kaydetme, sürüm yükseltme ve günlükleri görüntüleme | Hizmetleştirme Dağıtımı ve Yükseltme |
Hızlı Başlangıç
clmBot'u ilk kez kullanıyorsanız, aşağıdaki yolu izlemeniz önerilir:
- Yönetim panelinde AccessKey / AccessSecret oluşturun.
- clmBot'u indirin ve sunucuya yükleyin.
loginkomutunu çalıştırarak bağlantıyı tamamlayın ve paneldeki düğümü etkinleştirin.discover-certificatekomutunu çalıştırarak sunucudaki sertifikaları otomatik olarak keşfedin.- Güncelleme yöntemini yapılandırın (anında gönderim veya zamanlanmış çekme).
Tam adımlar için bkz. Hızlı Başlangıç。