Docker bilan bir neçta xizmatni bitta serverda işga tuşirganda, har biriga SSL sertifikat oliş va uni yangilab turiş tezda çarçatadigan işga aylanadi. Traefik bu jarayonni butunlay avtomatlaştiradi: u Docker'dagi konteynerlarni özi kuzatadi, ularning yorliqlaridan qaysi domen qaysi konteynerga tegişli ekanini öqiydi va Let's Encrypt'dan sertifikatni özi olib, özi yangilaydi. Uşbu maqolada Traefik 3 bilan işlaydigan töliq sozlamani bosqiçma-bosqiç körib çiqamiz.
Traefik qanday işlaydi
Traefik teskari proksi, ya'ni internetdan kelgan sörovlarni qabul qilib, ularni kerakli konteynerga yönaltiruvçi xizmat. Uning Nginx'dan asosiy farqi konfiguratsiyani qayerdan olişida. Traefik Docker soketi orqali konteynerlar röyxatini kuzatadi, va yangi konteyner işga tuşişi bilan uning labels bölimini öqiydi. Yorliqlarda marşrut qoidasi, masalan, qaysi domen nomi, qaysi kiriş nuqtasi va qaysi sertifikat beruvçi işlatilişi yoziladi.
Sertifikatlar uçun Traefik'da certificate resolver tuşunçasi bor. Bu ACME protokoli böyiça sertifikat oliş usuli: qaysi markaz, qaysi tekşiruv turi va sertifikatlar qaysi faylda saqlanişi.
Tayyorgarlik: domen va portlar
Boşlaşdan oldin ikkita şart bajarilgan bölişi kerak. Birinçidan, xizmatlar uçun işlatiladigan barça nomlar, masalan, example.uz va www.example.uz, DNS'da serveringiz IP manziliga işora qilişi lozim. Ikkinçidan, serverda 80 va 443 portlar oçiq bölişi va ularni boşqa dastur, masalan, ilgari örnatilgan Nginx egallab turmasligi kerak. HTTP tekşiruvi aynan 80-port orqali ötadi, şuning uçun uni xavfsizlik devorida yopib qöysangiz, sertifikat çiqmaydi. sayt.uz'da röyxatdan ötgan domenlar uçun A yozuvlarini kabinetdagi DNS bölimidan qöşiş mumkin.
Töliq docker-compose.yml
Quyidagi faylda ikkita xizmat bor: Traefik'ning özi va oddiy veb-sayt sifatida nginx:alpine konteyneri. Traefik ikkita kiriş nuqtasini oçadi: web 80-portda va websecure 443-portda. HTTP'dan kelgan barça sörovlar avtomatik ravişda HTTPS'ga yönaltiriladi, le nomli resolver esa sertifikatlarni HTTP tekşiruvi orqali oladi va acme.json faylida saqlaydi.
services:
traefik:
image: traefik:v3
command:
- --providers.docker=true
- --providers.docker.exposedbydefault=false
- --entrypoints.web.address=:80
- --entrypoints.websecure.address=:443
- --entrypoints.web.http.redirections.entrypoint.to=websecure
- --entrypoints.web.http.redirections.entrypoint.scheme=https
- --certificatesresolvers.le.acme.email=admin@example.uz
- --certificatesresolvers.le.acme.storage=/letsencrypt/acme.json
- --certificatesresolvers.le.acme.httpchallenge.entrypoint=web
ports:
- "80:80"
- "443:443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./letsencrypt:/letsencrypt
restart: unless-stopped
site:
image: nginx:alpine
labels:
- traefik.enable=true
- traefik.http.routers.site.rule=Host(`example.uz`) || Host(`www.example.uz`)
- traefik.http.routers.site.entrypoints=websecure
- traefik.http.routers.site.tls.certresolver=le
- traefik.http.services.site.loadbalancer.server.port=80
restart: unless-stopped
Bir neçta muhim tafsilotga e'tibor bering. exposedbydefault=false parametri tufayli Traefik faqat traefik.enable=true yorliği bor konteynerlarni internetga çiqaradi, bu esa içki ma'lumotlar bazasi kabi xizmatlarning tasodifan oçilib qolişining oldini oladi. loadbalancer.server.port konteyner içidagi portni körsatadi, uni hostga oçiş, ya'ni ports bölimiga yoziş şart emas.
Işga tuşiriş uçun sertifikatlar papkasini yarating va Compose'ni işga tuşiring. Birinçi sörovdan keyin bir neça soniya içida sertifikat olinadi, jarayonni loglarda kuzatiş mumkin.
mkdir -p letsencrypt
docker compose up -d
docker compose logs -f traefik
Avval sinov serverida tekşiring
Let's Encrypt'ning muvaffaqiyatsiz urinişlar böyiça çeklovlari bor, va DNS yoki port xatosi bilan ketma-ket qayta uriniş sizni vaqtinça bloklaşi mumkin. Şuning uçun yangi sozlamani avval staging, ya'ni sinov serverida tekşiriş odatiy amaliyot hisoblanadi. Buning uçun Traefik buyruqlariga bitta qator qöşiladi:
- --certificatesresolvers.le.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory
Sinov sertifikati brauzerda işonçsiz deb körinadi, bu normal holat. Hammasi işlayotganiga işonç hosil qilgaç, bu qatorni olib taşlang, letsencrypt/acme.json faylini öçiring va konteynerni qayta işga tuşiring. Aks holda Traefik saqlangan sinov sertifikatlarini işlatişda davom etadi.
Amaliy misol: öquv markazining sayti va CRM tizimi
Namangandagi xususiy öquv markazi VPS'da Docker yordamida ikkita xizmat yuritadi: misol.uz manzilidagi oçiq sayt va crm.misol.uz manzilidagi öquvçilar hisobini yurituvçi içki tizim. Avval har bir xizmat uçun alohida Nginx sozlamasi va Certbot buyruği yozilgan, va bir marta CRM sertifikati yangilanmay qolib, menejerlar ertalab tizimga kira olmagan edi. Traefik'ga ötgandan keyin CRM uçun faqat quyidagi blok yozildi, va sertifikat konteyner birinçi marta işga tuşgandayoq avtomatik olindi:
crm:
image: misol/crm:latest
labels:
- traefik.enable=true
- traefik.http.routers.crm.rule=Host(`crm.misol.uz`)
- traefik.http.routers.crm.entrypoints=websecure
- traefik.http.routers.crm.tls.certresolver=le
- traefik.http.services.crm.loadbalancer.server.port=3000
restart: unless-stopped
Şundan beri yangi xizmat qöşiş beş daqiqalik işga aylandi: konteynerga törtta yorliq yoziladi va docker compose up -d bajariladi.
Wildcard sertifikat va DNS tekşiruvi
Agar köp subdomenli tizim uçun *.example.uz körinişidagi wildcard sertifikat kerak bölsa, HTTP tekşiruvi yetarli emas, çunki Let's Encrypt wildcard'ni faqat DNS-01 orqali beradi. Traefik DNS tekşiruvini qöllab-quvvatlaydi, lekin buning uçun DNS provayderingiz API'ga ega bölişi va Traefik qöllab-quvvatlaydigan provayderlar röyxatida turişi kerak.
Xavfsizlik: Docker soketi va acme.json
Traefik konteynerlarni körişi uçun Docker soketi ulanadi, va bu jiddiy mas'uliyat. Soketga kiriş huquqiga ega jarayon amalda server ustidan root darajasidagi nazoratga ega böladi, :ro belgisi esa API sörovlarini çeklamaydi. Şuning uçun Traefik'ning boşqaruv paneli, ya'ni daşboard'ni parolsiz internetga oçmang va iloji bölsa, soketga töğridan-töğri emas, faqat öqiş sörovlarini ötkazuvçi soket-proksi orqali ulaning. acme.json faylida esa barça sertifikatlarning yopiq kalitlari saqlanadi, uni zaxira nusxalarga qöşing, lekin oçiq repozitoriyga heç qaçon joylamang.
Natijani tekşiriş
Sertifikat çiqmasa, birinçi navbatda Traefik loglaridagi ACME bilan boğliq xabarlarni öqing: ular odatda DNS notöğri ekanini, 80-port yopiqligini yoki limitga urilganingizni aniq körsatadi. Sertifikat olingaç, uning beruvçisi va muddatini openssl bilan tekşiring.
docker compose logs traefik 2>&1 | grep -i acme
openssl s_client -connect example.uz:443 -servername example.uz </dev/null 2>/dev/null \
| openssl x509 -noout -subject -issuer -dates