Repository navigation
InstallGuide
已有团队站点的用户只需登录,不必安装。自建站点请先准备能运行 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 协助部署时也应遵循上述入口,遇到错误先保留输出并排查,不要另起一套容器绕过配置。
- 启动后打开命令输出的访问地址,进入初始配置页;不要猜测其他示例的端口。
- 核对安装页的数据库和存储位置,已有环境不要覆盖原数据。安装页的 App URL 应填写浏览器与未来 Agent 均能访问的实际站点地址,包含正确协议和端口。当前安装校验不接受
localhost、127.0.0.1或0.0.0.0作为 App URL;请使用主机可达的局域网地址或已配置解析的域名。 - 在安装页设置管理员账户并妥善保存密码,完成安装后登录。没有通用的默认账号密码;使用团队站点时由管理员提供账号或注册方式。
- 创建或导入项目仓库,在工单页创建一个普通 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平台的衔接配置。
已有可用 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 都应是实际可达的站点地址。
打开终端参照本文开头安装部署即可。
可能需要手工安装Docker Desktop
在HarmonyOS 6.0.0的应用商店 > 我的 > 应用尝鲜 中找到“融合开发引擎”,进入openEuler终端环境中参照本文开头安装部署即可。
注意:检查openEuler终端环境中是否可以正常安装Docker
- 请将您遇到的问题及错误信息评论到:https://github.com/mengning/DevStar/issues/3
Copyright ©Mengning Software 2024-2026 All rights reserved.