valet Skill 技能

项目简介

valet 是一款开源的自托管云端 Coding Agent 平台，只需一台 Linux 服务器或装了 Docker Engine 24+ / Compose v2 的 Mac，就能跑起与 Cursor Cloud Agents、amp orbs 同级别的云端代理体验。Claude Code 与 Codex 在「per-thread sandbox」（每条会话一个独立沙箱）里运行，账号、GitHub Token、API Key 全部在 Web 控制台统一管理，核心服务不接触你的代码也不持有任何凭据。

核心能力

1. 双 Agent 引擎：内置 Claude Code 与 Codex CLI 任选其一作为驱动；账号用 setup-token / sign-in / API Key 三种方式接入。
2. Per-thread 沙箱：每次会话创建独立容器，资源隔离、内存安全，互不污染；可同时跑多个 agent 互不干扰。
3. Web 控制台 + 实时终端：端口 3000 暴露 Web UI，可观察容器日志、终端输出、文件改动。
4. 可选 GitHub 集成：填入 GitHub Token 后可自动处理私有仓库与 Pull Request 流程。
5. 服务编排：.valet/services.yaml 可声明 web / api 等常驻服务进程，平台负责保活。
6. 生产级 HTTPS：配合 Traefik / Caddy 等支持 DNS challenge 的反代，给 *.valet.example.com 一键上通配符证书。
7. 资源边界保护：core 服务持有 Docker socket，但通过 iptables 规则屏蔽云厂商元数据 IP（169.254.169.254），缓解 SSRF 风险。

安装配置

1. 环境前置：Linux 服务器或 macOS（Docker Engine 24+、Docker Compose v2）、至少一个 Claude 或 Codex 账号。
2. 克隆并准备环境：git clone https://github.com/dropalltables/valet && cd valet && cp .env.example .env，设置 POSTGRES_PASSWORD、VALET_SECRET_KEY（openssl rand -base64 32 生成）、VALET_PASSWORD。
3. 构建与启动：docker compose --profile sandbox build，然后 docker compose up -d --build，启动 Web + 数据库 + 沙箱调度器。
4. 绑定公网域名（可选）：用反代转发 3000 端口（开 WebSocket），设 VALET_BASE_URL，给 *.valet.example.com 配通配符证书；同时配置 VALET_SERVICE_DOMAIN、VALET_PROXY_NETWORK、VALET_CERT_RESOLVER。
5. 首次启动执行 .valet/setup、每次唤醒执行 .valet/resume。

使用步骤

1. 浏览器访问 http://localhost:3000，进入 Settings 添加 Claude setup-token / Codex sign-in / GitHub Token。
2. 新建一条会话（thread），平台自动拉起一个隔离沙箱容器。
3. 通过 Web 终端与 Agent 协作；写代码、跑命令、提交 PR 全在沙箱内完成。
4. 沙箱内可用 valet service start|list|logs|restart|remove 管理常驻进程，valet url 暴露端口。
5. 反代上线后通过 *.valet.example.com 直连每个 thread 的子域名。

适用场景

• 想自建 Cursor Cloud Agents / Claude Code 远程执行环境的团队。
• 需要把 Coding Agent 跑在自家服务器 / 内网，对代码与凭据合规有要求的公司。
• 多成员共享一组 Claude / Codex 账号，避免每台机器各自配置、避免凭据外发。
• 给每个 PR 自动开一个 sandbox 做隔离评审或测试运行。
• 给自动化 CI 跑短期 Agent 任务（修 bug、写脚本、跑调研）。
• 在 macOS 本地模拟一个「team-grade」 Coding Agent 平台做 PoC。

适用人群

• 自托管 / DevOps 工程师，需要在私有环境跑 Coding Agent。
• 中小团队想统一 Coding Agent 账号与凭据管理。
• 对 SaaS Coding Agent 数据出境有顾虑的安全合规团队。
• 重度 Claude Code / Codex 用户，希望随时在任意设备远程驱动。
• Docker / Compose 重度用户，想把 Coding Agent 当可编排服务看待。

工作原理

valet 的 core 服务持有宿主机的 Docker socket，负责创建并管理每个 thread 的容器；web 服务是唯一对外暴露端口的组件，前端通过 WebSocket 与容器里的 Agent 进程通讯。Agent 在容器内拥有 sudo（因此被视为「不可信」），平台通过 iptables 规则屏蔽云厂商元数据 IP（169.254.169.254）以缓解 SSRF 风险。所有凭据由用户在 Web UI 录入，存在 PostgreSQL，由 core 服务按需注入对应 sandbox。

官方链接

• GitHub 仓库：https://github.com/dropalltables/valet
• 许可证：MIT