Simplify versioning system for user guides
This new approach doesn't require version numbers and make easier for contributors to understand the status
of the document. There are only 3 states:
- Outdated: The page is outdated and might not work as expected
- Untranslated: The page needs to be translated
- Translation outdated: The page is translated, but the original (English) document has been updated
To mark a guide as outdated, we change the boolean of the front matter entry 'outdated' in /resources/user-guides/GUIDE.
If 'False', the guide is updated. If 'True' all versions of the guide (English included) will show a warning at the bottom
of the page.
The other 2 states are related to the status of the translated pages and we control them from the language-specific
user guides: /_i18n/LANG/resources/user-guides/GUIDE. At the top of the page a snippet will include 2 parameters:
- translated: "yes" if the page is translated, "no" if it's not.
- translationOutdated: "yes" if the translation is outdated, "no" if it's not
This new system aims to be simpler than the precedent, avoiding to compare versioning numbers and using a higher level
system instead (yes, no, True, False). I also removed the middle way status 'only minor changes', because if there are
only minor changes that don't affect the usability of the guide, we don't need to point it out.
The old system was complex and people didn't use it. These changes will hopefully make things easier for translators and
other contributors.
2020-05-03 13:38:01 +00:00
{% include disclaimer.html translated="yes" translationOutdated="no" %}
2018-07-16 13:13:48 +00:00
# التأكد من ملفات التثبيت : ليُنكس وماك وويندوز بإستخدام واجهه سطر الأوامر (مُتطور)
التأكد من صحه ملفات التثبيت يجب أن يكون قبل فك الضغط أو التثبيت أو إستخدام البرامج. هذه هي الطريقه الوحيده للتأكد من حصولك علي البرامج الرسميه. إذا حصلت علي ملفات تثبيت مزيفه ( مثال هجمات التصيد و إختراق الإتصال وخلافه) بمتابعه هذا لدليل سوف تحمي نفسك من الوقوع ضحيه لهذه الملفات.
لحماية تكامل الثنائيات ، يوفر فريق مونيرو قائمة موقعة مشفرة لكل الملفات [SHA256] (https://en.wikipedia.org/wiki/SHA-2). إذا تم العبث بالملف الذي تم تنزيله ، فسيتم إنتاجه [هاش مختلف] (https://en.wikipedia.org/wiki/File_verification) عن الموجود في الملف.
هذا دليل متقدم يستخدم سطر الأوامر لنُظم تشغيل لينُكس وويندوز وماك سيوجهك خلال عملية تثبيت البرامج المطلوبه واستيراد مفتاح التوقيع وتنزيل الملفات الضرورية وأخيرًا التحقق من صحة ملفات التثبيت.
## قائمه المحتوي:
### [1. تثبيت GnuPG](#1-installing-gnupg)
### [2. تأكيد & إستيراد ملف مفتاح التوقيع](#2-verify-and-import-signing-key)
+ [2.1. إحصل علي مفتاح التوقيع ](#21-get-signing-key )
+ [2.2. تأكد من مفتاح التوقيع ](#22-verify-signing-key )
+ [2.3. إستيراد مفتاح التوقيع ](#23-import-signing-key )
### [3. تنزيل & تأكد من ملف الهاش](#3-download-and-verify-hash-file)
+ [3.1. إحصل علي ملف الهاش ](#31-get-hash-file )
+ [3.2. تأكد من ملف الهاش ](#32-verify-hash-file )
### [4. تحميل & تأكد من ملفات التسطيب ](#4-download-and-verify-binary)
+ [4.1. الحصول علي ملفات التسطيب ](#41-get-monero-binary )
+ [4.2. تأكد من الملفات علي ليُنكس اوماك ](#42-binary-verification-on-linux-or-mac )
+ [4.3. تأكد من الملفات علي ويندوز ](#43-binary-verification-on-windows )
## 1. تثبيت GnuPG
+ في ويندوز انتقل إلى صفحة التنزيل [Gpg4win] (https://gpg4win.org/download.html) واتبع الإرشادات الخاصة بالتثبيت.
+ في ماك انتقل إلى صفحة تنزيل [Gpgtools] (https://gpgtools.org/) واتبع الإرشادات الخاصة بالتثبيت.
+ في ليُنكس ، GnuPG مُثبّت افتراضيًا.
## 2. تأكيد & إستيراد ملف مفتاح التوقيع
سيغطي هذا القسم الحصول على مفتاح توقيع مونيرو والتأكد من صحته واستيراد المفتاح إلى GnuPG.
### 2.1. إحصل علي مفتاح التوقيع
2020-04-17 09:46:11 +00:00
علي ويندوز أو ماك إذهب إلي [binaryFate's GPG key ](https://raw.githubusercontent.com/monero-project/monero/master/utils/gpg_keys/binaryfate.asc ) لتحميل المُفتاح المُستخدم في توقيع الملفات وقم بحفظه بإسم `binaryfate.asc` في مجلدك الرئيسي.
2018-07-16 13:13:48 +00:00
في ليُنكس يمكنك تحميل ملف مفتاح التوقيع من خلال الأمر التالي :
```
2020-04-17 09:46:11 +00:00
wget -O binaryfate.asc https://raw.githubusercontent.com/monero-project/monero/master/utils/gpg_keys/binaryfate.asc
2018-07-16 13:13:48 +00:00
```
### 2.2. تأكد من مفتاح التوقيع
2020-04-17 09:46:11 +00:00
في جميع أنظمة التشغيل ، تحقق من بصمة `binaryfate.asc` بإصدار الأمر التالي في سطر الأوامر :
2018-07-16 13:13:48 +00:00
```
2020-04-17 09:46:11 +00:00
gpg --keyid-format long --with-fingerprint binaryfate.asc
2018-07-16 13:13:48 +00:00
```
تحقق من تطابق البصمه بالتالي :
```
2020-04-17 09:46:11 +00:00
pub rsa4096/F0AF4D462A0BDF92 2019-12-12 [SCEA]
Key fingerprint = 81AC 591F E9C4 B65C 5806 AFC3 F0AF 4D46 2A0B DF92
uid binaryFate < binaryfate @ getmonero . org >
2018-07-16 13:13:48 +00:00
```
إذا كانت البصمه **صحيحه** يمكنك المُتابعه.
2020-04-17 09:46:11 +00:00
إذا كانت البصمه ** غير متطابقه ** **لا تُكمل** بل قم بحذف ملف `binaryfate.asc` وإذهب إلي [فصل 2.1 ](#21-get-signing-key ).
2018-07-16 13:13:48 +00:00
### 2.3. إستيراد مفتاح التوقيع
من سطر الأوامر ، قم باستيراد مفتاح التوقيع:
```
2020-04-17 09:46:11 +00:00
gpg --import binaryfate.asc
2018-07-16 13:13:48 +00:00
```
إذا كانت هذه هي المرة الأولى التي تستورد فيها المفتاح ، فسيبدو الناتج كما يلي:
```
2020-04-17 09:46:11 +00:00
gpg: key F0AF4D462A0BDF92: 2 signatures not checked due to missing keys
gpg: key F0AF4D462A0BDF92: public key "binaryFate < binaryfate @ getmonero . org > " imported
2018-07-16 13:13:48 +00:00
gpg: Total number processed: 1
gpg: imported: 1
2020-04-17 09:46:11 +00:00
gpg: marginals needed: 3 completes needed: 1 trust model: pgp
2018-07-16 13:13:48 +00:00
```
إذا قمت باستيراد المفتاح مسبقًا ، فسيبدو الناتج كما يلي:
```
2020-04-17 09:46:11 +00:00
gpg: key F0AF4D462A0BDF92: "binaryFate < binaryfate @ getmonero . org > " not changed
2018-07-16 13:13:48 +00:00
gpg: Total number processed: 1
gpg: unchanged: 1
```
## 3. تنزيل & تأكد من ملف الهاش
سيغطي هذا القسم تنزيل ملف الهاش والتحقق من صحته.
### 3.1. إحصل علي ملف الهاش
2019-12-19 10:29:35 +00:00
على نظام ويندوز أو ماك انتقل إلى [ملف الهاشات على getmonero.org] ({{ site.baseurl }}/downloads/hashes.txt) واحفظ الصفحة كـ `hashes.txt` إلى مجلدك الرئيسي.
2018-07-16 13:13:48 +00:00
في ليُنكس يمكنك تنزيل ملف الهاشات الموقّع عن طريق إصدار الأمر التالي:
```
2020-10-07 17:28:27 +00:00
wget -O hashes.txt https://www.getmonero.org/downloads/hashes.txt
2018-07-16 13:13:48 +00:00
```
### 3.2. تأكد من ملف الهاش
2020-04-17 09:46:11 +00:00
ملف الهاش موقع بمفتاح `81AC 591F E9C4 B65C 5806 AFC3 F0AF 4D46 2A0B DF92` , كما هو موضح في الناتج أدناه.
2018-07-16 13:13:48 +00:00
في جميع أنظمة التشغيل ، تحقق من توقيع ملف التجزئة عن طريق إصدار الأمر التالي في سطر الأوامر:
```
gpg --verify hashes.txt
```
إذا كان الملف صحيح ، سيبدو الناتج كما يلي:
```
2020-04-17 09:46:11 +00:00
gpg: using RSA key 81AC591FE9C4B65C5806AFC3F0AF4D462A0BDF92
gpg: Good signature from "binaryFate < binaryfate @ getmonero . org > " [unknown]
2018-07-16 13:13:48 +00:00
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
2020-04-17 09:46:11 +00:00
Primary key fingerprint: 81AC 591F E9C4 B65C 5806 AFC3 F0AF 4D46 2A0B DF92
2018-07-16 13:13:48 +00:00
```
إذا كان الناتج يُظهر ** Good signature ** كما هو موضح في المثال فيمكنك المتابعة.
إذا كان الناتج **BAD signature** **لا تُكمل** بل قم بحذف ملف `hashes.txt` وإرجع إلي [القسم 3.1 ](#31-get-hash-file ).
## 4. تحميل & تأكد من ملفات التسطيب
سيغطي هذا القسم تنزيل برنامج مونيرو لنظام التشغيل الخاص بك ، والحصول على هاش `SHA256` من التنزيل الخاص بك ، والتحقق من صحته.
### 4.1. الحصول علي ملفات التسطيب
2019-12-19 10:29:35 +00:00
علي ويندوز أو ماك توجه إلي [getmonero.org ]({{ site.baseurl }}/downloads/ ) وقم بتنزيل الملف الخاص بنظام التشغيل الخاص بك. قم بحفظ الملف لمجلدك الرئيسي. **لا تقم بفك الضغط **
2018-07-16 13:13:48 +00:00
في Linux ، يمكنك تنزيل واجهه سطر الأوامر عن طريق إصدار الأمر التالي:
```
2020-04-17 09:46:11 +00:00
wget -O monero-linux-x64-v0.15.0.1.tar.bz2 https://downloads.getmonero.org/cli/linux64
2018-07-16 13:13:48 +00:00
```
### 4.2. تأكد من الملفات علي ليُنكس اوماك
2020-04-17 09:46:11 +00:00
هذه الخطوات لنظامي تشغيل لينُكس وماك. من سطر الأوامر إحصل علي هاش `SHA256` لملف التثبيت. كمثال سيستخدم هذا الدليل واجهه المستخدم الرسوميه علي ليُنكس , إستبدل `monero-gui-linux-x64-v0.15.0.1.tar.bz2` بإسم ملف التثبيت الذي قمت بتنزيله في [الفصل 4.1 ](#41-get-monero-binary ).
2018-07-16 13:13:48 +00:00
```
2020-04-17 09:46:11 +00:00
shasum -a 256 monero-gui-linux-x64-v0.15.0.1.tar.bz2
2018-07-16 13:13:48 +00:00
```
سيبدو الناتج كهذا ، ولكن سيكون مختلفًا لكل ملف. يجب أن يتطابق هاش `SHA256` الخاصة بك مع الهاش في القائمة المدرجة في ملف` hashes.txt` لملف التثبيت.
```
2020-04-17 09:46:11 +00:00
fb0f43387b31202f381c918660d9bc32a3d28a4733d391b1625a0e15737c5388 monero-gui-linux-x64-v0.15.0.1.tar.bz2
2018-07-16 13:13:48 +00:00
```
إذا كان الهاش **مُتطابق** يمكنك الأن فك الضفط والتثبيت.
إذا كان الهاش **غير مُتطابق** , ** لا تُكمل ** بل إحذف ملف التثبيت وإرجع إلي [القسم 4.1 ](#41-get-monero-binary ).
### 4.3. تأكد من الملفات علي ويندوز
2020-04-17 09:46:11 +00:00
من سطر الأوامر احصل على هاش `SHA256` من ملف التثبيت الذي تم تنزيله. على سبيل المثال ، سيستخدم هذا الدليل ثنائي واجهة المستخدم الرسومية لنظام ويندوز ، 64 بت. استبدل `monero-gui-win-x64-v0.15.0.1.zip` باسم الملف الذي قمت بتنزيله في [القسم 4.1 ](#41-get-monero-binary ).
2018-07-16 13:13:48 +00:00
```
certUtil -hashfile monero-gui-win-x64-v0.12.0.0.zip SHA256
```
سيبدو الناتج كهذا ، ولكن سيكون مختلفًا لكل ملف. يجب أن يتطابق هاش `SHA256` الخاصة بك مع الهاش في القائمة المدرجة في ملف` hashes.txt` لملف التثبيت.
```
SHA256 hash of file monero-gui-win-x64-v0.12.0.0.zip:
4b 9f 31 68 6e ca ad 97 cd b1 75 e6 57 4b f3 07 f8 d1 c4 10 42 78 25 f4 30 4c 21 da 8a ac 18 64
CertUtil: -hashfile command completed successfully.
```
إذا كان الهاش **مُتطابق** يمكنك الأن فك الضفط والتثبيت.
إذا كان الهاش **غير مُتطابق** , ** لا تُكمل ** بل إحذف ملف التثبيت وإرجع إلي [القسم 4.1 ](#41-get-monero-binary ).