日常命令
doctor 检查 Node、数据库以及按用途需要的 Python、OpenSSH、cloudflared。可选依赖缺失不等于所有功能不可用。status 返回管理服务的健康信息;服务管理与凭据入口健康不同。
默认数据目录为 .local/control-plane。指定 HEXAGON_DATA_DIR 后持续使用同一路径,避免误发现另一个工作区。Python Hexagon.local(data_directory=...) 和 TypeScript Hexagon.local({dataDirectory: ...}) 可以显式选择本地数据目录。
不要手工把 owner Token 复制到前端。Console 与 SDK 使用各自的本地发现流程。重启产生新的本地浏览器身份;它不意味着数据库中的业务记录丢失。
保持工作区选择一致
仅使用不同数据目录,并不能构成完整隔离的部署。两个工作区并行运行时,应分别配置 PostgreSQL 目标、私有数据目录、API 端口、预览端口和凭据 listener 端口,各自配置入口路由。launcher 使用PORT 探测 127.0.0.1,并读取所选目录的 owner 文件;用不同端口或目录执行 status/stop,可能查询另一个服务或无法鉴权。每个生命周期命令都应沿用相同环境。
不要让两个 launcher 共用数据目录,不复制另一工作区的 owner 文件绕过鉴权,也不删除目录来解决未知云操作。多个工作区是明确配置的独立部署,不是内置多工作区切换器或高可用拓扑。
修改持久配置
在 Console Settings → Network & ingress 编辑,或准备无凭据的配置文件:计划停机
先完成或取消活动 Run,关闭不用的云 Session 并确认删除,再运行:service.log、正确端口与工作区,而不是删除 PID 文件并另启一份。
控制平面停机期间无法保证按时执行云资源期限。未决清理记录保存在数据库,启动后仍需核对;停止本机服务不删除云资源。