尧图网站建设 
3条命令部署自己的地址测试工具Address Docker Compose快速上手完全指南【免费下载链接】addressA self-hosted address and synthetic test-profile generator for 27 countries and regions, built from real open-data streets, administrative areas, coordinates, and postcodes. Supports multilingual output, IP-nearby generation, map previews, and API access. 基于真实开放数据的自托管地址与合成测试资料生成器覆盖 27 个国家和地区支持多语言地址、IP 附近生成、地图预览与 API 调用项目地址: https://gitcode.com/gh_mirrors/address4/addressAddress 是一个自托管地址生成器与合成测试资料生成器基于真实开放数据的街道、行政区、坐标和邮编构建覆盖27 个国家和地区支持多语言输出、IP 附近生成、地图预览与 API 调用。本指南带你用Docker Compose执行 3 条命令在自己的服务器上完成部署从此 QA、开发和测试数据都能用上真实存在的地址。为什么值得部署一个自己的地址生成器随机拼接的假地址往往格式错误、无法通过校验。Address 与它不同每一条地址都来自官方地址登记册、开放地图数据或已验证的地理编码结果并附带来源、精度和坐标缺失字段保持为空绝不编造。27 个国家/地区按各国真实行政层级做省市区、邮编过滤️10 种展示语言原生语言、英、简中、繁中、日、韩、德、法、西、葡开放 APIBearer 令牌鉴权支持单条与批量最多 50 条生成免值守同步增量导入、有限重试、配额等待失败任务不会无限重跑单文件部署一个 Compose 文件跑起应用、PostgreSQL、迁移和同步服务内部密钥自动生成并持久化环境要求开始前先核对项目要求系统LinuxAMD64 或 ARM64运行时Docker Engine 24 与 Docker Compose v2内存至少 4 GB首次导入美国、法国等大型国家建议 8 GB磁盘27 国完整同步后数据库约 15 GB另留同步暂存与备份空间网络可访问 Docker Hub 与各数据源对外服务需 HTTPS 反向代理 默认配置开箱即用。端口绑定、跨域来源、代理信任等参数都可以用 Compose 文件旁的.env覆盖详见 docs/DEPLOYMENT.zh-CN.md。3条命令完成 Docker Compose 部署打开终端依次执行# 1️⃣ 克隆仓库 git clone https://gitcode.com/gh_mirrors/address4/address # 2️⃣ 进入目录 cd address # 3️⃣ 一键启动全部服务 docker compose up -d就这么简单。仓库根目录的 docker-compose.yml 统一管理 6 个服务服务作用生命周期bootstrap生成并校验内部密钥完成后退出postgresPostgreSQL 16仅内部网络可见常驻migrate每次启动前执行数据库迁移完成后退出api网页与 API监听127.0.0.1:8787常驻sync官方数据源自动同步常驻credential-broker平台密钥加密、轮换与额度协调常驻首次启动时Compose 会自动在文件旁创建持久化的data/与runtime/目录并把数据库密码、配置加密密钥、服务令牌生成到data/secrets/——你不需要手动配置任何密码或密钥。部署验证两个检查点docker compose ps # 所有服务应为 running / healthy curl -fsS http://127.0.0.1:8787/api/v1/ready # 返回 {status:ready} 即部署成功⏳ 注意sync服务首次启动要加载行政目录可能需要几分钟才变为 healthy期间网页和 API 已可用属正常现象。首次登录管理后台 4 步初始化浏览器打开http://127.0.0.1:8787/admin/用初始密码admin登录按提示修改管理员密码在Access Security中决定是否给公开生成器加访问密码在API Tokens中创建 API 令牌供外部程序调用如果想一上来就用自定义密码首次docker compose up -d前设置ADMIN_INITIAL_PASSWORD环境变量即可。第一次生成地址网页端体验打开http://127.0.0.1:8787/选择国家、地区和展示语言点击生成。结果可以一键复制、导出、存入收藏夹或直接投到 Google 地图 / 高德地图查看位置。生成的地址会带精度标签street/premise/subpremise只有存在独立住宅证据时才标记residential以中国为例还支持在地图上直接框选区域生成接入自动化测试一条 curl 调用 API先在后台API Tokens创建一个令牌可按 scope、每分钟请求数、过期时间限制然后curl -fsS http://127.0.0.1:8787/api/v1/generate?countryUScitySeattle \ -H Authorization: Bearer YOUR_API_TOKEN返回的 JSON 中formattedAddress即为可直接用于测试的地址如4019 Aikins Avenue Southwest, Seattle, WA, 98116并附带经纬度。/generate/batch支持一次生成最多 50 条。全部端点、参数与错误码见 docs/API.md运行中的实例也会在/en/api/提供交互式文档和 OpenAPI 3.1 文件。数据自动同步部署后不用管sync服务会持续从各国官方登记册、OpenStreetMap、Overture 等来源增量拉取、校验并发布数据——大部分国家不需要任何第三方密钥。想查看某个国家同步到什么程度了公开监控页一目了然各国数据来源、字段溯源与住宅证据说明见 docs/data-sources.md。备份与升级两条命令安心运维升级迁移会自动执行docker compose pull docker compose up -d docker compose ps备份数据库 密钥务必成对保存mkdir -p backups docker compose exec -T postgres sh -c pg_dump -U $POSTGRES_USER -d $POSTGRES_DB --formatcustom \ backups/address-$(date -u %Y%m%dT%H%M%SZ).dump cp -r data/secrets backups/secrets-$(date -u %Y%m%d) 重要data/secrets/config_master_key必须与每个数据库备份一起保存——后台录入的平台密钥都靠它加密丢了只能重新录入。常见问题Qsync一直显示 starting正常。它在启动时加载行政目录并校验已发布数据库越大耗时越长。用docker compose logs -f sync观察日志持续输出即工作正常网页和 API 不受影响。Q忘记管理员密码按 docs/DEPLOYMENT.zh-CN.md 中的 FAQ 操作重新生成初始密码并清除旧管理员服务启动时会用新密码重建。Q能直接暴露 8787 端口吗不建议。API 默认只听127.0.0.1:8787对外请走 HTTPS 反向代理文档中附 Caddy / Nginx 完整示例并设置ALLOWED_ORIGINS、TRUST_PROXYtrue、COOKIE_SECUREtrue。Q能不用 Docker 运行吗Docker Compose 是唯一维护的生产部署方式本地开发请看 docs/DEVELOPMENT.zh-CN.md。延伸阅读部署与运维细节docs/DEPLOYMENT.zh-CN.mdAPI 参考docs/API.zh-CN.md平台密钥获取与配置docs/API_KEYS.zh-CN.md27 国地址策略字段、坐标、去重、校验docs/strategies/3 条命令、零手动密钥、数据自动同步——现在就可以把 Address 变成你团队的真实地址水龙头了 【免费下载链接】addressA self-hosted address and synthetic test-profile generator for 27 countries and regions, built from real open-data streets, administrative areas, coordinates, and postcodes. Supports multilingual output, IP-nearby generation, map previews, and API access. 基于真实开放数据的自托管地址与合成测试资料生成器覆盖 27 个国家和地区支持多语言地址、IP 附近生成、地图预览与 API 调用项目地址: https://gitcode.com/gh_mirrors/address4/address创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3条命令部署自己的地址测试工具：Address Docker Compose快速上手完全指南
3条命令部署自己的地址测试工具Address Docker Compose快速上手完全指南【免费下载链接】addressA self-hosted address and synthetic test-profile generator for 27 countries and regions, built from real open-data streets, administrative areas, coordinates, and postcodes. Supports multilingual output, IP-nearby generation, map previews, and API access. 基于真实开放数据的自托管地址与合成测试资料生成器覆盖 27 个国家和地区支持多语言地址、IP 附近生成、地图预览与 API 调用项目地址: https://gitcode.com/gh_mirrors/address4/addressAddress 是一个自托管地址生成器与合成测试资料生成器基于真实开放数据的街道、行政区、坐标和邮编构建覆盖27 个国家和地区支持多语言输出、IP 附近生成、地图预览与 API 调用。本指南带你用Docker Compose执行 3 条命令在自己的服务器上完成部署从此 QA、开发和测试数据都能用上真实存在的地址。为什么值得部署一个自己的地址生成器随机拼接的假地址往往格式错误、无法通过校验。Address 与它不同每一条地址都来自官方地址登记册、开放地图数据或已验证的地理编码结果并附带来源、精度和坐标缺失字段保持为空绝不编造。27 个国家/地区按各国真实行政层级做省市区、邮编过滤️10 种展示语言原生语言、英、简中、繁中、日、韩、德、法、西、葡开放 APIBearer 令牌鉴权支持单条与批量最多 50 条生成免值守同步增量导入、有限重试、配额等待失败任务不会无限重跑单文件部署一个 Compose 文件跑起应用、PostgreSQL、迁移和同步服务内部密钥自动生成并持久化环境要求开始前先核对项目要求系统LinuxAMD64 或 ARM64运行时Docker Engine 24 与 Docker Compose v2内存至少 4 GB首次导入美国、法国等大型国家建议 8 GB磁盘27 国完整同步后数据库约 15 GB另留同步暂存与备份空间网络可访问 Docker Hub 与各数据源对外服务需 HTTPS 反向代理 默认配置开箱即用。端口绑定、跨域来源、代理信任等参数都可以用 Compose 文件旁的.env覆盖详见 docs/DEPLOYMENT.zh-CN.md。3条命令完成 Docker Compose 部署打开终端依次执行# 1️⃣ 克隆仓库 git clone https://gitcode.com/gh_mirrors/address4/address # 2️⃣ 进入目录 cd address # 3️⃣ 一键启动全部服务 docker compose up -d就这么简单。仓库根目录的 docker-compose.yml 统一管理 6 个服务服务作用生命周期bootstrap生成并校验内部密钥完成后退出postgresPostgreSQL 16仅内部网络可见常驻migrate每次启动前执行数据库迁移完成后退出api网页与 API监听127.0.0.1:8787常驻sync官方数据源自动同步常驻credential-broker平台密钥加密、轮换与额度协调常驻首次启动时Compose 会自动在文件旁创建持久化的data/与runtime/目录并把数据库密码、配置加密密钥、服务令牌生成到data/secrets/——你不需要手动配置任何密码或密钥。部署验证两个检查点docker compose ps # 所有服务应为 running / healthy curl -fsS http://127.0.0.1:8787/api/v1/ready # 返回 {status:ready} 即部署成功⏳ 注意sync服务首次启动要加载行政目录可能需要几分钟才变为 healthy期间网页和 API 已可用属正常现象。首次登录管理后台 4 步初始化浏览器打开http://127.0.0.1:8787/admin/用初始密码admin登录按提示修改管理员密码在Access Security中决定是否给公开生成器加访问密码在API Tokens中创建 API 令牌供外部程序调用如果想一上来就用自定义密码首次docker compose up -d前设置ADMIN_INITIAL_PASSWORD环境变量即可。第一次生成地址网页端体验打开http://127.0.0.1:8787/选择国家、地区和展示语言点击生成。结果可以一键复制、导出、存入收藏夹或直接投到 Google 地图 / 高德地图查看位置。生成的地址会带精度标签street/premise/subpremise只有存在独立住宅证据时才标记residential以中国为例还支持在地图上直接框选区域生成接入自动化测试一条 curl 调用 API先在后台API Tokens创建一个令牌可按 scope、每分钟请求数、过期时间限制然后curl -fsS http://127.0.0.1:8787/api/v1/generate?countryUScitySeattle \ -H Authorization: Bearer YOUR_API_TOKEN返回的 JSON 中formattedAddress即为可直接用于测试的地址如4019 Aikins Avenue Southwest, Seattle, WA, 98116并附带经纬度。/generate/batch支持一次生成最多 50 条。全部端点、参数与错误码见 docs/API.md运行中的实例也会在/en/api/提供交互式文档和 OpenAPI 3.1 文件。数据自动同步部署后不用管sync服务会持续从各国官方登记册、OpenStreetMap、Overture 等来源增量拉取、校验并发布数据——大部分国家不需要任何第三方密钥。想查看某个国家同步到什么程度了公开监控页一目了然各国数据来源、字段溯源与住宅证据说明见 docs/data-sources.md。备份与升级两条命令安心运维升级迁移会自动执行docker compose pull docker compose up -d docker compose ps备份数据库 密钥务必成对保存mkdir -p backups docker compose exec -T postgres sh -c pg_dump -U $POSTGRES_USER -d $POSTGRES_DB --formatcustom \ backups/address-$(date -u %Y%m%dT%H%M%SZ).dump cp -r data/secrets backups/secrets-$(date -u %Y%m%d) 重要data/secrets/config_master_key必须与每个数据库备份一起保存——后台录入的平台密钥都靠它加密丢了只能重新录入。常见问题Qsync一直显示 starting正常。它在启动时加载行政目录并校验已发布数据库越大耗时越长。用docker compose logs -f sync观察日志持续输出即工作正常网页和 API 不受影响。Q忘记管理员密码按 docs/DEPLOYMENT.zh-CN.md 中的 FAQ 操作重新生成初始密码并清除旧管理员服务启动时会用新密码重建。Q能直接暴露 8787 端口吗不建议。API 默认只听127.0.0.1:8787对外请走 HTTPS 反向代理文档中附 Caddy / Nginx 完整示例并设置ALLOWED_ORIGINS、TRUST_PROXYtrue、COOKIE_SECUREtrue。Q能不用 Docker 运行吗Docker Compose 是唯一维护的生产部署方式本地开发请看 docs/DEVELOPMENT.zh-CN.md。延伸阅读部署与运维细节docs/DEPLOYMENT.zh-CN.mdAPI 参考docs/API.zh-CN.md平台密钥获取与配置docs/API_KEYS.zh-CN.md27 国地址策略字段、坐标、去重、校验docs/strategies/3 条命令、零手动密钥、数据自动同步——现在就可以把 Address 变成你团队的真实地址水龙头了 【免费下载链接】addressA self-hosted address and synthetic test-profile generator for 27 countries and regions, built from real open-data streets, administrative areas, coordinates, and postcodes. Supports multilingual output, IP-nearby generation, map previews, and API access. 基于真实开放数据的自托管地址与合成测试资料生成器覆盖 27 个国家和地区支持多语言地址、IP 附近生成、地图预览与 API 调用项目地址: https://gitcode.com/gh_mirrors/address4/address创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考