فرض کنید روی سرور Debian 13 دستور apt upgrade را اجرا کردهاید. چندین پکیج با موفقیت بهروزرسانی میشوند و در ظاهر خطای مهمی دیده نمیشود؛ اما پس از آن متوجه میشوید وبسرور دیگر اجرا نمیشود، سرویس دیتابیس بالا نمیآید یا یکی از برنامههای اختصاصی سرور با خطای Dependency شکست میخورد. حالا سؤال اصلی این است: کدام پکیج باعث اختلال شده و چطور بدون خرابکردن سایر سرویسها مشکل را برطرف کنیم؟
یکی از اشتباههای رایج در چنین شرایطی، بازگرداندن تصادفی نسخه برنامه یا اجرای دوباره apt upgrade و apt –fix-broken install بدون بررسی خروجی است. این روشها ممکن است پکیجهای بیشتری را تغییر دهند، وابستگیهای سالم را تحت تأثیر قرار دهند یا شواهد لازم برای تشخیص مشکل را پیچیده کنند.
برای رفع Debian 13 apt problem باید از تاریخچه واقعی تغییرات شروع کنیم. Debian اطلاعات تراکنشهای APT، تغییرات بستهها و پیامهای نصب را در چند Log جداگانه ثبت میکند. اگر این اطلاعات را با زمان توقف سرویس و لاگهای systemd مقایسه کنیم، میتوانیم مجموعه کوچکی از پکیجهای مشکوک را پیدا کنیم.
در این آموزش یاد میگیریم چگونه فایلهای apt history، dpkg.log و journalctl را بررسی کنیم، تغییرات Dependency و فایلهای تنظیمات را تشخیص دهیم، مشکل پکیج نیمهنصبشده را از ناسازگاری نسخه جدا کنیم و فقط در شرایط مناسب از Downgrade یا apt-mark hold استفاده کنیم. این روش برای Debian 13 با نام Trixie و سرویسهای رایج مانند Nginx، Apache، MariaDB و برنامههای اختصاصی کاربرد دارد.
چرا بعد از apt upgrade در Debian 13 یک سرویس اجرا نمیشود؟
دستور apt upgrade نسخه پکیجهای نصبشده را بر اساس مخازن و سیاستهای APT بهروزرسانی میکند. اما سالمبودن عملیات Package Manager لزوماً تضمین نمیکند برنامهها با همان تنظیمات قبلی کار کنند.
یک آپدیت ممکن است کتابخانه، فایل اجرایی، اسکریپت راهاندازی، Unit مربوط به systemd یا فایل پیکربندی برنامه را تغییر دهد. همچنین برنامهای که از مخزن ثالث نصب شده ممکن است با نسخه جدید یکی از کتابخانههای Debian سازگار نباشد.
علتهای رایج عبارتاند از:
- تغییر رفتار برنامه در نسخه جدید پکیج.
- ناسازگاری کتابخانه یا ABI با نرمافزار قدیمی.
- تغییر یا بازنویسی فایل تنظیمات یک سرویس.
- شکست اسکریپتهای post-installation یا سایر Maintainer Scriptها.
- باقیماندن پکیج در وضعیت نیمهپیکربندیشده.
- تغییر پکیجهای وابسته، حتی بدون ارتقای خود سرویس.
- ناسازگاری پکیج مخزن ثالث با Debian 13.
- تغییر در مجوزها، مسیر فایل اجرایی یا محدودیت امنیتی.
- فعالشدن خطایی که تا پیش از Restart سرویس پنهان مانده بود.
- نیاز به Restart سرویس یا Reboot برای استفاده از مؤلفه جدید.
نکته: اگر مشکل بلافاصله پس از apt upgrade ظاهر شده، ارتباط زمانی یک سرنخ مهم است؛ اما هنوز ثابت نمیکند آخرین پکیج تغییرکرده علت اصلی است.
قبل از عیبیابی، از اطلاعات و شواهد محافظت کنید
در سرور عملیاتی، قبل از نصب مجدد، حذف پکیج یا Downgrade باید وضعیت فعلی را ثبت کنید.
- نام سرویس خرابشده و زمان شروع اختلال را مشخص کنید.
- دسترسی Console مستقل از SSH را بررسی کنید.
- آخرین بکاپ معتبر و وضعیت بازیابی را مشخص کنید.
- نسخه Debian، مخازن فعال و نسخه سرویس را ثبت کنید.
- برای دیتابیسها، سازگاری Backup و فایلهای داده را بررسی کنید.
- از فایلهای تنظیمات اختصاصی برنامه نسخه ایمن تهیه کنید.
- تا زمان تشخیص علت، از اجرای آپدیت گسترده دیگر خودداری کنید.
اگر سرور مجازی است، یک Snapshot ممکن است برای ثبت وضعیت بررسی مفید باشد؛ اما جایگزین بکاپ قابل بازیابی، بهخصوص برای دیتابیسهای فعال، نیست.
مرحله اول: تأیید نسخه Debian و وضعیت سرویس
ابتدا مشخص کنید سیستمعامل واقعاً Debian 13 است و سرویس در چه وضعیتی قرار دارد.
cat /etc/os-release
uname -r
systemctl --version
سپس برای نمونه، وضعیت سرویس Nginx را مشاهده کنید:
systemctl status nginx.service --no-pager -l
در دستورهای این مقاله، نام nginx صرفاً یک مثال است و باید با سرویس واقعی مانند mariadb.service، apache2.service یا نام سرویس اختصاصی جایگزین شود.
برای فهرست سرویسهای Failed:
systemctl --failed
در خروجی وضعیت سرویس، فیلدهای Result، ExecMainStatus و پیامهای خطا را بررسی کنید. برای مثال، خطای ExecStart ممکن است به نبود فایل اجرایی، مشکل مجوز یا ناسازگاری اجرای برنامه اشاره کند.
مرحله دوم: پیدا کردن آخرین تراکنش آپدیت در apt history
اولین فایل مهم برای تشخیص، تاریخچه APT است:
/var/log/apt/history.log
برای مشاهده آخرین تراکنشها:
sudo tail -n 100 /var/log/apt/history.log
در این Log به فیلدهای زیر توجه کنید:
Start-DateوEnd-Dateبرای زمان تراکنش.Commandlineبرای دستور واقعی اجراشده.Upgradeبرای پکیجهای بهروزرسانیشده.Installبرای پکیجهای اضافهشده.RemoveوPurgeبرای حذفهای ثبتشده.- اطلاعات نسخه قبلی و نسخه جدید، در صورت ثبت در همان رویداد.
برای نمایش خلاصه خطوط مهم:
sudo grep -E \
'^(Start-Date|End-Date|Commandline|Upgrade|Install|Remove|Purge):' \
/var/log/apt/history.log
برای لاگهای قدیمی که Rotate و فشرده شدهاند، میتوان از zgrep برای فایلهای فشرده استفاده کرد:
sudo zgrep -hE \
'^(Start-Date|Commandline|Upgrade):' \
/var/log/apt/history.log*.gz
توجه: history.log فقط اقدامات ثبتشده توسط APT را پوشش میدهد. اگر پکیجی با dpkg -i یا ابزار دیگری تغییر کرده باشد، ممکن است در این فایل دیده نشود؛ برای همین باید dpkg.log را نیز بررسی کنیم.
منبع رسمی: Debian Reference – Package Management and Logs.
مرحله سوم: پیدا کردن تغییر دقیق پکیجها در dpkg.log
فایل /var/log/dpkg.log اطلاعات جزئیتری از عملیات نصب، ارتقا، حذف و تغییر وضعیت پکیجها ارائه میکند.
برای مشاهده تغییرات اخیر:
sudo tail -n 150 /var/log/dpkg.log
برای مشاهده پکیجهایی که واقعاً Upgrade شدهاند:
sudo grep ' upgrade ' /var/log/dpkg.log |
tail -n 60
ساختار معمول رویداد Upgrade شامل تاریخ، ساعت، نوع عملیات، نام پکیج، نسخه قبلی و نسخه جدید است.
برای مثال، یک خروجی فرضی ممکن است نشان دهد یک کتابخانه ساعت ۱۱:۲۰ ارتقا یافته است، درحالیکه سرویس وابسته چند ثانیه بعد متوقف شده است.
در این شرایط باید نسخه همان کتابخانه و Log سرویس بررسی شود؛ نه اینکه بدون تحلیل، آن را Downgrade کنیم.
اگر تغییر در لاگ جاری نیست، لاگهای Rotateشده را نیز بررسی کنید:
ls -lh /var/log/dpkg.log*
sudo zgrep -h ' upgrade ' /var/log/dpkg.log*.gz 2>/dev/null |
tail -n 80
از آنجا که ترتیب خروجی فایلهای فشرده لزوماً برابر ترتیب زمانی کل رویدادها نیست، برای تحلیل نهایی تاریخ داخل هر سطر را نیز بررسی کنید.
منبع: dpkg Manual – Debian 13.
مرحله چهارم: بررسی خروجی نصب در apt term.log
گاهی apt history فقط نشان میدهد کدام پکیج تغییر کرده، اما علت شکست عملیات Configure در فایل term.log مشخص میشود.
برای مشاهده خروجی آخرین عملیات:
sudo tail -n 150 /var/log/apt/term.log
برای جستوجوی پیامهای خطا:
sudo grep -Ein \
'error|failed|dependency|post-installation|subprocess|dpkg:' \
/var/log/apt/term.log |
tail -n 80
در این فایل ممکن است خروجی Maintainer Script، خطای وابستگی، خطای راهاندازی سرویس یا شکست نصب دیده شود.
نبود کلمه Error در این جستوجو به معنی موفقیت قطعی برنامه نیست؛ بعضی پیامها عبارت متفاوتی دارند و ممکن است مشکل تنها پس از پایان عملیات APT آشکار شود.
مرحله پنجم: ارتباط زمانی آپدیت را با Journal سرویس پیدا کنید
بعد از مشخصکردن زمان تراکنش APT، باید همان بازه را در Journal بررسی کنیم.
فرض کنید آپدیت ساعت ۱۱:۲۰ شروع شده و سرویس ساعت ۱۱:۲۲ از دسترس خارج شده است.
برای بررسی Journal سرویس Nginx در بازه فرضی:
sudo journalctl -u nginx.service \
--since "2026-11-19 11:15:00" \
--until "2026-11-19 11:30:00" \
--no-pager -o short-iso
تاریخ و زمان بالا صرفاً نمونهاند و باید با زمان واقعی آپدیت جایگزین شوند.
برای مشاهده رویدادهای Error در بوت جاری:
sudo journalctl -b -p err --no-pager
و برای مشاهده لاگ سرویس در بوت قبلی، در صورت حفظ Journal:
sudo journalctl -b -1 -u nginx.service \
--no-pager -n 100
اگر Journal بوت قبلی نگهداری نشده باشد، خروجی مربوط در دسترس نخواهد بود.
منبع رسمی: journalctl در Debian 13.
چگونه تشخیص دهیم مشکل از پکیج است یا تنظیمات سرویس؟
قبل از Downgrade، متن دقیق خطا را تفسیر کنید.
| نشانه | علت احتمالی | اقدام اولیه |
|---|---|---|
| Failed to start service | خطای عمومی Startup | بررسی Journal و ExecStart |
| Unknown directive | تغییر نسخه یا تنظیمات | اعتبارسنجی فایل Config |
| Symbol lookup error | ناسازگاری کتابخانه یا ABI | بررسی Dependency و نسخه Library |
| No such file or directory | مسیر حذفشده یا فایل مفقود | بررسی مسیر فایل اجرایی |
| Permission denied | مجوز یا محدودیت سرویس | بررسی User، Group و Sandbox |
| Dependency failed | سرویس یا Mount وابسته آماده نیست | systemctl list-dependencies |
| Address already in use | تداخل پورت | بررسی Listenerهای فعال |
| Package not configured | ناتمامماندن dpkg | dpkg –audit و term.log |
اگر خطا از فایل تنظیمات است، احتمال دارد نسخه جدید برنامه دیگر یک Directive قدیمی را قبول نکند. در این حالت راهکار درست ممکن است اصلاح همان Config باشد؛ نه Downgrade.
مرحله ششم: بررسی پکیجهای نیمهنصبشده یا خراب
اگر apt upgrade کامل نشده یا اسکریپت نصب شکست خورده، ابتدا وضعیت دیتابیس dpkg را بررسی کنید:
sudo dpkg --audit
این دستور مشکلات وضعیت Package Database و برخی پکیجهای ناقص را گزارش میکند و عملیات اصلاحی انجام نمیدهد.
برای نمایش وضعیت پکیج مشخص:
dpkg-query -W \
-f='${Package} ${Version} ${db:Status-Abbrev}\n' \
nginx
اگر پکیجی نیمهپیکربندیشده است، فرمان زیر میتواند عملیات Configure معلق را ادامه دهد:
sudo dpkg --configure -a
هشدار: این دستور تغییردهنده است؛ ممکن است Maintainer Scriptها اجرا شوند و سرویسها Restart شوند. فقط پس از بررسی خطای قبلی، Backup و آثار تغییر آن را اجرا کنید.
همچنین برای بررسی راهحل پیشنهادی APT برای وابستگی خراب میتوان ابتدا شبیهسازی کرد:
sudo apt-get -s --fix-broken install
در خروجی شبیهسازی به پکیجهایی که برای نصب، ارتقا یا حذف پیشنهاد میشوند توجه کنید. شبیهسازی تضمین قطعی نتیجه اجرای واقعی نیست، اما برای ارزیابی اولیه ضروری است.
مرحله هفتم: بررسی Dependencyها و پکیجهای مرتبط
گاهی سرویس مستقیماً آپدیت نشده، اما یکی از Libraryها یا بستههای وابسته آن تغییر کرده است.
برای مشاهده Dependencyهای ثبتشده یک پکیج:
apt-cache depends nginx
برای پیدا کردن پکیجهایی که به یک پکیج مشخص وابستهاند:
apt-cache rdepends nginx
همچنین نسخه نصبشده و نسخههای قابل دریافت را بررسی کنید:
apt-cache policy nginx
apt list -a nginx
برای برنامههای اختصاصی که از کتابخانههای مشترک استفاده میکنند، بررسی خطای Loader و Libraryهای مرتبط میتواند مهمتر از نام پکیج اصلی باشد.
در صورت لزوم میتوان با ابزارهای مناسب، وابستگیهای باینری را بررسی کرد. برای فایلهای اجرایی ناشناس از اجرای مستقیم آنها یا ابزارهایی که ممکن است کد برنامه را اجرا کنند خودداری کنید.
مرحله هشتم: بررسی تغییر فایلهای پیکربندی بعد از Upgrade
بعضی پکیجها هنگام نصب نسخه جدید با فایل پیکربندی تغییریافته مواجه میشوند. dpkg ممکن است بسته به شرایط و انتخاب مدیر سیستم، نسخه فعلی یا نسخه جدید فایل را نگه دارد.
اگر سرویس پس از Upgrade بالا نمیآید، وجود فایلهایی با پسوندهای زیر میتواند سرنخ باشد:
.dpkg-new.dpkg-old.dpkg-dist
برای پیدا کردن فایلهای مرتبط در مسیر یک سرویس مشخص:
sudo find /etc/nginx -type f \
\( -name '*.dpkg-new' \
-o -name '*.dpkg-old' \
-o -name '*.dpkg-dist' \) -print
این مسیر صرفاً نمونه است. همچنین نبود چنین فایلهایی اثبات نمیکند Config تغییر نکرده است.
اگر تفاوتی پیدا شد، فایلها را مقایسه کنید و فقط تنظیمات سازگار با نسخه فعلی را اعمال کنید. جایگزینی کورکورانه فایل Config میتواند تنظیمات SSL، Virtual Host یا مسیرهای اختصاصی را از بین ببرد.
برای Nginx، قبل از Restart میتوان اعتبارسنجی پیکربندی را انجام داد:
sudo nginx -t
برای سرویسهای دیگر باید از دستور اعتبارسنجی رسمی همان نرمافزار استفاده شود.
مرحله نهم: بررسی مخازن ثالث و APT Pinning
اگر پکیج از مخزن Debian نصب نشده باشد، احتمال ناسازگاری با وابستگیهای Debian 13 باید جدیتر بررسی شود.
برای مشاهده مخازن فعال:
grep -RInE \
'^(deb |URIs:|Suites:|Components:)' \
/etc/apt/sources.list \
/etc/apt/sources.list.d/ 2>/dev/null
Debian 13 ممکن است از فایلهای مخزن با فرمت deb822 و پسوند .sources استفاده کند؛ بنابراین بررسی تنها فایل sources.list کافی نیست.
برای مشاهده سیاست انتخاب نسخه:
apt-cache policy
اگر مخزنهای نسخههای مختلف Debian، Backports یا یک مخزن ثالث در سیستم فعالاند، باید مشخص شود پکیج مشکوک دقیقاً از کجا نصب شده است.
همچنین در سرورهای Debian 13 بهتر است از نام نسخه trixie در پیکربندیهایی که نیازمند ثبات نسخه هستند استفاده شود. استفاده از نام شناور stable ممکن است در زمان انتشار نسخه بعدی، مجموعه پکیجهای هدف را تغییر دهد.
منبع رسمی: Debian 13 Release Notes – APT Sources and Upgrade.
چطور پکیج مقصر را با شواهد کافی شناسایی کنیم؟
برای رسیدن به یک نتیجه قابل دفاع، چند منبع اطلاعاتی را کنار هم قرار دهید.
| شاهد | پرسش | اهمیت |
|---|---|---|
| APT History | چه پکیجهایی در همان تراکنش تغییر کردهاند؟ | فهرست اولیه مظنونها |
| dpkg.log | نسخه قبلی و جدید هر پکیج چیست؟ | ردیابی تغییر واقعی |
| term.log | آیا Configure یا Script نصب شکست خورده است؟ | تشخیص خطای نصب |
| journalctl | سرویس دقیقاً چه زمانی و چگونه شکست خورده است؟ | ارتباط زمانی |
| Dependency Analysis | کدام کتابخانه یا سرویس تغییر کرده است؟ | علت فنی محتمل |
| Config Diff | آیا تنظیمات قدیمی ناسازگار شدهاند؟ | تأیید خطای پیکربندی |
| Rollback Test | آیا نسخه سازگار مشکل را برطرف میکند؟ | تأیید کنترلشده فرضیه |
در صورت امکان، آزمایش نسخه قبلی را روی یک Clone یا محیط Stage انجام دهید تا از تغییرات نامطمئن روی سرور تولیدی جلوگیری شود.
مثال عملی: Nginx پس از ارتقای پکیج اجرا نمیشود
فرض کنید پس از آپدیت Debian 13، سرویس Nginx متوقف شده است. ابتدا Journal خطایی درباره یک Directive ناشناخته نشان میدهد.
در این سناریو ترتیب مناسب بررسی چنین است:
- از apt history زمان و فهرست پکیجهای تغییرکرده را پیدا کنید.
- در dpkg.log نسخه قبلی و جدید nginx و پکیجهای مرتبط را بررسی کنید.
- با journalctl متن دقیق خطای Startup را دریافت کنید.
- با nginx -t فایل و خط دارای پیکربندی نامعتبر را شناسایی کنید.
- Release Notes یا مستندات نسخه جدید Nginx را بررسی کنید.
- در صورت تأیید ناسازگاری Config، فایل را با بکاپ و تغییر حداقلی اصلاح کنید.
- پس از موفقیت تست پیکربندی، سرویس را در شرایط مناسب راهاندازی و از بیرون تست کنید.
در این مثال، ممکن است مشکل بدون Downgrade برطرف شود. چون علت، تنظیم ناسازگار است نه لزوماً خرابی خود پکیج.
مرحله دهم: چه زمانی Downgrade یک پکیج منطقی است؟
اگر شواهد نشان دهند نسخه جدید یک پکیج با برنامه حیاتی ناسازگار شده و نسخه اصلاحشده دیگری موجود نیست، Downgrade هدفمند میتواند بهعنوان یک اقدام موقت بررسی شود.
اما Debian یک عملیات Undo ساده و عمومی برای بازگرداندن تمام تغییرات یک تراکنش APT ارائه نمیکند. بازگرداندن یک پکیج ممکن است به نسخه قبلی کتابخانهها نیز وابسته باشد و بعضی فایلهای داده یا پیکربندی با نسخه قدیمی سازگار نباشند.
قبل از هر اقدام، نسخههای قابل نصب را مشاهده کنید:
apt-cache policy nginx
apt list -a nginx
اگر نسخه قدیمی معتبر در مخزن فعال وجود داشته باشد، میتوان طرح نصب نسخه مشخص را ابتدا شبیهسازی کرد:
sudo apt-get -s install 'nginx=EXACT_VERSION'
عبارت EXACT_VERSION باید با نسخه واقعی گزارششده توسط APT جایگزین شود.
در خروجی شبیهسازی حتماً بررسی کنید آیا APT قصد حذف، Downgrade یا تغییر پکیجهای وابسته را دارد یا خیر.
هشدار: نسخه قبلی ممکن است دیگر در مخازن فعال وجود نداشته باشد. همچنین بعضی Downgradeها از نظر برنامه یا فرمت داده پشتیبانی نمیشوند؛ بهخصوص دیتابیسها و سرویسهای دارای Migration.
برای وضعیتهایی که نسخه قدیمی در مخزن فعال موجود نیست، آرشیو رسمی Debian Snapshot Archive میتواند برای بررسی نسخههای تاریخی مفید باشد. استفاده از آن در Production باید با کنترل وابستگیها، اصالت بستهها و سیاست امنیتی انجام شود.
منبع: Debian Wiki – Rollback Update.
مرحله یازدهم: استفاده درست از apt-mark hold
اگر یک نسخه مشخص بهصورت موقت برای پایداری سرویس ضروری است، میتوان از Hold برای جلوگیری از Upgrade خودکار همان پکیج استفاده کرد.
ابتدا وضعیت Holdهای فعلی را مشاهده کنید:
apt-mark showhold
پس از تصمیم فنی و تأیید نسخه مناسب، میتوان پکیج را موقتاً Hold کرد:
sudo apt-mark hold nginx
برای برداشتن Hold پس از رفع مشکل:
sudo apt-mark unhold nginx
نکته امنیتی: Hold کردن نسخه آسیبپذیر برای مدت طولانی میتواند مانع نصب اصلاحات امنیتی شود. بنابراین هر Hold باید دلیل، مسئول، تاریخ بازبینی و برنامه رفع دائمی داشته باشد.
Hold نیز مشکل Dependency یا ناسازگاری واقعی را حل نمیکند؛ فقط جلوی بعضی تغییرات خودکار آینده را میگیرد.
منبع: apt-mark در Debian 13.
چه زمانی Restore از بکاپ بهتر از Downgrade است؟
اگر چندین پکیج اصلی تغییر کردهاند یا سرویس دارای دادههای حساس است، بازگردانی یک Package ممکن است کافی نباشد.
در شرایط زیر باید بازیابی از بکاپ یا Clone سالم جدیتر بررسی شود:
- نسخه جدید دیتابیس فرمت داده یا Schema را تغییر داده است.
- چندین پکیج وابسته به یکدیگر در تراکنش تغییر کردهاند.
- Dependency Solver حذف بخش مهمی از سیستم را پیشنهاد میدهد.
- نسخه قبلی پکیج قابل تأمین از منبع معتبر نیست.
- وضعیت dpkg و فایلهای تنظیمات بهشدت ناسازگار شده است.
- زمان موردنیاز برای تعمیر از RTO تعیینشده بیشتر شده است.
در بازیابی ماشین مجازی، سازگاری Snapshot با دیتابیس، فایلسیستم و تراکنشهای برنامه باید بررسی شود. بازگرداندن Snapshot قدیمی روی سروری که در فاصله زمانی بعدی داده جدید دریافت کرده، ممکن است موجب از دست رفتن آن دادهها شود.
اسکریپت یکپارچه عیبیابی Debian 13 بعد از apt upgrade
اسکریپت زیر برای بررسی یک سرویس مشخص، نسخه Debian، وضعیت پکیجها، اطلاعات APT و Journal را جمعآوری میکند.
این اسکریپت هیچ پکیجی را نصب، حذف یا Downgrade نمیکند و سرویس را Restart نمیکند. فقط خروجی را روی صفحه نمایش میدهد.
#!/usr/bin/env bash
set -u
SERVICE="${1:-nginx.service}"
PACKAGE="${2:-nginx}"
echo "===== OPERATING SYSTEM ====="
cat /etc/os-release
echo "===== SYSTEMD FAILED UNITS ====="
systemctl --failed --no-pager
echo "===== SERVICE STATUS ====="
systemctl status "$SERVICE" --no-pager -l || true
echo "===== SERVICE CONFIGURATION ====="
systemctl cat "$SERVICE" || true
echo "===== SERVICE JOURNAL ====="
journalctl -u "$SERVICE" -b -n 100 \
--no-pager || true
echo "===== APT HISTORY ====="
if [ -r /var/log/apt/history.log ]; then
tail -n 100 /var/log/apt/history.log
fi
echo "===== APT TERMINAL ERRORS ====="
if [ -r /var/log/apt/term.log ]; then
grep -Ein \
'error|failed|dependency|subprocess|dpkg:' \
/var/log/apt/term.log | tail -n 60 || true
fi
echo "===== RECENT DPKG UPGRADES ====="
if [ -r /var/log/dpkg.log ]; then
grep ' upgrade ' /var/log/dpkg.log |
tail -n 60 || true
fi
echo "===== DPKG AUDIT ====="
dpkg --audit || true
echo "===== PACKAGE POLICY ====="
apt-cache policy "$PACKAGE" || true
echo "===== PACKAGE DEPENDENCIES ====="
apt-cache depends "$PACKAGE" || true
echo "===== HELD PACKAGES ====="
apt-mark showhold
echo "===== DIAGNOSTICS COMPLETE ====="
در صورت نیاز، اسکریپت را با دسترسی مدیریتی مجاز اجرا کنید. برای مثال، در بررسی سرویس MariaDB میتوان نام سرویس و پکیج متناظر را بهعنوان دو پارامتر وارد کرد.
اگر لاگهای مربوط به زمان خرابی Rotate شدهاند، باید فایلهای قدیمی نیز جداگانه بررسی شوند. اسکریپت بالا برای تشخیص اولیه است و بهتنهایی علت ریشهای را اثبات نمیکند.
جدول تصمیمگیری برای رفع مشکل APT در Debian 13
| نتیجه بررسی | اقدام پیشنهادی |
|---|---|
| پکیج نیمهپیکربندیشده است | بررسی term.log و اصلاح کنترلشده وضعیت dpkg |
| Config نسخه قبلی ناسازگار شده | تغییر حداقلی Config و اعتبارسنجی برنامه |
| کتابخانه جدید با برنامه قدیمی ناسازگار است | بررسی نسخه سازگار برنامه و Dependencyها |
| پکیج از مخزن ثالث نصب شده | بررسی پشتیبانی Debian 13 توسط سازنده |
| یک نسخه جدید مشخص باعث Regression شده | بررسی Fix موجود و Downgrade محدود در صورت ضرورت |
| چند بسته حیاتی تغییر کردهاند | آزمایش روی Clone یا بازیابی از بکاپ |
| APT حذف پکیجهای مهم را پیشنهاد میدهد | عدم تأیید تغییر تا روشنشدن علت وابستگی |
| نسخه موقت سالم با Hold نگهداری شده | ثبت تاریخ بازبینی و برنامه اعمال اصلاح امنیتی |
| بعد از Reboot مشکل ظاهر شده | بررسی Kernel، Boot Journal و سرویسهای وابسته |
چطور از تکرار مشکل پس از apt upgrade جلوگیری کنیم؟
در سرورهای مهم، Patch Management باید قابل کنترل و قابل بازگشت باشد.
- پیش از آپدیت، فهرست پکیجهای قابل ارتقا را بررسی کنید.
- زمان نصب آپدیت را در Maintenance Window قرار دهید.
- از سرویسها، دیتابیسها و فایلهای تنظیمات بکاپ معتبر داشته باشید.
- آپدیت را ابتدا روی محیط Stage یا Clone بررسی کنید.
- مخازن ثالث و APT Pinning را مستند نگه دارید.
- تغییرات کتابخانههای اصلی و Runtime برنامه را پایش کنید.
- بعد از آپدیت، فقط فعالبودن سرویس را معیار موفقیت ندانید؛ Endpoint و عملکرد واقعی را تست کنید.
- لاگهای APT و Journal را برای مدت مناسب نگهداری کنید.
- Holdهای موقت را بهصورت دورهای بازبینی کنید.
- از تغییر مخازن Trixie به نسخه دیگر Debian بدون برنامه مهاجرت خودداری کنید.
برای برنامههای حیاتی، بهتر است پیش از آپدیت معیار موفقیت مشخص شود؛ برای مثال پاسخ صحیح وبسایت، موفقیت اتصال دیتابیس، وضعیت صف کارها و نتیجه تست سلامت برنامه.
اشتباههای رایج هنگام رفع Debian 13 apt problem
۱. نسبتدادن مشکل به آخرین پکیج در dpkg.log
ممکن است عامل اصلی یکی از بستههای وابسته یا تغییر Config باشد. ارتباط زمانی باید با شواهد فنی تأیید شود.
۲. اجرای مجدد apt upgrade بدون تشخیص
این کار ممکن است تغییرات جدیدی ایجاد و تحلیل تراکنش قبلی را دشوار کند.
۳. اجرای apt –fix-broken install بدون بررسی خروجی
ابتدا شبیهسازی کنید و مطمئن شوید APT قصد حذف پکیج حیاتی ندارد.
۴. Downgrade کردن تصادفی کتابخانههای سیستم
این اقدام ممکن است برنامههای دیگر را ناسازگار کند یا وابستگیهای جدیدی ایجاد کند.
۵. استفاده بلندمدت از apt-mark hold
Hold مداوم میتواند اصلاحات امنیتی مهم را متوقف کند.
۶. نادیدهگرفتن فایلهای .dpkg-old و .dpkg-dist
این فایلها ممکن است سرنخ تغییر پیکربندی هنگام ارتقا باشند.
۷. مخلوطکردن مخازن Debian Stable و Testing
ترکیب نسخههای توزیع بدون سیاست مشخص میتواند باعث پیچیدگی شدید Dependencyها شود.
۸. حذف و نصب دوباره سرویس بدون بکاپ
Remove و Purge رفتار متفاوتی دارند و ممکن است فایلهای پیکربندی یا دادههای مهم تحت تأثیر قرار گیرند.
۹. Restart مکرر سرویس بدون خواندن Journal
وقتی تنظیمات نامعتبر است، Restartهای تکراری علت اصلی را اصلاح نمیکنند.
۱۰. تأیید موفقیت فقط با systemctl active
ممکن است Process اجرا شده باشد، اما پورت، دیتابیس یا عملکرد برنامه هنوز مشکل داشته باشد.
سؤالات متداول درباره مشکل APT در Debian 13
چرا سرویس بعد از apt upgrade در Debian 13 اجرا نمیشود؟
ممکن است نسخه جدید پکیج، کتابخانه، فایل تنظیمات، مجوزها یا وابستگیهای سرویس تغییر کرده باشد. ابتدا apt history و Journal را بررسی کنید.
چگونه بفهمیم کدام پکیج آخرین بار آپدیت شده است؟
از فایلهای /var/log/apt/history.log و /var/log/dpkg.log برای بررسی تاریخ و نسخه تغییرات استفاده کنید.
تفاوت apt history و dpkg.log چیست؟
apt history تراکنشهای APT را ثبت میکند، اما dpkg.log جزئیات عملیات و تغییر وضعیت پکیجها را در سطح dpkg نشان میدهد.
لاگ خطای نصب پکیج در Debian کجاست؟
فایل /var/log/apt/term.log یکی از منابع اصلی خروجی نصب و پیکربندی پکیجهاست.
چگونه خطای سرویس را بعد از آپدیت بررسی کنیم؟
با systemctl status و journalctl -u میتوان وضعیت و پیامهای خطای همان سرویس را مشاهده کرد.
آیا apt upgrade را میتوان Undo کرد؟
بازگردانی یک تراکنش APT در همه شرایط یک عملیات ساده و تضمینشده نیست. ممکن است به Downgrade چند پکیج یا Restore از بکاپ نیاز باشد.
چگونه نسخه قبلی یک پکیج را در Debian پیدا کنیم؟
با apt-cache policy و apt list -a نسخههای قابل دریافت را بررسی کنید؛ نسخههای تاریخی نیز ممکن است در Debian Snapshot Archive موجود باشند.
آیا Downgrade کردن پکیج خطرناک است؟
ممکن است بهدلیل تغییر Dependency، Config یا فرمت داده باعث ناسازگاری شود. قبل از اجرا باید شبیهسازی و برنامه بازیابی وجود داشته باشد.
دستور apt-mark hold چه کاری انجام میدهد؟
باعث میشود پکیج مشخص از بعضی تغییرات خودکار مانند ارتقای معمول کنار گذاشته شود؛ اما مشکل امنیتی یا سازگاری را برطرف نمیکند.
بهترین روش رفع مشکل سرویس پس از آپدیت چیست؟
تطبیق زمان آپدیت با لاگ سرویس، تشخیص تغییر واقعی، اصلاح حداقلی علت و تست عملکرد سرویس قبل از اجرای تغییرات گسترده.
جمعبندی؛ پیدا کردن پکیج مقصر بعد از apt upgrade
اگر یک سرویس در Debian 13 پس از apt upgrade دیگر اجرا نمیشود، قبل از حذف یا بازگرداندن پکیجها باید شواهد را بررسی کنید. فایل apt history نشان میدهد چه تراکنشی انجام شده، dpkg.log تغییرات دقیق پکیجها را مشخص میکند و apt term.log جزئیات نصب یا خطاهای Configure را ارائه میدهد.
سپس با journalctl و systemctl میتوان زمان و علت ظاهری توقف سرویس را بررسی کرد. در بسیاری از موارد، مشکل از تنظیم ناسازگار، فایل اجرایی جابهجاشده یا تغییر کتابخانه است و نیازی به Downgrade وجود ندارد.
اگر نسخه جدید واقعاً باعث یک Regression شده باشد، باید ابتدا راهکار رسمی یا نسخه اصلاحشده را بررسی کرد. Downgrade و apt-mark hold فقط باید بهصورت هدفمند، موقت و با آگاهی از ریسک امنیتی و وابستگیها استفاده شوند.
اصل نهایی: در Debian 13 اول پکیج مشکوک را با تطبیق تاریخچه APT، لاگ dpkg و Journal شناسایی کنید؛ بعد از تأیید علت، کمخطرترین روش اصلاح را انتخاب کنید.






دیدگاهها (۰)