Arkloop Developers

本地启动

依赖

  • Go 1.22+
  • Node.js 20+
  • pnpm
  • Docker(运行 PostgreSQL)

1. 启动 PostgreSQL

cp .env.example .env
# 编辑 .env,设置 ARKLOOP_POSTGRES_PASSWORD
docker compose up -d

连通性验证:

docker compose exec -T postgres psql -U arkloop -d arkloop -c "select 1;"

2. 启动 API 服务

默认监听 127.0.0.1:19001

Linux/macOS

export ARKLOOP_LOAD_DOTENV=1
export ARKLOOP_DOTENV_FILE=.env
cd src/services/api && go run ./cmd/api

Windows

$env:ARKLOOP_LOAD_DOTENV="1"
$env:ARKLOOP_DOTENV_FILE=".env"
cd src/services/api; go run ./cmd/api

覆盖监听地址:

ARKLOOP_API_GO_ADDR=127.0.0.1:19001

3. 启动 Worker 服务

cd src/services/worker && go run ./cmd/worker

4. 启动前端(Web)

docker compose up -d 已包含 Gateway(默认监听 19000),前端代理应指向 Gateway:

Linux/macOS

export ARKLOOP_API_PROXY_TARGET=http://127.0.0.1:19000
cd src/apps/web && pnpm install && pnpm dev

Windows

$env:ARKLOOP_API_PROXY_TARGET="http://127.0.0.1:19000"
cd src/apps/web; pnpm install; pnpm dev

5. 启动前端(Console)

Linux/macOS

export ARKLOOP_API_PROXY_TARGET=http://127.0.0.1:19000
cd src/apps/console && pnpm install && pnpm dev

Windows

$env:ARKLOOP_API_PROXY_TARGET="http://127.0.0.1:19000"
cd src/apps/console; pnpm install; pnpm dev

集成测试

cd src/services/api && go test -tags integration ./...

环境变量速查

变量说明默认值
ARKLOOP_DATABASE_URLPostgreSQL 连接串
ARKLOOP_API_GO_ADDRAPI 监听地址127.0.0.1:19001
ARKLOOP_LOAD_DOTENV自动从 .env 文件加载0
ARKLOOP_DOTENV_FILE.env 文件路径.env
ARKLOOP_TOOL_ALLOWLIST已弃用的兼容配置;仅记录日志,不再裁剪运行时工具
ARKLOOP_JWT_SECRETJWT 签名密钥

完整环境变量参考:.env.example

On this page