跳到主要内容
Depsilo
EN
开始部署

开源、自托管的依赖代理

一份缓存，连接每一次构建。

让开发机、服务器和 CI 复用依赖下载。继续使用 npm、pip 等包管理器，通过自托管入口查看请求、管理缓存与交付规则。

部署 DepsiloGitHub
  • MIT 开源
  • Docker / 单文件部署
  • 服务无遥测

请求路径示意

开发机
服务器
CI / CD
Depsilo缓存命中
通过已启用的策略
lodash@4.17.21复用缓存
上游仓库npm registry
未命中时回源
npm · 请求示例

通过策略检查后，直接复用已缓存的依赖。

产品界面

真实产品界面 / 示例数据开发版预览
Depsilo 总览：示例数据中的请求命中率、节省回源流量估算与平均响应耗时。查看完整截图Depsilo 总览：示例数据中的请求命中率、节省回源流量估算与平均响应耗时。查看完整截图

缓存复用，一眼看清。

在总览中查看命中率、节省回源流量的估算，以及命中与回源的响应耗时。

在产品中这样查看
  1. 打开管理界面的总览
  2. 查看命中率与节省回源流量估算
  3. 比较命中与回源的响应耗时
验证你自己的缓存效果
真实产品界面 / 示例数据开发版预览
Depsilo 请求详情：示例请求命中缓存、完成交付，回源流量为零，策略结果未记录。查看完整截图Depsilo 请求详情：示例请求命中缓存、完成交付，回源流量为零，策略结果未记录。查看完整截图

这次请求，命中了缓存。

示例请求命中缓存、完成交付，回源流量为零。策略结果未被记录，界面保留这个未知状态。

在产品中这样查看
  1. 在访问日志中找到这次请求
  2. 打开详情中的请求链
  3. 对照缓存、交付结果与回源流量
查看请求诊断方法
真实产品界面 / 示例数据开发版预览
Depsilo 审计详情：示例依赖下载被阻断，HTTP 状态为 451，交付字节数为零。查看完整截图Depsilo 审计详情：示例依赖下载被阻断，HTTP 状态为 451，交付字节数为零。查看完整截图

阻断结果，有据可查。

审计详情展示被请求的包与版本、阻断结果和 HTTP 451。这个示例的交付字节数为零。

在产品中这样查看
  1. 在审计日志中找到阻断记录
  2. 打开这条记录的审计详情
  3. 核对包名、结果与 HTTP 状态
了解策略与覆盖范围

此处展示开发版界面；快速开始安装稳定版 v0.11.0，界面可能有所不同。 查看稳定版

真实界面使用示例数据。适应宽度时长图可纵向滚动；原始尺寸可双向滚动。按 Esc 关闭。

继续用你熟悉的包管理器。

14 个标准生态 + Docker OCI

额外配置：DockerHugging Face 需先配置服务端上游。

ccache / sccache支持 ccache / sccache 远程编译缓存，使用独立的存储与配额。

配置编译缓存

新的环境，也能接上已有缓存。

包管理器的本地缓存服务当前机器，CI 缓存恢复已保存的目录。Depsilo 集中缓存经过它的依赖下载，供其他机器复用；已有缓存仍可保留。

判断共享缓存是否适合你的环境

从个人环境，到小团队

个人环境与 Homelab

经常重建虚拟机、切换开发设备时，让新环境复用其他机器通过 Depsilo 下载的依赖。

从自己的环境开始

开发团队与 CI

让新的 Runner 接入同一依赖入口，按请求核对缓存与交付结果，并在交付前执行启用的包规则。

了解请求路径上的策略

用 MCP 核对请求结果

通过只读 MCP 读取请求记录，核对缓存与交付结果。

连接 Agent 与只读 MCP

让 Agent 接入项目

depsilo init-agent 生成可审阅的项目指令，沿用现有包管理器。

查看 AI 配置提示词

只读诊断示例

MCP

这次下载命中缓存了吗？

这次请求命中缓存并完成响应。策略结果未知，无法判断具体规则是否生效。

查看查询与返回字段

  1. 读取请求

    depsilo_request按请求 ID 查询

  2. 核对事实

    cache_result: hit
    缓存命中
    delivery_result: completed
    响应完成
    policy_decision: unknown
    策略结果未知

示例展示字段含义，实际回答以实例记录为准。只读查询不修改配置或执行修复。

部署 Depsilo

让 AI 帮你接入，或选择适合自己的部署方式。

01

启动服务

稳定版 v0.11.0 ↗

让 AI 接入

复制给你的 AI 助手

请先阅读 https://depsilo.com/llms.txt，根据当前环境帮我部署 Depsilo 并接入当前项目；已有实例则复用。完成首次设置后，验证请求与缓存结果。

粘贴到能读取网页的 AI 工具。网页助手提供操作步骤；能访问项目和终端的 coding agent 可协助部署并修改配置。

AI 阅读入口 查看接入说明

Docker

Docker · POSIX shell
docker run -d --name depsilo -p 23333:23333 \
  -v depsilo-state:/root/.depsilo \
  ghcr.io/depsilo/depsilo:0.11.0

使用已安装 Docker 的机器。配置、数据库和本地缓存保存在命名卷中，服务使用 23333 端口。

完整部署与首次设置

二进制

安装 · Linux / macOS
curl -fsSL https://github.com/depsilo/depsilo/releases/download/v0.11.0/install.sh | \
  DEPSILO_VERSION=v0.11.0 DEPSILO_INSTALL_DIR="$HOME/.local/bin" bash
启动 · 前台运行
cd "$HOME"
"$HOME/.local/bin/depsilo" serve --host 127.0.0.1 --port 23333

安装 v0.11.0 到 ~/.local/bin，并校验下载文件。启动后保持终端打开，引导令牌会显示在该终端中；新实例默认将状态保存在 ~/.depsilo/。

二进制部署说明 Windows 与全部下载

Homebrew

Homebrew 暂未发布

官方 Homebrew 配方尚未发布。macOS 和 Linux 可以使用二进制安装。

使用二进制安装
02创建管理员引导令牌、管理员与就绪检查

从服务启动日志中读取一次性引导令牌，在浏览器中创建首个管理员。

由 AI 协助找到启动日志，你在浏览器中输入引导令牌并完成设置。

Docker · 读取引导令牌
docker logs depsilo

二进制安装：引导令牌显示在运行 serve 的终端中，请保持该终端打开。

Homebrew 配方尚未发布，请先选择其他部署方式。

打开本机服务 localhost:23333 ↗

localhost 与 127.0.0.1 指运行 Depsilo 的机器。从其他设备访问时，先配置可达地址与 HTTPS。

完成设置后，检查就绪状态
curl -fsS http://127.0.0.1:23333/ready
03发起第一条请求本机 HTTP 验证，再接入项目

完成首次设置后，在运行 Depsilo 的机器上执行这条命令，读取一份 npm 包元数据。

第一次请求 · POSIX shell
curl -fsS --max-time 30 \
  http://127.0.0.1:23333/npm/is-number \
  -o /dev/null -w 'HTTP %{http_code}\n'

收到 HTTP 200 后，打开 Admin → 访问日志（/admin/logs），按刚才的时间找到 npm 的 is-number 请求。核对这条记录，确认请求经过了 Depsilo。

每次运行 curl 都会发起请求，不依赖包管理器的本地缓存。本机验证直接使用上面的 HTTP 地址。

接入你的项目pip / npm / Go

确认请求后，再接入项目。下方使用 HTTPS 示例地址；请替换为你的实例地址，也可从 Portal 获取对应客户端的配置。

配置 HTTPS 与反向代理 →

单次命令 · POSIX shell

pip install requests \
  --index-url https://depsilo.example/pypi/simple/

此命令不写入全局源配置。

项目命令可能复用已安装的依赖或本地缓存。安装成功不代表产生了新请求；连接验证以上面的 curl 请求及对应日志为准。

先用开源能力，按需启用 Pro。

开源核心MIT 许可，自托管
  • 依赖代理与共享缓存
  • 包规则、发布年龄与审计
  • Webhook、Agent 指令与只读 MCP
Pro 扩展可选，14 天试用
  • 多项目工作区
  • 运行时项目 SBOM

核心缓存与上述开源治理能力不需要 Pro。

了解 Pro 与试用

常见问题

查看支持范围与配置边界
适合什么规模？

适合个人开发者、Homelab 和小团队，也适合负责这些环境的 DevOps。当前采用单实例运行方式，不提供多节点高可用或共享数据库部署。

需要替换现有包管理器吗？

不需要。继续使用 pip、npm、Go 等工具，只将对应的下载源指向你的 Depsilo。优先从项目级配置开始，并保留 lockfile 与校验设置。

断网后也能安装所有依赖吗？

上游不可用时，可以在适用条件下继续提供已缓存的内容。尚未缓存的依赖仍需要上游；它不是一份完整的离线镜像。

数据保存在哪里？

实例使用 SQLite 保存元数据，制品可保存在本地磁盘或 S3 对象存储。数据由你自己的部署管理。

哪些能力开源？

代理缓存、包规则、发布年龄、审计与 Webhook 等治理能力开源。多项目工作区和运行时项目 SBOM 属于 Pro，提供 14 天试用。

所有生态的策略能力一样吗？

不同生态的协议与发布时间来源不同，安全控制的覆盖范围也不同。Docker 是拉取缓存；Docker 与 Hugging Face 在此版本需要补充服务端配置。

把下一个依赖，放近一点。

从一台机器、一个项目开始，让缓存和请求都看得见。

部署 Depsilo查看 GitHub