快速开始

文档状态：当前操作指南。本页提供本地部署、启动与登录说明。能力范围见当前状态。

选择路径

当前能力和验证成熟度统一见当前状态。

启动完整栈

需要 Git、Docker Engine 或 Docker Desktop，以及 Docker Compose v2。Compose 路径不要求主机预装 .NET、Node.js、Python 或 uv。

git clone https://github.com/liuweichaox/Ingot.git
cd Ingot
cp .env.example .env

修改 .env 中的数据库密码和管理员配置。至少替换所有 change-this- 占位值；生产环境必须使用随机生成且彼此不同的密码和令牌。

先校验配置，再启动：

docker compose -f docker-compose.app.yml config --quiet
docker compose -f docker-compose.app.yml up -d --build

首次构建会下载 .NET、Node、Python、PyTorch 和 TimescaleDB 镜像。命令结束后检查全部容器状态：

docker compose -f docker-compose.app.yml ps -a

至少确认：

• platform-migrate 成功退出；
• postgres、optimizer、platform-api 和 platform-web 为 healthy；
• platform-worker 持续为 healthy；
• 没有容器处于反复重启状态。

然后访问：

http://localhost:3000       工程工作台
http://localhost:8000/health
http://localhost:8000/openapi/v1.json
http://localhost:8100/ready

使用 .env 中的 INGOT_ADMIN_USERNAME 和 INGOT_ADMIN_PASSWORD 登录。若管理员密码留空，Migrator 只在用户表为空时生成随机口令：

docker compose -f docker-compose.app.yml logs platform-migrate

后续修改 .env 不会重置已有账户。

此部署启动 Ingot 自身的 Web、API、数据库、优化器和后台服务，无需外部业务系统账号或连接。设备及企业系统连接器按需配置和启用。登录后从工艺配置管理工艺变量和配方版本；每次工艺运行就是一次实验，运行和质量记录共同保存实验事实，具体能力与推荐所需数据见当前状态。

常见启动问题

页面无法访问时先检查状态和最近日志：

docker compose -f docker-compose.app.yml ps -a
docker compose -f docker-compose.app.yml logs --tail=200

若出现 unexpected EOF、short read 或拉取超时，通常是镜像下载中断；重新执行 up -d --build 会复用已完成层。不要为了排障直接删除数据卷。更多诊断见部署运维。

下一步

• 要接入一组真实或代表性配方运行：继续配方优化试点指南；
• 要了解身份、点位和映射：阅读数据接入；
• 要判断哪些能力已经验证：阅读当前状态；
• 要部署生产环境：先完成生产架构定义的站点验收。