外部操作记录
本文件记录教材制作过程中对工作区以外环境的授权操作。不得记录密码、令牌或其他敏感值。
2026-09-10:只读环境核验
- 授权范围:读取 Windows、WSL、Ubuntu、Docker Desktop 和 Codex 的版本与可用状态。
- 外部位置:Windows 系统信息、WSL 发行版信息、Docker 引擎状态、已安装应用信息。
- 结果:Windows 11 家庭版 Build 26100;WSL 2.7.13;Ubuntu 26.04.1 LTS;Docker Desktop 4.89.0;Docker Engine 29.7.2;Docker Compose 5.5.0;VS Code 1.137.0;Codex 桌面版 26.903.8094.0。
- 修改:无。没有安装、升级、重启、拉取镜像或创建容器。
- 恢复方法:不适用。
待授权验证
如需真实运行综合项目,将记录镜像名、容器名、执行结果和清理方式。默认不执行。
2026-09-10:GitHub Pages 公开发布
- 授权范围:创建公开 GitHub 仓库、推送教材、启用 GitHub Actions Pages、设置自定义域名并发起域名所有权验证。
- 外部位置:GitHub 仓库
myTangly/linux-learning-guide与 GitHub Pages 设置。 - 结果:仓库已创建并推送;Pages 发布源已设为 GitHub Actions;默认站点
https://mytangly.github.io/linux-learning-guide/已成功发布并完成首页、深层章节、静态资源、站点地图和 404 实际访问检查。linux.tangmy.top的公共 CNAME 已指向mytangly.github.io,但tangmy.top所有权验证仍等待用户在阿里云添加 TXT 记录,因此仓库中的自定义域名暂未重新绑定。 - 恢复处置:首次 Pages 初始化长期停留在
updating_pages并阻塞后续运行。依据 GitHub Pages 官方接口,先取消该残留部署;确认取消状态后删除并重建尚未成功发布的 Pages 站点配置。仓库、提交和 DNS 记录均未删除。重建后的工作流第 8 次运行成功。 - 未操作:未登录或修改阿里云;未改动其他域名记录;未安装 GitHub CLI;未写入个人邮箱、令牌或密码。
- 恢复方法:可在仓库 Pages 设置中移除自定义域名或停用 Pages;DNS 回退由域名所有者删除
linux的 CNAME。仓库删除属于难以恢复操作,不作为常规回退。
2026-09-10:加入 tangmy.top 主站项目列表
- 授权范围:在主站“项目与工具”区域加入 Linux 联合教程入口并发布。
- 外部位置:GitHub 仓库
myTangly/tangmy.github.io的master分支。 - 结果:新增第三张项目卡片、真实教程页面预览图和 README 入口;提交
b657d67已推送,GitHub Pages 部署状态为成功。主站 HTTP 页面和预览图已实际读取;根域名 HTTPS 证书名称校验仍未通过,因此未声称 HTTPS 可用。 - 隐私:预览图只包含公开教程页面和软件版本基准,不包含账号、凭据、用户目录或设备标识。
- 恢复方法:如需撤回,优先在主站仓库新增一次反向提交,移除该卡片、README 条目与
assets/linux-learning-preview.png;不改写已发布历史。
2026-09-10:恢复 linux.tangmy.top Pages 绑定
- 授权范围:排查用户反馈的自定义域名 404,并恢复教程仓库的 Pages 域名设置。
- 结果:确认 DNS 的
linux CNAME mytangly.github.io正确;默认 GitHub Pages 地址正常。已在仓库 Pages 设置重新保存linux.tangmy.top,GitHub 显示“DNS Check in Progress”,但公共 DNS 尚未看到账号验证 TXT,因此自定义域名暂时仍返回 GitHub 404。 - 待用户操作:在阿里云添加
_github-pages-challenge-myTangly的 TXT 记录后,再在 GitHub 的已验证域名页面点击 Verify。 - 恢复方法:若 DNS 配置需要回退,只需移除
linux的 CNAME;仓库内容、默认 Pages 地址和其他子域名不受影响。
复测结果(同日)
- GitHub Pages 配置确认
cname=linux.tangmy.top,站点地址为https://linux.tangmy.top/,并已启用强制 HTTPS。 - 重新触发部署后,工作流第 13 次运行(提交
86af7e5)成功。 https://linux.tangmy.top/与深层章节/docs/01-five-layers.html均返回 HTTP 200,TLS 校验结果为 0(证书有效);http://访问返回 301 跳转到 HTTPS。- 页面标题、20 章导航与 canonical 地址均正确;主站项目卡片链接已指向可用的自定义域名。
- 仍未完成:账号级域名所有权 TXT 记录尚未出现在公共 DNS。该记录用于防止域名被其他账号占用,不影响当前访问;建议后续补上并在 GitHub 点击 Verify。