نصب

ویندوز یا مک‌اواس

می‌توانید OnionShare را برای Windows و macOS از وب‌سایت OnionShare دانلود کنید.

موبایل

شما می‌توانید OnionShare را برای موبایل از لینک‌های زیر دانلود کنید

Linux

روش‌های مختلفی برای نصب OnionShare برای Linux وجود دارد، اما روش پیشنهادی استفاده از بسته‌های Flatpak یا Snap است. Flatpak و Snapcraft تضمین می‌کنند که شما همیشه از جدیدترین نسخه استفاده خواهید کرد و OnionShare را در داخل یک محیط امن (sandbox) اجرا خواهید کرد.

پشتیبانی از Snapcraft در Ubuntu تعبیه شده است و Fedora نیز از Flatpak پشتیبانی می‌کند، اما اینکه از کدام استفاده کنید به خودتان بستگی دارد. هر دو در همه توزیع‌های Linux کار می‌کنند.

نصب OnionShare با استفاده از Flatpk: https://flathub.org/apps/details/org.onionshare.OnionShare

OnionShare را با استفاده از Snapcraft نصب کنید: https://snapcraft.io/onionshare

همچنین می‌توانید در صورت تمایل، بسته‌های .flatpak یا .snap امضا شده توسط PGP را از https://onionshare.org/dist/ دانلود و نصب کنید.

نصب دستی Flatpak

اگر می‌خواهید OnionShare را به صورت دستی با Flatpak و با استفاده از بسته تک فایلی امضا شده توسط PGP `single-file bundle <https://docs.flatpak.org/en/latest/single-file-bundles.html>`_نصب کنید، می‌توانید این کار را به صورت زیر انجام دهید:

  • با دنبال کردن دستورالعمل‌های موجود در https://flatpak.org/setup/، Flatpak را نصب کنید.

  • مخزن Flathub را با اجرای دستور flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo اضافه کنید. اگرچه شما OnionShare را از Flathub دانلود نخواهید کرد، OnionShare به برخی از بسته‌هایی که فقط در آنجا موجود هستند، وابسته است.

  • به https://onionshare.org/dist/ بروید، آخرین نسخه OnionShare را انتخاب کنید و فایل‌های .flatpak و .flatpak.asc را دانلود کنید.

  • امضای PGP فایل .flatpak را تأیید کنید. برای اطلاعات بیشتر به تایید امضای PGP مراجعه کنید.

  • فایل``.flatpak`` را با اجرای flatpak install OnionShare-VERSION.flatpak نصب کنید. VERSION را با شماره نسخه فایلی که دانلود کردید جایگزین کنید.

می‌توانید OnionShare را با: flatpak run org.onionshare.OnionShare اجرا کنید.

نصب دستی Snapcraft

اگر می خواهید OnionShare را با استفاده از بسته Snapcraft امضا شده با PGP به صورت دستی با Snapcraft نصب کنید، می توانید این کار را به صورت زیر انجام دهید:

  • Snapcraft را با دنبال کردن دستورالعمل‌های موجود در https://snapcraft.io/docs/installing-snapd نصب کنید.

  • به https://onionshare.org/dist/ بروید، آخرین نسخه OnionShare را انتخاب کنید و فایل‌های .snap و .snap.asc را دانلود کنید.

  • امضای PGP فایل``.snap`` را تأیید کنید. برای اطلاعات بیشتر به:ref:verifying_sigs مراجعه کنید.

  • فایل .snap را با اجرای snap install --dangerous onionshare_VERSION_amd64.snap نصب کنید. VERSION را با شماره نسخه فایلی که دانلود کردید جایگزین کنید. توجه داشته باشید که باید از --خطرناک استفاده کنید زیرا بسته توسط فروشگاه Snapcraft امضا نشده است، اما شما امضای PGP آن را تأیید کردید، بنابراین می دانید که قانونی است.

می‌توانید OnionShare را با: snap run onionshare اجرا کنید.

فقط خط-فرمان

شما می توانید فقط نسخه خط-فرمان OnionShare را روی هر سیستم عاملی با استفاده از مدیریت بسته ``Python ``pip نصب کنید. رابط خط فرمان اطلاعات بیشتری دارد.

FreeBSD

اگرچه OnionShare به طور رسمی برای این پلتفرم توسعه داده نشده است، می‌توان آن را بر روی FreeBSD <https://freebsd.org/>`_ نیز نصب کرد. از طریق مجموعه پورت های آن یا به عنوان بسته از پیش ساخته شده در دسترس است. اگر تصمیم به نصب و استفاده از OnionShare بر روی یک سیستم عامل FreeBSD دارید، لطفاً توجه داشته باشید که به طور رسمی توسط پروژه OnionShare پشتیبانی** نمی شود**.

اگرچه بسته‌ها و پورت‌های FreeBSD به طور رسمی توسط توسعه‌دهندگان OnionShare ارائه و نگهداری نمی‌شوند، کدهای منبع را از مخزن رسمی OnionShare (یا بسته‌های انتشار رسمی آن از PyPI) را واکشی و تأیید می‌کنند. اگر می خواهید تغییرات مربوط به این پلتفرم را بررسی کنید، لطفاً به منابع زیر مراجعه کنید:

نصب دستی pkg

برای نصب بسته باینری، از pkg install pyXY-onionshare استفاده کنید، با pyXY نسخه Python که بسته برای آن ساخته شده است را مشخص می کند. بنابراین، برای نصب OnionShare برای Python 3.9، استفاده کنید از:

pkg install py39-onionshare

همچنین یک نسخه فقط خط-فرمان از OnionShare به عنوان بسته از پیش ساخته شده موجود است. اگر می‌خواهید آن نسخه را نصب کنید، py39-onionshare را با py39-onionshare-cli جایگزین کنید.

برای اطلاعات بیشتر و جزئیات بیشتر در مورد بسته های از پیش ساخته شده FreeBSD، لطفاً به بخش راهنمای رسمی آن درباره pkg <https://docs.freebsd.org/en/books/handbook/ports/#pkgng-intro>`_ مراجعه کنید.

نصب دستی پورت

برای نصب پورت FreeBSD، دایرکتوری را به مجموعه پورت‌ها <https://freebsd.org/ports/> تغییر دهید که باید قبلاً بررسی کرده باشید و موارد زیر را اجرا کنید:

make -s -C www/onionshare all install clean

مجموعه پورت ها همچنین یک پورت اختصاصی برای نسخه فقط خط-فرمان OnionShare ارائه می دهد. اگر می‌خواهید آن نسخه را نصب کنید، www/onionshare را با www/onionshare-cli جایگزین کنید.

برای اطلاعات بیشتر و جزئیات بیشتر درباره مجموعه پورت‌های FreeBSD، لطفاً به بخش راهنمای رسمی آن درباره پورت‌ها <https://docs.freebsd.org/en/books/handbook/ports/#ports-using>`_ مراجعه کنید.

تایید امضای PGP

با تأیید امضای PGP می‌توانید تأیید کنید که بسته‌ای که دانلود می‌کنید قانونی است و دستکاری نشده است. برای ویندوز و macOS، این مرحله اختیاری است و دفاع عمیقی را ارائه می‌کند: باینری‌های OnionShare شامل امضاهای خاص سیستم‌عامل هستند و در صورت تمایل می‌توانید فقط به آن‌ها تکیه کنید.

کلید امضا

بسته ها توسط توسعه دهنده اصلی که مسئول انتشارات خاص است امضا می شوند. در اینجا اطلاعات کلیدی GPG برای هر یک از توسعه دهندگان اصلی OnionShare آمده است:

برای تأیید امضاها باید GnuPG را نصب کرده باشید. برای macOS احتمالاً GPGTools و برای ویندوز احتمالا Gpg4win را می خواهید.

امضاها

می‌توانید امضاها (به‌عنوان فایل‌های .asc)، و همچنین بسته‌های Windows، macOS، Flatpak، Snap و منبع را در https://onionshare.org/dist/ در پوشه‌های نام‌گذاری شده برای هر نسخه OnionShare پیدا کنید. همچنین می‌توانید آنها را در صفحه نسخه‌های GitHub پیدا کنید.

تأیید کردن

هنگامی که کلیدهای عمومی توسعه دهندگان اصلی را به زنجیره کلید GnuPG خود وارد کردید، امضای باینری و .asc را دانلود کردید، می توانید باینری را در ترمینال مانند زیر تأیید کنید:

برای ویندوز:

gpg --verify OnionShare-win64-2.6.msi.asc OnionShare-win64-2.6.msi (Windows 64-bit)

برای macOS

gpg --verify OnionShare-2.6.dmg.asc OnionShare-2.6.dmg

برای Linux:

gpg --verify OnionShare-2.6.flatpak.asc OnionShare-2.6.flatpak (Flatpak)

gpg --verify onionshare_2.6_amd64.snap.asc onionshare_2.6_amd64.snap (Snap)

و برای فایل منبع:

gpg --verify onionshare-2.6.tar.gz.asc onionshare-2.6.tar.gz

خروجی مورد انتظار به این شکل است:

gpg: Signature made Mo 10 Okt 2022 02:27:16 CEST
gpg:                using RSA key 927F419D7EC82C2F149C1BD1403C2657CD994F73
gpg: Good signature from "Micah Lee <micah@micahflee.com>" [unknown]
gpg:                 aka "Micah Lee <micah.lee@firstlook.media>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 927F 419D 7EC8 2C2F 149C  1BD1 403C 2657 CD99 4F73

اگر عبارت امضای خوب از را نمی‌بینید، ممکن است مشکلی در صحت فایل (مخرب یا غیره) وجود داشته باشد و نباید بسته را نصب کنید.

هشدار نشان داده شده در بالا، مشکل از بسته نیست، بلکه فقط به این معنی است که شما سطحی از «اعتماد» به کلید PGP Michah (توسعه‌دهنده اصلی) را تعریف نکرده‌اید.

اگر می‌خواهید درباره تأیید امضاهای PGP بیشتر بدانید، راهنماهای مربوط به سیستم عامل Qubes و پروژه Tor ممکن است مفید باشند.