kage安装指南：Go、Homebrew、Scoop、apt与Docker 5种方式一次搞定（附Chrome配置技巧）

kage安装指南：Go、Homebrew、Scoop、apt与Docker 5种方式一次搞定（附Chrome配置技巧）

【免费下载链接】kageShadow any website for offline viewing, with the JavaScript stripped out项目地址: https://gitcode.com/gh_mirrors/kage6/kage

kage是一个网站离线镜像克隆工具：它用真实无头 Chrome 打开网页、等待渲染完成后截取 DOM，剔除全部 JavaScript，再把 CSS、图片、字体下载到本地路径。装好它，你就能把任意网站"影子化"成纯静态文件，离线打开依然像活站一样——零脚本、零网络请求、零追踪。

5种kage安装方式速览

kage 是单个二进制文件，选哪种方式全看你的系统：

各平台的完整说明可参考官方安装文档：docs/content/getting-started/installation.md。

方式一：Go 一行安装（跨平台首选）

只要装了 Go，一条命令搞定，@latest保证拿到最新版：

go install github.com/tamnd/kage/cmd/kage@latest

二进制会装进$GOBIN（默认~/go/bin），确认它在你PATH中即可。也可以从源码构建：

make build # 产出 bin/kage（纯 Go，无需 cgo）

构建逻辑见 Makefile。

方式二：macOS 用 Homebrew 安装

预编译 cask，不用装 Go、不用编译：

brew install --cask tamnd/tap/kage

升级时brew upgrade --cask kage一条命令即可。

方式三：Windows 用 Scoop 安装

Scoop 需要先加项目作者的 bucket，再安装：

scoop bucket add tamnd https://github.com/tamnd/scoop-bucket scoop install kage

完成后kage --version验证。Windows 版还会自动寻找已安装的 Chrome / Edge / Chromium，找不到时会自动下载一份专用 Chromium 缓存到本地（实现见 browser/launcher_windows.go）。

方式四：Debian/Ubuntu 用 apt 安装

官方签名软件源会跟随每个版本发布，之后apt upgrade就能保持最新：

# 导入 GPG 密钥与软件源 curl -fsSL https://tamnd.github.io/linux-repo/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/tamnd.gpg echo "deb [signed-by=/usr/share/keyrings/tamnd.gpg] https://tamnd.github.io/linux-repo/apt stable main" | sudo tee /etc/apt/sources.list.d/tamnd.list sudo apt update && sudo apt install kage

Fedora / RHEL 走 dnf：

sudo dnf config-manager --add-repo https://tamnd.github.io/linux-repo/dnf/tamnd.repo sudo dnf install kage

不想加源也可以直接下载发行版附件里的.deb/.rpm/.apk包安装。

方式五：Docker 一条命令（免装 Chrome）

官方容器镜像基于 Alpine 并内置 Chromium、字体与 CA 证书，开箱即用：

docker run --rm -v "$PWD/out:/out" ghcr.io/tamnd/kage clone example.com

镜像直接落在宿主机的./out/example.com/。镜像内置KAGE_CHROME=/usr/bin/chromium-browser环境变量，因此永远不会再去下载浏览器——细节可看 Dockerfile。

Chrome配置技巧：kage 如何找到你的浏览器

kage 驱动的是真实 Chrome而非网页抓取，所以本机安装需要系统装有 Chrome 或 Chromium：

• 自动探测：macOS/Windows 找 Google Chrome，Linux 找google-chrome/chromium，无需任何配置；
• 手动指定：用--chrome参数或KAGE_CHROME环境变量指向指定二进制：

kage clone example.com --chrome /path/to/chromium # 或 export KAGE_CHROME=/path/to/chromium

• 找不到浏览器怎么办：启动器会在首次使用时自动下载一份专用 Chromium 缓存起来，之后复用，无需手动干预；
• Docker 方式：容器已内置 Chromium，跳过全部浏览器配置。

装好之后：一条命令验证

安装完成后，立刻克隆一个站点验证整条链路：

kage clone example.com kage serve $HOME/data/kage/example.com # 浏览器打开 http://127.0.0.1:8800

克隆完的页面里搜不到任何<script>、onclick或javascript:，全部资源都在本地_kage/目录下。想体验"原生窗口打开离线站点"的效果，还可以用make build-webview构建带 webview 标签的版本，打包后的站点会在系统 WebView 独立窗口中打开，而不是浏览器标签页：

小结

五条路殊途同归：装完kage，任何网站都能被"影子化"到本地，成为一份十年后依然能离线打开的纯净副本。

【免费下载链接】kageShadow any website for offline viewing, with the JavaScript stripped out项目地址: https://gitcode.com/gh_mirrors/kage6/kage