# به‌روزرسانی ccam

> ccam update پس از بررسی SHA-256، ccam را با آخرین نسخه GitHub جایگزین می‌کند؛ --check فقط گزارش می‌دهد و --version یک برچسب نسخه مشخص را نصب می‌کند.

Source: https://ccam.dev/fa/features/update/ · Updated 2026-10-19

`ccam update` یک نسخه ccam را از GitHub دانلود می‌کند، آن را با `checksums.txt` همان نسخه بررسی می‌کند و فایل اجرایی در حال اجرا را با یک تغییر نام جایگزین می‌کند. اگر ccam را با اسکریپت نصب یا از یک فایل فشرده نصب کرده‌اید، از این فرمان استفاده کنید. ccam هرگز خودش به دنبال به‌روزرسانی نمی‌گردد: فقط این فرمان با GitHub ارتباط می‌گیرد، بنابراین همه فرمان‌های دیگر به‌صورت آفلاین هم همان‌طور کار می‌کنند.

## استفاده

```sh
ccam update                    # install the latest release
ccam update --check            # only say whether a newer release exists
ccam update --version v0.3.0   # install that release, also an older one
ccam --dry-run update          # show what would be downloaded and replaced
```

```console
$ ccam update --check
ccam 0.5.0 is available (you have 0.4.0). Run `ccam update`.
$ ccam --dry-run update
Would update ccam 0.4.0 → 0.5.0:
  download  https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/ccam_linux_amd64.tar.gz
  verify    with https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/checksums.txt
  replace   /home/you/.local/bin/ccam
$ ccam update
→ downloading https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/ccam_linux_amd64.tar.gz
✓ Updated ccam 0.4.0 → 0.5.0 (/home/you/.local/bin/ccam)
```

وقتی نسخه جدیدتری وجود نداشته باشد، ccam پیام `ccam 0.4.0 is up to date.` را چاپ می‌کند و چیزی را تغییر نمی‌دهد. اگر با `--version` همان نسخه‌ای را بدهید که اکنون اجرا می‌کنید، `ccam 0.4.0 is already installed.` را چاپ می‌کند.

## گزینه‌ها

| گزینه | کاری که انجام می‌دهد | پیش‌فرض |
| --- | --- | --- |
| `--check` | فقط گزارش می‌دهد که نسخه جدیدتری وجود دارد یا نه | خاموش |
| `--version <tag>` | این برچسب نسخه را نصب می‌کند، مانند `v0.3.0`، چه جدیدتر و چه قدیمی‌تر از نسخه فعلی | آخرین نسخه |
| `--dry-run` | پشتیبانی می‌شود: آخرین برچسب را پیدا می‌کند (مگر اینکه `--version` برچسبی را نام ببرد)، همان بررسی‌ها را روی فایل اجرایی انجام می‌دهد و مسیرهای دانلود، checksum و جایگزینی را بدون دانلود چاپ می‌کند | خاموش |

`--check` و `--version` را نمی‌توان با هم استفاده کرد. برچسب باید به شکل `vMAJOR.MINOR.PATCH` باشد و می‌تواند یک پسوند پیش‌انتشار یا build هم داشته باشد؛ می‌توان `v` ابتدای آن را حذف کرد. هر چیز دیگری خطا می‌دهد، برای مثال `--version takes a release tag such as v0.3.0, not "1.2"`.

متغیر محیطی `CCAM_RELEASES_URL` برای یک mirror یا برای آزمون‌ها جایگزین `https://github.com/jhyunwoo/ccam/releases` می‌شود. ساختار آن باید یکسان باشد: `<url>/latest` به `<url>/tag/<tag>` هدایت می‌شود و فایل‌ها در `<url>/download/<tag>/<asset>` قرار دارند.

## چگونه کار می‌کند

کد در `internal/update` است که فقط `ccam update` آن را import می‌کند. مسیر اجرا هرگز آن را فراخوانی نمی‌کند.

1. `cli.updateCmd` فایل اجرایی در حال اجرا را با `os.Executable` پیدا می‌کند و پیوندهای نمادین را با `filepath.EvalSymlinks` دنبال می‌کند. همین مسیر واقعی است که جایگزین می‌شود.
2. بدون `--version`، `Updater.Latest` نشانی `<releases>/latest` را بدون دنبال کردن هدایت درخواست می‌کند و برچسب را از سرآیند `Location` (`…/tag/v0.5.0`) می‌خواند. این روش به‌جای API GitHub از صفحه نسخه‌ها استفاده می‌کند، بنابراین محدودیت ۶۰ درخواست در ساعت API شامل آن نمی‌شود. این جست‌وجو ۱۰ ثانیه فرصت دارد.
3. `parseVersion` برچسب را با یک الگوی سخت‌گیرانه بررسی می‌کند. برچسب در نشانی‌های دانلود و در یک فرمان shell چاپ‌شده قرار می‌گیرد، پس هیچ چیزی که `/`، `%`، فاصله یا نویسه‌های shell داشته باشد پذیرفته نمی‌شود. `compareVersions` آن را با نسخه در حال اجرا مقایسه می‌کند؛ یک پیش‌انتشار پیش از نسخه نهایی خود قرار می‌گیرد.
4. `managed()` و `writable()` تعیین می‌کنند که آیا ccam اصلاً اجازه دارد فایل اجرایی را جایگزین کند یا نه (پایین‌تر را ببینید).
5. `Updater.Fetch` فایل‌های `ccam_<os>_<arch>.tar.gz` و `checksums.txt` را هم‌زمان دانلود می‌کند و برای هر دو روی هم ۲ دقیقه فرصت دارد. حجم هر دانلود حداکثر ۲۵۶ MB است.
6. پیش از هر کار دیگری، SHA-256 فایل فشرده باید با خط مربوط به آن در `checksums.txt` یکی باشد. نبودن خط یا متفاوت بودن checksum به‌روزرسانی را با `nothing was changed` متوقف می‌کند.
7. `extract()` فایل tar را می‌خواند و نخستین فایل عادی با نام `ccam` را برمی‌دارد. پوشه‌ها، پیوندها و دیگر ورودی‌ها نادیده گرفته می‌شوند و حجم فایل اجرایی هم حداکثر ۲۵۶ MB است.
8. `Updater.Install` فایل اجرایی جدید را با `fsutil.AtomicWrite` می‌نویسد: یک فایل موقت `.ccam.tmp*` کنار فایل اجرایی، با بیت‌های مجوز فایل قبلی، که روی دیسک ذخیره و سپس با تغییر نام جایگزین فایل قبلی می‌شود.

کل این فرایند، از یافتن برچسب تا تغییر نام:

فایل فشرده و `checksums.txt` کنار هم دانلود می‌شوند و تا وقتی checksum مطابقت نداشته باشد چیزی نوشته نمی‌شود. تغییر نام اتمی است، بنابراین یک خرابی یا پر شدن دیسک یا فایل اجرایی قبلی را باقی می‌گذارد یا فایل جدید را، هرگز نیمی از یکی را. فرمان‌های میان‌بر مانند `~/.local/bin/ccwork` پیوندهای نمادین به فایل اجرایی ccam هستند، بنابراین بدون هیچ تغییری نسخه جدید را اجرا می‌کنند.

### نصب‌های مدیریت‌شده با بسته

ccam نصب‌شده از `.deb` متعلق به apt است و جایگزین کردن آن بدون اطلاع apt پایگاه داده بسته‌ها را نادرست می‌کند. ccam پیش از دانلود بررسی می‌کند که فایل اجرایی متعلق به کیست:

1. فایل اجرایی در `/usr/bin`، `/bin`، `/usr/sbin` یا `/sbin` مدیریت‌شده با بسته به حساب می‌آید.
2. در جاهای دیگر، اگر `dpkg` نصب باشد و `dpkg -S <path>` موفق شود، آن هم مدیریت‌شده با بسته به حساب می‌آید.
3. در غیر این صورت ccam یک فایل موقت `.ccam-update-*` کنار فایل اجرایی می‌سازد و حذف می‌کند تا مطمئن شود می‌تواند در آنجا بنویسد.

برای فایل اجرایی مدیریت‌شده با بسته، ccam متوقف می‌شود و گام‌های apt را چاپ می‌کند:

```console
$ ccam update
ccam: /usr/bin/ccam was installed by a package, so `ccam update` leaves it alone.
To update the .deb, download ccam_0.5.0_linux_amd64.deb from https://github.com/jhyunwoo/ccam/releases/tag/v0.5.0 and run:
  sudo apt install ./ccam_0.5.0_linux_amd64.deb
Or install a copy in ~/.local/bin with the install script:
  curl -fsSL https://raw.githubusercontent.com/jhyunwoo/ccam/main/install.sh | sh
```

در سیستم‌هایی غیر از Linux، فقط خط اسکریپت نصب چاپ می‌شود. وقتی پوشه قابل نوشتن نباشد، ccam پیشنهاد می‌کند اسکریپت نصب را دوباره اجرا کنید که ccam را در `~/.local/bin` نصب می‌کند.

## ایمنی و حالت‌های خاص

- یک build توسعه نسخه خود را `dev` گزارش می‌کند و نسخه‌ای برای مقایسه ندارد، بنابراین `ccam update` و `ccam update --check` آن را رد می‌کنند. `ccam update --version vX.Y.Z` یک نسخه را روی آن نصب می‌کند.
- دانلود ناموفق، نبودن فایل مخصوص پلتفرم شما یا عدم تطابق checksum، فایل اجرایی نصب‌شده را دست‌نخورده باقی می‌گذارد.
- نسخه‌ای که وجود ندارد با `there is no release <tag>` خطا می‌دهد. وقتی GitHub با HTTP 403 یا 429 درخواست را رد کند، ccam می‌گوید احتمالاً محدودیت نرخ درخواست است و از شما می‌خواهد بعداً دوباره امتحان کنید.
- `--check` فقط می‌خواند. بررسی نمی‌کند که فایل اجرایی مدیریت‌شده با بسته یا قابل نوشتن است.
- استفاده از `--version` با یک برچسب قدیمی‌تر، راه بازگشت به نسخه قبلی است.

## مرتبط

- [نصب](https://ccam.dev/fa/docs/install.md)
- [فرمان‌ها](https://ccam.dev/fa/docs/commands.md)
- [پرسش‌های متداول](https://ccam.dev/fa/docs/faq.md)