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

التثبيت

يغطي هذا القسم خطوات إعداد بيئتك المحلية لتطوير سولانا.

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

على أنظمة Mac وLinux، قم بتشغيل هذا الأمر الواحد لتثبيت جميع التبعيات.

Terminal
$ 
curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

مستخدمو Windows: يجب عليك أولاً تثبيت WSL (انظر تثبيت التبعيات). ثم قم بتشغيل الأمر السابق في طرفية Ubuntu (Linux).

بعد التثبيت، يجب أن ترى مخرجات مثل ما يلي:

Installed Versions:

Rust: rustc 1.86.0 (05f9846f8 2025-03-31)

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

Anchor CLI: anchor-cli 0.31.1

Node.js: v23.11.0

Yarn: 1.22.1

إذا لم يعمل أمر التثبيت السريع، يرجى الرجوع إلى قسم تثبيت التبعيات أدناه للحصول على تعليمات لتثبيت كل تبعية بشكل فردي.

إذا تم تنفيذ أمر التثبيت السريع بنجاح، انتقل إلى أقسام أساسيات واجهة سطر أوامر سولانا و أساسيات واجهة سطر أوامر Anchor أدناه.

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

الإرشادات أدناه ترشدك خلال تثبيت كل تبعية بشكل فردي.

  • يجب على مستخدمي Windows أولاً تثبيت WSL (نظام Windows الفرعي لـ Linux) ثم تثبيت التبعيات المحددة في قسم Linux أدناه.
  • يجب على مستخدمي Linux أولاً تثبيت التبعيات المحددة في قسم Linux أدناه.
  • يجب على مستخدمي Mac البدء بتعليمات تثبيت Rust أدناه.

تثبيت Rust

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

قم بتثبيت Rust باستخدام rustup.

قم بتشغيل الأمر التالي لتثبيت Rust:

Terminal
$ 
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

يجب أن ترى الرسالة التالية بعد اكتمال التثبيت:

قم بتشغيل الأمر التالي لإعادة تحميل متغير بيئة PATH الخاص بك ليشمل دليل bin الخاص بـ Cargo:

Terminal
$ 
. "$HOME/.cargo/env"

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

Terminal
$ 
rustc --version

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

rustc 1.86.0 (05f9846f8 2025-03-31)

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

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

قم بتثبيت مجموعة أدوات واجهة سطر أوامر سولانا باستخدام أمر التثبيت الرسمي:

Terminal
$ 
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

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

عند تثبيت واجهة سطر أوامر سولانا للمرة الأولى، قد ترى الرسالة التالية التي تطلب منك إضافة متغير بيئة PATH:

Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:



export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

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

أولاً، قم بتشغيل الأمر التالي للتحقق من الشل الذي تستخدمه:

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

اعتمادًا على الشل الخاص بك، قم بتشغيل الأمر المناسب.

لـ 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

ثم قم بتشغيل الأمر التالي لتحديث جلسة الطرفية أو إعادة تشغيل الطرفية الخاصة بك.

Terminal
$ 
source ~/.bashrc # If using Bash

$ 
source ~/.zshrc # If using Zsh

للتحقق من نجاح التثبيت، تحقق من إصدار واجهة سطر أوامر سولانا:

Terminal
$ 
solana --version

يجب أن ترى مخرجات مثل ما يلي:

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

يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على Github.

Agave هو عميل validator من Anza، المعروف سابقًا باسم عميل validator من Solana Labs.

لتحديث واجهة سطر أوامر سولانا لاحقًا إلى أحدث إصدار، يمكنك استخدام الأمر التالي:

Terminal
$ 
agave-install update

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

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

يمكنك تثبيت واجهة سطر أوامر Anchor والأدوات بطريقتين:

  1. مدير إصدارات Anchor (AVM) - طريقة التثبيت الموصى بها
  2. بدون AVM - التثبيت مباشرة من GitHub

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

قم بتثبيت AVM باستخدام الأمر التالي:

Terminal
$ 
cargo install --git https://github.com/coral-xyz/anchor avm --force

تأكد من تثبيت AVM بنجاح:

Terminal
$ 
avm --version

قم بتثبيت أحدث إصدار من Anchor CLI باستخدام AVM:

Terminal
$ 
avm install latest

$ 
avm use latest

يمكنك تثبيت إصدار محدد من Anchor CLI عن طريق تحديد رقم الإصدار:

Terminal
$ 
avm install 0.30.1

$ 
avm use 0.30.1

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

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

للتحقق من نجاح التثبيت، تحقق من إصدار Anchor CLI:

Terminal
$ 
anchor --version

يجب أن ترى مخرجات مثل ما يلي:

anchor-cli 0.31.1

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

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

إذا رأيت رسالة الخطأ هذه:

  1. قم بتثبيت التبعيات المذكورة في قسم Linux في أعلى هذه الصفحة.
  2. أعد محاولة تثبيت Anchor CLI.

Node.js و Yarn

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

عند تشغيل anchor build، إذا واجهت الأخطاء التالية:

بعد تطبيق الحل السابق، حاول تشغيل anchor build مرة أخرى.

عند تشغيل anchor test بعد إنشاء مشروع Anchor جديد على لينكس أو WSL، قد تواجه الأخطاء التالية إذا لم يكن لديك Node.js أو Yarn مثبتين:

Permission denied (os error 13)
No such file or directory (os error 2)

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

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

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

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

يشرح هذا القسم بعض أوامر واجهة سطر الأوامر (CLI) الشائعة في سولانا للبدء.

إعدادات سولانا

لعرض الإعدادات الحالية:

Terminal
$ 
solana config get

يجب أن ترى مخرجات مثل ما يلي:

Config File: /Users/test/.config/solana/cli/config.yml

RPC URL: https://api.mainnet-beta.solana.com

WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)

Keypair Path: /Users/test/.config/solana/id.json

Commitment: confirmed

يحدد عنوان RPC URL وعنوان Websocket URL مجموعة سولانا التي ترسل إليها واجهة سطر الأوامر الطلبات.

يمكنك تحديث مجموعة سولانا في واجهة سطر الأوامر باستخدام الأوامر التالية:

Terminal
$ 
solana config set --url mainnet-beta

$ 
solana config set --url devnet

$ 
solana config set --url localhost

$ 
solana config set --url testnet

يمكنك أيضًا استخدام الخيارات المختصرة التالية:

Terminal
$ 
solana config set -um    # For mainnet-beta

$ 
solana config set -ud    # For devnet

$ 
solana config set -ul    # For localhost

$ 
solana config set -ut    # For testnet

يشير مسار keypair إلى محفظة سولانا الافتراضية (keypair) التي تستخدمها واجهة سطر أوامر سولانا لدفع رسوم المعاملات ونشر البرامج. بشكل افتراضي، يتم تخزين هذا الملف في ~/.config/solana/id.json.

إنشاء محفظة

لإرسال المعاملات باستخدام واجهة سطر أوامر سولانا، تحتاج إلى محفظة سولانا ممولة بعملة SOL.

لإنشاء keypair في مسار Keypair الافتراضي، قم بتشغيل الأمر التالي:

Terminal
$ 
solana-keygen new

يجب أن ترى مخرجات مثل ما يلي:

Generating a new keypair



For added security, enter a BIP39 passphrase



NOTE! This passphrase improves security of the recovery seed phrase NOT the

keypair file itself, which is stored as insecure plain text



BIP39 Passphrase (empty for none):



Wrote new keypair to /Users/test/.config/solana/id.json

===========================================================================

pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT

===========================================================================

Save this seed phrase and your BIP39 passphrase to recover your new keypair:

cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing

===========================================================================

إذا كان لديك بالفعل محفظة نظام ملفات محفوظة في الموقع الافتراضي، فإن هذا الأمر لا يقوم بتجاوزها إلا إذا قمت بفرض التجاوز صراحةً باستخدام علامة --force.

لعرض عنوان محفظتك (المفتاح العام)، قم بتشغيل:

Terminal
$ 
solana address

إسقاط جوي لعملة SOL

اطلب إسقاطًا جويًا لعملة SOL إلى محفظتك لدفع تكاليف المعاملات ونشر البرامج.

قم بتعيين مجموعتك إلى شبكة التطوير (devnet):

Terminal
$ 
solana config set -ud

ثم اطلب إسقاطًا جويًا لعملة SOL من شبكة التطوير:

Terminal
$ 
solana airdrop 2

تقيد الإسقاطات الجوية في شبكة التطوير الطلبات إلى 5 SOL لكل طلب. إذا واجهت حدود معدل الطلبات أو أخطاء، حاول استخدام صنبور الويب بدلاً من ذلك.

للتحقق من رصيد SOL في محفظتك، قم بتشغيل الأمر التالي:

Terminal
$ 
solana balance

تشغيل المصادق المحلي

تتضمن واجهة سطر أوامر سولانا مصادقًا اختباريًا مدمجًا للتطوير المحلي.

في نافذة طرفية منفصلة، قم بتشغيل الأمر التالي لبدء مصادق محلي:

Terminal
$ 
solana-test-validator

تذكر أيضًا تحديث واجهة سطر الأوامر الخاصة بك لاستخدام المضيف المحلي قبل تشغيل أوامر واجهة سطر أوامر سولانا:

Terminal
$ 
solana config set -ul

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

يستعرض هذا القسم بعض أوامر واجهة سطر أوامر Anchor الشائعة لمساعدتك في البدء. لمزيد من المعلومات حول واجهة سطر أوامر Anchor، راجع وثائق Anchor.

تهيئة المشروع

لإنشاء مشروع Anchor جديد، قم بتشغيل الأمر التالي:

Terminal
$ 
anchor init <project-name>

على سبيل المثال، لإنشاء مشروع يسمى my-project، قم بتشغيل:

Terminal
$ 
anchor init my-project

يقوم هذا الأمر بإنشاء دليل جديد باسم المشروع وتهيئة مشروع Anchor جديد مع برنامج Rust أساسي ونموذج اختبار TypeScript.

انتقل إلى دليل المشروع:

Terminal
$ 
cd <project-name>

اطلع على هيكل ملفات مشروع Anchor.

بناء البرنامج

لبناء مشروعك، قم بتشغيل الأمر التالي:

Terminal
$ 
anchor build

يمكنك العثور على البرنامج المُجمّع في دليل /target/deploy.

نشر البرنامج

لنشر مشروعك، قم بتشغيل الأمر التالي:

Terminal
$ 
anchor deploy

يقوم هذا الأمر بنشر برنامجك إلى cluster المحدد في ملف Anchor.toml.

اختبار البرنامج

لاختبار مشروعك، قم بتشغيل الأمر التالي:

Terminal
$ 
anchor test

يقوم هذا الأمر ببناء ونشر وتشغيل الاختبارات لمشروعك.

عند استخدام localnet كـ cluster في Anchor.toml، يقوم Anchor تلقائيًا بتشغيل validator محلي، ونشر برنامجك، وتشغيل الاختبارات، ثم إيقاف الـ validator.

Is this page helpful?

السابق

تكوين برامج متعددة

التالي

المفاهيم الأساسية

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

تعديل الصفحة

تدار بواسطة

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