为什么需要
做面向海外市场的应用，测试和演示环节几乎一定要伪造一批"看起来真实"的本地地址：账单地址、配送地址、KYC 表单、地图标记、营销邮件签名……这些数据如果用占位符或随机字符串，QA 工程师和最终用户都能一眼看出来。传统 mock-data 库要么完全瞎编，要么只在北美/西欧几个国家有数据，要么不支持多语言。Address 走的是另一条路——它把每个国家的官方地址库（OSM、Overture Maps、政府开放数据如 INEGI、Kadaster BAG、eThekwini）落到自己的 PostgreSQL 里，再按"必须是住宅类建筑"的硬规则生成，对坐标、行政区、邮编都做交叉校验。
怎么用
部署只需三步：
bash
git clone https://github.com/daimon3332/address.git
cd address
sh ops/init-compose.sh
docker compose up -d
默认会启动 Astro 静态前端、React 管理后台、Hono API、PostgreSQL，以及一个同步监督进程。首次启动时会按国家优先级（CN 最先）从开放数据源拉取地址数据，整个库大约 5 GB 磁盘。同步完成后即可调用 JSON API：
bash
curl -X POST https://your-host/api/generate -H "Authorization: Bearer YOUR_TOKEN" -d '{"country": "US", "language": "en", "with_profile": true}'
支持 10 种输出语言（英、简中、繁中、日、韩、德、法、西、葡、俄），地址和资料语言可独立配置。支持 IP 邻近生成、单条/批量、收藏夹、Google Maps/AMap 链接直跳。
使用案例
- 给海外 SaaS 准备演示账号：用 Address 生成 27 个国家的"真实感"地址池，演示时切换地区自动展示本地化地址与时区，比手填假地址可信度提升一个数量级。
- 多区域 KYC 测试：海外支付/银行类应用跑 KYC 表单时，需要覆盖各种地址格式（HK 公共屋邨 + 楼层 + 室号、JP 都道府県 + 町 + 番地、SG HDB 块号 + 邮编）。Address 严格按各国官方地址结构生成，避免 KYC 引擎被假地址的格式错误刷掉。
注意事项
- 部署需要 PostgreSQL 14+，建议至少 8 GB 磁盘 + 4 GB 内存（同步时占内存较多）。
- 同步器对每个国家都设有"住宅证据门槛"——非住宅建筑、政府机关、商业 POI 不会被发布，这会显著降低某些国家的地址密度，特别是中亚和非洲。
- 部分国家（尼日利亚、印度、越南）的额外数据源处于"已禁用"状态，等拿到合规授权才打开。
- 上游开放数据集（Overture、OSM Geofabrik、各国政府数据）保留各自的许可证，归因要求见
docs/data-sources.md。