نکات کلیدی
- برای صدور گواهی بدون استفاده از پورت 80، از چالش DNS‑01 بهره می بریم؛ این روش با ایجاد رکورد TXT در سرویس DNS، مالکیت دامنه را تأیید می کند.
- acme.sh با چالش DNS‑01 امکان صدور گواهی Wildcard بدون باز کردن پورت 80 را فراهم می کند.
- حالت DNS persist: یک TXT ماندگار ایجاد می شود و تمدید بدون ویرایش DNS انجام می گیرد؛ شرط پشتیبانی مرجع از `dns-persist-01` است.
مقدمه
acme.sh یک اسکریپت پوستهای است که با پروتکل ACME گواهیهای SSL را صادر میکند. از نسخهٔ 3.0، در صورت عدم تعیین مرجع، پیشفرضی ZeroSSL میباشد. برای صدور گواهی بدون استفاده از پورت 80، از چالش DNS‑01 بهره میبریم؛ این روش با ایجاد رکورد TXT در سرویس DNS، مالکیت دامنه را تأیید میکند.
نکات کلیدی
- گواهی Wildcard میتواند بدون باز کردن هیچ پورت ورودی صادر شود.
- پس از نصب، تمام تنظیمات (ایمیل، توکن، کلید خصوصی) در پوشهٔ `~/.acme.sh` ذخیره میشوند و در تمدیدهای بعدی دوباره خوانده میشوند.
- برای جلوگیری از خطای مجوز در cron، نصب اسکریپت را با دسترسی root انجام دهید و پس از نصب، ترمینال را باز کنید تا alias فعال شود.
نصب و تنظیم اولیه
- کپی اسکریپت
“`bash curl | sh “`
- تعیین مرجع پیشفرض
“`bash acme.sh –set-default-ca –server zerossl “`
- محدود کردن توکن به یک zone
“`bash acme.sh –set-default-ca –server zerossl –dns <provider> –dns-01-token <token> “`
- تعیین ایمیل حساب
“`bash acme.sh –set-account-email <email> “`
صدور گواهی Wildcard
acme.sh –issue -d *.example.com –dns <provider> –server zerossl
پس از صدور، گواهی را به Nginx نصب کنید:
acme.sh –install-cert -d *.example.com \ –cert-file /etc/nginx/ssl/example.com.crt \ –key-file /etc/nginx/ssl/example.com.key \ –reloadcmd “systemctl reload nginx”
ساختار پوشه `~/.acme.sh`
| مسیر | توضیح |
|---|---|
| `~/.acme.sh/account.conf` | تنظیمات حساب (ایمیل، توکن) |
| `~/.acme.sh/ca/` | کلیدهای مرجع (مثلاً `zerossl`) |
| `~/.acme.sh/example.com/` | گواهیها و کلیدهای خصوصی |
| `~/.acme.sh/cron` | اسکریپت cron برای تمدید خودکار |
نکته: پس از هر تغییر در تنظیمات، ترمینال را باز کنید تا alias فعال شود و cron بتواند بهدرستی اجرا شود.
تغییر مرجع صدور گواهی
اگر بخواهید از مرجع دیگری مانند Let’s Encrypt استفاده کنید، کافی است:
acme.sh –set-default-ca –server letsencrypt
یا در فرمان صدور:
acme.sh –issue -d example.com –server letsencrypt
جمعبندی
acme.sh با چالش DNS‑01 امکان صدور گواهی Wildcard بدون باز کردن پورت 80 را فراهم میکند. تنظیمات در پوشهٔ `~/.acme.sh` ذخیره میشود و با cron بهصورت خودکار تمدید میشود. انتخاب مرجع پیشفرض و مدیریت کلیدهای DNS در این مسیر انجام میشود.
چالش DNS-01 و نقش API یا حالت alias در حل آن
در چالش DNS-01، سرویس صدور گواهینامه بهجای استفاده از پورت 80، رکورد TXT را در نام _acme‑challenge.<دامنه> میخواند. برای گواهی Wildcard نیز همان روش بهکار میرود؛ افزونههای dnsapi این رکورد را با فراخوانی API سرویس DNS ایجاد و پس از تأیید حذف میکنند.
توکن Cloudflare و انتشار گواهی Wildcard
برای Cloudflare، ویکی پیشنهاد میکند توکنی با دسترسی Zone > DNS > Edit در محدودهٔ زونهای مورد نیاز ایجاد کنید؛ این توکن را در بخش User API Tokens پروفایل Cloudflare خود بسازید. استفاده از کلید سراسری حساب نیز ممکن است، اما خطر نشت کل حساب را به همراه دارد. نمونهٔ مقادیر زیر را میتوانید بهعنوان راهنما ببینید:
پس از صدور موفق، اسکریپت acme.sh این مقادیر را در فایل account.conf ذخیره میکند تا در تمدیدهای بعدی دوباره خوانده شود. در ویکی اشاره شده است که این فایل در مسیر account.conf قرار دارد. کد dns_cf.sh یک نکتهٔ خاص دارد که در ویکی ذکر نشده است: با استفاده از متغیر CF_Zone_ID، توکن در فایل example.com.conf در پوشهٔ دامنه ذخیره میشود.
⚠️ توجه: فایل account.conf با مجوز 600 ساخته میشود؛ اگر مجوزهای دیگری مشاهده کردید، آن را بازگردانید. دسترسی خواندن این فایل یا پشتیبانگیری از آن، امکان تغییر رکوردهای زون شما را میدهد و Let’s Encrypt آن را بهعنوان خطرناک میداند.
حالت alias برای DNS بدون API
اگر سرویس DNS دامنهٔ اصلی API ندارد یا نمیخواهید توکن زون اصلی را روی سرور نگه دارید، میتوانید از حالت alias استفاده کنید. در این حالت، یک رکورد CNAME ثابت از _acme‑challenge دامنهٔ اصلی به دامنهٔ ثانویهای که API دارد، ایجاد میشود. این رکورد در پنل DNS دامنهٔ اصلی ثبت میشود و در کنار رکوردهای دیگر قرار میگیرد. فرمان زیر را روی سرور اجرا کنید؛ توکن باید دسترسی Edit به زون دامنهٔ دوم داشته باشد:
☁️ ایجاد یک CNAME به جای رکورد TXT
توکن بر روی سرور فقط به دامنهٔ دوم دسترسی دارد و تمدید بدون دستزدن به DNS اصلی امکانپذیر است. مستندات Let’s Encrypt نیز امکان واگذاری پاسخ چالش با CNAME را تأیید میکنند.
حالت persist و حالت دستی برای DNS بدون API
برای دامنهای که API ندارد اما شما زون آن را بهصورت دستی ویرایش میکنید، ویکی dns‑manual‑mode ابتدا حالت DNS persist را پیشنهاد میکند. در این حالت، یک رکورد TXT ماندگار در _validation‑persist.example.com یکبار ثبت میشود و تمدیدهای بعدی نیازی به ویرایش DNS ندارند. مقدار رکورد در خروجی فرمان اول چاپ میشود:
مقدار رکورد به حساب ACME شما (accounturi) وابسته است و اگر account.key گم شود، بیاثر میشود. برای گواهی Wildcard، گزینهٔ –dns‑persist‑wildcard را با پارامتر policy=wildcard اضافه کنید. این حالت بر اساس draft‑ietf‑acme‑dns‑persist‑01 پیادهسازی شده است و ویکی توصیه میکند قبل از استفاده، از پشتیبانی مرجع خود اطمینان حاصل کنید. اگر API و persist در دسترس نیستند، حالت دستی باقی میماند.
تمدید دستی و خودکار گواهیهای Let’s Encrypt
- حالت دستی تمدید نمیشود؛ چرا که در هر تمدید، رکورد TXT جدیدی باید در DNS ثبت گردد.
- برای استفاده از تمدید خودکار، باید از اسکریپت `acme.sh` و تنظیمات مناسب استفاده کنید.
نصب گواهی در وبسرور
- فرمان `–install-cert` کلید و زنجیره کامل را به مسیر دلخواه شما کپی میکند و دستور `reload` را برای تمدیدهای بعدی ذخیره میسازد.
- اسکریپت پوشه مقصد را ایجاد نمیکند؛ در سیستمهای Debian و Ubuntu، پوشهی `/etc/nginx/ssl` پیشفرض وجود ندارد؛ بنابراین در نشست root اول آن را بسازید.
- مسیرها و دستور `reload` در فایل پیکربندی وبسرور (`example.com.conf`) با نام `Le_ReloadCmd` و به صورت Base64 ذخیره میشوند.
- مستندات Nginx نیاز دارد کلید خصوصی در فایلی با دسترسی محدود قرار گیرد تا فرایند master بتواند آن را بخواند؛ گواهی میانی پس از گواهی اصلی در همان فایل قرار میگیرد؛ ترتیب `fullchain` نیز همینطور است.
- مهم: مسیر Nginx نباید به پوشه داخلی اسکریپت اشاره کند؛ فایل `ssl_certificate` باید به `fullchain.cer` داخل پوشه دامنه اشاره کند تا کار کند. README این فایلها را داخلی میداند و ممکن است در نسخههای بعدی مسیرشان تغییر کند.
زمانبندی و cron
- خطی که `acme.sh` هنگام نصب در cron قرار میدهد، میتوانید با دستور `crontab -l` مشاهده کنید.
- در نسخهی 3.1.7، زمان اجرا به صورت تصادفی در هر شش ساعت انتخاب میشود؛ تمدید هر 30 روز انجام میشود یا زودتر اگر مرجع از طریق ARI درخواست کند.
- در خروجی فرمان، متغیر `Le_NextRenewTimeStr` زمان بعدی تمدید را نشان میدهد.
وقتی سرویس DNS در فهرست `dnsapi` نیست
- حالت DNS persist: یک TXT ماندگار ایجاد میشود و تمدید بدون ویرایش DNS انجام میگیرد؛ شرط پشتیبانی مرجع از `dns-persist-01` است.
- حالت alias: انتقال nameserverها به سرویس با API.
- حالت دستی: آخرین گزینه؛ چون خودکار تمدید نمیشود.
افزونههای مخصوص سرویسهای DNS
- برای ArvanCloud، افزونه `dns_arvan` وجود دارد؛ کلید را از متغیر `Arvan_Token` میخواند و با `–dns dns_arvan` صدور میکند.
- برای Cloudflare، حداقل دسترسیهای `Zone > DNS > Edit` بر روی زونهای اعتبارسنجی لازم است؛ اگر فیلتر IP دارید، آدرس سرور نیز باید مجاز باشد.
تغییر پیشفرض سرور گواهی
- میتوانید با افزودن `–server letsencrypt` به فرمان `–issue`، گواهی از Let’s Encrypt دریافت کنید؛ پیشفرض فقط با `–set-default-ca` تغییر میکند.
نکات درباره DNS‑01
- برای چالش DNS‑01 نیازی به باز کردن پورت 80 نیست؛ Let’s Encrypt فقط برای HTTP‑01 این پورت را میخواهد.
- دسترسی خروجی به مرجع و API سرویس DNS ضروری است.
متوقف کردن تمدید خودکار
- با اجرای `–remove -d example.com` و برای گواهی ECC با `–ecc`، گواهی و کلید را از سیستم حذف میکنید؛ فایلهای کلید و گواهی بر روی دیسک باقی میمانند و پاکسازی دستی لازم است.
رفتار رکورد validation-persist بعد از نصب مجدد سرور
رکورد validation-persist تنها در صورتی که پوشه ~/.acme.sh و کلید حساب بازیابی شوند، کار خود را ادامه میدهد. در صورت استفاده از کلید حساب جدید، رکورد قبلی بیاثر شده و مقدار جدید با استفاده از –make-dns-persist-value ایجاد میشود. برای لغو مجوز، رکورد باید پاک شود.
جمعبندی و نکات مهم
حافظه acme.sh در دو فایل پیکربندی ایمیل حساب و مرجع پیشفرض در account.conf ذخیره میشود. توکن DNS نیز به جز در caso Cloudflare که شناسه zone داده میشود، کنار هاست قرار میگیرد. مسیرهای نصب و فرمان reload در فایل .conf پوشه دامنه ثبت میشوند و cron از روی همین مقدارها تمدید و کپی را تکرار میکند. برای حفظ امنیت، مجوز 600 را نگه دارید، توکن را محدود کنید یا با CNAME به دامنه دوم ببرید و nginx را فقط به مسیرهای –install-cert وصل کنید.
تداوم گواهی در صورت قطعی شبکه
کار cron هر شش ساعت سراغ مرجع میرود. در صورتی که به مرجع دسترسی وجود نداشته باشد، تاریخ انقضای گواهی باید پایش شود و یک راه جایگزین باید از قبل چیده شده باشد. برای جلوگیری از مشکلات، گواهی باید پیش از قطعی تمدید شود.
اسناد و منابع
- مخزن acmesh-official در GitHub برای متن README و کد
- صفحه dnsapi ویکی برای افزونههای DNS و متغیرهای Cloudflare
- صفحه DNS alias mode برای واگذاری چالش با CNAME
- صفحه Change default CA to ZeroSSL برای تغییر مرجع پیشفرض در نسخه 3.0
- مستندات Let’s Encrypt درباره انواع چالش برای چالش DNS-01 و شرط Wildcard
پرسشهای متداول
آیا برای استفاده از DNS‑01 نیاز به پورت 80 دارم؟
خیر، چالش DNS‑01 فقط با ایجاد رکورد TXT در DNS کار می کند و نیازی به باز کردن پورت 80 ندارد.
چگونه می توانم گواهی را به صورت خودکار تمدید کنم؟
پس از نصب، اسکریپت cron در `~/.acme.sh/cron` فعال می شود و گواهی ها را قبل از انقضا تمدید می کند.
چه زمانی باید مرجع صدور را تغییر دهم؟
اگر می خواهید از مرجع دیگری مانند Let’s Encrypt استفاده کنید، فرمان `--set-default-ca --server letsencrypt` را اجرا کنید.

کمپین ابتکار نو
کمپین ایده های نو
کمپین آینده روشن
کمپین طراحی مدرن