وثائق سولاناالبدءالتثبيت

تثبيت التبعيات

دليل لإعداد بيئة تطوير سولانا المحلية الخاصة بك. تعلم كيفية تثبيت Rust وواجهة سطر أوامر سولانا وإطار عمل Anchor على Windows (WSL) وLinux و Mac. استخدم هذا الدليل إذا كنت تفضل تثبيت كل تبعية على حدة، أو إذا فشل التثبيت السريع لأي سبب.

المتطلبات الأساسية

تثبيت Rust

يقوم المطورون ببناء برامج سولانا باستخدام لغة البرمجة Rust.

  1. قم بتثبيت Rust باستخدام rustup عن طريق إدخال الأمر التالي في الطرفية الخاصة بك:
Terminal
$ 
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

بعد التثبيت الناجح سترى الرسالة التالية:

  1. أعد تحميل متغير بيئة PATH الخاص بك لتضمين دليل bin الخاص بـ Cargo:
Terminal
$ 
. "$HOME/.cargo/env"
  1. تحقق من نجاح التثبيت.
Terminal
$ 
rustc --version

سترى مخرجات مثل ما يلي:

rustc 1.86.0 (05f9846f8 2025-03-31)

تثبيت Solana CLI

توفر Solana CLI جميع الأدوات المطلوبة لبناء ونشر برامج سولانا.

  1. قم بتثبيت مجموعة أدوات Solana CLI باستخدام أمر التثبيت الرسمي:
Terminal
$ 
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

يمكنك استبدال stable بعلامة الإصدار المطابقة لإصدار البرنامج الذي تريده (مثل v2.0.3)، أو استخدام أحد أسماء القنوات الرمزية الثلاثة: stable، beta، أو edge.

  1. أضف متغير بيئة PATH

قد يطالبك التثبيت الأول لـ Solana CLI بإضافة متغير بيئة PATH. للقيام بذلك، أغلق وأعد فتح الطرفية الخاصة بك أو قم بتشغيل الأمر التالي في shell الخاص بك:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
  1. حدّث متغير بيئة PATH الخاص بك

إذا كنت تستخدم Linux أو WSL، يجب عليك إضافة ملف Solana CLI الثنائي إلى PATH الخاص بك حتى يكون الأمر متاحًا في الطرفية الخاصة بك. للقيام بذلك، اتبع الخطوات أدناه:

أ. تحقق من shell الذي تستخدمه:

Terminal
$ 
echo $SHELL
  • إذا كانت المخرجات تحتوي على /bash، استخدم .bashrc.
  • إذا كانت المخرجات تحتوي على /zsh، استخدم .zshrc.

ب. قم بتشغيل الأمر المناسب، بناءً على الصدفة (shell) التي تستخدمها.

لـ Bash (bashrc):

Terminal
$ 
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc

$ 
source ~/.bashrc

لـ Zsh (zshrc):

Terminal
$ 
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc

$ 
source ~/.zshrc
  1. أعد تشغيل الطرفية أو قم بتشغيل الأمر التالي لتحديث جلسة الطرفية:
Terminal
$ 
source ~/.bashrc # If using Bash

$ 
source ~/.zshrc # If using Zsh
  1. تحقق من نجاح التثبيت عن طريق فحص إصدار واجهة سطر أوامر سولانا:
Terminal
$ 
solana --version

سترى مخرجات مشابهة لما يلي:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على Github. Agave هو عميل المدقق (validator) من Anza، المعروف سابقاً باسم عميل المدقق من Solana Labs.

  1. قم بتحديث واجهة سطر أوامر سولانا إلى أحدث إصدار، حسب الحاجة (اختياري)
Terminal
$ 
agave-install update

تثبيت واجهة سطر أوامر Anchor

Anchor هو إطار عمل لتطوير برامج سولانا. يستفيد إطار عمل Anchor من وحدات ماكرو Rust لتبسيط عملية كتابة برامج سولانا.

المتطلبات الأساسية

ملف اختبار مشروع Anchor الافتراضي (TypeScript) الذي تم إنشاؤه باستخدام الأمر anchor init يتطلب Node.js وYarn. (قالب اختبار Rust متاح باستخدام anchor init --test-template rust)

التثبيت

يمكنك تثبيت Anchor CLI والأدوات بطريقتين:

  • Anchor Version Manager (AVM) — طريقة التثبيت الموصى بها
  • بدون AVM — التثبيت مباشرة من GitHub

يتيح لك مدير إصدارات Anchor (AVM) تثبيت وإدارة إصدارات Anchor المختلفة على نظامك وتحديث إصدارات Anchor بسهولة في المستقبل. لتثبيت Anchor باستخدام AVM، اتبع الخطوات أدناه:

  1. قم بتثبيت AVM باستخدام الأمر التالي:
Terminal
$ 
cargo install --git https://github.com/solana-foundation/anchor avm --force
  1. تأكد من نجاح تثبيت AVM:
Terminal
$ 
avm --version
  1. قم بتثبيت واجهة سطر أوامر Anchor باستخدام AVM:

لتثبيت أحدث إصدار:

Terminal
$ 
avm install latest

$ 
avm use latest

لتثبيت إصدار محدد، حدد رقم الإصدار:

Terminal
$ 
avm install 0.30.1

$ 
avm use 0.30.1

عند تثبيت واجهة سطر أوامر Anchor على Linux أو WSL، قد تواجه هذا الخطأ:

error: could not exec the linker cc = note: Permission denied (os error 13)

إذا رأيت رسالة الخطأ هذه، اتبع الخطوات التالية:

  1. قم بتثبيت التبعيات المدرجة في قسم Linux في أعلى هذه الصفحة.
  2. أعد محاولة تثبيت واجهة سطر أوامر Anchor.
  1. تحقق من نجاح التثبيت، من خلال التحقق من إصدار واجهة سطر أوامر Anchor:
Terminal
$ 
anchor --version

سترى مخرجات مشابهة لما يلي:

anchor-cli 0.31.1

لا تنس تشغيل أمر avm use لتحديد إصدار واجهة سطر أوامر Anchor الذي سيتم تشغيله على نظامك.

  • إذا قمت بتثبيت الإصدار latest، قم بتشغيل avm use latest.
  • إذا قمت بتثبيت الإصدار 0.30.1، قم بتشغيل avm use 0.30.1.

تثبيت واجهة سطر أوامر Surfpool

Surfpool هي أداة للتطوير المحلي وبديل محسّن لـ solana-test-validator. تعرف على المزيد حول ميزات Surfpool في وثائق Surfpool.

  1. قم بتثبيت Surfpool باستخدام الأمر التالي:
Terminal
$ 
curl -sL https://run.surfpool.run/ | bash
  1. تحقق من نجاح التثبيت من خلال التحقق من إصدار واجهة سطر أوامر Surfpool:
Terminal
$ 
surfpool --version

سترى مخرجات مشابهة لما يلي:

surfpool 0.12.0

إعداد أدوات الذكاء الاصطناعي لتطوير سولانا

يوضح هذا القسم إعداد أدوات الذكاء الاصطناعي الاختيارية التي يمكنك استخدامها لتسريع تطوير سولانا الخاص بك.

الأداةالوصفالرابط
MCPخادم MCP يمكنك الاتصال به باستخدام cursor لتحسين التطوير بمساعدة الذكاء الاصطناعي لسولانا.https://mcp.solana.com/
LLMs.txtوثائق محسّنة لنماذج اللغة الكبيرة يمكنك استخدامها لتدريب نماذج اللغة الكبيرة على وثائق سولانا.https://solana.com/llms.txt

Is this page helpful?

السابق

التثبيت السريع

التالي

أساسيات واجهة سطر أوامر سولانا

جدول المحتويات

تعديل الصفحة

تدار بواسطة

© 2026 مؤسسة سولانا.
جميع الحقوق محفوظة.
سولانا
تواصل معنا