开发机器
用于构建和测试的隔离开发环境。由 Proyecta Cloud 提供支持的完整 Linux 环境。
Proyecta 为每个项目提供一台专属的开发机器（运行时）。这是一个包含完整 Linux 环境的隔离容器，你的应用在开发过程中就运行在这里。
开发机器是如何工作的？
Section titled “开发机器是如何工作的？”当你打开一个项目时，Proyecta 会：
- 在云端创建一个隔离容器（pod）
- 从 GitHub 克隆你的代码
- 安装依赖并配置环境
- 启动应用的开发服务器
- 在 builder 中显示实时预览
你可以在工具栏下方的 Runtime Status Bar 中查看配置进度。
启动过程中，状态栏会显示以下步骤：
| 步骤 | 描述 |
|---|---|
| Creating pod | 启动隔离容器 |
| Health check | 验证容器是否正常运行 |
| Git init | 克隆你的代码仓库 |
| Environment setup | 安装依赖（npm、pip 等） |
| Starting services | 启动应用及基础设施 |
| Ready | 开发机器已完全就绪 |
开发机器出现问题该如何解决？
Section titled “开发机器出现问题该如何解决？”如果预览无法加载或机器似乎卡住了：
- 查看 Runtime Status Bar 中的错误信息
- 尝试使用 Terminal 检查日志
- 如果仍无法解决，可以让 AI 协助调试问题
基础设施服务
Section titled “基础设施服务”你的开发机器可以包含用于数据库和其他服务的 sidecar 容器：
- PostgreSQL — 关系型数据库（端口 5432）
- PostGIS — 带地理空间扩展的 PostgreSQL（端口 5432）
- Redis — 内存缓存（端口 6379）
- MongoDB — 文档数据库（端口 27017）
- MySQL — 关系型数据库（端口 3306）
- MailHog — 带 Web UI 的邮件测试服务器（SMTP 端口 1025，UI 端口 8025）
在 Services 面板中查看正在运行的服务及其状态。
生命周期状态
Section titled “生命周期状态”开发机器会经历以下生命周期状态：
| 状态 | 描述 |
|---|---|
| Pending | 等待创建 |
| Initializing | 正在配置环境 |
| Running | 活跃且运行正常 |
| Suspended | 已暂停以节省资源（可快速恢复） |
| Archived | 存储在冷存储中（恢复需要较长时间） |
| Restoring | 正在从归档存储中恢复 |
| Failed | 配置或操作失败——可以重新配置该机器 |
| Terminated | 已永久停止 |
机器在闲置 60 分钟后会自动挂起，挂起 24 小时后会自动归档。
如果开发机器宕机，我已发布的应用会怎样？
你的应用 backend（Convex serverless 函数和数据库）运行在 Convex 自己的云基础设施上，无论开发机器处于何种状态都会保持可用。但是，你的应用 frontend 文件是从开发机器上提供的——如果机器被挂起或归档，访客将看到 503 错误，直到机器恢复为止。对于希望保持公开访问的应用，请注意这一点；恢复机器后网站即可正常访问。
能不能使用更快的开发机器？
目前所有开发机器使用相同的资源配置。如果你的大型项目需要更多资源，请联系技术支持。
能直接访问开发机器吗？
可以。使用内置的 Terminal 即可获得对开发环境的完整 shell 访问权限。