Address 地址生成工具下载|多平台（真实结构测试地址）
做开发测试时，地址字段总是最难凑的那一块：手写一串随机字符过不了表单校验，用通用假数据工具生成的地址在地图上查不到，邮编和行政区划也对不上。本篇讲 Address 这款地址生成工具：它只给开发测试用的、结构真实的地址数据，来源公开可追溯，且全部部署在你自己的服务器上。地址生成这个环节一旦有了可信的数据源，跨国业务的测试用例就不用逐国手工拼了。
Address 是什么：地址生成先讲数据来源
Address 是一个基于 PostgreSQL 的自托管真实住宅地址生成器，源码以 MIT 许可证开源。它的核心承诺只有一条：发布池里的住宅基础地址全部来自官方开放数据、国家或地区地址登记、地图登记建筑，以及具有明确住宅用途证据的开放地图数据，不用随机街道、门牌或邮编冒充真实地址。
这个设计把“真实结构”和“非冒用”分开了：地址字段来自公开登记与开放地图数据，并经过一道住宅证据门禁筛选，坐标可以回溯到来源。换句话说，它解决的是“测试数据要像真的”，而不是“造一条像某个真人的地址”。
Address 信息表与覆盖范围
| 项目 | 内容 |
|---|---|
| 软件名称 | Address |
| 类型 | 自托管地址生成服务（Web 应用） |
| 后端 | PostgreSQL |
| 开源协议 | MIT |
| 覆盖范围 | 27 个国家和地区 |
| 展示语言 | 原文、英文、简体中文、繁体中文、日语、韩语、德语、法语、西班牙语、葡萄牙语 |
| 部署方式 | 自托管，数据留在自己的服务器上 |
| 适用平台 | 多平台（浏览器访问，服务端自行部署） |
数据源按国家组合搭配，各国取最权威的公开登记：美国用 Overture Maps 与 OpenStreetMap 州级分片，加拿大用全国地址登记，西班牙用 Catastro 地籍数据，荷兰用 Kadaster BAG，日本用数字厅地址库与日本邮便，韩国用 K-apt，新加坡用组屋楼栋数据，中国来自行政区划数据与主流地图平台的住宅小区兴趣点。覆盖北美、欧洲、东亚、东南亚、南亚、大洋洲、中东、南美与非洲。
版本选择：先用在线演示，再决定是否自托管
| 使用方式 | 适合谁 | 注意点 |
|---|---|---|
| 在线演示 | 只想先看生成效果、验证字段结构的人 | 数据不在自己手里，不适合接进正式测试流水线 |
| 自托管部署 | 要把地址生成接进测试环境、需要长期稳定数据的团队 | 需要一台能跑 PostgreSQL 的服务器，并定期同步地址数据 |
结论先行：先用在线演示确认字段是否符合你的表单，再上自托管。演示能验证各国行政层级、邮编格式和语言展示是否对得上你的业务；确认之后再部署，避免搭好服务才发现字段结构不合用。
Address 安装步骤：自托管部署流程
- 准备一台服务器并装好 PostgreSQL，按官方仓库的部署说明拉取项目代码。
- 按文档配置数据库连接与各国数据源的同步任务，首次同步会拉取所选国家的公开地址数据，耗时取决于国家数量。
- 启动服务后打开 Web 界面，先在后台的公开覆盖监控页确认各国数据已同步到位，再开始生成。
- 生成前先选国家与行政范围：按各国实际行政结构提供州省、城市、区县和邮编筛选，选好范围再点生成。
- 把生成的地址接进测试库前，先抽查几条：确认邮编与行政区划对应、坐标能在地图服务中定位。
装完必改设置：地址生成用顺手的 4 处
- 地址语言与资料语言分开设：界面里地址语言和资料语言分别记忆，浏览器首次打开默认英文。面向国内测试时把资料语言切到简体中文，地址语言按被测业务保留原文，避免中英文混排导致校验规则走偏。
- 热门行政区先配好：每个国家可配置热门行政区、热门城市和特殊区域。把业务常测的城市设为热门，后续生成不用每次翻行政区划树，批量构造用例更快。
- 收藏夹按大洲或国家分组：地址收藏保存在浏览器本地，支持按大洲或国家分组与筛选、拖动或序号排序。回归测试常用的地址先收藏分组，复现缺陷时直接取用，不用重新随机生成。
- API Token 与访问控制先收紧：后台提供 API Token、访问控制与黑名单页面。自托管上线前先建好 Token 并限制访问范围，测试服务不要裸奔在公网。
Address 地址生成的筛选规则：为什么它不会“悄悄换地方”
筛选语义是这个项目最值得单独说的一点：所选范围没有合格记录时，它返回错误，不会悄悄切换到其他地区。生成时从当前筛选范围的全部合格地址中快速随机选择，不会反复读取数据库前几条。这对测试很关键——用例失败时你能确定是业务逻辑问题，而不是生成器偷偷换了地区。
发布门禁同样写得明确：除中国室内字段（栋、单元、楼层、室号，标记为合成字段）外，不随机补造任何组件；必填字段缺失、行政区冲突、坐标越界或住宅证据不足的记录不进发布池。每条记录保留来源坐标，可在覆盖相应地区的地图服务中定位核对。
Address 适用人群与使用边界
适合两类人：一是需要批量构造格式合法测试资料的开发与测试人员，二是希望把测试数据留在自己服务器上、不经过第三方假数据服务的团队。JSON API 覆盖健康检查、国家、可用性、地区选项、搜索、地址与资料生成、批量生成和监控接口，并附 Python、cURL 和 JavaScript 示例，可以直接接进现有测试流水线。
不适合的场景也要说清楚：它只解决开发测试数据问题，不能用来冒用真实个人的地址，也不能用来绕过需要真实身份信息的验证环节。测试数据与真实个人信息之间必须划清界线，这是用它之前就要定好的团队规矩。
注意事项：用 Address 之前先确认 4 件事
- 只用于开发测试数据：生成的地址源于公开登记与开放地图数据，但仍不得用于冒充真实住户、注册验证或任何涉及真实个人的场景。
- 室内字段有合成标记：中国室内字段（栋、单元、楼层、室号）标记为合成字段，接进断言时不要把它当作登记数据校验。
- 同步队列要定期看：后台有同步队列与同步历史页面，地址数据依赖公开数据源更新，长期不跑同步，覆盖范围会慢慢落后于现实。
- 语言切换不会重置选择：生成和切换国家不会重置语言选择，这是优点也是坑——换国家做对比测试时，先确认当前语言仍是你想要的那一种。
下载说明
本篇为自有网盘已转存稿，下载链接以发布时填入的自有网盘链接为准，发布前请核对链接与本篇软件名一致后再上线。
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
