OnionShare 介绍与选型指南

目标：本文是 OnionShare 的认知与选型第一站——讲清它是什么、基于什么机制、能做什么、不能做什么，并给出与同类匿名分享 / onion 服务方案的量化选型对比。本篇为认知篇，全部信息均于 2026-10-31 联网溯源自官方渠道（官网、官方文档、PyPI、shields.io 仓库徽章），未做本地部署实测；安装与命令实操分别见本专栏 《Ubuntu 22.04 安装 OnionShare 2.7.1 指南》与 《OnionShare 2.7.1 常用 CLI 命令详解》。

一、溯源信息基线

本篇不依赖任何本地部署，全部事实来自以下公开渠道，逐项标注来源与查询日期，便于后续复核：

💡 说明：GitHub API 直连存在限流，本文星数取证采用 shields.io 徽章 JSON（https://img.shields.io/github/stars/onionshare/onionshare.json），其返回 {"label":"stars","message":"7.2k"}，即 约 7200 星（2026-10-31 快照）。

二、软件概述

2.1 一句话定位

OnionShare 是一个开源工具，让你安全且匿名地分享文件、托管网站、与朋友聊天——它的做法是在你自己的电脑上启动一个 Web 服务器，然后通过 Tor 网络把服务暴露为 onion 服务，生成一个不可猜测的 *.onion 地址供对方访问（来源：官网首页与官方文档 "How OnionShare Works"，查询日期 2026-10-31）。

它的核心价值主张可以拆成三句话：

• 不需要第三方服务器：文件直接从你的机器流到对方，不经过网盘、不经过中转存储服务；
• 不需要公网 IP、不需要开端口：onion 服务天然穿透 NAT，你的真实 IP 与位置始终不对访客暴露；
• 默认临时：分享完成后服务即可自动下线，不留持久化的公开页面。

2.2 名称辨析与常见混淆

「OnionShare」是一个组合词（Onion 洋葱 + Share 分享），检索时注意与以下几类实体区分，避免同名异物：

2.3 基本信息

💡 技术拓展：上文反复出现的「onion 服务（Onion Service）」是 Tor 网络的一种服务形态，理解它需要区分两代地址体系——

代际	地址形态	密码学基础	现状
onion v2	16 字符 Base32（如 http://abc…xyz.onion）	RSA-1024	已于 2021 年被 Tor 网络废弃，现网不可用
onion v3	56 字符 Base32（如本文分享演示中的 …467zfy5qd.onion）	Ed25519 + Curve25519	当前唯一受支持形态

OnionShare 2.x 系列全部使用 v3 onion 服务，地址形如官方文档示例 http://oy5oaslxxzwib7fsjaiz5mjeyg3ziwdmiyeotpjw6etxi722pn7pqsyd.onion（来源：官方文档 features 页）。选型时凡是只提供 v2 地址的旧方案都应排除。

2.4 版本分叉观察（如实标注）

2026-10-31 溯源时发现一处需要留意的版本分叉：

• 官网发行版：桌面安装包与文档站均为 2.7.1，这是官方当前的最新稳定版线；
• PyPI 包：onionshare-cli 项目页主版本显示为 2.6（发布于 2022-10-10），而搜索快照中 onionshare_cli 显示 2.7（发布于 10 月 16 日）——PyPI 对包名做连字符/下划线规范化后两者指向同一项目，页面快照存在 2.6/2.7 两个版本观察结果。

结论：以官网 dist/2.7.1/ 为最新稳定版依据（2.7.1 已核）；CLI 包在 PyPI 上的可用版本清单以安装篇的 pip index versions 实测为准（见本专栏 《Ubuntu 22.04 安装 OnionShare 2.7.1 指南》），本文不做定论。

三、核心架构

3.1 数据流总览

官方文档对机制的描述非常直接（来源：docs.onionshare.org/2.7.1/en/features.html，查询日期 2026-10-31）：

1. 本地起 Web 服务：OnionShare 在你自己的机器上启动一个本地 Web 服务器（Flask 技术栈）；
2. 注册为 onion 服务：该本地服务通过 Tor 以 onion 服务形式对外可达，Tor 负责把 *.onion 地址路由到你的机器，全程不暴露真实 IP，也无需公网 IP / 端口转发；
3. 地址 + 私钥双因子：默认情况下每个分享地址受一把私钥（Tor client authentication 密钥，56 字符大写字母，官方示例 K3N3N3U3BURJW46HZEZV2LZHBPKEFAGVN6DPC7TY6FHWXT7RLRAQ）保护——访客必须同时在 Tor Browser 中提供地址与私钥才能打开；
4. 地址分发由你负责：官方明确「地址与私钥通过什么渠道发给对方」是使用者的威胁模型问题——高安全场景用端到端加密通讯软件，低要求场景甚至可用明文邮件；
5. 关闭即下线：你停止分享或退出程序，服务立即从互联网上消失。

💡 技术拓展：「地址 + 私钥双因子」用到的 Tor client authentication（客户端认证）不止一种发放方式——

方式	原理	适用场景
OnionShare 默认（x25519 私钥）	onion 服务生成 v3 client auth 私钥，访客在 Tor Browser 粘贴导入	一对一临时分享，默认形态
公开服务（关闭私钥）	地址本身即唯一凭证，任何人可访问	挂在网站/社交主页上的长期爆料与下载入口
地址即密码（公开 + 复杂随机地址）	依赖 56 字符地址不可猜测性	可接受「知道地址即可用」的半公开场景

OnionShare 2.7.1 默认采用第一种，并在界面上提供「Turn Off Private Key」开关切换到第二/三种（来源：官方文档 Advanced Usage 章节，查询日期 2026-10-31）。

3.2 架构特征推论

基于上述数据流，可以推论出几个选型上关键的架构特征（均为官方机制描述的直接结果）：

• 无中心存储：没有服务端持久化层，服务停了数据面就没了——这是它与网盘类工具的本质区别；
• 在线可用性 = 你的机器在线：官方文档原话——如果你的笔记本在传输完成前休眠，服务就不可用，恢复联网后恢复；因此长期挂载的服务（爆料入口、长期网站）官方建议跑在专用常开设备上；
• 安全上限高：官方文档明确「因为 Web 服务器就是你自己的电脑，没有任何第三方能访问 OnionShare 里发生的事情，连 OnionShare 开发者也不能」——这是它对比一切中转式网盘/临时分享服务的根本优势；
• 匿名性双向：既保护服务方（你）的位置，也保护访客（他们用 Tor Browser 访问）。

四、功能特性

OnionShare 2.7.1 提供五种服务模式（来源：官方文档 features 页逐节描述，查询日期 2026-10-31）：

此外还有若干横向能力（均出自官方文档 Advanced Usage 目录与 features 页）：

• 保存标签页（Save Tabs）：把服务固化为持久 onion 地址，重启程序后地址不变；
• 定时启停（Scheduled Times）：设置自动开始/自动停止计时；
• 自定义标题（Custom Titles）：给公开服务设置页面标题；
• 公开模式与私钥开关：前文 client auth 拓展中的切换；
• 移动端：Android/iOS 与桌面端功能对齐（官网移动端章节）。

五、快速开始（最小可用示例）

本节只给官方推荐的两条最小上手路径，命令细节与完整回显见本专栏命令篇与安装篇。

5.1 桌面应用路径（官方主推）

从官网下载页获取对应平台安装包（Windows .msi / macOS .dmg / Linux 见官方文档安装页），安装后打开应用，选择「Share」标签拖入文件点「Start sharing」，把界面给出的 *.onion 地址与私钥发给对方即可（来源：官网下载页与官方文档 features 页，查询日期 2026-10-31）。

5.2 纯 CLI 路径（服务器/无图形界面场景）

官方文档安装页提供的命令行-only 安装方式是 Python 包管理器（来源：docs.onionshare.org/2.7.1/en/install.html "Command-line only"，查询日期 2026-10-31）：

pip install onionshare-cli
# 分享一个文件（对方用 Tor Browser 打开输出的 *.onion 地址即可下载）
onionshare-cli /path/to/file

CLI 的完整子命令族（--receive、--website、--chat、--persistent、--public 等）与逐参数实测回显，见本专栏 《OnionShare 2.7.1 常用 CLI 命令详解》。

5.3 访客侧

无论服务方用哪种模式，访客侧的标准姿势都是：Tor Browser 打开 *.onion 地址 → 粘贴私钥 → 操作（下载、上传或聊天）；2.7 起也可以用对方 OnionShare 的 Download 模式代劳（来源：官方文档 features 页，查询日期 2026-10-31）。

六、适用场景与限制

6.1 适用场景（官方口径）

6.2 限制与安全边界（官方明示，选型前必读）

1. 可用性受限于你的设备在线：休眠/断网/退出程序即服务下线，官方建议长期服务用「专用常开设备」（features 页）；
2. 传输速度受 Tor 限制：onion 服务路由经过 Tor 三跳+介绍点，吞吐与延迟显著低于直连，不适合大文件高频分发（机制由 Tor onion 服务决定，见官方文档 Tor 章节语境）；
3. Receive 模式不防恶意文件：官方原话「OnionShare 没有任何针对恶意上传文件的安全机制」，收到 Office/PDF 建议用 Dangerzone 转换或在 Tails/Qubes 一次性虚拟机中打开；纯文字消息则总是安全的（features 页 "Use at your own risk"）；
4. Chat 模式无法验证身份：任何人可随意改名，匿名是双向的；安全性取决于地址分发渠道（features 页）；
5. Website 仅静态：不能跑 WordPress 等动态程序（features 页）；
6. 地址分发渠道决定整体安全：官方反复强调地址+私钥的传递渠道要匹配威胁模型（features 页开头）；
7. 已知客户端兼容问题：官方文档记录 iOS 上 OnionBrowser 在 Silver 安全级别下无法向 Receive 模式上传，需切换 Bronze/Gold（features 页 Receive 注意事项）。

七、同类选型对比（量化）

按官网与文档口径，OnionShare 的竞品要分两类看：匿名优先（走 Tor 或匿名网络）与便利优先（自托管网盘/临时分享）。下表为量化对比（星数为 2026-10-31 快照，来源均在参考链接）：

解读与选型建议：

• 匿名性优先、临时性优先 → OnionShare 是该象限里唯一「零服务器、零端口、五模式」的开箱即用方案，且被 Tails/Qubes/Whonix/Parrot 预装这一点构成了隐私圈层的生态背书；
• 机构级爆料平台 → SecureDrop 在流程合规与审计上更完整，但需要专用硬件与专职运维，个人与小型团队用 OnionShare Receive 模式即可（官方自己也是这么定位的）；
• 只要保密、不在乎匿名 → magic-wormhole 类直传工具速度远快于 Tor，没有匿名诉求时是更快的答案；
• 常规文件分享服务（给同事/朋友发链接） → 自托管网盘类吞吐高、易集成，但请明确它们不提供匿名——服务器日志、域名 WHOIS、证书都会关联到你；
• 长期公开内容发布 → OnionShare Website 模式适合临时或抗审查场景，长期公开站建议常规托管 + CDN，匿名网络只作为镜像逃生通道。

八、参考链接

• OnionShare 官网（查询日期 2026-10-31）
• OnionShare 2.7.1 官方文档
• How OnionShare Works（features）
• Advanced Usage（CLI 与配置参数）
• Security Design
• GitHub 仓库 onionshare/onionshare
• shields.io 星数徽章取证（2026-10-31 快照：7.2k）
• PyPI onionshare-cli 项目页
• SecureDrop 官网（对比项）
• Tor onion services 社区文档