Kiwix Tools离线知识库NAS部署指南，Docker快速搭建私人维基百科服务器

项目介绍

Kiwix Tools 是一套功能强大的离线内容访问工具集合，专为那些想要在没有互联网连接的环境下访问维基百科、古腾堡计划等海量知识资源的用户而设计。它包含三个核心工具：kiwix-manage（用于管理ZIM文件库）、kiwix-search（全文搜索功能）和 kiwix-serve（HTTP服务守护进程）。

这个项目完全开源，基于GPL v3许可证。无论你是在网络受限的地区、离线学习场景，还是想要建立一个私人知识库服务器，Kiwix Tools都能帮你轻松实现。它支持跨平台部署，官方提供了Docker镜像支持，让部署变得简单快捷。

项目地址：点我跳转

部署安装

如果你需要在外网也能访问这个服务，建议配置内网穿透工具。推荐使用 帕斯内网穿透，先注册好账号。具体操作步骤可以查看 帕斯内网穿透全平台上手攻略，帮你快速打通内外网通道。

使用 Docker 快速部署

打开你的 NAS 设备或任何支持 Docker 的系统，按照以下步骤操作：

第一步：添加镜像

点击本地镜像 → 添加镜像 → 从 URL 添加

镜像地址填写：`ghcr.io/kiwix/kiwix-serve:latest`

等待镜像下载完成后，点击启动按钮。

第二步：容器配置

启动容器时，勾选开机自动启动选项，确保服务随系统启动。

端口映射设置

容器内部端口：`8080`（这是 kiwix-serve 的默认服务端口） 主机映射端口：`8080`（如果你的系统中 8080 端口已被占用，可以修改为其他端口，比如 `8081`、`8082` 等，但记住容器内的端口始终是 `8080`）

存储位置配置

你需要创建一个文件夹用于存放 ZIM 文件（离线内容库）。建议在 NAS 上创建一个专用目录，比如 `/data/kiwix`，然后将其映射到容器内的 `/data` 目录。这样你下载的所有离线资源都会被保存下来。

环境变量设置

Kiwix-serve 基本上不需要特殊的环境变量配置，使用默认设置即可正常运行。如果你有特殊需求，可以参考官方文档进行高级配置。

第三步：启动并访问

容器启动成功后，打开浏览器访问：`http://你的设备IP:8080`

例如，如果你的 NAS IP 是 `192.168.1.100`，就访问 `http://192.168.1.100:8080`

到这里，Kiwix 服务就已经成功部署并可以使用了。你可以开始上传 ZIM 文件到映射的存储目录，然后通过 Web 界面进行管理和访问。

总结

通过上述步骤，你已经成功在自己的 NAS 或服务器上部署了 Kiwix Tools。现在你可以拥有一个完全离线的知识库服务，随时随地访问你需要的内容，不受网络限制。祝你使用愉快！

本篇教程结束