dstack

环境要求

• Git（CLI 依赖，README 明确要求）
• OpenSSH（CLI 依赖，README 明确要求）
• uv 工具（用于安装 dstack CLI）
• 可访问的 dstack 服务器地址，例如 http://127.0.0.1:3000
• Node.js/npx（仅在使用 npx skills 安装 agent skills 时需要）

安装与启动步骤

1. 1准备前置依赖

   README 说明 CLI 可装在 Linux、macOS、Windows，且依赖 Git 和 OpenSSH，请先确认两者已可用。README 未给出安装命令。

2. 2安装 dstack CLI

   使用 uv 工具安装或升级 dstack 命令行客户端，安装后即可在终端调用 dstack 命令。

   uv tool install dstack -U

   复制

3. 3添加项目连接服务器

   把 CLI 指向 dstack 服务器，需提供服务地址、用户 token 和项目名，命令执行后会更新本地配置。

   dstack project add --name main --url http://127.0.0.1:3000 --token bbae0f28-d3dd-4820-bf61-8f4bb40815da

   复制

4. 4安装 agent skills

   可选步骤，安装 dstack 技能包，让 Claude、Codex、Cursor 等 AI 代理代为创建 fleet、提交任务。

   npx skills add dstackai/dstack

   复制

5. 5编写 YAML 配置

   在代码仓库中以 YAML 定义 Fleet、Dev environment、Task、Service、Preset 或 Volume 等配置。

6. 6应用配置

   用 dstack apply 提交配置，平台自动处理资源供给、排队、扩缩容、网络与卷等。具体参数见官方文档。

   dstack apply

   复制

关键配置

如何确认成功

执行 dstack project add 后提示 Configuration is updated at ~/.dstack/config.yml，且该文件含项目名、URL 与 token，即表示 CLI 已连上服务器。

常见问题

注意事项

• README 节选未给出服务器端的安装命令，服务器部署需参考官方文档 https://dstack.ai/docs
• 示例 token bbae0f28-d3dd-4820-bf61-8f4bb40815da 仅为演示值，请替换为你自己的 token
• dstack apply 的具体参数（配置文件路径等）README 未说明，请以官方文档为准
• CLI 配置保存在 ~/.dstack/config.yml，换服务器或项目时需重新执行 dstack project add