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 16:38:01 +03:00
|
|
|
{% include disclaimer.html translated="yes" translationOutdated="no" %}
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
التأكد من صحه ملفات التثبيت يجب أن يكون قبل فك الضغط أو التثبيت أو إستخدام
|
|
|
|
البرامج. هذه هي الطريقه الوحيده للتأكد من حصولك علي البرامج الرسميه. إذا
|
|
|
|
حصلت علي ملفات تثبيت مزيفه ( مثال هجمات التصيد و إختراق الإتصال وخلافه)
|
|
|
|
بمتابعه هذا لدليل سوف تحمي نفسك من الوقوع ضحيه لهذه الملفات.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
لحماية تكامل الثنائيات ، يوفر فريق مونيرو قائمة موقعة مشفرة لكل الملفات
|
|
|
|
[SHA256] (https://en.wikipedia.org/wiki/SHA-2). إذا تم العبث بالملف الذي تم
|
|
|
|
تنزيله ، فسيتم إنتاجه [هاش مختلف]
|
|
|
|
(https://en.wikipedia.org/wiki/File_verification) عن الموجود في الملف.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
هذا دليل متقدم يستخدم سطر الأوامر لنُظم تشغيل لينُكس وويندوز وماك سيوجهك
|
|
|
|
خلال عملية تثبيت البرامج المطلوبه واستيراد مفتاح التوقيع وتنزيل الملفات
|
|
|
|
الضرورية وأخيرًا التحقق من صحة ملفات التثبيت.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
## Table of Contents:
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### - [Install GnuPG](#installing-gnupg)
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### - [Verify & Import Signing Key](#verify-and-import-signing-key)
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### - [Download & Verify Hash File](#download-and-verify-hash-file)
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### - [Download & Verify Binary](#download-and-verify-binary)
|
|
|
|
|
|
|
|
## Installing GnuPG
|
|
|
|
|
|
|
|
+ في ويندوز انتقل إلى صفحة التنزيل [Gpg4win]
|
|
|
|
(https://gpg4win.org/download.html) واتبع الإرشادات الخاصة بالتثبيت.
|
|
|
|
|
|
|
|
+ في ماك انتقل إلى صفحة تنزيل [Gpgtools] (https://gpgtools.org/) واتبع
|
|
|
|
الإرشادات الخاصة بالتثبيت.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
+ في ليُنكس ، GnuPG مُثبّت افتراضيًا.
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
## Verify and Import Signing Key
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
سيغطي هذا القسم الحصول على مفتاح توقيع مونيرو والتأكد من صحته واستيراد
|
|
|
|
المفتاح إلى GnuPG.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Get Signing Key
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
علي ويندوز أو ماك إذهب إلي [binaryFate's GPG
|
|
|
|
key](https://raw.githubusercontent.com/monero-project/monero/master/utils/gpg_keys/binaryfate.asc)
|
|
|
|
لتحميل المُفتاح المُستخدم في توقيع الملفات وقم بحفظه بإسم `binaryfate.asc`
|
|
|
|
في مجلدك الرئيسي.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
في ليُنكس يمكنك تحميل ملف مفتاح التوقيع من خلال الأمر التالي :
|
|
|
|
|
|
|
|
```
|
2021-05-22 15:52:40 +03:00
|
|
|
wget -O binaryfate.asc
|
|
|
|
https://raw.githubusercontent.com/monero-project/monero/master/utils/gpg_keys/binaryfate.asc
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Verify Signing Key
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
في جميع أنظمة التشغيل ، تحقق من بصمة `binaryfate.asc` بإصدار الأمر التالي في
|
|
|
|
سطر الأوامر :
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
``` gpg --keyid-format long --with-fingerprint binaryfate.asc ```
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
|
|
|
|
تحقق من تطابق البصمه بالتالي :
|
|
|
|
|
|
|
|
```
|
2020-04-17 12:46:11 +03: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 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
إذا كانت البصمه **صحيحه** يمكنك المُتابعه.
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
إذا كانت البصمه ** غير متطابقه ** **لا تُكمل** بل قم بحذف ملف
|
|
|
|
`binaryfate.asc` وإذهب إلي [فصل 2.1](#21-get-signing-key).
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Import Signing Key
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
من سطر الأوامر ، قم باستيراد مفتاح التوقيع:
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
``` gpg --import binaryfate.asc ```
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
إذا كانت هذه هي المرة الأولى التي تستورد فيها المفتاح ، فسيبدو الناتج كما
|
|
|
|
يلي:
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
```
|
2020-04-17 12:46:11 +03: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 16:13:48 +03:00
|
|
|
gpg: Total number processed: 1
|
|
|
|
gpg: imported: 1
|
2020-04-17 12:46:11 +03:00
|
|
|
gpg: marginals needed: 3 completes needed: 1 trust model: pgp
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
إذا قمت باستيراد المفتاح مسبقًا ، فسيبدو الناتج كما يلي:
|
|
|
|
|
|
|
|
```
|
2020-04-17 12:46:11 +03:00
|
|
|
gpg: key F0AF4D462A0BDF92: "binaryFate <binaryfate@getmonero.org>" not changed
|
2018-07-16 16:13:48 +03:00
|
|
|
gpg: Total number processed: 1
|
|
|
|
gpg: unchanged: 1
|
|
|
|
```
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
## Download and Verify Hash File
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
سيغطي هذا القسم تنزيل ملف الهاش والتحقق من صحته.
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Get Hash File
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
على نظام ويندوز أو ماك انتقل إلى [ملف الهاشات على getmonero.org] ({{
|
|
|
|
site.baseurl }}/downloads/hashes.txt) واحفظ الصفحة كـ `hashes.txt` إلى مجلدك
|
|
|
|
الرئيسي.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
في ليُنكس يمكنك تنزيل ملف الهاشات الموقّع عن طريق إصدار الأمر التالي:
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
``` wget -O hashes.txt https://www.getmonero.org/downloads/hashes.txt ```
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Verify Hash File
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
ملف الهاش موقع بمفتاح `81AC 591F E9C4 B65C 5806 AFC3 F0AF 4D46 2A0B DF92`,
|
|
|
|
كما هو موضح في الناتج أدناه.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
في جميع أنظمة التشغيل ، تحقق من توقيع ملف التجزئة عن طريق إصدار الأمر التالي
|
|
|
|
في سطر الأوامر:
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
``` gpg --verify hashes.txt ```
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
إذا كان الملف صحيح ، سيبدو الناتج كما يلي:
|
|
|
|
|
|
|
|
```
|
2020-04-17 12:46:11 +03:00
|
|
|
gpg: using RSA key 81AC591FE9C4B65C5806AFC3F0AF4D462A0BDF92
|
|
|
|
gpg: Good signature from "binaryFate <binaryfate@getmonero.org>" [unknown]
|
2018-07-16 16:13:48 +03: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 12:46:11 +03:00
|
|
|
Primary key fingerprint: 81AC 591F E9C4 B65C 5806 AFC3 F0AF 4D46 2A0B DF92
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
إذا كان الناتج يُظهر ** Good signature ** كما هو موضح في المثال فيمكنك
|
|
|
|
المتابعة.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
إذا كان الناتج **BAD signature** **لا تُكمل** بل قم بحذف ملف `hashes.txt`
|
|
|
|
وإرجع إلي [القسم 3.1](#31-get-hash-file).
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
## Download and Verify Binary
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
سيغطي هذا القسم تنزيل برنامج مونيرو لنظام التشغيل الخاص بك ، والحصول على هاش
|
|
|
|
`SHA256` من التنزيل الخاص بك ، والتحقق من صحته.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Get Monero binary
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
On Windows or Mac, go to [getmonero.org]({{ site.baseurl_root }}/downloads/)
|
|
|
|
and download the correct file for your operating system. Save the file to
|
|
|
|
your home directory. **Do not extract the files yet.**
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
في Linux ، يمكنك تنزيل واجهه سطر الأوامر عن طريق إصدار الأمر التالي:
|
|
|
|
|
|
|
|
```
|
2020-04-17 12:46:11 +03:00
|
|
|
wget -O monero-linux-x64-v0.15.0.1.tar.bz2 https://downloads.getmonero.org/cli/linux64
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Binary Verification on Linux or Mac
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
هذه الخطوات لنظامي تشغيل لينُكس وماك. من سطر الأوامر إحصل علي هاش `SHA256`
|
|
|
|
لملف التثبيت. كمثال سيستخدم هذا الدليل واجهه المستخدم الرسوميه علي ليُنكس ,
|
|
|
|
إستبدل `monero-gui-linux-x64-v0.15.0.1.tar.bz2` بإسم ملف التثبيت الذي قمت
|
|
|
|
بتنزيله في [الفصل 4.1](#41-get-monero-binary).
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
```
|
2021-05-22 15:52:40 +03:00
|
|
|
shasum -a 256 monero-linux-x64-v0.15.0.1.tar.bz2
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
سيبدو الناتج كهذا ، ولكن سيكون مختلفًا لكل ملف. يجب أن يتطابق هاش `SHA256`
|
|
|
|
الخاصة بك مع الهاش في القائمة المدرجة في ملف` hashes.txt` لملف التثبيت.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
```
|
2021-05-22 15:52:40 +03:00
|
|
|
8d61f992a7e2dbc3d753470b4928b5bb9134ea14cf6f2973ba11d1600c0ce9ad
|
|
|
|
monero-linux-x64-v0.15.0.1.tar.bz2
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
إذا كان الهاش **مُتطابق** يمكنك الأن فك الضفط والتثبيت.
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
إذا كان الهاش **غير مُتطابق** , ** لا تُكمل ** بل إحذف ملف التثبيت وإرجع إلي
|
|
|
|
[القسم 4.1](#41-get-monero-binary).
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
### Binary Verification on Windows
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
من سطر الأوامر احصل على هاش `SHA256` من ملف التثبيت الذي تم تنزيله. على سبيل
|
|
|
|
المثال ، سيستخدم هذا الدليل ثنائي واجهة المستخدم الرسومية لنظام ويندوز ، 64
|
|
|
|
بت. استبدل `monero-gui-win-x64-v0.15.0.1.zip` باسم الملف الذي قمت بتنزيله في
|
|
|
|
[القسم 4.1](#41-get-monero-binary).
|
2018-07-16 16:13:48 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
``` certUtil -hashfile monero-gui-win-x64-v0.12.0.0.zip SHA256 ```
|
2021-03-31 12:02:42 +03:00
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
سيبدو الناتج كهذا ، ولكن سيكون مختلفًا لكل ملف. يجب أن يتطابق هاش `SHA256`
|
|
|
|
الخاصة بك مع الهاش في القائمة المدرجة في ملف` hashes.txt` لملف التثبيت.
|
2018-07-16 16:13:48 +03:00
|
|
|
|
|
|
|
```
|
2021-05-22 15:52:40 +03:00
|
|
|
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.
|
2018-07-16 16:13:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
إذا كان الهاش **مُتطابق** يمكنك الأن فك الضفط والتثبيت.
|
|
|
|
|
2021-05-22 15:52:40 +03:00
|
|
|
إذا كان الهاش **غير مُتطابق** , ** لا تُكمل ** بل إحذف ملف التثبيت وإرجع إلي
|
|
|
|
[القسم 4.1](#41-get-monero-binary).
|