Cài đặt

Windows hoặc macOS

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

Điện thoại

Bạn có thể tải OnionShare cho thiết bị di động từ các liên kết sau

Linux

Có nhiều cách khác nhau để cài đặt OnionShare cho Linux, nhưng cách được khuyến nghị là sử dụng gói Flatpak hoặc 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 hộp cát.

Hỗ trợ Snapcraft được tích hợp sẵn trong Ubuntu và Fedora đi kèm với hỗ trợ Flatpak, nhưng bạn sử dụng cái nào là tùy 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.

Hệ điều hành FreeBSD

Mặc dù không được phát triển chính thức cho nền tảng này, OnionShare cũng có thể được cài đặt trên FreeBSD. Nó có sẵn thông qua bộ sưu tập cổng của nó hoặc dưới dạng gói dựng sẵn. Nếu bạn chọn cài đặt và sử dụng OnionShare trên hệ điều hành FreeBSD, vui lòng lưu ý rằng nó KHÔNG được hỗ trợ chính thức bởi dự án OnionShare.

Mặc dù không được cung cấp và bảo trì chính thức bởi các nhà phát triển OnionShare, các gói và cổng FreeBSD sẽ lấy và xác minh mã nguồn từ kho lưu trữ OnionShare chính thức (hoặc các gói phát hành chính thức từ PyPI). Nếu bạn muốn kiểm tra các thay đổi liên quan đến nền tảng này, vui lòng tham khảo các tài nguyên sau:

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

Để cài đặt gói nhị phân, hãy sử dụng pkg install pyXY-onionshare, với pyXY chỉ định phiên bản Python mà gói được xây dựng cho. Vì vậy, để cài đặt OnionShare cho Python 3.9, hãy sử dụng:

pkg install py39-onionshare

Ngoài ra còn có phiên bản Chỉ dòng lệnh của OnionShare có sẵn dưới dạng gói dựng sẵn. Thay thế py39-onionshare bằng py39-onionshare-cli nếu bạn muốn cài đặt phiên bản đó.

Để biết thêm thông tin và chi tiết về các gói dựng sẵn của FreeBSD, vui lòng tham khảo phần Sổ tay chính thức về pkg.

Cài đặt cổng thủ công

Để cài đặt cổng FreeBSD, hãy thay đổi thư mục thành ports collection mà bạn phải đã kiểm tra trước đó và chạy lệnh sau:

make -s -C www/onionshare all install clean

Bộ sưu tập cổng cũng cung cấp một cổng chuyên dụng cho phiên bản Chỉ dòng lệnh của OnionShare. Thay thế www/onionshare bằng www/onionshare-cli nếu bạn muốn cài đặt phiên bản đó.

Để biết thêm thông tin chi tiết về bộ sưu tập cổng FreeBSD, vui lòng tham khảo phần Sổ tay chính thức về cổng.

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ý

Các gói được ký bởi nhà phát triển cốt lõi chịu trách nhiệm cho bản phát hành cụ thể. Sau đây là thông tin khóa GPG cho từng nhà phát triển cốt lõi của 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ý

Bạn có thể tìm thấy các chữ ký (dưới dạng tệp .asc), cũng như các gói Windows, macOS, Flatpak, Snap và nguồn, tại https://onionshare.org/dist/ trong các thư mục được đặt tên cho từng phiên bản OnionShare. Bạn cũng có thể tìm thấy chúng trên Trang phát hành GitHub.

Việc xác minh

Sau khi bạn đã nhập khóa công khai của nhà phát triển cốt lõi vào chuỗi khóa GnuPG của mình, tải xuống tệp nhị phân và chữ ký .asc, bạn có thể xác minh tệp nhị phân trong thiết bị đầu cuối như sau:

Đối với Windows:

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

Đối với macOS:

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

Đối với 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)

và đối với tập tin nguồn:

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

Nếu bạn không thấy Good signature from, có thể đã xảy ra sự cố về tính toàn vẹn của tệp (có thể là độc hại hoặc không) và bạn không nên cài đặt gói.

CẢNH BÁO: hiển thị ở trên không phải là vấn đề của gói, nó chỉ có nghĩa là bạn chưa xác định mức độ "tin cậy" của khóa PGP của Micah (nhà phát triển cốt lõi).

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.