--- title: "在 Linux 上安装 Voxis（snap） | VoxisLive" description: "从 snap 的 stable 通道在 Linux 上安装 Voxis，连接音频录制权限，并选择正确的 PipeWire 音源。" url: https://voxislive.com/zh/docs/install-linux-snap language: "zh-CN" source_html: https://voxislive.com/zh/docs/install-linux-snap site: "Voxis — real-time voice translation" og_image: https://voxislive.com/assets/og.png generated_by: voxislive-markdown-pipeline --- [首页](https://voxislive.com/zh/) · / · [文档](https://voxislive.com/zh/docs) · / · 在 Linux 上安装（snap） 在 LINUX 上安装 # 在 Linux 上通过 snap 安装 Voxis Voxis 发布在 snap 的 stable 通道上，因此在 Linux 上安装只需要一条命令加一项权限。本页介绍安装方法、决定应用能否听到任何声音的那项权限、PipeWire 上的音频捕获如何工作，以及 Linux 版有意不做的事情。 ## 从 Snap Store 安装 Voxis 发布在 snap 的 **stable** 通道上。在任何支持 snapd 的发行版上，安装只需一条命令： `sudo snap install voxis` 这就是完整的安装。无需添加软件源，无需下载 `.deb`，也没有构建步骤——snap 自带翻译引擎、它的 Python 运行时，以及绘制窗口所用的 GTK/WebKit 组件，因此您电脑上已有的任何东西都不必与我们选定的版本相匹配。 **我们有意不在本页写出版本号。**stable 通道会不断更新，写进文档的版本号在发布后的第二天就会过时。要查看通道此刻提供的确切版本，请运行 `snap info voxis` 并查看 `stable:` 一行；要查看您实际安装的版本，请运行 `snap list voxis`。这两条命令在您输入的那一刻都是准确的，这是一个页面无法保证的。 更新的方式与所有 snap 一样——snapd 会在后台刷新软件包，如果您不想等待，`sudo snap refresh voxis` 会立即拉取更新。这个通道上没有应用内更新器；应用商店就是更新机制。 ## 连接音频权限——没有它，安装的应用就是“失聪”的 这是一个容易被跳过、却又无法绕过的步骤。snap 在严格的受限环境中运行：软件包声明它想要哪些接口，而系统决定其中哪些真正被连接。Voxis 需要 `audio-record` 接口，因为读取您的电脑正在播放的内容，与读取麦克风走的是同一条录音路径。 **音频权限未连接的安装会一直“失聪”。**应用能启动，窗口能打开，语言选择器能用，会话看起来也在运行——但没有任何音频到达翻译引擎，所以永远不会有译文返回。它不会表现为权限错误，而是表现为一片寂静。请显式连接它： `sudo snap connect voxis:audio-record` 您可以在开始会话之前确认结果。`snap connections voxis` 会列出软件包的接口；`audio-record` 一行应当显示插头（plug）和插槽（slot）的名称，而不是在“已连接”一列显示短横线。如果显示短横线，说明上面的命令没有运行，或者它针对的是另一个安装。 1. 运行 `sudo snap install voxis`。 2. 运行 `sudo snap connect voxis:audio-record`。 3. 运行 `snap connections voxis`，检查 audio-record 一行是否已连接。 4. 启动 Voxis，登录，并在依赖真实会话之前先运行内置的“声音测试”。 如果您是从本地文件手动安装的软件包，而不是从应用商店安装，那么系统不会替您授予任何权限——在这种情况下，连接命令不是可有可无的附加项，而是安装的一部分。请运行它，然后重新启动应用。 ## Linux 上的音频捕获如何工作：PipeWire 与 Voxis 自己的 sink Linux 端基于 **PipeWire** 运行。Voxis 不会试图截取您的扬声器，而是创建一个属于自己的 sink，把您想翻译的应用的音频移到其中，再读取该 sink 的监听端。它播放的译音会送到您常用的输出设备，因此永远不会进入 Voxis 正在收听的那个 sink。 由此带来的实际结果才是最重要的：**Voxis 不会重新翻译自己的声音。**这种分离是结构性的——译音根本不存在于被捕获的音频流中——而不是事后去猜哪个声音是哪个的过滤器。 这还意味着 Voxis 永远不会接管您系统的默认输出设备或默认输入设备。您的桌面会保持安装应用之前的行为，退出应用后也不会留下任何需要您撤销的东西。 ### 在会议应用中选择音源：“Monitor of Voxis\_Virtual\_Mic” 双向[会议模式](https://voxislive.com/zh/use-cases/meetings)还有另一半：您自己的讲话需要被翻译，并送达对方。在 Windows 上，这需要虚拟音频线驱动。在 Linux 上，Voxis 会为发出方向创建一个单独的 sink，以 **Voxis\_Virtual\_Mic** 为名发布，并把您声音的译音播放到其中。 然后，您的会议应用必须指向它。在 Zoom、Teams、Meet 或您正在使用的任何应用中，打开该应用自己的麦克风选择器，选择**“Monitor of Voxis\_Virtual\_Mic”**，而不是您的物理麦克风。其他应用能够录制的是 sink 的监听端，所以您选择的是监听端，而不是 sink 本身。 **它不会做什么：**Voxis 不会进入您的会议应用替您更改这项设置，也不会通过切换系统默认输入来自动把您路由到那里。您需要自己在会议应用中选择监听端，并在通话结束后把它切回您的真实麦克风。如果您忘了，对方听到的就是您未经翻译的声音——这就是应用会在双向会话开始和结束时发出提醒的原因。 ## 转写记录写入哪里 转写记录保存在您自己的电脑上，位于您真实的主目录中，而不是 snap 的私有存储内，因此您可以用任何文件管理器打开、移动和删除它们： `~/Documents/Voxis/Transcripts` 如果您的桌面使用了本地化或已迁移的“文档”文件夹，Voxis 会遵循 XDG 设置，而不是默认使用英文路径，因此该文件夹会出现在您的系统所指定的“文档”所在位置。每个会话都有自己的子文件夹，您在“翻译历史”视图中生成的任何导出文件，都会写在该会话记录的旁边。 访问您真实的主目录需要 snap 的 `home` 接口，通过应用商店安装时它通常已被连接。如果转写记录不在您预期的位置，请像检查 `audio-record` 那样，用 `snap connections voxis` 检查 `home` 一行。 ## 您的账户和分钟数在这里的用法完全相同 Linux 版 snap 并不是一个单独计费的独立产品。您使用同一个 Voxis 账户登录，**已购买的分钟数和每日免费时长同样适用于 Linux 版 snap**——在 Windows 上购买的套餐可以在 Linux 上使用，每日免费时长也还是同一份，而不是并行运行的第二份。方案和余额请见[价格](https://voxislive.com/zh/pricing)页面。 在这个通道上无需粘贴 API 密钥，也无需管理密钥：翻译分钟数随账户提供，应用会在会话开始时获取所需内容。 ## Linux 版的已知限制 如实列出，以便您在安装之前而不是之后做出决定： - **没有 AppImage 软件包。**snap 是我们发布的 Linux 打包格式；我们并没有在它之外另行提供 AppImage。 - **没有自动的会议应用路由。**会议的发出方向不会替您接入您的会议应用——您需要在该应用自己的麦克风选择器中选择“Monitor of Voxis\_Virtual\_Mic”，并在事后把它设回去。 - **您的系统默认设置不会被改动。**这是设计上的选择，而不是缺失的功能，但后果是实实在在的：应用不会通过接管您的默认设备来修复路由错误的设置。 - **手动安装的本地软件包起初没有连接任何接口。**在应用商店安装时会被授予的接口，在这里必须手动连接。 ## 如果会话一直没有声音 Linux 上没有声音，几乎总能归结为少数几个原因之一，而且很快就能把它们区分开： 1. 先检查权限：`snap connections voxis`，查看 `audio-record` 一行。接口未连接恰好会产生这种症状，其他任何办法都解决不了。 2. 运行应用内置的“声音测试”。播放和捕获是分别检查的，所以它能告诉您两半中哪一半没有声音。 3. 确认确实有东西在播放。Voxis 翻译的是您的电脑正在播放的内容——暂停的视频或静音的标签页没有任何内容可供它处理。 4. 在双向会议中，查看会议应用自己的麦克风选择器。如果它仍然是您的物理麦克风，对方听到的就是未经翻译的您。 5. 如果仍然没有声音，请在应用内发送一份报告。报告附带一份经过脱敏的日志，其中会注明使用了哪条捕获路径，而这一点仅凭描述是没人能还原的。 两个平台上按症状排查的帮助见[故障排除](https://voxislive.com/zh/troubleshooting)，其余文档的索引见[文档](https://voxislive.com/zh/docs)。 常见问题 ## 常见问题 ### 在 Linux 上用哪条命令安装 Voxis？ sudo snap install voxis。Voxis 发布在 snap 的 stable 通道上，所以这一条命令就是完整的安装——无需添加软件源，也无需构建任何东西。 ### 我装好了，但什么都没有被翻译。我漏掉了什么？ 几乎可以肯定是音频权限。snap 在受限环境中运行，音频权限未连接的安装会一直“失聪”：应用运行正常，但没有任何声音会到达翻译引擎。请运行 sudo snap connect voxis:audio-record，然后在开始会话之前用 snap connections voxis 确认。 ### 在 Zoom、Teams 或 Meet 中应该选择哪个音源？ 请在该应用自己的音频设置中，把麦克风选为“Monitor of Voxis\_Virtual\_Mic”。Voxis 会把您声音的译音播放到它以该名称发布的接收端（sink）中，而其他应用可以录制的正是 sink 的监听端（monitor）。Voxis 不会替您更改这项设置，所以通话结束后请把它切回您的真实麦克风。 ### 我的转写记录保存在哪里？ 保存在 ~/Documents/Voxis/Transcripts，位于您真实的主目录中，而不是 snap 的私有存储内，每个会话一个子文件夹。如果您的桌面使用了本地化或已迁移的“文档”文件夹，Voxis 会遵循 XDG 设置，而不是默认使用英文路径。 ### 我的分钟数在 Linux 上能用吗，还是需要重新购买？ 可以直接使用。已购买的分钟数和每日免费时长同样适用于 Linux 版 snap——同一个账户、同一份余额，无需另行购买 Linux 版。当前方案请参阅价格页面。 ### 有 AppImage 或其他 Linux 软件包吗？ 没有，不提供 AppImage 软件包；我们发布的 Linux 打包格式是 snap。而且由于通道会不断更新，请用 snap info voxis 查看 stable 当前提供的版本，不要轻信写在页面上的版本号。 ## Structured data (JSON-LD) ```json [ { "@context": "https://schema.org", "@graph": [ { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://voxislive.com/zh/" }, { "@type": "ListItem", "position": 2, "name": "文档", "item": "https://voxislive.com/zh/docs" }, { "@type": "ListItem", "position": 3, "name": "在 Linux 上安装（snap）", "item": "https://voxislive.com/zh/docs/install-linux-snap" } ] }, { "@type": "WebPage", "name": "在 Linux 上安装 Voxis（snap） | VoxisLive", "url": "https://voxislive.com/zh/docs/install-linux-snap", "description": "从 snap 的 stable 通道在 Linux 上安装 Voxis，连接音频录制权限，并选择正确的 PipeWire 音源。", "inLanguage": "zh-CN", "isPartOf": { "@type": "WebSite", "name": "VoxisLive", "url": "https://voxislive.com/" }, "publisher": { "@id": "https://voxislive.com/#org", "@type": "Organization", "name": "VoxisLive", "url": "https://voxislive.com/" } }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "在 Linux 上用哪条命令安装 Voxis？", "acceptedAnswer": { "@type": "Answer", "text": "sudo snap install voxis。Voxis 发布在 snap 的 stable 通道上，所以这一条命令就是完整的安装——无需添加软件源，也无需构建任何东西。" } }, { "@type": "Question", "name": "我装好了，但什么都没有被翻译。我漏掉了什么？", "acceptedAnswer": { "@type": "Answer", "text": "几乎可以肯定是音频权限。snap 在受限环境中运行，音频权限未连接的安装会一直“失聪”：应用运行正常，但没有任何声音会到达翻译引擎。请运行 sudo snap connect voxis:audio-record，然后在开始会话之前用 snap connections voxis 确认。" } }, { "@type": "Question", "name": "在 Zoom、Teams 或 Meet 中应该选择哪个音源？", "acceptedAnswer": { "@type": "Answer", "text": "请在该应用自己的音频设置中，把麦克风选为“Monitor of Voxis_Virtual_Mic”。Voxis 会把您声音的译音播放到它以该名称发布的接收端（sink）中，而其他应用可以录制的正是 sink 的监听端（monitor）。Voxis 不会替您更改这项设置，所以通话结束后请把它切回您的真实麦克风。" } }, { "@type": "Question", "name": "我的转写记录保存在哪里？", "acceptedAnswer": { "@type": "Answer", "text": "保存在 ~/Documents/Voxis/Transcripts，位于您真实的主目录中，而不是 snap 的私有存储内，每个会话一个子文件夹。如果您的桌面使用了本地化或已迁移的“文档”文件夹，Voxis 会遵循 XDG 设置，而不是默认使用英文路径。" } }, { "@type": "Question", "name": "我的分钟数在 Linux 上能用吗，还是需要重新购买？", "acceptedAnswer": { "@type": "Answer", "text": "可以直接使用。已购买的分钟数和每日免费时长同样适用于 Linux 版 snap——同一个账户、同一份余额，无需另行购买 Linux 版。当前方案请参阅价格页面。" } }, { "@type": "Question", "name": "有 AppImage 或其他 Linux 软件包吗？", "acceptedAnswer": { "@type": "Answer", "text": "没有，不提供 AppImage 软件包；我们发布的 Linux 打包格式是 snap。而且由于通道会不断更新，请用 snap info voxis 查看 stable 当前提供的版本，不要轻信写在页面上的版本号。" } } ] } ] }, { "@context": "https://schema.org", "@type": "Organization", "@id": "https://voxislive.com/#org", "name": "VoxisLive", "legalName": "VoxisLive Limited", "alternateName": [ "Voxis", "Voxis Live" ], "url": "https://voxislive.com/", "logo": { "@type": "ImageObject", "url": "https://voxislive.com/assets/voxis-mark-512.png", "width": 512, "height": 512 }, "identifier": "UK Companies House 17500296", "address": { "@type": "PostalAddress", "streetAddress": "71-75 Shelton Street, Covent Garden", "addressLocality": "London", "postalCode": "WC2H 9JQ", "addressCountry": "GB" }, "contactPoint": [ { "@type": "ContactPoint", "contactType": "customer support", "email": "support@voxislive.com", "url": "https://voxislive.com/contact", "availableLanguage": [ "en", "tr", "es", "de", "fr", "pt", "ko", "ja", "zh", "ru" ] } ], "sameAs": [ "https://apps.microsoft.com/store/detail/9P5Z0KVS58RS", "https://snapcraft.io/voxis", "https://chromewebstore.google.com/detail/voxis-%E2%80%94-live-translate/eaoplhkoomnlgfhcjeccgkhnkodkfbjn", "https://github.com/VoxisLive/voxislive", "https://www.reddit.com/r/LiveTranslation/", "https://www.reddit.com/r/LiveTranslation/wiki/index", "https://www.youtube.com/@VoxisLiveApp", "https://www.wikidata.org/wiki/Q141727138", "https://find-and-update.company-information.service.gov.uk/company/17500296", "https://www.google.com/search?kgmid=/g/11zyg5wsj8", "https://www.linkedin.com/company/voxislive/" ] } ] ```