安装

如何在各种平台上安装 KSpeeder

KSpeeder 支持的平台

KSpeeder 支持多种操作系统和多架构

Linux ( AMD64/ARM64/ARM )
macOS ( AMD64/ARM64 )
OpenWrt ( AMD64/ARM )
各种 NAS 操作系统（只要支持 docker 即可）
- 群晖, 飞牛OS, etc.

一键安装

一键安装脚本会先下载当前系统对应的 ks-cli，把它安装到系统 PATH 中，然后继续进入 KSpeeder 安装流程。你只需要按提示确认安装方式、端口和缓存目录即可。

默认安装路径：

Linux / macOS：/usr/local/bin/ks-cli
Windows：C:\ProgramData\KSpeeder\bin\ks-cli.exe

macOS / Linux

用 curl 安装

sh -c "$(curl -fsSL https://kspeeder.com/bin/install-kspeeder.sh)"

用 wget 安装

sh -c "$(wget -qO- https://kspeeder.com/bin/install-kspeeder.sh)"

Windows

远程下载脚本并直接执行

iwr https://kspeeder.com/bin/install-kspeeder.ps1 -UseBasicParsing | iex

静默安装和自定义参数

如果你希望跳过交互式确认，可以在运行脚本前设置环境变量。常用参数如下：

环境变量	作用
`KSPEEDER_INSTALL_YES=1`	使用默认值并跳过交互确认
`KSPEEDER_INSTALL_FORCE_DOCKER=1`	强制使用 Docker Compose 安装 KSpeeder
`KSPEEDER_INSTALL_LISTEN=:5443`	设置镜像代理监听地址
`KSPEEDER_INSTALL_ADMIN=:5003`	设置管理面板监听地址
`KSPEEDER_INSTALL_CACHE_PATH=/path/to/cache`	设置本地缓存目录
`KSPEEDER_INSTALL_VERSION_URL=https://.../version.txt`	使用指定版本清单

Linux / macOS 示例：

KSPEEDER_INSTALL_YES=1 \
KSPEEDER_INSTALL_LISTEN=:5443 \
KSPEEDER_INSTALL_ADMIN=:5003 \
sh -c "$(curl -fsSL https://kspeeder.com/bin/install-kspeeder.sh)"

强制使用 Docker Compose 安装：

KSPEEDER_INSTALL_FORCE_DOCKER=1 sh -c "$(curl -fsSL https://kspeeder.com/bin/install-kspeeder.sh)"

Windows PowerShell 示例：

$env:KSPEEDER_INSTALL_YES = "1"; iwr https://kspeeder.com/bin/install-kspeeder.ps1 -UseBasicParsing | iex

只安装 ks-cli

如果你暂时只想安装命令行工具，不安装 KSpeeder 常驻服务，可以使用 ks-cli 单独安装脚本。安装后你仍然可以用 ks-cli docker ... 无配置使用 kspeeder 加速拉取镜像，也可以之后再运行 ks-cli installer 安装服务。

只安装 CLI 时，macOS / Linux 默认安装到 ~/.local/bin/ks-cli，Windows 默认安装到 %LOCALAPPDATA%\KSpeeder\bin\ks-cli.exe。如果当前终端提示找不到 ks-cli，请把对应目录加入 PATH，或使用完整路径运行。

macOS / Linux：

sh -c "$(curl -fsSL https://kspeeder.com/bin/install-ks-cli.sh)"

Windows PowerShell：

iwr https://kspeeder.com/bin/install-ks-cli.ps1 -UseBasicParsing | iex

更多命令请参考：KS CLI 使用帮助。

用 Docker 安装 ( 其他平台 )

方法一

在 shell 中运行命令下载镜像：

docker pull registry.kspeeder.com/linkease/kspeeder:latest

在 shell 中执行命令，启动 KSpeeder：


docker run -d --name kspeeder \
  -p 5443:5443 \
  -p 5003:5003 \
  -v $(pwd)/kspeeder-data:/kspeeder-data \
  -v $(pwd)/kspeeder-config:/kspeeder-config \
  --restart unless-stopped \
  registry.kspeeder.com/linkease/kspeeder:latest

方法二

如果你有 docker-compose, 可以创建docker-compose.yml文件, 添加内容：

services:
  kspeeder:
    image: registry.kspeeder.com/linkease/kspeeder:latest
    container_name: kspeeder
    ports:
      - '5443:5443'
      - '5003:5003'
    volumes:
      - ./kspeeder-data:/kspeeder-data
      - ./kspeeder-config:/kspeeder-config
    restart: unless-stopped