开发机器

用于构建和测试的隔离开发环境。由 Proyecta Cloud 提供支持的完整 Linux 环境。

Proyecta 为每个项目分配一台专用的开发机器（运行时）。这是一个带有完整 Linux 环境的隔离容器，你的应用在开发期间就运行在其中。

开发机器是如何工作的？

当你打开一个项目时，Proyecta 会：

1. 在云端创建一个隔离容器（pod）
2. 将项目代码恢复到其中
3. 安装依赖项并配置环境
4. 启动应用的开发服务器
5. 在 builder 中显示实时预览

你可以在工具栏下方的 Runtime Status Bar 中查看配置进度。

配置步骤

启动期间，状态栏会显示以下步骤：

步骤	说明
Creating pod	正在启动隔离容器
Health check	验证容器是否正常运行
Git init	克隆你的代码仓库
Environment setup	安装依赖项（npm、pip 等）
Starting services	启动应用及基础设施
Ready	开发机器已完全就绪

我的开发机器出现问题了，怎么解决？

如果预览无法加载或机器似乎卡住了：

1. 检查 Runtime Status Bar 中的错误信息
2. 请求 AI 查看服务日志并进行调试——它对机器拥有完全访问权限
3. 如果仍无法解决，请求 AI 协助排查问题

基础设施服务

你的开发机器可以包含用于数据库和其他服务的 sidecar 容器：

• PostgreSQL — 关系型数据库（端口 5432）
• PostGIS — 带地理空间扩展的 PostgreSQL（端口 5432）
• Redis — 内存缓存（端口 6379）
• MongoDB — 文档数据库（端口 27017）
• MySQL — 关系型数据库（端口 3306）
• MailHog — 邮件测试服务器，带 Web UI（SMTP 端口 1025，UI 端口 8025）

在 Services 面板中查看正在运行的服务及其状态。

生命周期状态

开发机器会经历以下生命周期状态：

状态	说明
Pending	等待创建
Initializing	正在配置环境
Running	运行中且健康
Suspended	已暂停以节省资源（可快速恢复）
Archived	存储在冷存储中（恢复需要较长时间）
Restoring	正在从归档存储中恢复
Failed	配置或操作失败——可以重新配置该机器
Terminated	已永久停止

机器在闲置 60 分钟后会自动暂停，暂停 24 小时后会自动归档。

常见问题

如果开发机器宕机，我已发布的应用会怎样？

应用的数据存储在 Proyecta 的平台数据层（CMS）中，该层独立于开发机器，始终保持可用。但是，应用的 frontend 文件由开发机器提供——如果机器被暂停或归档，访客将看到 503 错误，直到机器恢复为止。对于需要保持公开访问的应用，请注意这一点；恢复机器后网站即可恢复正常。

能使用更快的开发机器吗？

目前所有开发机器的资源分配相同。如果你的大型项目需要更多算力，请联系支持团队。

能直接访问开发机器吗？

不能。builder 中没有终端或 shell 访问入口。AI 会代表你对机器拥有完全访问权限——你可以请求它运行命令、查看日志或检查文件，它会在聊天中反馈结果。