本地启动
依赖
- Go 1.22+
- Node.js 20+
- pnpm
- Docker(运行 PostgreSQL)
1. 启动 PostgreSQL
连通性验证:
2. 启动 API 服务
默认监听 127.0.0.1:19001。
Linux/macOS
Windows
覆盖监听地址:
3. 启动 Worker 服务
4. 启动前端(Web)
docker compose up -d 已包含 Gateway(默认监听 19000),前端代理应指向 Gateway:
Linux/macOS
Windows
5. 启动前端(Console)
Linux/macOS
Windows
集成测试
环境变量速查
| 变量 | 说明 | 默认值 |
|---|---|---|
ARKLOOP_DATABASE_URL | PostgreSQL 连接串 | — |
ARKLOOP_API_GO_ADDR | API 监听地址 | 127.0.0.1:19001 |
ARKLOOP_LOAD_DOTENV | 自动从 .env 文件加载 | 0 |
ARKLOOP_DOTENV_FILE | .env 文件路径 | .env |
ARKLOOP_TOOL_ALLOWLIST | 已弃用的兼容配置;仅记录日志,不再裁剪运行时工具 | — |
ARKLOOP_JWT_SECRET | JWT 签名密钥 | — |
完整环境变量参考:.env.example。