快速上手
GopherForge 是开源 Go 微服务管理与业务平台。主应用包括网关、16 个 API 服务、AI worker、React 前端和 PostgreSQL/Redis/NATS；媒体和客户端另行启动。外部供应商需用户配置。
环境要求
- Docker Engine 24+ 与 Docker Compose v2；macOS / Windows 推荐使用 Docker Desktop
- 可选本地开发：Go 1.27.0+（仓库语言与构建基线均为 1.27.0）、Node.js 20.19+ / 22.12+（推荐 24）
一键启动
bash
git clone https://github.com/SuperiorChuo/gopherforge.git
cd gopherforge
cp microservices/.env.example microservices/.env
make compose-up
# 或在仓库根目录：make compose-up首次构建耗时取决于机器资源和网络。完成后：
| 入口 | 地址 |
|---|---|
| 统一网关（推荐） | http://localhost:8000 |
| 前端直连 | http://localhost:3000 |
| 健康检查 | http://localhost:8000/api/v1/health/ready |
默认账号
| 用户名 | 密码 |
|---|---|
admin | admin123 |
上线必改
生产环境请立即修改默认密码，并替换 .env 中的 JWT_SECRET、数据库与中间件密钥。清单见生产部署。
跑一遍验证
bash
npm ci --prefix microservices/web
bash scripts/verify-product.sh all
cd microservices
docker compose --profile compose-fallback config --quiet
docker compose -p go-admin-kit-infra -f docker-compose.infra.yml config --quiet
API_BASE_URL=http://127.0.0.1:8000/api/v1 npm run smoke:apismoke:api 会用真实验证码识别器走完登录→接口冒烟全链路。
本地开发模式（可选）
只起依赖容器，服务与前端本机热更新：
下面的长时间运行命令请分别放在三个终端执行：
bash
# 终端 1：依赖容器
cd microservices
docker compose -p go-admin-kit-infra -f docker-compose.infra.yml up -d go-admin-kit-postgres go-admin-kit-redis go-admin-kit-nats
# 终端 2：要调试的 Go 服务（以 auth 为例）
cd microservices/services/auth
go run ./cmd
# 终端 3：前端 HMR
cd microservices/web
npm ci
npm run dev端口冲突怎么办
默认端口：前端 3000、网关 8000、PostgreSQL 5432、Redis 6379。冲突时改 microservices/.env 里对应的 *_PORT 即可，compose 会读取。