安装

Windows 或 macOS

你可以从 OnionShare website 下载适用于 Windows 和 macOS 的 OnionShare。

手机

您可以从下方链接下载 OnionShare 移动版

• Android

  • Google Play: https://play.google.com/store/apps/details?id=org.onionshare.android&hl=zh

  • F-Droid: https://github.com/onionshare/onionshare-android-nightly

• iOS

  • Apple 应用商店：https://apps.apple.com/app/onionshare/id1601890129

  • 直接 IPA 下载：https://github.com/onionshare/onionshare-ios/releases

  • TestFlight: https://testflight.apple.com/join/ZCJeY65W

Linux

这有几种方式安装适用于 Linux 的 OnionShare，但推荐使用 Flatpak <https://flatpak.org/> _或 Snap 的软件包来安装。Flatpak 和 Snap 确保你将总能使用最新版本的 OnionShare 并在一个沙箱里运行它。

Ubuntu 内置 Snapcraft 支持，而 Fedora 则支持 Flatpak，但使用哪一种取决于您。两者都适用于所有 Linux 发行版。

使用 Flatpak 安装 OnionShare: https://flathub.org/apps/details/org.onionshare.OnionShare

使用 Snapcraft 安装 OnionShare：https://snapcraft.io/onionshare

如果你愿意的话，你也可以从 https://onionshare.org/dist/ 下载和安装 PGP 签署过的 .flatpak 或 .snap 软件包。

手动 Flatpak 安装

如果您想要通过 Flatpak 使用 PGP 签名的 单文件软件包 手动安装 OnionShare，您可以这样做：

• 按照 https://flatpak.org/setup/ 上的说明安装 Flatpak。

• 通过运行 flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo 添加 Flathub 存储库。即使您不会从 Flathub 下载 OnionShare，但 OnionShare 也依赖于某些仅在那里可用的软件包。

• 前往 https://onionshare.org/dist/，选择最新版本的 OnionShare，并下载 .flatpak 和 .flatpak.asc 文件。

• 验证 .flatpak 文件的 PGP 签名。有关更多信息，请参阅：ref:verifying_sigs。

• 通过运行 flatpak install OnionShare-VERSION.flatpak 来安装 .flatpak 文件。将 VERSION 替换为您下载的文件的版本号。

您可以使用以下命令运行 OnionShare：flatpak run org.onionshare.OnionShare。

手动 Snapcraft 安装

如果您想使用 PGP 签名的 Snapcraft 包手动安装 OnionShare，您可以这样做：

• 按照 https://snapcraft.io/docs/installing-snapd 上的说明安装 Snapcraft。

• 前往 https://onionshare.org/dist/，选择最新版本的 OnionShare，并下载 .snap 和 .snap.asc 文件。

• 验证 .snap 文件的 PGP 签名。有关更多信息，请参阅：ref:verifying_sigs。

• 通过运行 snap install --dangerous onionshare_VERSION_amd64.snap 来安装 .snap 文件。将 VERSION 替换为您下载的文件的版本号。请注意，您必须使用 –dangerous，因为该软件包未由 Snapcraft 商店签名，但您确实验证了其 PGP 签名，因此您知道它是合法的。

您可以使用以下命令运行 OnionShare：snap run onionshare。

仅限命令行

您可以使用 Python 软件包管理器 pip 在任何操作系统上安装 OnionShare 的命令行版本。命令行界面 有更多信息。

FreeBSD

尽管 OnionShare 并非专为此平台开发，但它也可以安装在 FreeBSD 上。它可通过其 Ports Collection 或预构建包获得。如果您选择在 FreeBSD 操作系统上安装和使用 OnionShare，请注意，它 不 受 OnionShare 项目的官方支持。

尽管不是由 OnionShare 开发人员提供和正式维护，但 FreeBSD 软件包和 ports 确实会从官方 OnionShare 存储库（或其来自 PyPI 的官方发布软件包）获取和验证源代码。如果您希望查看与此平台相关的更改，请参考以下资源：

• https://cgit.freebsd.org/ports/log/www/onionshare

• https://www.freshports.org/www/onionshare

手动 pkg 安装

要安装二进制包，请使用 pkg install pyXY-onionshare，其中 pyXY 指定包所针对的 Python 版本。因此，为了安装适用于 Python 3.9 的 OnionShare，请使用:

pkg install py39-onionshare

还有一个**仅命令行**版本的 OnionShare 作为预构建包提供。如果要安装该版本，请将 py39-onionshare 替换为 py39-onionshare-cli 。

有关 FreeBSD 预构建软件包的更多信息和详细信息，请参阅其`有关 pkg 的官方手册部分 <https://docs.freebsd.org/en/books/handbook/ports/#pkgng-intro>`_。

手动 port 安装

要安装 FreeBSD port，请将目录更改为 ports collection。您必须已经签出，并运行以下命令:

make -s -C www/onionshare all install clean

Ports Collection 还为 OnionShare 的**仅命令行**版本提供了专用 port。如果您想要安装该版本，请将 www/onionshare 替换为 www/onionshare-cli 。

有关 FreeBSD Ports Collection 的更多信息和详细信息，请参阅其`有关 ports 的官方手册部分 <https://docs.freebsd.org/en/books/handbook/ports/#ports-using>`_。

验证 PGP 签名

你可以通过验证其 PGP 签名来验证你下载的软件包是可靠且未被篡改过的。对于 Windows 和 macOS 来说，这一步是可选的，并提供更深层次的保护：OnionShare 的二进制文件中包含操作系统特定的数字签名，如果你愿意的话，你可以只依赖这些签名。

签名密钥

软件包由负责特定版本的核心开发人员签名。以下是每个 OnionShare 核心开发人员的 GPG 密钥信息：

• Micah Lee:

  • PGP 公钥指纹 927F419D7EC82C2F149C1BD1403C2657CD994F73。

  • 您可以`从 keys.openpgp.org 密钥服务器 <https://keys.openpgp.org/vks/v1/by-fingerprint/927F419D7EC82C2F149C1BD1403C2657CD994F73>`_下载 Micah 的密钥。

• Saptak Sengupta:

  • PGP 公钥指纹 2AE3D40A6905C8E4E8ED95ECE46A2B977C14666B。

  • 您可以`从 keys.openpgp.org 密钥服务器 <https://keys.openpgp.org/vks/v1/by-fingerprint/2AE3D40A6905C8E4E8ED95ECE46A2B977C14666B>`_下载 Saptak 的密钥。

• Miguel Jacq:

  • PGP 公钥指纹 00AE817C24A10C2540461A9C1D7CDE0234DB458D。

  • 您可以`从 keys.openpgp.org 密钥服务器 <https://keys.openpgp.org/vks/v1/by-fingerprint/00AE817C24A10C2540461A9C1D7CDE0234DB458D>`_ 下载 Miguel 的密钥。

你必须安装 GnuPG 来验证签名，对于 macOS 你可能想要 GPGTools，对于 Windows 你可能想要 Gpg4win。

签名

您可以在 https://onionshare.org/dist/ 上每个 OnionShare 版本文件夹中找到签名（作为 .asc 文件），以及 Windows、macOS、Flatpak、Snap 和源代码包。您还可以在 GitHub 发布页面 上找到它们。

验证

将核心开发人员的公钥导入 GnuPG 密钥串、下载二进制文件和 .asc 签名后，您可以在终端中验证二进制文件，如下所示：

Windows:

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

如果您没有看到 Good signature from，则文件的完整性可能存在问题（恶意或其他），您不应该安装该软件包。

上面显示的``警告：``不是软件包的问题，它只意味着您没有定义 Micah（核心开发人员）的 PGP 密钥的“信任”级别。

如果你想了解更多有关验证 PGP 签名的知识，这几篇指南 Qubes OS 和 Tor Project 可能会有帮助。