适用于 PWA、Windows 和 Linux（Electron、NWJS、UWP）的 Kiwix JS

演示： [ 在桌面上安装 PWA ] [ 安装和使用：Android ] [ 安装和使用： Firefox Android ] [ 选择存档文件夹 ] [ 文件处理（桌面） ] [ 演示所有 OPFS 功能 ] [ 将应用程序添加到 Edge 侧边栏 ]

Kiwix 是 Wikipedia、Project Gutenberg、TED Talks、Wikivoyage、Stackexchange 以及许多其他网站和资源的离线浏览器。它以多种不同的语言向互联网访问受限或无法访问的人们提供知识。该软件和内容可供任何人免费使用。获取应用程序并下载您选择的离线内容（ZIM 档案，可以在应用程序内免费下载）。有数百个多语言档案可供选择，涉及许多不同的主题和主题。打造全线下知识数字图书馆！

作为 Kiwix 系列的一部分，该应用程序既可以作为支持离线、可安装的渐进式 Web 应用程序 (PWA) 提供，适用于几乎所有现代浏览器和设备，也可以作为适用于各种 Windows 和 Linux 操作系统的应用程序包提供：请参阅Kiwix JS Windows 和 Linux 。对于Mac 和 iOS ，请使用离线 PWA。

我们还提供了Kiwix 的 WikiMed （完整的医学百科全书）和Kiwix 的 Wikivoyage （完整的旅行指南）的英文版应用程序 - 无需额外下载！（但是，您可以在这些应用程序中下载其他语言。）

如果您使用的是Windows 10 或 11 ，那么这三个应用程序都可以在 Microsoft Store 中方便地获得： Kiwix JS UWP 、 WikiMed by Kiwix和Wikivoyage by Kiwix 。当有新的软件包可用时，它们会自动更新。如果您使用的是Linux ，那么 Kiwix JS 的 Electron AppImage 包也会（可选）自我更新，就像可安装的 Windows Electron 包一样。当有更新可用时，其他应用程序会通知您。

通用渐进式网络应用程序

不喜欢商店或套餐？我们为您服务！立即在浏览器中打开可安装、可离线使用的 PWA（渐进式 Web 应用程序），网址为pwa.kiwix.org ，即可立即启动此应用程序。这适用于任何支持 Service Workers 的浏览器：现代 Chrome、Edge、Firefox 和 Safari（请注意，在 iOS 设备上，您必须使用 Safari，因为 Apple 禁止在 i 设备上的任何其他浏览器中使用 Service Workers）。

从应用程序的配置页面获取可与 PWA 一起使用的免费 ZIM 存档，或者您可以在下载 ZIM 之前在library.kiwix.org 上预览 ZIM。安装、添加书签或添加到主屏幕后，即使您的设备完全离线，PWA 也能正常工作！看看我们的演示，它展示了安装 PWA 是多么快速和简单。

如何使所有维基百科离线？

如果您想要带有图像的版本，请注意，下载量很大：英文版约为 97 GB！我们建议您首先尝试使用较小的主题档案之一，例如天文学、化学、数学、物理等。在应用程序中，您会发现一个方便的下拉菜单，可让您选择语言和主题，然后下载。存档将在您的浏览器中下载。

如果您确实想要带有图像的完整英文维基百科，那么我们强烈建议您使用开源应用程序 qBittorrent 将其下载到具有足够磁盘空间的 PC 上。首先安装qBittorrent。然后，当您在应用程序中选择要下载的大型存档时，它将为您提供 torrent 链接。单击该链接并允许您的浏览器下载并打开 torrent 文件。这个小文件将在 qBittorrent 中打开，系统会询问您要将要下载的存档保存在哪里。这比听起来容易得多！

Zimit（网络档案）格式怎么样？

Zimit 是一项允许将任何网站存档为 ZIM 的服务，尽管有许多令人兴奋的基于 Zimit 的预爬网 ZIM 供您使用（见下文）。如果您想自己制作，请在 https://youzim.it/ 上尝试一下。 Kiwix JS PWA 和 Electron 应用程序从 v.2.8.5 开始，使用开源 Replay Web Archive 阅读器完全支持基于 Zimit 的存档，并且已经支持即将推出的 Zimit v2 格式。请注意，大多数 Zimit 档案由于其高度动态的内容而需要 ServiceWorker 模式。

Kiwix 下载库（在应用程序内提供）以 Zimit 文件格式发布了许多非常有用的参考网站，例如Ready.Gov 灾难准备网站、引人入胜的Low-Tech 杂志、 CIA World Factbook 、 Harmony Project库乐谱、网络哲学百科全书等等。只需打开应用内库中的 Zimit 目录即可。

浏览器支持

我们为能够维持对旧浏览器和平台的支持而感到自豪，因为该应用程序的重要目标受众是发展中国家的用户，他们可能只能访问具有过时软件的旧设备。我们经常在较旧的浏览器和操作系统上测试该应用程序。该应用程序通常会检测哪些功能在给定浏览器上不起作用，并禁用它们或解决它们。但是，在某些情况下（例如 Firefox <= 59），应用程序会将自身设置为 Service Worker 模式，但此模式会默默失败。如果受影响，请尝试将应用程序切换到受限模式（请参阅配置中的内容注入模式）。

官方支持

作为 Linux、Windows、Android、iOS、macOS 上的渐进式 Web 应用程序 (PWA)：

Google Chrome / Chromium >= 59（以及许多基于 Chromium 的浏览器，例如 Opera、Samsung Internet）
Microsoft Edge（铬）> = 79
Mozilla Firefox >= 68（但请参阅有关 Android 的注释* ）
适用于 iOS 和 macOS 的 Apple Safari >= 11.3（全文搜索仅适用于 iOS 15+）
Microsoft Edge Legacy 18（仅限 Windows）

作为使用以下框架实现的应用程序：

Electron >= 1.8.0（Ubuntu、Debian、Fedora、OpenSUSE、AppImage、Windows）：GitHub 发布
通用 Windows 平台 (UWP) >=10.0.10240：Microsoft Store 应用或 GitHub 版本 - Windows 10/11 (Electron)、ARM 上的 Windows、Xbox、Windows 10 Mobile
NWJS >= 0.23.0 (Windows 7/8/10/11)：GitHub 发布
NWJS 0.14.7（仅限 Windows XP/Vista）：GitHub 发布

*对于Android 版 Firefox ，该应用程序仅可用于存储在 Origin 私有文件系统中的文件。 Firefox 存在一个错误，如果从用户可见的文件系统打开 ZIM 存档，浏览器会尝试将整个 ZIM 存档读入内存。

已弃用

尽管已弃用，但只要可行，我们将继续提供支持：

Internet Explorer 11（仅限受限模式，不能离线使用 PWA）
Edge Legacy <= 17（仅限受限模式，不能离线使用 PWA）
Firefox 45-67（部分版本需要用户手动切换到受限模式，部分版本无法显示WebP图片）
Chromium 49-58（某些版本仅在受限模式下运行）

报告错误和技术支持

请使用此存储库的问题跟踪器来报告您在该软件中发现的任何错误。打开新的票证（在检查您发现的问题是否还没有票证后）。请清楚说明您正在使用的版本号（在应用程序的配置页面顶部）以及您正在使用的浏览器或平台。

如果您在使用该软件时遇到困难，或者想查看新功能，也请开具票证。或者，请参阅应用程序“关于”页面上的“反馈”部分，了解针对您的问题获取技术支持的其他方法。如果您只是想提供反馈，请随时联系（请参阅应用程序的“关于”页面）；如果您是从商店获得该应用程序，请留下评论。如果您喜欢该应用程序，请为此存储库加注星标（见顶部）！

技术资料

此存储库用于开发适用于 PWA、Electron、NWJS 和 Windows 10/11 通用 Windows 平台 (UWP) 的 Kiwix JS 应用程序。最新的代码通常位于主分支上，但这用于主动开发，并且可能在发布之前进行多次提交。适用于 Windows (XP/Vista/7/8/10/11) 和 Linux（32 位和 64 位）的可安装和便携式版本可从发行版获得。 Electron 和 NWJS 应用程序的不稳定夜间构建可与开发部署一起使用，但代码可能存在错误并且变化很快。此外，夜间 Windows 二进制文件是未签名的。

该代码基于 Kiwix JS，Kiwix 离线阅读器的轻量级 HTML/JavaScript 端口。为各种框架打包此应用程序并添加一些通常向后移植到上游的功能已进行了大量开发。如果在现代 Chromium 浏览器中打开，PWA 可以作为完全集成的系统应用程序安装，并且它使用文件系统访问 API 和文件处理 API 在支持这些 API 的浏览器中提供类似本机的体验。有关这些 API 的更多信息，请参阅本页底部：文件系统访问 API 和文件处理。

这些应用程序也可以在 WinGet 包管理器中找到。您可以通过打开命令提示符或 PowerShell 终端并输入winget install kiwix.kiwixjs来旁加载 UWP 版本（在 Windows 10/11 中）（此版本不会自动更新，但它会在新更新准备就绪时通知您）安装）。发行说明中提供了替代侧载说明。 Electron 版本可以使用winget install kiwix.kiwixjs.electron Electron 来安装，或者通过从 Releases 下载软件包来安装。为了进行测试，Store、Electron 和 NWJS 版本附带了前 100 篇维基百科文章的迷你档案（没有图像，只有 lede 段落）。

一些 ZIM 档案确实非常大，因此可以考虑文件系统的潜在限制。对于大多数格式化为 exFAT 或 NTFS 的存储类型（包括 microSD 卡），您甚至可以毫无问题地将这些非常大的文件存储在存储中。但是，如果您计划将 ZIM 文件存储在格式化为FAT32 的SD 卡上，并且希望使用大于 4GB 的存档，那么您将需要拆分 ZIM：请参阅文件拆分说明。

这个应用程序的许多开发都发生在 Kiwix JS 存储库的上游，我积极参与了该存储库的开发。如果没有 Kiwix JS，这个应用程序就不可能实现，非常感谢 Evopedia 应用程序和 Kiwix HTML5（最终成为 Kiwix JS）的原始开发人员。 Kiwix JS PWA 和其他应用程序的移植和进一步开发由 Geoffrey Kantaris 完成。您可以通过电子邮件联系我：egk10 at cam ac uk。

贡献代码

如果您有编码经验并且有兴趣为该项目做出贡献，我们建议您首先为上游 Kiwix JS 存储库做出贡献，因为其中贡献的大部分代码随后都会移植到该存储库。详细信息请参阅 CONTRIBUTING.md。如果您希望为特定的 Kiwix JS PWA 功能做出贡献，请在此存储库上打开一个问题，解释您打算贡献的功能或其他代码以及您建议如何完成此操作。您应该能够轻松地创建 PR，并且对 JavaScript 有很好的了解。遵循与 Kiwix JS 相同的贡献指南。

我们现在已将此应用程序转换为 ES6 代码，该代码由 rollup.js 和 Babel 转译为与旧版浏览器兼容的代码。简要说明：

克隆此存储库并运行npm install以获取 Node 依赖项；
要使用 Vite.js（包括热模块替换）为应用程序提供服务，请运行npm run serve ；
您必须在“故障排除和开发”下的“配置”中打开“绕过应用程序缓存”选项。如果应用程序以无序方式加载，只要应用程序处于 ServiceWorker 模式（如果未在内容注入模式下打开它），您仍然应该能够访问此设置。使用 Ctrl-R 刷新应用程序；
Vite 会监视更改，并在您进行更改并保存时刷新应用程序；
要预览应用程序的捆绑版本，请运行npm run preview ，Vite 将构建应用程序并打开浏览器窗口以查看捆绑版本；
要完全构建应用程序，请运行npm run build 。构建的应用程序将保存到克隆存储库中名为dist目录中；
要在 Electron 框架中运行应用程序，您可以使用npm start 。这将在package.json中指定的 Electron 版本中运行未捆绑的应用程序。请参阅package.json中的各种脚本来构建 Electron 应用程序的捆绑版本（您只能为当前使用的操作系统构建它，尽管 Linux 应用程序可以使用 WSL 在 Windows 上构建）。

其他捐款/捐赠

如果您喜欢这个项目并愿意为维持其运行提供经济捐助，您可以在 Kiwix 支持页面上进行一次性或定期捐款。捐款有助于支付服务器、编码证书、维护等费用。如果您愿意贡献时间和专业知识而不是金钱，并且您具有良好的外语知识，您可以帮助翻译 Kiwix 项目。或者，您可以通过编辑或更正维基百科或维基导游文章来帮助改进维基媒体项目。

隐私政策

本隐私政策适用于 Kiwix JS Progressive Web App 及其为 Electron、NWJS 和 UWP 框架打包的版本，这些版本在 Kiwix 服务器上发布，并由 GitHub 和其他第三方供应商商店（“应用商店”）上的官方 Kiwix 帐户发布。）。

安装后，该应用程序能够完全离线工作。它不会收集或记录您的任何个人数据，但如果您从商店安装它，商店运营商可能会收集匿名使用数据（见下文）。该应用程序仅记住您在会话期间的浏览历史记录（以便返回之前查看的页面）。退出应用程序时，此历史记录将丢失，最后访问的页面除外。

如果您从安全的 Web 服务器（例如 PWA 服务器）访问此应用程序，则只有您的浏览器能够安装 Service Worker，它才会离线工作。如果您在 Service Worker 模式下安装 PWA 版本或为 PWA 版本添加书签，那么它将离线工作，但请注意，根据设计，任何 PWA 都会定期检查 PWA 服务器（在本例中为 https://pwa.kiwix.org/），如果它可以用来检查更新的 Service Worker。

未通过 Store 安装或不是 PWA 的应用程序版本将在启动时检查 GitHub Releases API 是否有更新，但此功能是可选的，可以关闭。如果您允许某些 Electron 应用程序检查更新，它们也可以选择自行更新（通过相同的 API）。这适用于 Windows 的安装程序（设置）版本和 Linux 的 AppImage 版本。 Store版本和PWA也会自我更新，但这在应用程序内是无法控制的。

默认情况下，此应用程序将使用本地存储或只能在此设备上访问的 cookie 记住您在会话之间上次访问的页面。如果您正在访问不希望下次打开此应用程序时显示的敏感信息，我们建议您在配置选项中关闭此选项。

此应用程序仅读取您在设备上明确选择的存档文件以及其自身包中包含的文件：它无法读取任何其他文件。如果您在配置页面上特别请求它访问 ZIM 存档的下载库，它只会访问 Kiwix 存档下载服务器。如果您将应用程序作为 PWA 运行，它将从安全 PWA 服务器缓存自己的代码，然后可以离线使用。某些 ZIM 存档包含活动内容（脚本），在极少数情况下，这些内容可能会尝试联系外部服务器以获取字体等附带文件。我们通过注入文章中的内容安全策略来阻止这些内容，但在某些情况下，如果文章已经有 CSP，我们的可能会被覆盖。请注意，只有在配置中启用 Service Worker 模式时，脚本才会运行。

如果您认为您的互联网访问不安全，或者正在被观察或审查，我们建议您在使用该应用程序之前完全关闭您的互联网访问（数据或 WiFi）。

此外，如果您从供应商商店（包括扩展程序）获得此应用程序，则商店运营商可能会跟踪您对该应用程序的使用情况（例如下载、安装、卸载、日期和会话次数/持续时间），以便提供匿名、向开发人员汇总使用统计数据。如果您对此感到担忧，您应该查看相关的商店隐私政策以获取更多信息。

此应用程序的构建版本不使用 Store 或在线 Service Worker。请参阅：