zetaloop本地开发环境
前置条件
- Docker
- Go 1.25+（构建镜像时在容器内编译，本机不强制）
使用
cd deploy/dev
# 1. 构建所有微服务镜像
./build.sh
# 2. 启动
docker compose up -d
# 3. 查看状态
docker compose ps
# 4. 停止
docker compose down
构建脚本会扫描 app/ 下所有 api、rpc、mq 入口，生成 juwan/<service>-<type>:dev 镜像。编译失败的服务会跳过，不影响其他服务。
如需只启动部分服务：
docker compose up -d postgres redis snowflake player-rpc player-api
端口映射
| 服务 | 宿主机端口 |
|---|---|
| PostgreSQL | 15432 |
| Redis | 16379 |
| Kafka | 19092 |
| users-api | 18801 |
| player-api | 18802 |
| game-api | 18803 |
| shop-api | 18804 |
| order-api | 18805 |
| wallet-api | 18806 |
| community-api | 18807 |
| objectstory-api | 18808 |
| email-api | 18809 |
环境变量
编辑 .env 修改数据库密码、Kafka 地址等。默认值可直接用于本地开发。
数据库初始化
首次启动时 PostgreSQL 会自动执行 desc/sql/ 下的建表语句。如需重新初始化，删除 volume 后重启：
docker compose down -v
docker compose up -d