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

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

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

作者:

A Tour of 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 失败?

最近在继续给 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 流程又收敛了一轮

A Tour of Go 多语言翻译项目

本系列完整记录 A Tour of Go 多语言翻译项目从架构设计、整页翻译、结构保护、自动校验,到生产发布与后续维护的实际开发过程。

项目入口:
✅ 简体中文:A Tour of Go 简体中文版
✅ 日语:A Tour of Go 日语版
✅ 德语:A Tour of Go 德语版
✅ 法语:A Tour of Go 法语版
✅ 项目源码:GitHub:shuijingwan/go-tour-i18n

当前已上线简体中文、日语、德语和法语版本。项目属于非官方社区多语言翻译项目,与 Go 官方无隶属或授权关系。