نظرة عامة

يأتي Bun كملف تنفيذي واحد بدون تبعيات. يمكنك تثبيته عبر سكربت أو مدير حزم أو Docker عبر macOS وLinux وWindows.

تحذير

بعد التثبيت، تحقق باستخدام bun --version و bun --revision.

التثبيت

macOS و Linux

curl -fsSL https://bun.com/install | bash

تحذير

مستخدمو Linux - حزمة unzip مطلوبة لتثبيت Bun. استخدم sudo apt install unzip لتثبيت حزمة unzip. يُنصح بشدة بإصدار Kernel 5.6 أو أعلى، لكن الحد الأدنى هو 5.1. استخدم uname -r للتحقق من إصدار Kernel.

Windows

powershell -c "irm bun.sh/install.ps1|iex"

WARNING

  يتطلب Bun Windows 10 الإصدار 1809 أو أحدث.

للحصول على الدعم والنقاش، يرجى الانضمام إلى قناة #windows على Discord.

مديرو الحزم

npm install -g bun # آخر أمر `npm` ستحتاجه ever

brew install oven-sh/bun/bun

scoop install bun

Docker

يوفر Bun صورة Docker تدعم كلاً من Linux x64 و arm64.

docker pull oven/bun
docker run --rm --init --ulimit memlock=-1:-1 oven/bun

متغيرات الصورة

هناك أيضًا متغيرات صور لأنظمة تشغيل مختلفة:

docker pull oven/bun:debian
docker pull oven/bun:slim
docker pull oven/bun:distroless
docker pull oven/bun:alpine

للتحقق من تثبيت Bun بنجاح، افتح نافذة طرفية جديدة وشغّل:

bun --version
# المخرج: 1.x.y

# شاهد الـ commit الدقيق لـ `oven-sh/bun` الذي تستخدمه
bun --revision
# المخرج: 1.x.y+b7982ac13189

WARNING

إذا قمت بتثبيت Bun ولكنك ترى خطأ command not found، فقد تضطر إلى إضافة دليل التثبيت (~/.bun/bin) يدويًا إلى PATH.

إضافة Bun إلى PATH

macOS و Linux

echo $SHELL
# /bin/zsh  أو /bin/bash أو /bin/fish

افتح ملف تكوين الـ shell

• لـ bash: ~/.bashrc
• لـ zsh: ~/.zshrc
• لـ fish: ~/.config/fish/config.fish

إضافة دليل Bun إلى PATH

أضف هذا السطر إلى ملف التكوين الخاص بك:

export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

إعادة تحميل تكوين الـ shell

source ~/.bashrc  # أو ~/.zshrc

Windows

        ```bash
        & "$env:USERPROFILE\.bun\bin\bun" --version
        ```

        إذا نجح الأمر ولكن `bun --version` غير معترف به، فهذا يعني أن bun ليس في PATH الخاص بالنظام. لإصلاح ذلك، افتح طرفية Powershell وشغّل الأمر التالي:

        ```bash
        [System.Environment]::SetEnvironmentVariable(
          "Path",
          [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin",
          [System.EnvironmentVariableTarget]::User
        )
        ```

#### إعادة تشغيل الطرفية
بعد تشغيل الأمر، أعد تشغيل الطرفية واختبر باستخدام `bun --version`

```bash
bun --version

---

الترقية

بمجرد التثبيت، يمكن للثنائي ترقية نفسه:

bun upgrade

---

إصدارات Canary

-> عرض إصدار canary

يُصدر Bun تلقائيًا إصدار canary (غير مختبر) مع كل commit إلى main. للترقية إلى أحدث إصدار canary:

# الترقية إلى أحدث canary
bun upgrade --canary

# العودة إلى الإصدار المستقر
bun upgrade --stable

إصدار canary مفيد لاختبار الميزات الجديدة وإصلاحات الأخطاء قبل إصدارها في إصدار مستقر. لمساعدة فريق Bun على إصلاح الأخطاء بشكل أسرع، تقوم إصدارات canary تلقائيًا برفع تقارير الأعطال إلى فريق Bun.

---

تثبيت الإصدارات الأقدم

نظرًا لأن Bun ملف ثنائي واحد، يمكنك تثبيت الإصدارات الأقدم عن طريق إعادة تشغيل سكربت التثبيت بإصدار محدد.

####Linux و macOS"> لتثبيت إصدار محدد، مرر git tag إلى سكربت التثبيت:

```bash
curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"
```

####Windows"> على Windows، مرر رقم الإصدار إلى سكربت تثبيت PowerShell:

```powershell PowerShell
iex "& {$(irm https://bun.com/install.ps1)} -Version 1.3.3"
```

---

التنزيلات المباشرة

لتنزيل ملفات Bun الثنائية مباشرة، قم بزيارة صفحة الإصدارات على GitHub.

تنزيلات أحدث إصدار

ملف ثنائي قياسي لـ Linux x64

لوحدات المعالجة الأقدم بدون AVX2

ملف ثنائي قياسي لـ Windows

لوحدات المعالجة الأقدم بدون AVX2

Apple Silicon (M1/M2/M3)

أجهزة Mac Intel

أنظمة ARM64 Linux

ملفات Musl الثنائية

للتوزيعات بدون glibc (Alpine Linux و Void Linux):

• Linux x64 musl
• Linux x64 musl baseline
• Linux ARM64 musl

TIP

إذا واجهت خطأ مثل bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found، فحاول استخدام الملف الثنائي musl. يختار سكربت تثبيت Bun تلقائيًا الملف الثنائي الصحيح لنظامك.

---

متطلبات وحدة المعالجة المركزية

يحتوي Bun على متطلبات محددة لوحدة المعالجة المركزية بناءً على الملف الثنائي الذي تستخدمه:

الإصدارات القياسية

ملفات x64 الثنائية تستهدف بنية معالج Haswell (تعليمات AVX و AVX2 مطلوبة)

المنصة	متطلبات Intel	متطلبات AMD
x64	Haswell (الجيل الرابع Core) أو أحدث	Excavator أو أحدث

الإصدارات الأساسية

ملفات x64-baseline الثنائية تستهدف بنية Nehalem لوحدات المعالجة الأقدم

المنصة	متطلبات Intel	متطلبات AMD
x64-baseline	Nehalem (الجيل الأول Core) أو أحدث	Bulldozer أو أحدث

WARNING

الإصدارات الأساسية أبطأ من الإصدارات العادية. استخدمها فقط إذا واجهت خطأ "Illegal Instruction".

::: note لا يدعم Bun وحدات المعالجة الأقدم من الهدف الأساسي، الذي يتطلب امتداد SSE4.2. يتطلب macOS الإصدار 13.0 أو أحدث. :::

إلغاء التثبيت

لإزالة Bun من نظامك:

macOS و Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

مديرو الحزم

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun