Cài đặt

Windows hoặc macOS

Bạn có thể tải xuống OnionShare cho Windows và macOS từ trang web OnionShare.

Mobile

You can download OnionShare for Mobile from the follow links

Linux

Có nhiều cách khác nhau để cài đặt OnionShare cho Linux, nhưng cách được đề xuất là hoặc sử dụng gói Flatpak hoặc gói Snap . Flatpak và Snapcraft đảm bảo rằng bạn sẽ luôn sử dụng phiên bản mới nhất và chạy OnionShare bên trong một sandbox.

Hỗ trợ Snapcraft được tích hợp sẵn trong Ubuntu và Fedora đi kèm với hỗ trợ Flatpak, nhưng việc bạn sử dụng loại nào là tùy thuộc vào bạn. Cả hai đều hoạt động trong tất cả các bản phân phối Linux.

Cài đặt OnionShare sử dụng Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Cài đặt OnionShare sử dụng Snapcraft: https://snapcraft.io/onionshare

Bạn cũng có thể tải xuống và cài đặt các gói .flatpak hoặc .snap có chữ ký PGP từ https://onionshare.org/dist/ nếu bạn muốn.

Cài đặt Flatpak theo cách thủ công

Nếu bạn muốn cài đặt OnionShare theo cách thủ công với Flatpak bằng cách sử dụng gói tập tin đơn có chữ ký PGP, bạn có thể thực hiện như sau:

  • Cài đặt Flatpak bằng cách làm theo hướng dẫn tại https://flatpak.org/setup/.

  • Thêm kho lưu trữ Flathub bằng cách chạy flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Mặc dù bạn sẽ không tải xuống OnionShare từ Flathub, nhưng OnionShare phụ thuộc vào một số gói package chỉ khả dụng ở đó mà thôi.

  • Đi tới https://onionshare.org/dist/, lựa chọn phiên bản OnionShare mới nhất, và tải xuống các file tệp tin .flatpak và .flatpak.asc.

  • Xác minh chữ ký PGP của file tệp tin .flatpak. Hãy xem Việc xác minh chữ ký PGP để biết thêm thông tin.

  • Cài đặt file tệp tin .flatpak bằng cách chạy flatpak install OnionShare-VERSION.flatpak. Thay thế VERSION bằng số phiên bản của file tệp tin bạn đã tải xuống.

Bạn có thể chạy OnionShare với: flatpak run org.onionshare.OnionShare.

Cài đặt Snapcraft theo cách thủ công

nếu như bạn muốn cài đặt OnionShare theo cách thủ công với Snapcraft bằng cách sử dụng gói package Snapcraft có chữ ký PGP, bạn có thể làm như thế này:

  • Cài đặt Snapcraft bằng cách làm theo các chỉ dẫn tại https://snapcraft.io/docs/installing-snapd.

  • Đi tới https://onionshare.org/dist/, lựa chọn phiên bản mới nhất của OnionShare, và tải xuống các file tệp tin .snap và .snap.asc.

  • Xác minh chữ ký PGP của file tệp tin .snap. hãy xem Việc xác minh chữ ký PGP để biết thêm thông tin.

  • Cài đặt file tệp tin .snap bằng cách chạy snap install --dangerous onionshare_VERSION_amd64.snap. Thay thế VERSION bằng số phiên bản của file tệp tin mà bạn đã tải xuống. Lưu ý rằng bạn phải sử dụng --dangerous bởi vì gói package không được ký bởi cửa hàng Snapcraft store, tuy nhiên, bạn đã xác minh chữ ký PGP của nó, vì vậy bạn biết nó là chính chủ hợp pháp.

Bạn có thể chạy OnionShare với: snap run onionshare.

Chỉ dòng lệnh command mà thôi

Bạn có thể chỉ cài đặt phiên bản dòng lệnh command của OnionShare trên bất kỳ hệ điều hành nào bằng cách sử dụng trình quản lý gói Python pip. Giao diện dòng lệnh Command có thêm thông tin.

FreeBSD

Althought not being officially developed for this platform, OnionShare can also be installed on FreeBSD. It's available via its ports collection or as pre-built package. Should you opt to install and use OnionShare on a FreeBSD operating system, please be aware that it's NOT officially supported by the OnionShare project.

Though not being offered and officially maintained by the OnionShare developers, the FreeBSD packages and ports do fetch and verifies the source codes from the official OnionShare repository (or its official release packages from PyPI). Should you wish to check changes related to this platform, please refer to the following resources:

Manual pkg Installation

To install the binary package, use pkg install pyXY-onionshare, with pyXY specifying the version of Python the package was built for. So, in order to install OnionShare for Python 3.9, use:

pkg install py39-onionshare

There's also a Command-line only version of OnionShare available as pre-built package. Replace py39-onionshare by py39-onionshare-cli if you want to install that version.

For additional information and details about the FreeBSD pre-built packages, please refer to its official Handbook section about pkg.

Manual port Installation

To install the FreeBSD port, change directory to the ports collection you must have checked out before and run the following:

make -s -C www/onionshare all install clean

The ports collection also offers a dedicated port for the Command-line only version of OnionShare. Replace www/onionshare by www/onionshare-cli if you want to install that version.

For additional information and details about the FreeBSD ports collection, please refer to its official Handbook section about ports.

Việc xác minh chữ ký PGP

Bạn có thể xác minh rằng gói mà bạn tải xuống là hợp pháp hợp lệ và không bị giả mạo hoặc xáo trộn bằng cách xác minh chữ ký PGP của nó. Đối với hệ điều hành Windows và macOS, bước này là tùy chọn và cung cấp khả năng bảo vệ chuyên sâu: các nhị phân OnionShare binaries bao gồm các chữ ký dành riêng cho hệ điều hành, và bạn có thể chỉ cần dựa vào những chữ ký đó mà thôi nếu bạn muốn.

Khoá key chữ ký

Packages are signed by the core developer who is responsible for the particular release. Following are the informations of the core developers of OnionShare:

Bạn phải cài đặt GnuPG sẵn để xác minh chữ ký. Đối với hệ điều hành macOS, bạn có thể muốn GPGTools, và đối với hệ điều hành Windows, bạn có thể muốn Gpg4win.

Các chữ ký

You can find the signatures (as .asc files), as well as Windows, macOS, Flatpak, Snap, and source packages, at https://onionshare.org/dist/ in the folders named for each version of OnionShare. You can also find them on the GitHub Releases page.

Việc xác minh

Once you have imported the core developers public keys into your GnuPG keychain, downloaded the binary and .asc signature, you can verify the binary in a terminal like this:

For Windows:

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

For macOS:

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

For 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)

and for the source file:

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

Đầu ra output dự kiến trông như thế này:

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

If you don't see Good signature from, there might be a problem with the integrity of the file (malicious or otherwise), and you should not install the package.

The WARNING: shown above, is not a problem with the package, it only means you haven't defined a level of "trust" of Micah's (the core developer) PGP key.

Nếu bạn muốn tìm hiểu thêm về việc xác minh chữ ký PGP, các hướng dẫn dành cho Qubes OS và Dự án Tor Project có thể hữu ích.