没有不值得去解决的问题,也没有不值得去学习的技术!

A Tour of Go Production 公网验收踩坑:从跨境 SOCKS 链路改为 zgocloud direct

图 1:旧公网验收链路连续出现 curl 28 超时,最终导致 public-machine 阶段失败

作者:

在

Go 学习与文档多语言本地化项目

图3:访问过去的 Go Tour 简体中文站 tour.go-zh.org 时,当前已经无法正常建立连接。

(1) 从「A Tour of Go 中文版」这个搜索词开始:我决定做一个持续维护的 Go Tour 中文版

本地运行的 A Tour of Go「Methods continued」课程页面,左侧为课程说明,右侧为 Go 代码编辑器及运行结果。

(2) A Tour of Go 中文版项目设计冻结:从 101 页到 103 页,从 Gin 转向 Cobra CLI

A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

(3) A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

go-tour-i18n 项目完成首个简体中文课程页面 welcome/1 的整页翻译、结构校验和本地预览。

(4) A Tour of Go 多语言翻译项目实录:完成首个 zh-CN 页面翻译闭环

图 1:DeepSeek 官方更新日志显示,本次只更新 DeepSeek-V4-Flash,DeepSeek-V4-Pro API 与 APP、Web 模型均未更新

(5) A Tour of Go 中文翻译项目进展:完成前 8 页、修复 present 语法,并暂缓 DeepSeek 对比

图 1:generics/1 简体中文页面本地预览

(6) 一个页面重试五次:使用 GLM-5.2 翻译 A Tour of Go 时遇到的 Token 与 Present 结构问题

图 1:methods/16 简体中文页面浏览器预览

(7) A Tour of Go 中文翻译实录:如何只翻译教学代码注释,而不破坏 Go 代码

图 2:A Tour of Go methods/20「练习:错误」中文候选页面最终渲染效果

(8) A Tour of Go 多语言翻译:当正确的中文语序被受保护标记顺序校验误判

图 3:methods/24 中文页面,静态代码、Bounds 行内代码和链接内的 image.Rectangle 均正确渲染

(9) A Tour of Go 中文翻译完成 7 个代表页校准:最后 3 页又发现了哪些真实问题

图 2:首批 10 个普通页面经过试跑与流程校准后全部进入 ready

(10) A Tour of Go 多语言翻译项目:首批 10 个普通页面试跑,从 2 个 blocked 到全部 ready

图 2:flowcontrol/6 最终中文页面,return 与 v 为适应自然中文语序发生整体换位

(11) A Tour of Go 中文翻译第二批实跑:从 Inline Code 顺序误判到历史响应重新验证

图 1:flowcontrol/6 首次原始输入实验直接通过统一自动校验

(12) A Tour of Go 多语言翻译项目:从 swap 问题重新审视 Token 保护,原始输入与最小保护的一次真实实验

图 7:moretypes/1 最终中文页面预览。左侧课程正文、静态代码块、行内代码和教学注释均正常渲染,右侧官方 Go 示例继续保持原样。

(13) A Tour of Go 多语言翻译实战:第三批 10 页全部 Ready,继续校准 Protected Token 的结构角色

图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0

(14) A Tour of Go 多语言翻译项目:zh-CN 103 个课程页面全部 ready,课程正文翻译阶段完成

图 4:GitHub 与 ChatGPT 已成功连接

(15) ChatGPT 连接 GitHub 实测:让 AI 直接读取 go-tour-i18n 仓库参与译文审核

图 3:中文 Go 术语校准完成后,将确定的译法写入 zh-CN glossary

(16) 为什么 channel 最终选择“通道”:A Tour of Go 中文术语统一的一次实践

图 1:技术含义基本正确,但“返回一个返回……”已经明显影响阅读,因此仍被列入 C 类修订

(17) 103 页逐页审核后,只返修 16 页:A Tour of Go 中文正文发布前质量审计

图 2:中文课程页面以及已经完成本地化的编辑器控制区

(18) A Tour of Go 多语言翻译项目:公共 UI 本地化完成,从课程译文走向完整中文界面

图 2:完整 zh-CN 正式投影成功生成,103 个课程页面被重新组装为 7 个 .article

(19) 从 103/103 ready 到完整站点验收:A Tour of Go 中文版补齐正式投影与课程元数据本地化

图 3:从 production bundle 独立启动的 A Tour of Go 简体中文页面,课程正文、公共 UI 和官方 Go 示例均已进入最终发布形态。

(20) A Tour of Go 多语言翻译项目:103 页全部完成后,我终于生成了可独立部署的 zh-CN Production Bundle

图 1:A Tour of Go 简体中文版正式生产页面,远程运行已经成功输出“Hello, 世界”。

(21) A Tour of Go 多语言翻译项目:zh-CN 正式上线,从生产发布到 go.dev Playground 的完整部署记录

图 1:新生产域名 go-dev.shuijingwanwq.com 已正常访问,Go 示例远程运行成功

(22) A Tour of Go 多语言翻译项目:从 go-tour 到 go-dev,完成 EdgeOne、Nginx 与 HTTPS 生产域名迁移

图 1:A Tour of Go 多语言翻译项目正式生产首页

(23) A Tour of Go 多语言翻译项目正式上线:从项目首页、公共 Footer 到生产发布元数据的完整收尾

图 3:GA4 g/collect 请求返回 HTTP 204,并携带当前课程页面地址,确认 Google Analytics 已产生真实事件上报

(24) A Tour of Go 多语言翻译项目:接入 Google Analytics 与百度统计,从 systemd 注入到 EdgeOne 与真实上报验证

图 1:生产环境 robots.txt 与 sitemap.xml 已正确对外提供,Sitemap 共包含 104 个规范 URL。

(25) A Tour of Go 中文站上线后:补齐 robots.txt、Sitemap,并完成五大搜索引擎提交

图 4:发布生产并刷新 EdgeOne 缓存后,再次通过真实手机访问,顶栏项目名称已经完整保持在一行,最终移动端验收通过。

(26) A Tour of Go 多语言翻译项目:修复手机端首页顶栏标题换行,并完成真机验证

图 3:生产自动部署脚本第一次真实运行时,systemd 已经显示 active,但首次 localhost 探测仍然得到 HTTP 000;随后连续 3 次同时满足 active + HTTP 200 后,脚本才判定部署成功,并继续完成公网 HTTP 200 验收。这次真实运行验证了连续应用层健康检查的必要性。

(27) A Tour of Go 多语言翻译项目:从一次 203/EXEC 故障到生产自动部署脚本落地

图 1:阿里云生产环境访问 go.dev Playground 时出现 TLS 握手超时

(28) A Tour of Go 多语言翻译项目:为 Playground 搭建独立的 ZgoCloud 执行代理

图 3:清除 /tour/script.js 缓存后,Run 已直接请求 ZgoCloud /compile 并返回 HTTP 200

(29) A Tour of Go 多语言翻译项目:将生产 Run / Format 切换到 ZgoCloud 执行节点

【图 1:微信中运行 Go 示例时出现 Error communicating with remote server.】

(30) A Tour of Go 中文版手机端运行与格式化偶发失败排查:从间歇性报错到补强 Nginx 可观测性

【图 4:向 golang-dev 公开邮件列表发送 Playground 使用告知邮件并投递成功】

(31) A Tour of Go 多语言项目:为 Playground 代理增加唯一 User-Agent,并主动告知 Go 官方

【图 3:百度剩余 9 个核心 URL 提交成功,remain 归零】

(32) A Tour of Go 搜索引擎收录实测:从 Google 自然索引到百度主动提交与 Bing IndexNow

【图 1:当前正式中文 methods/24 页面,右侧示例代码运行成功】

(33) A Tour of Go 中文翻译完成后,我为什么重新评估 minimal-protect 翻译模式

【图 3:5 个页面 Request SHA256 完全一致,但 Response SHA256 全部不同】

(34) A Tour of Go 翻译实验:更多原始上下文为什么没有更好?从 157 个保护标记到 30 次重复盲评

图 3:3 个代表页 × 4 个评审模型,共 12 次匿名评审的完整排名与第一名票数。

(35) A Tour of Go 翻译质量再评估:minimal-protect 未达预期后,我开始比较 ChatGPT、Codex 与 GLM-5.2

图 2:GitHub 中的 chatgpt-zh-CN-008 重译批次。一个 Batch 同时保存 inputs、raw-responses、candidates、validation 和 retry 记录,GitHub 成为 ChatGPT 与本地翻译流水线之间的数据交接层。

(36) 没有 OpenAI API,我如何用 ChatGPT + GitHub 完成 A Tour of Go 103 页全量重译

图 1:103 个正式课程页面完成最终语义质量审核,结果为 A=103、B/C/D=0,同时不存在缺失、重复或额外页面。A/B/C/D 是本轮项目内部语义质量分级,并不是自动结构 validator 的结果。

(37) 103 页翻完还不能发布:A Tour of Go ChatGPT 译文的语义审核与 Canonical Promotion

图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。

(38) 103/103 与 7/7 Exact Match:A Tour of Go ChatGPT 新译文的最终线上验收

【图 2:upstream source preview】

(39) A Tour of Go 多语言翻译项目首次实现 upstream 同步机制:从一次性翻译到长期维护

图 2:A/B/C/D 质量评级规则,展示正式质量 rubric 与 Promotion gate。

(40) A Tour of Go 多语言翻译项目引入 Translation Quality Review:从自动验证到 AI 翻译质量控制

图 4:翻译后 Playground Example,展示中文注释与保持不变的 Go 代码结构。

(41) A Tour of Go 多语言翻译项目实现 Playground Example 本地化:从代码注释翻译到完整学习体验

图 5:公网页面验证广告脚本输出

(42) A Tour of Go 多语言翻译项目接入广告系统:从 AdSense 专用配置到通用 HTML 注入架构

图 3:百度统计单页应用设置

(43) go-dev 单页网站接入统计与 Google AdSense Auto Ads 验证记录

图 1:GitHub 仓库中的多语言翻译项目结构

(44) A Tour of Go 多语言翻译项目:选择日语作为第二语言并启动翻译验证

图 5:模型身份描述不一致

(45) A Tour of Go 多语言翻译项目中的 AI 协作异常排查:一次长期工程会话失效分析

【图 1:ChatGPT GitHub 写入流程调整说明截图】

(46) go-tour-i18n 翻译流程调整:从 ChatGPT GitHub 写入到本地 artifact 导入

图 4 展示了本次异常状态。

(47) go-tour-i18n 翻译自动化流程复盘:已验证的 ChatGPT 翻译能力在新任务中的稳定性问题

【图 6:全部评审结束以后才读取 secret key,完成最终揭盲】

(48) A Tour of Go 翻译质量再评估:Codex High 已接近 ChatGPT High,我决定调整默认翻译引擎

图 4:ja-JP 生产课程页实际运行 Go 示例

(49) A Tour of Go 日语版正式上线:第二门语言 ja-JP 完成生产发布

图 1:ja-JP 上线以后,先提交“新增语言标准化流程”

(50) A Tour of Go 多语言扩展复盘:为第三门语言建立标准化流程

图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。

(51) A Tour of Go 明明有大片空白,为什么 AdSense 就是不显示展示广告?

图 2:golang/website 当前的 _content/tour/。课程内容、静态资源和模板都在这个上游目录中持续维护。

(52) 为了 AdSense,要不要放弃 SPA?A Tour of Go 页面架构的一次取舍

图 4:最终的手动课程广告真实展示在课程内容区域内,而不是 footer 之后。

(53) 保留 SPA 以后,广告应该放在哪里?从 AdSense 预览到方案 B

图 1:Google Search Console 中,多个不同的 A Tour of Go 课程 URL 被判断为“重复网页,用户未选定规范网页”。

(54) SPA 的 SEO 老问题:为什么最后还是给 103 个 A Tour of Go 课程页生成了 Prerender HTML

图 2:方案 B 生产环境中,源码已经正常,但课程主体高度异常缩短,footer 提前进入第一屏。

(55) 从源码空白到 AdSense 高度污染:A Tour of Go 方案 B 的生产收尾

图 1:A Tour of Go 德语版 de-DE 已正式运行在生产环境

(56) A Tour of Go de-DE 上线复盘:第三门语言用了约 16 小时,下一门如何压到 8 小时?

图 1:fr-FR 首次 production 验收完成后,我没有立即开始 ko-KR,而是先连续完成新增语言与首次生产流程的优化

(57) 法语版上线后,我没有马上开始韩语:A Tour of Go 新增语言流程的一轮完善与简化

图 1:根据 ko-KR 期间 76 次 Git 提交估算实际工作时间

(58) 原本预计 6 小时,最后用了约 16~18 小时:A Tour of Go 韩语版上线复盘

图 2:英文 source 与当时发生 validation failure 的 ko-KR candidate 对比

(59) Validator 报错,到底该改译文还是改规则?一次 A Tour of Go 韩语翻译实战

图 2:法语 A Tour of Go 仓库目前已经归档,页面仍保留 553 Commits 和 61 Contributors 的历史

(60) 从法语 553 次提交到韩语两代离线:A Tour of Go 社区翻译为什么难以长期维护

【图 4:es-ES 首次 Production 收口后连续完成的流程优化 commit】

(61) 从 es-ES 首次上线复盘:我把 A Tour of Go 新增语言的 Production 流程又收敛了一轮

图 1:旧公网验收链路连续出现 curl 28 超时,最终导致 public-machine 阶段失败

(62) A Tour of Go Production 公网验收踩坑:从跨境 SOCKS 链路改为 zgocloud direct

图 1:两次 Production Machine Acceptance 都已经通过,但 Headless Chrome 分别在 / 和 /tour/ 判定页面没有完成渲染

(63) 页面明明能打开,为什么 Headless Chrome 仍然判定 Production 失败?

图 3:Bing 从 Google Search Console 中识别到新的 it-IT 站点,并同时发现已有的 1 个 sitemap

(64) GSC → Bing Webmaster Tools:多语言站点如何减少重复验证

图 3:英文站 3 小时内出现 565 个 Cloudflare 来源 URL

(65) IndexNow 实战:手工提交长期不显示,Cloudflare Crawler Hints 却很快出现在 Bing Webmaster Tools

【图 1:A Tour of Go 项目首页目前的语言版本列表】

(66) 从 nl-NL 到 tr-TR:A Tour of Go 连续上线三门语言后,我又优化了哪些流程

【图 4:Go local 页面中已经出现 French、German、Korean、Simplified Chinese】

(67) 从邮件无人回复到进入 Go 官方 Go local:我的 4 个 A Tour of Go 翻译站终于被收录

图8:最终只保留一把启用的新 API Key

(68) 腾讯云 EdgeOne API 自动化:从 CAM 子用户到最小权限 API Key 的完整配置

【图 7:Production Release Batch 最终汇总】

(69) 从同步 Go 官方上游到一个命令发布 10 个语言站:A Tour of Go Production 流程的再次收敛

【图 3:Cloudflare Smart Tiered Cache 已启用】

(70) Cloudflare 缓存 HIT 很快,MISS 却不稳定:回源阿里云杭州的一次真实优化

【图 3:简体中文站 Support 页面】

(71) 广告之外,社区项目如何长期活下去?我给 A Tour of Go 多语言项目加了 Support

图5:评论成功发布

(72) 从 Go Weekly 到 Reddit、DEV 和 Go Forum:第一次系统推广 A Tour of Go 多语言项目

【图 4:RTL 桌面课程布局修复后的效果】

(73) 第一次把 A Tour of Go 做成 RTL:阿拉伯语版本上线,以及我踩过的几个坑

多语言项目应该先做哪些语言?我的 66 个语言版本商业优先级排序

(74) 多语言项目应该先做哪些语言?我的 66 个语言版本商业优先级排序

当术语一致性遇到性能瓶颈:Go 多语言翻译项目的一次架构取舍

(75) 当术语一致性遇到性能瓶颈:Go 多语言翻译项目的一次架构取舍

从 A Tour of Go 走向 Go Learning & Documentation:为什么这个多语言项目需要 v2

(76) 从 A Tour of Go 走向 Go Learning & Documentation:为什么这个多语言项目需要 v2

Markdown 明明可以拆成很多段,为什么 v2 仍然坚持一个 Page 就是一个 TranslationUnit

(77) Markdown 明明可以拆成很多段,为什么 v2 仍然坚持一个 Page 就是一个 TranslationUnit

Tour、Learn、Docs 为什么不应该各维护一份术语表:v2 的统一 Glossary 设计

(78) Tour、Learn、Docs 为什么不应该各维护一份术语表:v2 的统一 Glossary 设计

v2 术语表变更后的页面影响范围判断流程:区分 Compatible 与 Affected,只处理真正受影响的页面。

(79) 术语表改了,为什么不应该让所有页面重新翻译?v2 的影响范围判断

CLI 性能优化示意图:通过 Prepare Once、Reuse Many Times,将执行时间从 6m54.554s 降至 10.335s,约提升 40.1 倍。

(80) 从 6 分 54 秒到 10.3 秒:Go 多语言项目一次 CLI 性能优化实战

Markdown Page 经过 Parse / Protect、Generation 和 Reconstruct / Validate 的流程示意图,强调保护 inline code、链接、代码等机器语义,同时允许译文按照自然语言调整语序。

(81) Markdown 不是纯文本:Learn / Docs 为什么需要新的 parser 与结构保护

历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

(82) 历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

历史状态通过 Trusted Checkpoint 建立可信断点,旧记录继续保留用于审计和诊断,后续工作流从当前状态继续向前,不再要求无限重建过去。

(83) 历史应该被保留,而不是被反复重建:v2 为什么最终需要一个“断点”

v2 依赖与失效传播流程图:从内容变化开始,评估依赖关系和真实影响,将结果区分为“仍然有效”和“需要失效”,只让真正受影响的状态重新进入流程。

(84) 一次内容变化,到底应该让哪些状态失效?v2 的依赖与失效传播设计

v2 本地内容覆盖判断流程图:官方英文页面先检查是否已有正式本地覆盖,有覆盖时使用本地 URL,没有覆盖时直接链接 go.dev,并保持本地路径真实 404。

(85) 有英文页面,不代表一定应该有本地页面:v2 如何处理本地内容覆盖、canonical 与真实 404

v2 代码注释完整性审计流程图:从源页面建立代码块清单,分类教学注释、机器语义和无法判断的内容,再与当前译文精确对应,确认 missing、extra 和 protected mutation 均为 0。

(86) 代码块里的注释为什么不能只靠肉眼检查?v2 如何统计并验证代码注释翻译完整性

结构化语义输入扩展示意图:同一份 books.yaml 原始文件保持不变,旧 parser 识别 10 个可本地化单元,当前 parser 识别 12 个,并新增 PDF 和 GitHub,确认旧单元无删除无修改后重新进入 Generation。

(87) 原始文件一个字没变,为什么还要重新翻译?从 books.yaml 10→12 看语义输入扩展

v2 Activation 流程图:Surface PASS 后先执行只读 activation-preflight 获取 prior_sha256,activation-apply 时通过 CAS 再次比较当前状态,只有 current 等于 prior 才提交 result_sha256,否则停止并重新 preflight。

(88) 审核都通过了,为什么上线前还要再检查一次?v2 的 Activation、prior SHA 与 CAS 设计

v2 分层验证流程图:TranslationUnit、Package Closure 和 Integrated Surface 均通过后进入 Activation,再由 Preview 检查 LoadContent、Compose、Resolver 和 Renderer 的真实运行链;如果实际使用错误 renderer,即使前置内容全部通过,Preview 仍然失败。

(89) Surface 已经 PASS,为什么 Preview 还是会失败?从一次 wrong renderer 看分层验证的价值

更快不一定更好:为什么我主动撤销了一次已经明显变快的性能优化

(90) 更快不一定更好:为什么我主动撤销了一次已经明显变快的性能优化

最近在继续给 A Tour of Go 多语言项目增加意大利语站点时,Production 阶段又遇到了一个比较典型的问题。

站点本身已经部署成功,源站也正常,Cloudflare DNS 同样没有问题,但到了公网验收阶段,却会因为网络瞬态失败导致整个首次 Production 流程中断。

一开始我以为,只要再增加一些重试就可以解决。

实际排查下来,最后做的调整更彻底:

不再让完整公网验收流量经过我的本地电脑和跨境 SOCKS 链路,而是直接把公网验收放到 zgocloud 上执行。

调整之后,105 个 sitemap URL、CDN Cache、HTML Identity、Socket Boundary 等公网检查全部稳定通过。

一、问题不是部署失败,而是公网验收失败

A Tour of Go 多语言站点的首次 Production,并不是“服务启动了就算成功”。

正式流程里还需要继续检查:

  • release identity
  • remote/source identity
  • 关键公网路由
  • HTML identity
  • sitemap 以及其中的全部 URL
  • socket boundary
  • CDN Cache
  • 浏览器自动验收
  • HUMAN visual gate

这次出现问题的时候,前面的 release 和源站检查其实都已经通过了。

例如:

Plaintext
[verify-production] remote identity: PASS
[verify-production] source routes: 7/7 PASS

也就是说,已经有证据证明:

当前 release 正确,源站服务也是正常的。

但是进入公网请求后,同一个 Cloudflare URL 连续出现 15 秒超时:

Plaintext
curl: (28) Operation timed out after 15002 milliseconds with 0 bytes received
curl: (28) Operation timed out after 15002 milliseconds with 0 bytes received
curl: (28) Operation timed out after 15002 milliseconds with 0 bytes received

最终:

Plaintext
[首次生产] FAILED
stage: public-machine
expected: command exit 0
actual: exit 1
图 1:旧公网验收链路连续出现 curl 28 超时,最终导致 public-machine 阶段失败
图 1:旧公网验收链路连续出现 curl 28 超时,最终导致 public-machine 阶段失败

这张日志很重要。

如果只看到:

Plaintext
first-production FAILED

很容易下意识认为应该重新部署、重新检查 Nginx,甚至重新处理 Cloudflare DNS。

但真实 evidence 并不支持这些操作。

失败发生在:

Plaintext
stage: public-machine

而不是 deploy、source health 或 DNS 阶段。

这意味着正确方向应该是继续检查公网验收链路,而不是破坏已经正常工作的 Production 现场。

二、原来的公网验收链路有点绕

这个项目的 Production 源站位于中国大陆,而 Cloudflare 控制面以及部分公网访问需要经过跨境网络。

此前为了稳定访问 Cloudflare,我已经使用 zgocloud 作为海外出口,并通过 SSH、SOCKS 等方式处理相关流量。

但旧的公网验收链路,本质上仍然类似:

Plaintext
本地电脑
    ↓
跨境连接
    ↓
zgocloud
    ↓
Cloudflare
    ↓
Production Origin

这里有一个比较明显的问题。

真正需要验证的是:

Plaintext
zgocloud → Cloudflare → Production

但大量公网验收流量还必须先经过:

Plaintext
本地电脑 → zgocloud

这一段额外的跨境链路。

对于偶尔访问一个页面,这种差异可能并不明显。

但是 Production verifier 并不是只请求一次首页。

当前 A Tour of Go Production sitemap 中一共有:

Plaintext
105 URLs

除了 sitemap 之外,还要继续检查:

Plaintext
public routes
HTML identity
socket boundary
CDN cache

这意味着公网验收会产生大量连续请求。

只要其中某一段跨境链路存在一定概率的抖动,随着请求数量增加,失败的概率也会明显放大。

当时除了 curl 28 timeout 之外,我还遇到过:

Plaintext
curl: (97) Failed to receive SOCKS response, proxy closed connection

单独看某一次失败,也许只是偶发现象。

但对于正式 Production acceptance 来说,不能简单忽略。

三、不能为了让 Production 通过而无限重试

看到网络瞬态错误以后,一个很自然的想法就是增加 retry。

例如:

Plaintext
失败
→ retry
→ 还失败
→ 再 retry

但正式验收不能变成“只要多试几次,总有一次能通过”。

否则自动化验收的可信度反而会下降。

因此这次继续明确了几个原则。

1. 瞬态网络错误允许 bounded retry

对于明确可能属于瞬态网络问题的情况,正式 verifier 可以进行有限次数的 bounded retry。

例如当前 verify-production.sh 会针对部分:

Plaintext
curl exit 6
curl exit 7
curl exit 16
curl exit 28
curl exit 35
curl exit 97

以及 Cloudflare 的部分:

Plaintext
HTTP 522
HTTP 525

执行有限次数重试。

当前 verify-production.sh 中,单个公网 HTTP 逻辑请求最多尝试 3 次。

不过这里需要特别说明:

3 次并不是整个项目所有检查统一使用的数字。

不同阶段根据检查对象不同,会有自己的 bounded retry 或 readiness 规则。

例如某些 Nginx readiness、Playground Origin endpoint check 使用的是不同的尝试次数。

真正需要统一的不是“所有地方都重试几次”,而是:

重试必须有明确边界。

2. 重试耗尽以后必须 fail closed

无论具体阶段允许多少次尝试,只要正式的 bounded retry 已经耗尽,就必须:

Plaintext
FAILED

不能继续假设网络“其实应该是好的”。

也不能为了让首次 Production 顺利结束而跳过失败检查。

3. sitemap 检查失败后直接停止

这一点对当前项目尤其重要。

sitemap 有:

Plaintext
105 URLs

假设检查到第 20 个 URL 时,bounded retry 已经全部失败,那么后面的 URL 实际上就还没有得到验证。

此时继续请求第 21、22……105 个 URL,并不能改变前面已经失败的事实。

因此现在的正式逻辑是:

某个 sitemap URL 在 bounded retry 后仍然失败,就立即 fail closed。

只有真正完整验证全部 URL 后,才允许输出:

Plaintext
sitemap: 105/105 PASS

这也是我越来越重视的一点:

自动化验收的目标不是提高 PASS 率,而是让 PASS 本身可信。

四、真正的调整:把公网验收直接放到 zgocloud

继续分析之后,我觉得与其不断增强本地 SOCKS 链路,不如先重新思考一个更基础的问题:

Production 公网验收到底应该在哪里运行?

既然正式公网流量最终需要从海外访问 Cloudflare,那么更直接的路径其实就是:

Plaintext
zgocloud
    ↓
Cloudflare
    ↓
Production Origin

因此现在的 Production verifier 改成了:

Plaintext
本地维护机
    │
    │ SSH
    ▼
zgocloud
    │
    │ 直接执行公网 HTTP 验收
    ▼
Cloudflare
    ▼
Production Origin

也就是现在日志中会明确看到:

Plaintext
[verify-production] public network runner: zgocloud (direct)

这里的重点不是“换了一个代理”。

而是:

把真正的公网 HTTP acceptance 放到了更加合适的网络位置执行。

与此同时,并不是所有检查都搬到了 zgocloud。

本地仍然负责正式 release identity,远端 Production source identity 也仍然按原有正式路径检查。

也就是说,调整的是:

Plaintext
public HTTP acceptance 的执行位置

而不是降低或者绕过:

Plaintext
release identity
source identity
Production authority

五、为什么这比继续优化 SOCKS 更简单

理论上,也可以继续优化原来的链路:

Plaintext
本地
→ SOCKS
→ zgocloud
→ Cloudflare

例如继续做:

  • 更多 connection retry
  • 更复杂的 tunnel 恢复
  • 自动重新建立 SOCKS
  • 多出口切换
  • 动态线路评分
  • 不同时间段自动选路

但是对于当前项目来说,这些方案会越来越复杂。

而真正的需求其实很简单:

我需要一个相对稳定的海外网络位置,验证 Production 经 Cloudflare 对公网呈现的真实状态。

既然 zgocloud 本身已经存在,那么:

Plaintext
直接在 zgocloud 执行公网 verifier

明显比:

Plaintext
先从本地跨境连接到 zgocloud
再让大量请求经过这条 tunnel

更直接。

这也是这次最终没有继续做复杂网络工程的原因。

六、改造后的真实 Production 结果

调整完成后,我继续使用同一份正式 it-IT release。

没有重新 publish,也没有重新 deploy。

再次进入正式 Production 验收后,输出变成:

Plaintext
[verify-production] public network runner: zgocloud (direct)
[verify-production] public routes: 7/7 PASS
[verify-production] html identity: PASS

sitemap URLs: 105/105
host mismatch: 0
HTTP failure: 0

[verify-production] sitemap: 105/105 PASS
[verify-production] socket boundary: PASS
[verify-production] CDN /: HIT -> HIT -> HIT PASS
[verify-production] CDN /tour/welcome/1: HIT -> HIT -> HIT PASS

PRODUCTION MACHINE ACCEPTANCE: PASS
[首次生产] 公网验收:PASS(31.1s)
图 2:改为 zgocloud direct 后,105 个 sitemap URL、CDN 与 Socket Boundary 全部通过
图 2:改为 zgocloud direct 后,105 个 sitemap URL、CDN 与 Socket Boundary 全部通过

这张结果和前面的失败日志形成了非常直接的对比。

旧方案:

Plaintext
source routes: PASS
↓
公网请求 curl 28
↓
public-machine FAILED

新方案:

Plaintext
zgocloud (direct)
↓
public routes: 7/7 PASS
↓
sitemap: 105/105 PASS
↓
socket boundary: PASS
↓
CDN: PASS
↓
PRODUCTION MACHINE ACCEPTANCE: PASS

七、网络失败以后,不应该随便重新部署

这次还有一个很实用的收获。

以前遇到:

Plaintext
first-production FAILED

很容易产生一种冲动:

Plaintext
是不是重新 deploy 一次比较保险?

但这其实取决于失败发生在哪一个 stage。

例如这次:

Plaintext
source routes: PASS
remote identity: PASS

Production 服务本身已经存在完整证据证明是正常的。

真正失败的是:

Plaintext
public-machine

而且错误是:

Plaintext
curl 28
curl 97

那么正确处理应该是:

Plaintext
保留当前 release
保留 Production 现场
↓
解决或等待网络条件恢复
↓
正式 resume

而不是:

Plaintext
重新 publish
重新 upload
重新 deploy
重新修改 DNS

否则不仅浪费时间,还可能把一个单纯的网络问题变成新的部署变量。

现在 first-production 已经支持正式 resume,并会重新检查关键 identity。

所以后续再遇到类似问题,我会优先根据:

Plaintext
stage
+
真实 evidence

决定回流路径,而不是看到 FAILED 就从头再来。

八、首次 Production 尽量避开晚间跨境网络高峰

这次问题发生的时间也让我增加了一条偏运维习惯的规则。

如果没有紧急需求:

首次 Production、公网验收、DNS/CDN 激活等操作,尽量避开北京时间晚间的跨境网络高峰。

这里我并不是要证明:

Plaintext
某个具体时间段一定会出现丢包

也没有必要为此建立复杂的长期网络监控。

只是从实际维护成本来看:

如果:

Plaintext
上午执行

和:

Plaintext
晚上执行

业务上没有区别,那么就没有必要主动选择一个更容易引入跨境网络变量的时间段。

尤其首次 Production 本身已经包含:

Plaintext
DNS
Cloudflare
origin
shared assets
public acceptance
browser acceptance

变量已经足够多。

能少一个不确定因素,就少一个。

九、以后新增 locale 直接复用

现在 A Tour of Go 多语言项目已经有多门 Production locale。

后续新增语言时,我不打算再次为每一门语言重新设计网络方案。

当前正式路径直接复用:

Plaintext
Production deploy
↓
direct-origin acceptance
↓
Cloudflare DNS
↓
minimal public readiness
↓
zgocloud direct public machine acceptance
↓
browser acceptance
↓
HUMAN visual gate
↓
first-production finalize
↓
production_state=live

网络瞬态问题:

Plaintext
bounded retry

重试耗尽:

Plaintext
fail closed

Production 本身没有变化:

Plaintext
保留现场
稍后正式 resume

而不是重新部署。

对于后续 locale 来说,这一部分已经可以直接作为 Production 基线复用。

十、总结

这次一开始看到的,其实只是几个:

Plaintext
curl: (28)

以及后来出现的:

Plaintext
curl: (97)

如果只针对错误码本身处理,很容易最后变成:

Plaintext
再多重试几次
再把 timeout 调大一些

但真正值得解决的问题其实是:

为什么公网验收一定要经过这条更长、更容易波动的网络路径?

最终,我没有继续堆叠复杂的代理、自动选路或者多出口监控,而是选择了更简单的办法:

Plaintext
需要验证 Cloudflare 公网行为
↓
就在 zgocloud 直接验证

同时继续坚持:

Plaintext
bounded retry
+
fail closed
+
完整 identity 验证

这次也让我重新确认了一件事:

Production acceptance 本身也是 Production 架构的一部分。

站点部署在哪里是一回事。

验收从哪里执行,又是另一回事。

如果验收链路本身不稳定,即使 Production 完全正常,也可能不断得到 false failure。

与其不断提高 retry 次数,不如先确保:

验收发生在一个合理、稳定、与真实验证目标一致的位置。

对目前这个项目来说,zgocloud direct 已经足够解决这个问题,而且比继续维护复杂的跨境 SOCKS 公网验收链路更简单。

从 es-ES 首次上线复盘:我把 A Tour of Go 新增语言的 Production 流程又收敛了一轮 页面明明能打开,为什么 Headless Chrome 仍然判定 Production 失败?

Go 学习与文档多语言本地化项目

本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。

项目源码:
✅ GitHub:shuijingwan/go-tour-i18n

语言版本:

当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。

英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。

  1. 阿姆哈拉语
  2. 阿拉伯语
  3. 孟加拉语
  4. 葡萄牙语(巴西)
  5. 保加利亚语
  6. 加泰罗尼亚语
  7. 克罗地亚语
  8. 捷克语
  9. 丹麦语
  10. 荷兰语
  11. 英语(美国)(Go 官方英文站点)
  12. 英语(澳大利亚)
  13. 英语(加拿大)
  14. 英语(印度)
  15. 英语(新加坡)
  16. 英语(南非)
  17. 英语(英国)
  18. 爱沙尼亚语
  19. 菲律宾语
  20. 芬兰语
  21. 法语(法国)
  22. 法语(加拿大)
  23. 德语(德国)
  24. 德语(奥地利)
  25. 德语(瑞士)
  26. 希腊语
  27. 古吉拉特语
  28. 希伯来语
  29. 印地语
  30. 匈牙利语
  31. 印度尼西亚语
  32. 意大利语
  33. 日语
  34. 卡纳达语
  35. 哈萨克语
  36. 韩语
  37. 西班牙语(拉丁美洲)
  38. 拉脱维亚语
  39. 立陶宛语
  40. 马来语
  41. 马拉雅拉姆语
  42. 马拉地语
  43. 书面挪威语(Bokmål)
  44. 波斯语
  45. 波兰语
  46. 葡萄牙语(葡萄牙)
  47. 旁遮普语(果鲁穆奇文,印度)
  48. 罗马尼亚语
  49. 俄语
  50. 塞尔维亚语(西里尔文)
  51. 简体中文(中国大陆)
  52. 简体中文(新加坡)
  53. 斯洛伐克语
  54. 斯洛文尼亚语
  55. 西班牙语(西班牙)
  56. 斯瓦希里语(坦桑尼亚)
  57. 瑞典语
  58. 泰米尔语
  59. 泰卢固语
  60. 泰语
  61. 繁体中文(台湾)
  62. 繁体中文(香港)
  63. 土耳其语
  64. 乌克兰语
  65. 乌尔都语
  66. 越南语

项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。

本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。