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/addressAddress 是一个自托管的地址与合成测试资料生成器基于真实开放数据覆盖 27 个国家和地区支持多语言输出、IP 附近生成、地图预览与 API 调用。对于把 Address 部署在生产环境的人来说最核心的问题只有两个升级时别丢数据、出错时能回滚。好消息是这个仓库把这两件事浓缩成了两条命令——ops/backup.sh和ops/restore.sh本文带你把它们彻底讲清楚。️先搞懂数据在哪三处目录决定备份范围Address 只支持一种生产部署方式Docker Compose所有数据都放在 Compose 文件所在的目录下。真正需要不丢的有三块目录内容备份要求data/postgres/PostgreSQL 数据库地址池、同步状态核心用pg_dump逻辑备份data/secrets/自动生成的内部密钥含config_master_key必须随每次备份一起保存runtime/同步运行状态、发布记录建议一并归档其中最容易踩坑的是data/secrets/config_master_key管理后台里保存的平台密钥如地图、翻译服务商的 Key都用它加密丢了就只能重新录入。一条命令备份ops/backup.sh 做了什么在部署目录根下执行./ops/backup.sh脚本执行完会在标准输出打印备份文件路径形如backups/address-20261007T003000Z.dump。它内部做了四件你手工备份时容易漏掉的事见 ops/backup.sh自定义格式 压缩调用pg_dump --formatcustom --compress6备份更小且支持按对象恢复备份后自检立即用pg_restore --list校验文件完整坏文件当场暴露而不是等到恢复时才发现临时文件转正先写.tmp再原子性改名中断不会留下半截文件权限收紧chmod 600数据库备份默认就是敏感数据。⚠️ 数据库之外请顺手把密钥目录也复制一份cp -r data/secrets backups/secrets-$(date -u %Y%m%d)这条建议也写进了官方部署文档的备份章节docs/DEPLOYMENT.zh-CN.md 的备份与恢复一节。一条命令恢复ops/restore.sh 的安全设计恢复一条命令搞定./ops/restore.sh backups/address-20261007T003000Z.dumpops/restore.sh 的流程比想象讲究这正是不丢数据的关键入口校验备份文件必须位于backups/目录下拒绝任意路径防止误操作先停写、再恢复先docker compose stop api sync再用pg_restore --clean --if-exists --no-owner全量替换数据库自动补迁移恢复后自动运行migrate服务把 schema 对齐到当前版本的 server/control/schema.sql异常兜底注册了退出陷阱即使恢复中途失败或按 CtrlC也会自动把api和sync服务拉起来不会把系统留在一半状态。升级实操备份 → 拉新 → 起服务Address 的常规升级只需三步顺序不能乱先备份# 1. 升级前备份含密钥目录 ./ops/backup.sh cp -r data/secrets backups/secrets-$(date -u %Y%m%d) # 2. 拉取新镜像并重建容器 docker compose pull docker compose up -d # 3. 确认全部 running / healthy docker compose ps数据库迁移由migrate服务在启动时自动完成无需手动操作。若希望版本可控把.env里的ADDRESS_IMAGE固定为具体版本标签即可避免latest带来的不确定性。两条硬性注意事项跨 PostgreSQL 主版本如 15→16升级只能走pg_dump/pg_restore不要直接复用旧的data/postgres目录不要让两个 PostgreSQL 容器挂载同一个data/postgres。进阶玩法不可变发布与蓝绿切换如果你希望升级更零停机、失败可秒回滚仓库还内置了一整套生产级发布工具链ops/deploy.sh把工作区打包为不可变发布带 SHA-256 清单上传到远程构建address-local:release镜像绝不使用:latestops/activate-production-release.sh执行蓝绿切换——新流量切到蓝/绿槽位后观察健康状态并自动清理超期的旧发布默认保留 5 份随时可切回上一个槽位回滚ops/status.sh一键体检检查 Compose 服务、API/api/v1/ready与同步服务/healthz三处健康端点蓝绿模式下还会显示当前活跃槽位。配合 ops/start.sh、ops/stop.sh 这类薄封装脚本日常启停也统一了入口——脚本内部通过 ops/compose-root.sh 解析根目录支持ADDRESS_ROOT覆盖换机器迁移时只需整体拷贝该目录。恢复后的验收与常见问题恢复或升级完成后建议按这个顺序验收docker compose ps全部running / healthycurl http://127.0.0.1:8787/api/v1/ready返回{status:ready}打开http://127.0.0.1:8787/admin/抽查地址数据与同步状态。两个高频问题的官方答案sync一直显示 starting正常现象。它启动时要加载行政目录并校验已发布数据大库可能需几分钟日志持续输出即可等待网页与 API 不受影响忘记管理员密码按 docs/DEPLOYMENT.zh-CN.md 的常见问题一节操作删除data/secrets/admin_bootstrap_password用新初始密码运行bootstrap并清理旧管理员记录后重启即可。 运维清单速查场景操作耗时预期日常备份./ops/backup.sh 复制data/secrets分钟级恢复到指定备份./ops/restore.sh backups/xxx.dump分钟级大库稍久版本升级备份 →docker compose pull→docker compose up -d视镜像大小生产发布/回滚ops/deploy.shops/activate-production-release.sh蓝绿切换近零停机健康体检./ops/status.sh秒级一句话总结把data/secrets/config_master_key和数据库备份视为一对绑定资产升级前先跑ops/backup.sh出事就跑ops/restore.sh——这两条命令就是 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），仅供参考