Docker bilan bir nechta xizmatni bitta serverda ishga tushirganda, har biriga SSL sertifikat olish va uni yangilab turish tezda charchatadigan ishga aylanadi. Traefik bu jarayonni butunlay avtomatlashtiradi: u Docker'dagi konteynerlarni o'zi kuzatadi, ularning yorliqlaridan qaysi domen qaysi konteynerga tegishli ekanini o'qiydi va Let's Encrypt'dan sertifikatni o'zi olib, o'zi yangilaydi. Ushbu maqolada Traefik 3 bilan ishlaydigan to'liq sozlamani bosqichma-bosqich ko'rib chiqamiz.
Traefik qanday ishlaydi
Traefik teskari proksi, ya'ni internetdan kelgan so'rovlarni qabul qilib, ularni kerakli konteynerga yo'naltiruvchi xizmat. Uning Nginx'dan asosiy farqi konfiguratsiyani qayerdan olishida. Traefik Docker soketi orqali konteynerlar ro'yxatini kuzatadi, va yangi konteyner ishga tushishi bilan uning labels bo'limini o'qiydi. Yorliqlarda marshrut qoidasi, masalan, qaysi domen nomi, qaysi kirish nuqtasi va qaysi sertifikat beruvchi ishlatilishi yoziladi.
Sertifikatlar uchun Traefik'da certificate resolver tushunchasi bor. Bu ACME protokoli bo'yicha sertifikat olish usuli: qaysi markaz, qaysi tekshiruv turi va sertifikatlar qaysi faylda saqlanishi.
Tayyorgarlik: domen va portlar
Boshlashdan oldin ikkita shart bajarilgan bo'lishi kerak. Birinchidan, xizmatlar uchun ishlatiladigan barcha nomlar, masalan, example.uz va www.example.uz, DNS'da serveringiz IP manziliga ishora qilishi lozim. Ikkinchidan, serverda 80 va 443 portlar ochiq bo'lishi va ularni boshqa dastur, masalan, ilgari o'rnatilgan Nginx egallab turmasligi kerak. HTTP tekshiruvi aynan 80-port orqali o'tadi, shuning uchun uni xavfsizlik devorida yopib qo'ysangiz, sertifikat chiqmaydi. sayt.uz'da ro'yxatdan o'tgan domenlar uchun A yozuvlarini kabinetdagi DNS bo'limidan qo'shish mumkin.
To'liq docker-compose.yml
Quyidagi faylda ikkita xizmat bor: Traefik'ning o'zi va oddiy veb-sayt sifatida nginx:alpine konteyneri. Traefik ikkita kirish nuqtasini ochadi: web 80-portda va websecure 443-portda. HTTP'dan kelgan barcha so'rovlar avtomatik ravishda HTTPS'ga yo'naltiriladi, le nomli resolver esa sertifikatlarni HTTP tekshiruvi 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 nechta muhim tafsilotga e'tibor bering. exposedbydefault=false parametri tufayli Traefik faqat traefik.enable=true yorlig'i bor konteynerlarni internetga chiqaradi, bu esa ichki ma'lumotlar bazasi kabi xizmatlarning tasodifan ochilib qolishining oldini oladi. loadbalancer.server.port konteyner ichidagi portni ko'rsatadi, uni hostga ochish, ya'ni ports bo'limiga yozish shart emas.
Ishga tushirish uchun sertifikatlar papkasini yarating va Compose'ni ishga tushiring. Birinchi so'rovdan keyin bir necha soniya ichida sertifikat olinadi, jarayonni loglarda kuzatish mumkin.
mkdir -p letsencrypt
docker compose up -d
docker compose logs -f traefik
Avval sinov serverida tekshiring
Let's Encrypt'ning muvaffaqiyatsiz urinishlar bo'yicha cheklovlari bor, va DNS yoki port xatosi bilan ketma-ket qayta urinish sizni vaqtincha bloklashi mumkin. Shuning uchun yangi sozlamani avval staging, ya'ni sinov serverida tekshirish odatiy amaliyot hisoblanadi. Buning uchun Traefik buyruqlariga bitta qator qo'shiladi:
- --certificatesresolvers.le.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory
Sinov sertifikati brauzerda ishonchsiz deb ko'rinadi, bu normal holat. Hammasi ishlayotganiga ishonch hosil qilgach, bu qatorni olib tashlang, letsencrypt/acme.json faylini o'chiring va konteynerni qayta ishga tushiring. Aks holda Traefik saqlangan sinov sertifikatlarini ishlatishda davom etadi.
Amaliy misol: o'quv markazining sayti va CRM tizimi
Namangandagi xususiy o'quv markazi VPS'da Docker yordamida ikkita xizmat yuritadi: misol.uz manzilidagi ochiq sayt va crm.misol.uz manzilidagi o'quvchilar hisobini yurituvchi ichki tizim. Avval har bir xizmat uchun alohida Nginx sozlamasi va Certbot buyrug'i yozilgan, va bir marta CRM sertifikati yangilanmay qolib, menejerlar ertalab tizimga kira olmagan edi. Traefik'ga o'tgandan keyin CRM uchun faqat quyidagi blok yozildi, va sertifikat konteyner birinchi marta ishga tushgandayoq 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
Shundan beri yangi xizmat qo'shish besh daqiqalik ishga aylandi: konteynerga to'rtta yorliq yoziladi va docker compose up -d bajariladi.
Wildcard sertifikat va DNS tekshiruvi
Agar ko'p subdomenli tizim uchun *.example.uz ko'rinishidagi wildcard sertifikat kerak bo'lsa, HTTP tekshiruvi yetarli emas, chunki Let's Encrypt wildcard'ni faqat DNS-01 orqali beradi. Traefik DNS tekshiruvini qo'llab-quvvatlaydi, lekin buning uchun DNS provayderingiz API'ga ega bo'lishi va Traefik qo'llab-quvvatlaydigan provayderlar ro'yxatida turishi kerak.
Xavfsizlik: Docker soketi va acme.json
Traefik konteynerlarni ko'rishi uchun Docker soketi ulanadi, va bu jiddiy mas'uliyat. Soketga kirish huquqiga ega jarayon amalda server ustidan root darajasidagi nazoratga ega bo'ladi, :ro belgisi esa API so'rovlarini cheklamaydi. Shuning uchun Traefik'ning boshqaruv paneli, ya'ni dashboard'ni parolsiz internetga ochmang va iloji bo'lsa, soketga to'g'ridan-to'g'ri emas, faqat o'qish so'rovlarini o'tkazuvchi soket-proksi orqali ulaning. acme.json faylida esa barcha sertifikatlarning yopiq kalitlari saqlanadi, uni zaxira nusxalarga qo'shing, lekin ochiq repozitoriyga hech qachon joylamang.
Natijani tekshirish
Sertifikat chiqmasa, birinchi navbatda Traefik loglaridagi ACME bilan bog'liq xabarlarni o'qing: ular odatda DNS noto'g'ri ekanini, 80-port yopiqligini yoki limitga urilganingizni aniq ko'rsatadi. Sertifikat olingach, uning beruvchisi va muddatini openssl bilan tekshiring.
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