Skip to content

InstallGuide

DevStar Bot edited this page Nov 18, 2026 · 11 revisions

安装 DevStar

已有团队站点的用户只需登录,不必安装。自建站点请先准备能运行 Docker 的主机;Windows 用户先阅读本文的 WSL 部分,macOS 用户先确认 Docker Desktop 可用。在运行 DevStar 的 Linux、WSL 或其他受支持终端中执行:

curl -fsSL https://devstar.cn/install | bash
devstar start # 运行命令部署 DevStar Studio

统一使用 devstar 管理部署,不需要自行编写 Docker 启动命令。默认 HTTP 端口为 80、SSH 端口为 2222,数据保存在 ~/.devstar/data;无冲突时无需修改。端口被占用时可执行 devstar start --port=8080 --ssh-port=2223,完整选项见 devstar help。

安装后若当前终端提示找不到 devstar,重新打开终端,或使用 ~/.devstar/devstar start 调用已安装的同一个命令。自动化环境不需要保持交互终端打开。

使用同一个系统用户执行 devstar logs 查看日志,执行 devstar stop 停止实例并保留数据。devstar clean 会清理服务并询问是否删除数据,不用于日常停止或更新。

让 AI Agent 协助部署时也应遵循上述入口,遇到错误先保留输出并排查,不要另起一套容器绕过配置。

首次打开与登录

  1. 启动后打开命令输出的访问地址,进入初始配置页;不要猜测其他示例的端口。
  2. 核对安装页的数据库和存储位置,已有环境不要覆盖原数据。安装页的 App URL 应填写浏览器与未来 Agent 均能访问的实际站点地址,包含正确协议和端口。当前安装校验不接受 localhost、127.0.0.1 或 0.0.0.0 作为 App URL;请使用主机可达的局域网地址或已配置解析的域名。
  3. 在安装页设置管理员账户并妥善保存密码,完成安装后登录。没有通用的默认账号密码;使用团队站点时由管理员提供账号或注册方式。
  4. 创建或导入项目仓库,在工单页创建一个普通 Issue。能够重新打开该工单,才说明基本使用路径已完成。

创建工单后默认提供简要分析,内置 AI 使用兜底 API,不要求先配置模型或启动 Agent。继续Agent Team 使用指南了解结果和可选配置,无需重新安装或编译源码。

如果本机能打开页面而 Agent 无法连接,请检查站点地址、端口、防火墙和容器网络。容器中的 localhost 指容器自身,不是平台主机;不要通过关闭认证或公开令牌解决连接问题。

可选:从模板创建项目

从模板创建项目(比如base模板项目)可以获得包含:

  • 基于Web的AI助手及内置的MCP Server
  • 支持多种操作系统的Dockerfiles(.devstar/Dockerfiles.OS-TAG);
  • 立即可用的CI/CD工作流模板(.devstar/workflow/*.yaml)可以运行在多种操作系统的Dockerfiles之上;
  • 立即可用的开发容器,基于您选择的默认操作系统OS-TAG的Dockerfiles构建生成。
  • 在项目设置中添加开发容器启动脚本,可以默认安装Claude Code、OpenClaw、OpenCode等主流AI CLI工具;
  • 通过IDE克隆仓库到本地或IDE进入远程开发容器均可智能完成IDE与DevStar平台的衔接配置。

在Windows WSL上安装

已有可用 WSL 2 和 Docker 时直接使用,无需重装发行版或先改 .wslconfig。首次安装 WSL,可按微软安装指南,在管理员 PowerShell 中执行:

wsl --install

按提示重启,首次打开 Ubuntu 时创建 Linux 用户。新安装默认使用 WSL 2;已有环境可用 wsl --list --verbose 检查版本。确认该 Linux 环境能使用 Docker 后,在 Ubuntu 终端执行本文开头的 DevStar 安装命令。

仅当浏览器或 Agent 无法访问平台时,再依据WSL 网络说明检查 NAT、镜像网络或端口映射。镜像网络有 Windows 版本要求,不是所有用户的必填配置;无论使用哪种模式,App URL 都应是实际可达的站点地址。

在macOS上安装

打开终端参照本文开头安装部署即可。

可能需要手工安装Docker Desktop

在鸿蒙电脑融合开发引擎上安装

在HarmonyOS 6.0.0的应用商店 > 我的 > 应用尝鲜 中找到“融合开发引擎”,进入openEuler终端环境中参照本文开头安装部署即可。

注意:检查openEuler终端环境中是否可以正常安装Docker

在云原生(K8s)环境上安装

请联系contact@mengning.com.cn

安装部署过程遇到问题

Clone this wiki locally