更新日志

v0.7.15 - 2026-08-20

这版主要修安装资源。官网脚本、NAS 包和 Docker 镜像更容易拿到同一版，少一点下载地址不可用或版本对不上的问题。

Highlight

• 安装脚本使用公开资源，不再依赖私有源。
• NAS 和 Docker 安装入口的版本更一致。

主要更新

• 修正 KSpeeder 公开下载源。
• 改善 NAS 包和 Docker 镜像的资源一致性。

升级建议

用官网脚本、NAS 包或 Docker 镜像安装的用户建议升级。已经稳定运行、近期不重新安装的用户可以不急。

相关链接

docker_kspeeder v0.7.15

v0.7.14 - 2026-07-08

这版修 GHCR 多层级镜像路径。像 ghcr.io/owner/project/image:tag 这样的镜像，不应该被截断到错误路径。

Highlight

• 经常拉 GHCR 镜像的用户值得升级。很多项目把镜像放在多层命名空间里，旧解析逻辑容易在这里出错。

使用示例

ks-cli docker pull ghcr.io/owner/project/image:tag

主要更新

• 修复多层级 registry 镜像路径解析。
• 拉取多级 GHCR 镜像时更不容易被映射到错误地址。

升级建议

如果你常拉 GHCR 镜像，特别是路径里有多级命名空间的镜像，建议升到这个版本或更新版本。

相关链接

docker_kspeeder v0.7.14

v0.7.13 - 2026-07-01

这版让安装入口和 ks-cli 版本更容易对齐。它没有新增拉镜像命令，重点是减少安装时拿到旧版本工具的情况。

Highlight

• 官网脚本和 ks-cli 版本更容易一致。
• 安装后看到的版本信息更少出现前后不一致。

主要更新

• 改善安装脚本获取 ks-cli 版本的可靠性。
• 减少不同安装入口拿到不同资源的情况。

升级建议

新装或重装 KSpeeder 的用户建议使用这个版本或更新版本。已经安装完成且运行正常的用户可以正常往后升级。

v0.7.12 - 2026-06-29

这版更新 Codex 场景里的使用说明。普通用户不一定有感知，主要影响让 AI 助手帮你拉镜像的用法。

Highlight

• Codex 拉 DockerHub 或 GHCR 镜像时，会更明确地走 ks-cli，而不是自己拼加速地址。
• 如果你让 AI 助手跑 docker pull 或 docker compose pull，这版说明更不容易让命令跑偏。

主要更新

• 明确 Codex 场景应使用 ks-cli docker ...。
• 减少手动改镜像名、硬编码加速域名这类用法。

升级建议

只使用 KSpeeder 服务本身的用户正常更新即可。经常让 Codex 执行 Docker 命令的用户可以关注。

v0.7.11 - 2026-06-29

这版加入给 Codex 使用的 KSpeeder 入口。AI 助手可以把 DockerHub 和 GHCR 拉取交给 ks-cli。

Highlight

• AI 助手可以直接用 ks-cli docker ... 拉镜像。
• 用户不用再告诉助手每个镜像该换成哪个加速域名。

主要更新

• 增加 KSpeeder Codex 使用入口。
• DockerHub 和 GHCR 镜像拉取可以统一交给 ks-cli 处理。

升级建议

普通用户可以正常更新。经常用 Codex 跑 Docker 命令的用户可以关注。

v0.7.10 - 2026-06-29

这版让 ks-cli 更适合处理 Docker Compose 项目，也补了缓存清理命令。

Highlight

• Compose 项目可以先用 ks-cli 加速拉镜像，再按原来的方式启动服务。
• 缓存异常或占用太大时，可以直接用 CLI 清理，不必进管理面板找接口。

使用示例

ks-cli docker compose pull
ks-cli docker compose up -d web
ks-cli clear-cache

主要更新

• 支持通过 ks-cli 管理 Docker Compose 拉取和启动流程。
• 增加缓存清理命令。
• 修复 Compose 安装和卸载时的权限、服务识别和清理问题。

升级建议

使用 Docker Compose 部署 KSpeeder 或拉取多镜像应用的用户建议升级。

v0.7.8 - 2026-06-29

这版加入独立的 ks-cli docker pull。不想改 Docker daemon 配置时，可以临时走 KSpeeder 拉一次镜像。

Highlight

• 临时拉镜像时，把 docker pull 换成 ks-cli docker pull 就能用。
• 系统不适合装原生服务时，安装器可以退到 Docker Compose 部署。

使用示例

ks-cli docker pull alpine:latest
ks-cli docker pull ghcr.io/n8n-io/n8n:latest
ks-cli installer install --yes --force-docker

主要更新

• 新增 ks-cli docker pull 等独立加速入口。
• 把安装、健康检查、版本查看和管理入口收进 ks-cli。
• 支持用 Docker Compose 方式安装。

升级建议

想要"无配置拉一次"的用户建议从这个版本开始使用 ks-cli。

v0.7.7 - 2026-06-18

这版修反向代理兼容和镜像测速。适合自部署、反向代理和维护节点的人升级。

Highlight

• 旧反向代理入口继续可用，自部署环境更少被入口变化卡住。
• 镜像测速和 fallback 逻辑更稳，节点异常时更少误判。

主要更新

• 改善反向代理入口兼容性。
• 修复 GHCR、Docker registry、测速目标和 fallback 相关问题。

升级建议

维护自部署、反向代理或加速节点的用户建议升级。

v0.7.6 - 2026-06-16

这版重点修 Docker 镜像 fallback。某个镜像节点不可用、限流或返回异常时，KSpeeder 更容易换到可用来源。

Highlight

• 镜像源返回异常时，拉取流程更少直接中断。
• 遇到 429、节点不可用或高速节点异常时，切换来源更稳。

主要更新

• 修复 Docker mirror fallback 失败问题。
• 改善 GHCR 和高速节点异常时的处理。

升级建议

遇到镜像 fallback、429 或高速节点异常的用户建议升级。

v0.7.5 - 2026-03-17

这版修一些路由和高速通道边缘问题。功能不大，但对遇到特定站点异常的用户有用。

Highlight

• 高速通道关闭或节点异常时，请求更少被带到不可用路径。
• Plus 高速通道和多节点场景下，异常恢复更稳。

主要更新

• 修复部分路由处理问题。
• 修复高速通道关闭场景下的处理问题。

升级建议

如果你遇到特定站点路由异常或高速通道异常，建议升级。

v0.7.3 - 2026-03-14

这版改管理入口的搜索相关能力。普通拉镜像用户不需要专门为这个版本升级。

Highlight

• 管理入口查找资源、镜像信息和节点数据的基础能力更完整。

主要更新

• 改善管理入口搜索相关体验。

升级建议

正常更新即可。

v0.7.2 - 2026-03-13

这版改请求重试和 DomainFold 请求控制。目标很简单，失败时别急着断，请求也别打太猛。

Highlight

• 请求失败时会重试，临时网络波动不容易直接变成下载失败。
• DomainFold 发请求更克制，减少限流和节点压力。

主要更新

• 增加失败重试能力。
• 控制 DomainFold 请求量。
• 改善部分代理请求流程。

升级建议

使用 DomainFold 或代理加速能力的用户建议升级。

v0.7.1 - 2026-03-04

这版没有普通用户需要主动关注的新功能。它为后续代理能力做准备。

Highlight

• 已经在自定义代理链路的用户，可以关注后续版本里的配置入口。

升级建议

普通用户不必专门为这个版本升级。需要代理相关能力时，直接升级到更新版本。

v0.7.0 - 2026-03-03

这版处理大镜像层下载。拉 AI、数据库或开发环境镜像时，体积大的层更容易暴露吞吐和等待问题。

Highlight

• 大文件层下载更少卡住。
• 经常拉大镜像的用户更容易感受到变化。

主要更新

• 改善 Docker 大文件层下载。
• 改善多来源读取时的等待和切换行为。

升级建议

经常拉大镜像的用户建议升级。

v0.6.6 - 2026-02-26

这版集中改节点管理、DomainFold、管理界面和缓存清理。它更像一个管理体验版本。

Highlight

• 管理面板里的节点状态、测速结果和错误提示更清楚。
• 缓存出问题或磁盘占用过大时，可以从产品入口处理，不必手动删目录。

主要更新

• 改进加速节点的刷新、状态展示和错误提示。
• 增加 SOCKS5 和 DomainFold 相关能力。
• 支持更多分组和节点展示方式。
• 增加强制缓存清理功能。
• 改善管理界面的导航、状态展示和下载入口。

升级建议

使用节点管理、DomainFold 或管理面板的用户建议升级。

v0.6.5 - 2026-02-05

这版清理旧配置入口，并修退出行为。重点是少一点"服务怎么自己退了"的困惑。

Highlight

• 旧的 KS_USER_MIRROR_CONFIG 不再作为推荐入口。
• 长期运行服务更不容易意外退出。

主要更新

• 标记 KS_USER_MIRROR_CONFIG 为废弃配置。
• 修复 ExitAfter 相关行为。

升级建议

还在用旧环境变量的用户，建议迁移到新配置方式。

v0.6.3 - 2026-02-05

这版修外部忽略规则和默认退出行为。服务常驻场景会更稳。

Highlight

• 默认不再启用容易让服务退出的 exitAfter 行为。
• 外部忽略规则处理更准确，减少请求被错误跳过或错误接管。

主要更新

• 调整 external ignore 相关处理。
• 默认关闭 exitAfter 行为。

升级建议

正常更新即可。如果你依赖短生命周期进程，请重新确认启动参数。

v0.6.2 - 2026-02-05

这版加入多代理、SOCKS5、节点测速和管理概览。网络路径比较复杂的用户会更需要它。

Highlight

• 可以把 SOCKS5 或 HTTP 代理作为额外节点加入测速和排序。
• 管理概览、节点自动加入和实时探测更完整，适合多出口、多代理或自建节点环境。

使用示例

proxies:
  docker: true
  domainfold: true
  nodes:
    - url: socks5://proxy.example.com:1080
      display_name: proxy-a
      enabled: true

主要更新

• 增加多代理和 SOCKS5 相关能力。
• 改进节点测速、节点排序、fallback 和实时探测。
• 增加 Docker search、节点自动加入和管理界面展示。
• 修复节点刷新和 DomainFold 相关细节。

升级建议

使用多代理、SOCKS5 或节点测速功能的用户建议升级。

v0.6.1 - 2026-01-16

这版把安装、卸载、服务管理和 macOS 支持收进 ks-cli。

Highlight

• 安装、卸载、服务启停和版本文件管理开始统一到安装器。
• macOS 安装路径补齐，桌面开发环境也能更顺手地装和管 KSpeeder。

使用示例

ks-cli installer install --yes
ks-cli service restart
ks-cli installer uninstall

主要更新

• 支持通过 ks-cli 安装、卸载和管理版本文件。
• 增加下载进度显示。
• 增加 macOS 安装支持。
• 增加 Docker daemon 配置入口、服务启动停止和 Docker 重启确认。
• 改善安装脚本交互和权限处理。

升级建议

还在用旧 shell 安装流程的用户，建议迁移到新版安装器或 ks-cli 管理流程。

v0.6.0 - 2026-01-04

这版加入多来源下载，并修 GHCR 下载 URL。依赖 GitHub 资源或 GHCR 的用户会更有感知。

Highlight

• GitHub Raw、GitHub Release 等下载来源可以组合使用。
• GHCR URL 修复后，GitHub Container Registry 镜像加速更稳。

主要更新

• 支持从多个 GitHub 来源下载。
• 修复可能导致 GHCR 下载失败的 URL 问题。

升级建议

依赖 GitHub 资源下载或 GHCR 加速的用户建议升级。

v0.5.0 - 2025-12-07

这是官网记录里的 GHCR 起点。KSpeeder 从这个版本开始公开说明支持 ghcr.io 加速。

Highlight

• KSpeeder 不再只面向 DockerHub，也开始覆盖 GitHub Container Registry。
• 很多自托管应用和开源项目都把镜像放在 GHCR，这个版本让这类镜像进入加速范围。

使用示例

ks-cli docker pull ghcr.io/n8n-io/n8n:latest

主要更新

• 支持将 GHCR 镜像流量引导到 KSpeeder 加速入口。

升级建议

建议使用更新版本。后续版本修了 GHCR 路径解析、ks-cli 使用和安装资源问题。