Zayn's Blog

每日技术实践简报 - 2026-04-02：博客 Git 工作流治理、Linux 笔记本选购调研与 AI 安全事件追踪

yangzun@treesir.pub (Zayn) — Thu, 02 Apr 2026 22:00:00 +0800

今日技术实践
#

解决的问题
#

博客 MR 合并冲突解决：MR !53 合并后，后续推送的 03-29、03-30 日报和 03-31 重写版未包含在合并中。根因是合并后继续往同一分支推送新 commit，但未创建新 MR。最终通过本地 git merge 解决冲突，直接推送到 main 分支。

每日技术实践简报 - 2026-03-31：Claude Code 源码泄露、运维告警集中爆发与海南骑行决策

yangzun@treesir.pub (Zayn) — Tue, 31 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

多源运维告警分级梳理：一天之内收到 5 类告警——腾讯云 SSL 证书过期（3/28 通知，已过 3 天未续期）、YangZun Playground 反复宕机（3/29-3/31 共 6 次 DOWN/UP 循环）、TrueNAS 存储告警连续触发、CloudflareSpeedTest CI 连续 10 次失败、GitLab 暴力登录（1 分钟内 7 次验证码错误）。按紧急度分级：SSL 续期和 YangZun 根因排查为最高优先级。

每日技术实践简报 - 2026-03-30：工作周报整理、编程范式梳理与运维治理体系沉淀

yangzun@treesir.pub (Zayn) — Mon, 30 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

工作周报生成：使用 work-report-generator Skill 从对话记录中提取本周工作内容，先生成详细版再转化为领导汇报版（结果导向、简洁专业、突出重点和下一步计划）。
编程范式梳理：整理了面向过程、面向函数、面向对象三种编程范式的演进关系、核心区别和实际应用场景。现代语言已走向多范式混合路线。

学到的新东西
#

领导汇报版周报格式：分"重点工作"和"其他工作"两大块，重点工作按项目编号列出成果，底部用表格呈现下周计划和预期目标。语言风格要结果导向，不说过程只说结论。
编程范式本质区别：面向过程关注"步骤"（流程图），面向函数关注"变换"（数学映射），面向对象关注"协作"（角色交互）。三者不互斥，现代语言多范式混合是主流。
运维治理三重机制验证：预防层（配置审查、安全检查、操作规范）→ 监控层（日常检查、日志监控、错误追踪）→ 修复层（降级策略、备份恢复、故障诊断），已形成闭环且错误率显著下降。

实际产出
#

本周工作周报（领导汇报版）1 份
博客运营优化巡检自动执行（每日 10:15），当天优化了 03-21 和 03-15 日报标题

踩坑记录
#

Cron 任务 delivery 报错：多个 isolated agentTurn 任务（博客巡检、AI 论文简报、AI 资讯速览等）因缺少 channel 参数报 “Channel is required” 错误。在多通道配置（telegram + openclaw-weixin）环境下必须显式设置 delivery.channel: "telegram"。

其他思考
#

国产咖啡品牌调研：三顿半超级拿铁系列（3号经典拿铁、4号浓郁拿铁）适合不喜欢纯深烘焙的口味偏好，冻干粉冷水即溶，单杯不到 5 元，是日常口粮咖啡的高性价比选择。
外部服务依赖风险：Brave Search API 月度额度耗尽导致搜索能力暂时不可用，提醒了对外部 API 的依赖需要有降级预案。

每日技术实践简报 - 2026-03-29：从 MCP 到一键发包的博客深度写作与 Skill 链优化

yangzun@treesir.pub (Zayn) — Sun, 29 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

深度博客文章撰写：完成"从 MCP 到一键发包"的 300+ 行技术博客，完整记录了从 Teambition MCP 对接到 APK 自动上传 Nexus 的全链路踩坑过程。
Blowfish 主题 shortcode 踩坑：发现主题没有 notice shortcode，只有 alert。经过多次 sed/edit 替换尝试，最终确认正确语法为 {{< alert "icon-name" >}}内容{{< /alert >}}。
Mermaid 流程图修复：从 text 代码块改为 {{< mermaid >}} shortcode 格式，Hugo 才能正确渲染可视化流程图。
Git 分支治理：发现旧分支 feat/extract-markdown-rental-risk-20260324 堆积了大量无关提交（_index.md 修改、租房信息文章等），从 main 重新创建干净分支，只包含必要文件。

学到的新东西
#

Blowfish 可用 shortcode 清单：alert、mermaid、chart、timeline、figure、gist、katex 等。写文章前先确认 shortcode 存在，不要凭记忆用。
blog-post-generator Skill 规范：frontmatter 需要 featureimage、keywords、tags_weight/categories_weight；推荐阅读用相对路径内链；代码块必须是实际可用代码，不要伪代码。
Git 分支清理策略：保护分支的仓库应"从 main 创建新分支 → cherry-pick 或 checkout 需要的文件 → 关闭旧 MR → 创建新 MR"，比 rebase 更可控。
租房等非技术内容不应推到技术博客：分支提交前必须 review 文件列表，排除无关内容。

实际产出
#

深度博客文章 1 篇（302 行，9892 字节）
3月28日日报 1 篇
Git MR !53 创建（干净版本，排除租房信息）

踩坑记录
#

notice shortcode 不存在：Blowfish 主题没有 notice，只有 alert。Skill 文档记录有误，需以实际 shortcode 目录为准。
多次 sed 替换导致文件状态混乱：部分 notice 被替换为 alert，但残留不完整标签。应一次性 read 全文确认再精确 edit。
Hugo 版本兼容性警告：Module “blowfish” is not compatible with Hugo 0.137.0/0.148.0，但实际构建可通过，属于警告而非阻断。

其他思考
#

博客写作风格确立：口语化、有实操感、不要 AI 味；像一个资深工程师在写给同行看；段落简短，多用小标题。
博客 Skill 链（blowfish-hugo + blog-post-generator + structured-guide-writer）已形成完整工作流，后续写作效率会持续提升。

从 MCP 到一键发包：把 Teambition 评论里的 APK 自动上传 Nexus 的那些坑

yangzun@treesir.pub (Zayn) — Sun, 29 Mar 2026 10:30:00 +0800

这周我被一个很"低级但很费命"的流程折磨了好几次:

每日技术实践简报 - 2026-03-28：从 MCP 到一键 APK 发布的 Skill 封装

yangzun@treesir.pub (Zayn) — Sat, 28 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

Teambition MCP 全链路打通：验证了 BatchGetFileDetails、ListTaskActivitiesV3、PostV3MemberQuery 三个核心 API 的完整调用链路，解决了从任务评论中提取附件信息的需求。
成员 ID 映射机制：建立了项目成员 ObjectId → 真实姓名的映射表（37人），支持"陌生 ID 自动触发全量刷新"的缓存策略，让任务动态终于可读了。
tb-apk-uploader Skill 封装：将"TB附件获取 → 下载 → 重命名 → 上传 Nexus → 返回链接"的完整流程封装为独立 Skill，经 skill-creator 规范优化并打包验证通过。

学到的新东西
#

mcporter 调用参数格式：mcporter call 必须用 --args 传参且包在 requestBody 里，用 --body 会报 SyntaxError。这是踩了一个小时的坑才找到的。
Skill 封装规范：frontmatter description 要包含完整触发词，body 只保留工作流程和脚本用法，不要重复 frontmatter 信息。渐进式披露，核心逻辑在脚本里。
APK 文件名标准化规则：TB 附件下载后经常带 .1 后缀、(1) 括号、E 前缀，需要正则清洗。如 RinoTrack_E4218_3.2.820260326_release(1).apk.1 → RinoTrack_4218_3.2.820260326_release.apk。

实际产出
#

成功上传了两个 APK 到 Nexus（RinoTrack 85MB + 微信 248MB）
自动回复了下载链接到 DO-6456 评论区
tb-apk-uploader Skill 打包为 .skill 文件，可分发复用

踩坑记录
#

mcporter 参数格式：--body → --args + requestBody 包装
Nexus 重复上传：同一文件重复上传返回 HTTP 400，不是错误而是"已存在"，需要正确处理

其他思考
#

骑行语音 AI 助手项目构思（代号备选 CADENCE），核心场景：骑行中记录灵感 + 处理工作任务，已创建滴答清单任务储备。
讨论了 DevOps/SRE 在 AI 时代的转型方向，核心结论：不需要转行，需要在现有方向上叠加 AI 能力。

每日技术实践简报 - 2026-03-27：GPU 分层选型与 OpenClaw 安全基线

yangzun@treesir.pub (Zayn) — Fri, 27 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

GPU 选型与分层规划：明确了 PVE 虚拟化场景下的硬件方案。针对 Creo 5.0 的 3D 图形需求，确定以 GPU Passthrough 为主，建议配置 NVIDIA T1000 8GB 或 RTX A2000，而 Cadence 和 PADS 等 2D/EDA 工具则优先使用 CPU 渲染或基础 VDI。
AirDesk 交付路径收敛：硬件方案从“技术可行性分析”转向“可执行采购口径”。剔除了非必要授权费，成本模型更贴合实际落地场景。

学到的新东西
#

经济型 VDI 策略：在 7-8 人共享场景下，按并发使用 Creo 的人数配置 2-3 张 T1000 比全员配置 vGPU 更经济，规避了高昂的 GRID 许可证成本。
OpenClaw 安全基线：确立了“先读后改”的文件编辑规范，并强化了第三方 Skill 的供应链安全审查流程，自动化运维开始向安全可维护转型。

踩坑记录
#

自动化推送链路稳定性：在实现 AI 论文简报定时推送时，发现 cron + dashboard-pusher 的配合需要更严格的超时处理和环境隔离。

明日计划
#

完成 AirDesk 审批前的最后合规性映射。
优化 RSS 抓取链路的重试机制。

每日技术实践简报 - 2026-03-26

yangzun@treesir.pub (Zayn) — Thu, 26 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

博客元数据标准化：将每日简报的 categories 统一为“实践记录”，优化归档页聚合口径。
Git 提交规范：修正 commit message 格式以通过仓库 hook 检查（使用 chore: 前缀）。

学到的新东西
#

技术工具约束：确认 bird news 命令不支持 --hours 参数。
替代方案：在需要时间窗口过滤时，应通过搜索能力叠加时间参数实现，而非依赖无效的 CLI 原生参数。

踩坑记录
#

Git 提交被拒绝：原因在于 commit message 不符合仓库预设的规范（amend 后成功推送）。
注意事项：发布博客时应遵循“只提交正文文件，不提交 resources/_gen 生成资源”的原则，保持仓库整洁。

明日计划
#

优化 AI 资讯推送的筛选逻辑。
补全本周其余简报的相互内链（推荐阅读）。

每日技术实践简报 - 2026-03-25

yangzun@treesir.pub (Zayn) — Wed, 25 Mar 2026 23:00:00 +0800

今日技术实践
#

解决的问题
#

把分散的 DevOps 反馈从“零散问题”改写为“工程健康治理”视角，先做问题分层，再做治理路线，避免头痛医头式修修补补。
对未解决痛点做了结构化快照，统一了后续追踪入口，减少跨工具来回翻找的时间成本。

学到的新东西
#

当问题长期存在且跨团队反复出现时，最有效的切入点不是继续加临时补丁，而是定义统一指标与优先级，把“处理单点故障”升级为“治理系统性风险”。
轻量任务管理在早期调研阶段很关键：先把研究动作显式化，再逐步补齐验收标准，执行阻力会明显下降。

踩坑记录
#

仅有结论没有上下文时，后续复盘很难复用；因此当天补齐了“问题快照 + 行动项”配对记录，确保后续能直接接力推进。

明日计划
#

继续完善工程健康治理的指标草案（稳定性、交付效率、可观测性）。
将今日痛点快照扩展为可执行清单，补充负责边界与时间窗口。
对研究任务增加阶段性产出定义，确保每次推进都有可验证结果。

把一张 RX 6400 塞进虚拟机：PVE GPU 直通 + Windows Server RDS 部署全记录

yangzun@treesir.pub (Zayn) — Wed, 25 Mar 2026 10:00:00 +0800

一张 x4 通道的入门显卡、一块消费级 B550 主板、一个巨大的 IOMMU 分组 —— 这大概是 GPU 直通最不利的起点。但 ACS Override 改变了游戏规则。

3 行 YAML 接入生产级 GitLab CI/CD：gitlab-ci-templates 实战

yangzun@treesir.pub (Zayn) — Tue, 24 Mar 2026 23:45:00 +0800

来源声明：本文基于开源仓库 cdryzun/gitlab-ci-templates 的 README、目录结构与公开文档整理，重点提炼可直接落地的工程实践。

很多团队在 GitLab CI/CD 上都踩过同一个坑：

每个仓库维护一份独立流水线，重复劳动严重；
语言一多（Java / Node.js / Python / Go），规则开始分裂；
扫描、部署、回滚策略缺少统一治理。

这篇文章的核心目标很明确：用一套可复用模板，把“能跑”升级成“可持续维护”。

一、3 行接入：把流水线从“项目资产”变成“平台能力”
#

最小接入：

每日技术实践简报 - 2026-03-24

yangzun@treesir.pub (Zayn) — Tue, 24 Mar 2026 23:00:00 +0800

今天的重点是把“偶发不响应”从体感问题落到可验证的工程问题上：先处理运行形态冲突，再压低高延迟链路，最后形成可复用的排障路径。

解决的问题
#

插件加载失败从“无法启动”修到“可控禁用”：针对插件依赖 openclaw/plugin-sdk 解析失败和 SDK 版本不兼容的问题，先做了本地兼容修复，再按当前需求将相关插件置为禁用，避免持续影响主链路可用性。
网关偶发不响应定位到运行冲突：通过日志和进程状态确认了“多套守护/重复拉起”带来的端口争用与重启风暴风险，最终收敛为“仅 PM2 单监管器”模式，减少了短时不可用窗口。
记忆检索超时有了明确根因：nmem 超时并非随机波动，而是查询输入过长、结构不佳时触发；同时保留 API fallback 作为兜底，保证主流程不被单点阻塞。

学到的新东西
#

稳定性优化要先做形态治理：先统一进程监管、端口绑定和启动入口，再谈参数调优，收益通常更大。
兼容修复应优先“可回退”：遇到插件与宿主版本错配时，先保证系统整体可运行，再决定是升级、重构还是临时下线。
观测信号比主观感受更关键：重启次数、端口占用、超时日志比“感觉卡顿”更能指导下一步动作。

踩坑记录
#

同一服务被多路径拉起时，问题会被放大成随机故障：看似偶发，实际是运行拓扑不一致导致的不确定性。
把整段上下文直接喂给检索接口会引发超时：检索输入需要短、准、结构化，否则很容易触发 CLI 超时。
插件生态与主程序版本耦合度高：升级或安装插件前，最好先做导出接口和依赖路径核对。

明日计划
#

继续观察 PM2 单监管模式下的错误率与响应时延，确认是否彻底消除重启风暴。
为记忆检索补一层输入裁剪与超时重试策略，减少长查询导致的阻塞。
梳理一份“插件兼容检查清单”，用于后续安装或升级前的快速自检。

OpenClaw 记忆层降级策略：当 Working Memory 不可用时，如何保持稳定输出

yangzun@treesir.pub (Zayn) — Tue, 24 Mar 2026 09:30:00 +0800

很多团队在做 AI Agent 时，最容易忽略的一件事是：记忆系统也会故障。

平时我们都把注意力放在提示词、模型效果、工具编排上，但一旦记忆层出现“半可用”（不是完全挂掉，而是读写行为不稳定），Agent 会很快进入一种尴尬状态：

能跑，但上下文变浅；
能答，但连续性变差；
能写，但沉淀质量下降。

这篇文章不讲概念，直接讲一套能落地的策略：当 Working Memory 不可用时，如何通过分层降级保证业务连续性，并且为后续恢复留出“可回放”的证据链。

1. 问题不是“挂了没”，而是“退化到什么程度还能用”
#

真实线上里，记忆层异常通常分三种：

读失败：拿不到当日焦点与上下文。
写失败：新结论无法写回工作记忆。
部分成功：偶发成功，偶发 JSON 解析错误/超时，最难处理。

第三种最危险。因为它让系统看起来“偶尔正常”，导致团队误判稳定性。

每日技术实践简报 - 2026-03-23

yangzun@treesir.pub (Zayn) — Mon, 23 Mar 2026 23:00:00 +0800

今天的技术工作比较像一次集中收口：一边把几类工程软件的虚拟化路线梳理清楚，一边继续留意自动化链路的稳定性问题，同时也顺手整理了几条对 AI 工具落地很有用的判断。

解决的问题
#

软件虚拟化路线终于从“都研究一下”变成“按场景拆分”：针对不同软件的图形负载和授权约束，今天把结论明确下来。轻量 2D 场景可以优先考虑 RDS 或普通 VDI，重图形建模场景则必须走带 GPU 的 VDI 或远程工作站，避免一开始就把所有软件硬塞进同一套方案里。
EDA 工具的可虚拟化判断更务实了：从技术上看并不是不能跑，而是不能只看“能启动”。授权、图形性能和稳定性验证要先做小范围 PoC，再决定是否上线，不然前期省下来的部署时间，后面会在故障和兼容性上全部还回去。
CI 失败不再当成偶发噪音处理：今天把多仓库持续出现的 lint、测试和数据同步失败看成系统性问题，而不是零散报警。这个视角调整很重要，因为只要把它当成“偶尔红一下”，流水线就会长期处在不可依赖的状态。

学到的新东西
#

虚拟化不是统一平台问题，本质上是工作负载分层问题：同样叫“设计软件”，2D 制图、3D 建模、EDA 仿真对资源的要求完全不是一个量级。与其追求一套方案覆盖全部，不如先按图形强度和授权风险分层，再匹配 RDS、VDI 或远程工作站。
轻量自动化工具已经进入“随手可做”的阶段：今天再次验证了一个趋势——很多运营辅助、校验类、解析类小工具，已经可以用 AI 代码助手在很短时间内做出可执行版本。真正稀缺的不是写代码本身，而是能否把需求边界说清楚。
AI 治理开始从“能不能用”转向“能不能被信任”：对于企业场景来说，后续评估 AI 系统时，身份说明、审计轨迹和责任边界会越来越重要。只有结果，没有可追溯过程的系统，后面会越来越难进入关键流程。

踩坑记录
#

想用共享 RDS 一次性兜住所有工程软件，这条路看起来省事，实际风险很高：一旦把高图形负载和轻量办公型场景混在一起，性能、体验和授权都会互相拖累。
CI 重复失败最怕“看见了，但没升级处理级别”：如果同类错误连续出现，还只是逐次修补单个 job，团队会慢慢失去对流水线结果的信任，后续问题定位成本会越来越高。
低成本维护项最容易被拖延：像版本巡检这种投入不大但能提前发现兼容性问题的任务，如果长期没人接，就会在真正出故障时放大代价。

明日计划
#

把软件虚拟化结论整理成更清晰的选型文档，便于后续验证和落地。
针对近期反复失败的 CI 链路做一次集中排查，优先看 lint 规则、测试稳定性和依赖一致性。
补上自动化工具和关键依赖的版本巡检，避免小问题积累成兼容性故障。

每日技术实践简报 - 2026-03-22

yangzun@treesir.pub (Zayn) — Sun, 22 Mar 2026 23:00:00 +0800

今天的工作重心比较集中，基本都围绕内部平台迭代、AI 能力验证和汇报方式收口这三件事展开。比起堆更多功能，今天更像是在做“把事情做稳、把表达讲清”的整理工作。

解决的问题
#

内部平台迭代开始进入可用性收口阶段：这次重点不只是补功能，而是把代码仓库整理、稳定性修复和大文件上传验证一起补齐。这样做的好处很直接，后面继续加功能时，不会反复被基础问题拖住。
AI 评审服务正式落到业务链路里：今天把评审系统 V2 和 AI 评审服务继续往前推进，同时联动调试了 CI/CD 流水线调度器。相比单点试验，这一步更像是把能力真正接到可运行流程里。

学到的新东西
#

模型验证不能只看参数，要看落地效果：今天对几组模型和方案做了对比，结论不是谁规格更高谁就一定更合适，而是谁在当前任务里输出更稳定、结果更像可交付内容。
技术汇报按业务结果分组，比按模块罗列更清楚：把内容从“做了哪些技术项”改成“稳定性、能力建设、验证结果、问题处理”这类结构后，整体可读性明显更好，也更方便别人快速抓重点。

踩坑记录
#

很多技术内容本身没问题，问题出在表达方式太像模板：如果汇报里全是“优化、提升、赋能”这类词，读起来很顺，但信息密度其实不高。今天比较明确的一点是，汇报更适合直接写动作、结果和当前状态。
验证链路如果没有和真实流程一起调，结论很容易偏乐观：单独测试能跑通，不等于接进平台后也稳定。今天继续调度器和评审链路时，这个感受更明显。

明日计划
#

继续把内部平台剩余的稳定性问题收口，避免后续功能迭代反复返工。
继续完善 AI 评审链路和调度器联动，优先解决真实流程里的边界问题。
继续优化技术汇报结构，尽量让输出更自然、更具体，少一点空话。

每日技术实践简报 - 2026-03-21

yangzun@treesir.pub (Zayn) — Sat, 21 Mar 2026 22:05:00 +0800

今天把注意力放在两个方向：一是让信息流更适合长期使用，二是让自动化系统在扩展时更稳一点。看起来都像工程细节，但本质上都指向同一个问题：系统不是功能越多越好，而是越能长期稳定输出价值越好。

解决的问题
#

长期记忆开始真正做“减法”：这次重点不是继续往记忆系统里加内容，而是清理低价值信息。像占位模板、一次性播报、运行态重复内容、完成通知这类信息，短期看似有用，长期只会污染检索结果。把这些内容清掉之后，后续搜索和回顾都会更干净。
AI 信息流完成结构化收口：原本的信息汇总更像“把看到的东西发出来”，现在开始转向“按决策价值组织内容”。换句话说，不再只追求多，而是更强调什么值得关注、什么值得试、什么值得警惕。

学到的新东西
#

记忆系统的核心不是存储能力，而是筛选能力：真正有价值的长期记忆，通常只来自稳定偏好、关键决策、已验证结论、长期计划、重要事实和可复用流程。其余内容如果没有被压缩成方法论，留着只会变成噪声。
系统稳定性的关键常常不是功能本身，而是边界是否一致：当一个系统开始分层、拆实例、接更多自动化链路后，最容易出问题的往往不是某个单点能力，而是入口、认证、职责划分这些边界没有统一。
新能力接入越克制，长期越稳：相比一上来就做全量接管，先手动使用、局部验证、逐步扩大范围，往往更适合持续运行的环境。

踩坑记录
#

搜索词过长会直接拖垮检索质量：把整段提示词、上下文说明甚至工作区注入内容一起扔进检索，看起来像“信息更全”，实际上更容易造成召回失真甚至超时。检索系统更喜欢短、准、明确的问题。
自动化摘要如果不做过滤，会悄悄把系统变臃肿：成功通知、定时任务运行记录、线程同步信息，这些内容在当下有参考价值，但不适合作为长期知识保留。系统越自动，这类噪声越容易积累。

明日计划
#

继续压缩记忆系统里的边界项和重复主张，让长期记忆更适合检索和复用。
继续完善 AI 信息流的自动化链路，重点补上去重与防重复触发。
继续把正在推进的几个方向往“可持续”上收：不是追求一次做完，而是让系统以后少返工、少回退。

每日技术实践简报 - 2026-03-20

yangzun@treesir.pub (Zayn) — Fri, 20 Mar 2026 22:30:00 +0800

今天的工作更偏向“把系统说明白”。很多时候，工程效率不是来自多写几段代码，而是来自把命名、提醒和选型这些基础问题先梳理清楚。基础一旦清楚，后续很多动作都会顺下来。

解决的问题
#

命名体系开始收口：围绕一套产品命名方式做了结构化梳理，把原本分散的叫法整理成更清晰的层级关系。命名一旦统一，后续无论是归档、映射还是自动识别，成本都会明显下降。
任务提醒链路继续稳定化：同一套提醒机制在不同时间点给出了相对一致的结果，说明这条链路已经不只是“能跑”，而是在向“可依赖”靠近。

学到的新东西
#

好的命名规范本质上是在降低系统沟通成本：如果一套命名只能被少数人理解，它就更像内部黑话；如果它能稳定映射到平台、代际和能力差异，它才真正具备长期价值。
自动化体系成熟的标志不是任务数量，而是分层是否清楚：当提醒、汇总、检测和执行这些能力开始形成稳定分工，系统就会从单点脚本堆叠，演进成更像“运营架构”的东西。
硬件选型最怕脱离使用场景：同样一颗 CPU，在不同任务下价值完全不同。比起盯着参数高低，更重要的是明确自己的主要负载到底是什么。

踩坑记录
#

兼容性问题不能只看理论方案：纸面上可行的硬件方案，落到具体设备时仍然可能受安装位、接口规格和结构差异影响。越接近实体世界，越要尊重“逐项确认”这件事。

明日计划
#

继续把命名规范往后续流程里落，验证它是否真的能减少返工。
继续观察提醒链路在真实使用中的稳定性，而不只停留在单次成功。
继续把技术选择建立在实际使用场景之上，而不是单看参数表。

每日技术实践简报 - 2026-03-19

yangzun@treesir.pub (Zayn) — Thu, 19 Mar 2026 22:30:00 +0800

今天更多是在看“系统什么时候该提醒，什么时候该克制”。一个自动化系统如果只会不停报消息，很快就会让人失去耐心；但如果它什么都不说，又失去了存在意义。真正难的是边界感。

解决的问题
#

告警范围开始更接近真实风险：把关注点从单纯的应用状态，扩展到更广义的自动化运行状态。这样做的意义不在于让告警更多，而在于让真正值得人工介入的问题更早被看见。
异常状态识别更完整了一步：当某些凭证或访问条件失效时，系统不一定能继续判断全部上下文。这提醒我，自动化系统不只是要处理“正常输入”，还要明确面对“信息不完整”的表现方式。

学到的新东西
#

提醒系统的价值来自筛选，而不是频率：如果什么都提醒，提醒就会失去价值。比起频繁轮询，更重要的是找准哪些任务值得优先看、哪些状态只需要留痕不需要打扰。
静默策略是自动化系统成熟的重要标志：很多系统会做“能提醒”，但很少认真做“什么时候不该提醒”。真正长期可用的自动化，必须包含安静时段、节奏边界和打扰成本的设计。

踩坑记录
#

只有告警，没有自愈，系统仍然很脆：能发现问题固然重要，但如果后续没有重试、回退或补救机制，很多告警最终还是只能堆成人工负担。
依赖单点前提的监控很容易出现盲区：一旦某个关键前提失效，系统可能不只是“报错”，而是直接失去判断能力。这类问题往往比普通失败更值得优先补上。

明日计划
#

继续区分“需要提醒”和“只需记录”的事件类型。
评估哪些告警链路值得补自动重试或基础自愈。
继续把监控目标从单点状态扩展到真实可用性。

每日技术实践简报 - 2026-03-18

yangzun@treesir.pub (Zayn) — Wed, 18 Mar 2026 23:00:00 +0800

今天的信息输入比较密集，但真正值得留下来的，不是“看到了多少新东西”，而是几个越来越清楚的趋势：模型在分化，助手在贴近个人场景，工具链则在向更专门化的方向走。

解决的问题
#

信息监控继续维持可用状态：今天的重点不是做大的改动，而是确认几条关键监控链路依旧可靠。对自动化系统来说，稳定地获得输入，往往比增加新能力更重要。
工具版本保持收敛：没有为了追新而升级，而是先确认当前版本是否足够稳定。很多时候，不升级也是一种工程判断。

学到的新东西
#

模型正在明显分化成更细的使用形态：一部分模型继续追求通用能力，另一部分则越来越强调特定任务、特定负载和特定场景的效率。这意味着以后做技术选型，不能再只看“谁最强”，而要看“谁最合适”。
个人助理式 AI 正在更接近真实使用场景：当工具开始更深地理解用户的历史行为、个人上下文和长期偏好时，AI 的角色也会从“回答问题的工具”逐渐走向“持续协作的助手”。
稳定版本的价值经常被低估：如果一个工具当前已经足够稳定、足够满足需求，那么保持版本不乱动，本身就是降低风险的一种方式。

踩坑记录
#

信息监控最容易滑向“信息堆积”：输入越多，越容易把重要和不重要混在一起。系统要真正有价值，核心不是看得多，而是能不能把重点筛出来。

明日计划
#

继续观察模型和工具链的演进方向，重点关注那些真正改变工作方式的变化。
继续收敛监控内容，把注意力集中在少量高价值信号上。
在稳定优先的前提下，再决定哪些工具值得进一步跟进。

每日技术实践简报 - 2026-03-17

yangzun@treesir.pub (Zayn) — Tue, 17 Mar 2026 23:00:00 +0800

今天更像一次“把系统从能用推向稳用”的过程。很多问题表面看是单点故障，但往下挖，会发现真正需要治理的是配置习惯、安全边界和系统默契。

解决的问题
#

索引与可发现性问题得到修复：一项影响内容被发现的能力恢复正常。看起来只是一个结果恢复，但背后真正重要的是验证链路是否重新闭环。
一项平台能力完成阶段性增强：这次推进的重点不在“功能更多”，而在“能力更完整”，包括模型接入、动态配置以及基本的安全防护都往前走了一步。

学到的新东西
#

安全治理最好在系统早期就做进默认动作里：输入校验、认证、输出清洗这类能力，如果一开始没建立边界，后面补起来通常成本更高。
静默策略不是附属规则，而是系统体验的一部分：深夜只做状态检查、不重复提醒，看似只是交互细节，实际上决定了系统是否长期可用。
配置清洁度会直接影响系统稳定性：占位符、硬编码、路径约定这些小问题，平时看不起眼，但往往最容易在后续运维里变成真实故障。

踩坑记录
#

远程依赖的可用性经常卡在认证而不是逻辑：很多“拉不下来”“连不上”的问题，最终都不是代码逻辑本身，而是访问边界没有配置对。

明日计划
#

继续把配置治理、安全边界和运行策略做得更一致。
继续验证恢复后的链路是否稳定，而不是只看一次成功。
继续审查外部依赖的访问前提，减少后续中断。

2026 AI Agent 工程化全景：从框架选型到生产落地

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 14:00:00 +0800

从 7 层架构到框架选型、从多智能体协作到记忆系统、从 Coding Agent 到企业工具链的 AI Agent 2026 工程化实践全景。

PVE 虚拟机启动失败：qcow2 corrupt 标记残留的排查与修复

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 14:00:00 +0800

qcow2 镜像 corrupt 标记残留导致 PVE 虚拟机无法启动，快照回滚也失效。25 分钟内通过分阶段低风险修复恢复，附完整 SOP。

Claude Code + GitLab pr-agent：AI 驱动的持续迭代开发实践

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 13:00:00 +0800

32 个 MR 的真实案例，展示 Claude Code + GitLab CI + pr-agent 三位一体的 AI 驱动持续迭代开发工作流。

从 60 分到 95 分：Hugo Blowfish 博客的极致优化之路

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 12:00:00 +0800

20+ 项优化、16 个 MR、涵盖 SEO 修复、布局重构、苹果代码框、封面图自动化和 SSH 远程部署的完整博客优化复盘。

Blowfish 文章优化前后对比分析

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 02:30:00 +0800

通过 Front Matter、内容结构和 Shortcodes 的具体优化前后对比，直观展示文章质量提升效果。

Blowfish 主题文章优化指南

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 02:00:00 +0800

本文提供全面的 Blowfish 主题文章优化最佳实践，帮助你创建优雅、简洁、结构化、美观、逻辑清晰的技术文档。从 Front Matter 到 Shortcodes，一站式掌握 Blowfish 的正确用法。

Front Matter 优化
#

推荐的完整 Front Matter 模板
#

---
# 基础信息
title: "文章标题"
description: "SEO 友好的简短描述，建议 150-160 字符"
date: 2026-03-16T10:00:00+08:00
lastmod: 2026-03-16T12:00:00+08:00
draft: false

# 分类
tags: ["kubernetes", "devops", "云原生"]
categories: ["技术实践"]
series: ["Kubernetes 进阶"] # 如果属于某个系列
series_order: 1 # 系列中的顺序

# 图片
featureimage: "https://images.unsplash.com/photo-1461749280684-dccba630e2f6?w=1920&h=1080&fit=crop&q=100"
featureimagecaption: "图片说明（可选）"
showHero: true
heroStyle: "background" # basic, big, background, thumbAndBackground

# 显示控制
showDate: true
showDateUpdated: true
showReadingTime: true
showWordCount: true
showTableOfContents: true
showTaxonomies: true
showBreadcrumbs: true
showPagination: true
showZenMode: true

# SEO
robots: "index, follow"
excludeFromSearch: false
---

Front Matter 参数分类
#

必需参数
#

参数	说明	示例
`title`	文章标题	`"Kubernetes 部署指南"`
`description`	SEO 描述	`"从零开始学习 K8s 集群部署"`
`date`	发布日期	`2026-03-16T10:00:00+08:00`
`tags`	标签（数组）	`["kubernetes", "devops"]`

参数	说明	建议值
`showHero`	显示英雄图	`true`
`heroStyle`	英雄图样式	`"background"`
`showTableOfContents`	显示目录	`true`
`showReadingTime`	显示阅读时间	`true`
`showBreadcrumbs`	显示面包屑	`true`
`showZenMode`	显示 Zen 模式	`true`

可选参数
#

参数	说明	使用场景
`lastmod`	最后更新日期	更新文章后
`series`	系列名称	多篇相关文章
`series_order`	系列顺序	系列文章排序
`featureimage`	特性图片	有配图的文章
`robots`	SEO 指令	控制搜索引擎行为

不同类型文章的 Front Matter 建议
#

技术教程
#

---
title: "从零开始部署 Kubernetes 集群"
description: "详细介绍如何在生产环境部署高可用 K8s 集群"
date: 2026-03-16T10:00:00+08:00
tags: ["kubernetes", "devops", "tutorial"]
categories: ["技术教程"]
series: ["Kubernetes 生产实践"]
series_order: 1
showHero: true
heroStyle: "background"
featureimage: "k8s-cluster.jpg"
showTableOfContents: true
showReadingTime: true
---

概念解析
#

---
title: "深入理解 Kubernetes 架构"
description: "解析 K8s 核心组件和设计理念"
date: 2026-03-16T10:00:00+08:00
tags: ["kubernetes", "architecture"]
categories: ["技术概念"]
showHero: true
heroStyle: "basic"
showTableOfContents: true
showReadingTime: true
---

实战案例
#

---
title: "K8s 故障排查：Pod 一直处于 CrashLoopBackOff"
description: "记录一次完整的 K8s 故障排查过程"
date: 2026-03-16T10:00:00+08:00
lastmod: 2026-03-16T12:00:00+08:00
tags: ["kubernetes", "troubleshooting", "case-study"]
categories: ["故障排查"]
showHero: true
heroStyle: "background"
featureimage: "debugging.jpg"
showDateUpdated: true
showTableOfContents: true
---

内容结构最佳实践
#

1. 使用 Lead 引言
#

在文章开头使用 lead 突出核心内容：

{{< lead >}}
从零开始学习 Kubernetes 集群部署，涵盖环境准备、集群初始化、
网络配置到生产就绪的完整流程。
{{< /lead >}}

2. 结构化标题层级
#

# 主标题（H1，自动由 title 生成）

{{< lead >}}
引言内容
{{< /lead >}}

## 第一部分（H2）

### 子章节 1.1（H3）

#### 细节说明（H4）

### 子章节 1.2（H3）

## 第二部分（H2）

标题建议：H2 用于主要章节，H3 用于子章节，H4 用于细节说明，避免超过 4 级标题。

3. 使用表格对比信息
#

| 特性 | Docker | Kubernetes |
|------|--------|-----------|
| 容器编排 | 单机 | 集群级别 |
| 服务发现 | 手动配置 | 自动发现 |
| 负载均衡 | 需要额外工具 | 内置支持 |

4. 代码块语法高亮
#

支持的语言：bash, yaml, json, go, python, javascript, typescript, dockerfile, nginx 等。

5. 使用 Callout 提示重要信息
#

{{< alert icon="triangle-exclamation" >}}
**警告**：此操作不可逆，请先备份数据！
{{< /alert >}}

{{< alert icon="check-circle" cardColor="#10b981" iconColor="#fff" textColor="#fff" >}}
**最佳实践**：使用 Helm 管理应用配置。
{{< /alert >}}

Shortcodes 使用指南
#

1. Mermaid 流程图
#

替代 ASCII 字符画，使用 Mermaid 绘制流程图：

{{< mermaid >}}
graph TB
 A[开始部署] --> B{环境检查}
 B -->|通过| C[安装 Docker]
 B -->|失败| D[修复环境]
 D --> B
 C --> E[初始化集群]
 E --> F[部署网络插件]
 F --> G[验证集群]
{{< /mermaid >}}

常见图表类型：

流程图 graph TD - 决策流程、部署步骤
时序图 sequenceDiagram - API 调用、组件交互
架构图 graph TB + subgraph - 系统架构

2. Figure 增强图片
#

{{< figure
 src="architecture.png"
 alt="Kubernetes 架构图"
 caption="图 1：Kubernetes 集群架构"
 href="https://kubernetes.io"
 target="_blank"
>}}

3. Button 行动按钮
#

{{< button href="https://github.com" target="_blank" >}}
查看源码
{{< /button >}}

4. Badge 标签
#

{{< badge >}}New{{< /badge >}}
{{< badge style="warning" >}}Deprecated{{< /badge >}}

5. Timeline 时间线
#

{{< timeline >}}
{{< timelineItem icon="check" header="第一步" subheader="2026-03-01" >}}
项目启动
{{< /timelineItem >}}
{{< timelineItem icon="check" header="第二步" subheader="2026-03-10" >}}
完成开发
{{< /timelineItem >}}
{{< /timeline >}}

6. KaTeX 数学公式
#

<!-- 行内公式 -->
{{< katex >}}a^2 + b^2 = c^2{{< /katex >}}

<!-- 块级公式 -->
{{< katex display="true" >}}
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
{{< /katex >}}

实战优化示例
#

技术教程优化
#

优化前：

---
title: "Traefik 部署"
date: 2021-01-17
tags: ["traefik"]
---

# Traefik 简介

Traefik 是一个反向代理...

## 安装

kubectl apply -f traefik.yaml

优化后：

---
title: "Traefik Ingress Controller 完整部署指南"
description: "从零开始学习 Traefik：详细介绍如何在 Kubernetes 中部署和配置 Traefik Ingress Controller"
date: 2021-01-17T16:15:32+08:00
lastmod: 2026-03-16T10:00:00+08:00
tags: ["traefik", "ingress", "kubernetes"]
categories: ["网络", "Kubernetes"]
series: ["Kubernetes 网络实践"]
series_order: 2
featureimage: "traefik-architecture.png"
showHero: true
heroStyle: "background"
showTableOfContents: true
showReadingTime: true
showDateUpdated: true
---

优化后的内容结构：

{{< lead >}}
Traefik 是现代化的云原生反向代理和负载均衡器，
专为微服务架构设计。本指南将带你从零开始掌握 Traefik 的部署和配置。
{{< /lead >}}

## Traefik 核心优势

| 特性 | 传统代理 | Traefik |
|------|----------|---------|
| 配置方式 | 手动编辑 | 自动发现 |
| 配置更新 | 需要重启 | 动态实时更新 |
| 容器支持 | 需要额外配置 | 原生支持 |

## 架构概览

{{< mermaid >}}
graph TB
 Client[客户端] --> Traefik
 Traefik --> Service1[服务 A]
 Traefik --> Service2[服务 B]
 Traefik --> Service3[服务 C]
 subgraph Kubernetes
 Service1
 Service2
 Service3
 end
{{< /mermaid >}}

## 部署方式

### 使用 Helm 部署

```bash
helm repo add traefik https://traefik.github.io/charts
helm install traefik traefik/traefik \
 --namespace traefik \
 --create-namespace
```

### 使用 kubectl 部署

```bash
kubectl apply -f https://raw.githubusercontent.com/.../kubernetes-crd-rbac.yml
```

{{< alert icon="triangle-exclamation" >}}
**注意**：生产环境建议配置持久化存储和 RBAC 权限。
{{< /alert >}}

架构文档优化
#

优化前：

---
title: "OpenClaw 架构"
date: 2026-03-15
---

优化后：

---
title: "OpenClaw AI Agent 架构解析：多引擎联动与记忆系统"
description: "深入解析 OpenClaw AI Agent 的核心架构设计，包括多 AI 引擎联动、Skills 系统和 MCP 集成"
date: 2026-03-15T22:30:00+08:00
tags: ["AI", "Agent", "OpenClaw", "Architecture"]
categories: ["系统架构"]
series: ["OpenClaw 技术解析"]
series_order: 1
showHero: true
heroStyle: "background"
showTableOfContents: true
showReadingTime: true
showZenMode: true
---

优化后的内容结构：

{{< lead >}}
OpenClaw 是一个现代化的 AI Agent 框架，支持多引擎联动、技能系统和记忆管理。
本文将深入解析其核心架构设计。
{{< /lead >}}

## 核心架构

{{< mermaid >}}
graph TB
 subgraph Agent["OpenClaw Agent"]
 Claude["Claude Sonnet 4.6"]
 GPT["GPT-5.2/5.3"]
 end
 subgraph Router["Model Router"]
 Route["路由层"]
 end
 Claude --> Route
 GPT --> Route
 Route --> Skills["Skills Layer"]
 Skills --> MCP["MCP Layer"]
{{< /mermaid >}}

### 核心组件说明

| 组件 | 职责 | 技术栈 |
|------|------|--------|
| **Agent 层** | AI 模型集成 | Claude, GPT, GLM, Gemini |
| **Router 层** | 智能路由分发 | 自定义路由规则 |
| **Skills 层** | 技能系统 | 90+ 预置技能 |
| **MCP 层** | 外部集成 | Teambition, Nowledge Mem |

{{< alert icon="triangle-exclamation" >}}
**重要**：Working Memory 每日自动清理，
重要信息需要手动归档到 Long-term Memory。
{{< /alert >}}

常见问题
#

如何选择 heroStyle？
#

heroStyle	适用场景	特点
`basic`	简单文章	小图片，简洁
`big`	重要文章	大图片，突出
`background`	推荐	全屏背景，现代感
`thumbAndBackground`	双图需求	缩略图+背景

大多数文章推荐使用 background。

何时使用 Mermaid？
#

适用场景：流程图、时序图、架构图、状态转换图、甘特图。

不适用场景：简单的 2-3 步流程（用列表即可）、需要精细控制的图形（用图片）。

如何优化图片？
#

使用 WebP 格式（Hugo 自动转换）
提供不同尺寸（响应式）
添加 alt 文本（SEO）
使用 caption 说明

如何组织系列文章？
#

规划系列名称和顺序
每篇文章添加 series 和 series_order
第一篇设置 seriesOpened: true

---
series: ["Kubernetes 进阶"]
series_order: 1
seriesOpened: true
---

性能优化建议
#

构建优化：启用图片优化（默认开启）、使用 CDN 加速、减少不必要的 shortcodes。

内容优化：合理使用 Mermaid（避免过多）、图片压缩后再上传、使用 `

每日技术实践简报 - 2026-03-15

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 23:30:00 +0800

今天做的事情很多，但核心其实只有一个：把原本零散的博客发布动作，逐步收成一条更稳定的自动化链路。做这类系统时，最耗时间的往往不是“功能写出来”，而是把那些看似不起眼的前提条件一个个踩实。

解决的问题
#

自动化任务的执行前提被补齐：一些之前容易被忽略的必要参数和调用约束，这次都被重新确认并纳入固定流程。很多自动化任务不是逻辑错，而是前提没说清。
博客渲染规则得到统一：围绕图表渲染、正文写法和页面配置，把容易反复踩坑的地方都做了规范化处理。统一写法的价值，不是好看，而是避免下次再被同一类问题绊住。
重复发布风险开始被正视：内容自动生成一旦没有前置检查，很容易把同一主题发成多个版本。与其事后清理，不如在发布前就建立一层重复检查。

学到的新东西
#

自动化系统最重要的是“前提显式化”：什么字段必须有、什么格式必须对、什么配置必须先开，这些条件如果只存在脑子里，系统迟早会在别的时间点再坏一次。
内容系统也需要工程治理：博客表面上是内容输出，但一旦接入自动生成、渲染和发布流程，它本质上就是一套工程系统，同样需要规范、去重和失败兜底。
好的技能不是功能更多，而是更少重复踩坑：当一个技能把超时、重试、格式约束和重复检查都处理好之后，它才算真正变得“能长期用”。

踩坑记录
#

看似很小的格式问题，会一路放大成发布故障：文件命名、大小写、图表写法、正文转义这些细节，只要有一个没处理好，就可能让后面的渲染或发布全部出问题。
发布前不做去重，后面就要花更多时间清理：自动化一旦缺少“停止条件”，它就会用极高效率把重复问题放大。

明日计划
#

继续补强博客自动化链路的前置检查与失败兜底。
继续把容易重复踩的格式和配置问题收敛成固定规范。
继续观察内容生成与发布流程是否真正具备长期稳定性。

OpenClaw Skills Registry 安全架构与企业级实践指南

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 22:45:00 +0800

OpenClaw Skills Registry 安全架构与企业级实践指南
#

Author: Negentropy Updated: 2026-03-15

This document is based on Alibaba Cloud Community

目录
#

0. 问题背景与动机
1. 安全风险分析
2. 企业级解决方案
3. Nacos 3.2 Skills Registry
4. OpenClaw 集成实践
5. 部署流程
6. 安全最佳实践
7. 对比与选型
8. 故障排查
9. 资源链接

0. 问题背景与动机
#

0.1 为什么需要 Skills Registry?
#

OpenClaw 的 Skills 生态系统正在快速发展，ClawHub 上已有超过 10,000 个技能包。但这种开放生态也带来了安全挑战。

OpenClaw AI Agent 架构解析：多引擎联动与记忆系统

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 22:30:00 +0800

OpenClaw AI Agent 架构解析
#

核心架构
#

graph TB
subgraph Agent["OpenClaw Agent"]
Claude["Claude Sonnet 4.6"]
GPT["GPT-5.2/5.3"]
GLM["GLM-5"]
Gemini["Gemini Pro"]
end
subgraph Router["Model Router"]
Route["路由层"]
end
subgraph Skills["Skills Layer"]
Blog["blog-post-generator"]
Daily["daily-blog-generator"]
Code["coding-agent"]
Others["90+ skills..."]
end
subgraph MCP["MCP Layer"]
Team["Teambition MCP"]
NMem["Nowledge Mem MCP"]
Other["其他 MCP..."]
end
Claude --> Route
GPT --> Route
GLM --> Route
Gemini --> Route
Route --> Skills
Skills --> MCP

1. 多 AI 引擎联动
#

模型配置
#

{
 "providers": {
 "anthropic-local": {
 "models": ["claude-sonnet-4-6"]
 },
 "openai-codex": {
 "models": ["gpt-5.2", "gpt-5.3-codex"]
 },
 "zai": {
 "models": ["glm-5"]
 }
 }
}

路由策略
#

flowchart LR
A[任务类型] --> B{判断}
B -->|日常对话| C[Claude Sonnet 4.6]
B -->|代码生成| D[GPT-5.3-Codex]
B -->|复杂推理| E[GPT-5.4]
B -->|中文任务| F[GLM-5]

任务类型	推荐模型	原因
日常对话	Claude Sonnet 4.6	成本低、速度快
代码生成	GPT-5.3-Codex	代码能力强
复杂推理	GPT-5.4	推理能力最强
中文任务	GLM-5	中文理解好

Sub-Agent 编排
#

graph LR
Main[主 Agent
Claude Sonnet 4.6] --> S1[Sub-Agent 1
GPT-5.2 搜索总结]
Main --> S2[Sub-Agent 2
Claude 文档处理]
Main --> S3[Sub-Agent 3
GPT-5.3 代码审查]

2. 记忆系统
#

架构图
#

graph TB
subgraph Memory["记忆系统"]
WM["Working Memory
(工作记忆)"]
NM["Nowledge Mem
(知识图谱)"]
LT["MEMORY.md
(长期记忆)"]
TL["Timeline
(时间线)"]
end
WM <--> NM
NM --> TL
NM --> LT
Session[每次对话] --> WM
Session --> NM

三层记忆
#

flowchart TD
A[对话启动] --> B[Working Memory
当日焦点]
A --> C[相关记忆
语义搜索]
A --> D[Timeline
最近活动]
B --> E[构建上下文]
C --> E
D --> E
E --> F[Agent 响应]

层级	存储	用途
Working Memory	Nowledge Mem	当日焦点、优先事项
Long-term Memory	MEMORY.md	持久化记忆、偏好
Timeline	Nowledge Mem	活动历史、事件记录

3. 定时任务系统
#

Cron 配置
#

{
 "name": "每日博客简报生成",
 "schedule": { "kind": "cron", "expr": "0 23 * * *" },
 "payload": {
 "kind": "agentTurn",
 "message": "执行 daily-blog-generator skill",
 "model": "anthropic-local/claude-sonnet-4-6"
 },
 "sessionTarget": "isolated"
}

任务类型
#

flowchart LR
A[Cron 任务] --> B{类型}
B -->|systemEvent| C[注入系统事件
无需 model]
B -->|agentTurn| D[隔离会话执行
需要 model]

4. Skills 体系
#

目录结构
#

~/.agents/skills/
├── blog-post-generator/
│ └── SKILL.md
├── daily-blog-generator/
│ └── SKILL.md
├── coding-agent/
│ └── SKILL.md
└── ... 90+ skills

Skill 触发流程
#

sequenceDiagram
participant U as 用户
participant A as Agent
participant S as Skill
participant B as 博客
U->>A: 随机找一篇上传 blog
A->>S: 匹配 blog-post-generator
S->>S: 1. 从远程仓库获取文档
S->>S: 2. 检查博客已有内容
S->>S: 3. 优化文风
S->>B: 4. 发布到博客
B-->>U: 发布成功

5. 最佳实践
#

模型选择流程
#

flowchart TD
A[任务] --> B{复杂度}
B -->|简单| C[Claude Sonnet 4.6
省钱]
B -->|复杂| D{类型}
D -->|代码| E[GPT-5.3-Codex]
D -->|推理| F[GPT-5.4]
D -->|中文| G[GLM-5]

配置规范
#

✅ 模型名必须写完整：anthropic-local/claude-sonnet-4-6
✅ 路径必须用绝对路径
✅ agentTurn 任务必须带 model 字段

避坑指南
#

graph LR
A[问题] --> B{诊断}
B -->|模型回退失败| C[检查 fallback provider]
B -->|Cron 不执行| D[检查 model 字段]
B -->|Skills 加载不到| E[检查绝对路径]

问题	原因	解决方案
模型回退失败	fallback 模型的 provider 未配置	检查 providers 配置
Cron 任务不执行	缺少 model 字段	agentTurn 必须带 model
Skills 加载不到	路径用相对路径	本机必须用绝对路径

这套架构运行稳定，每天自动生成博客简报，任务管理效率提升 49%。

每周技术实践总结 - 2026 年第 11 周

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 22:30:00 +0800

这周做的事情表面上很散：任务管理、博客自动化、记忆系统、监控恢复、工具选型、系统排障。但回头看，真正贯穿整周的其实是同一个问题：怎么把一个越来越复杂的系统，慢慢收成一个长期可用的系统。

我现在越来越相信，很多工程工作最值钱的部分，不是“又接了一个新能力”，而是把那些已经存在的东西收干净、讲清楚、跑稳定。

这一周真正推进的几件事
#

1. 自动化开始从“能跑”变成“有层次”
#

这周一个明显变化是，很多原本孤立的自动化动作，开始不再像散落的脚本，而更像有分工的系统。

当 AI Agent 遇上运维自动化：我的实践踩坑之路

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 22:05:00 +0800

当 AI Agent 遇上运维自动化：我的实践踩坑之路
#

花了几天把 AI Agent 集成到日常运维里，踩了不少坑，记录下来供参考。

1. 为什么要用 AI Agent
#

简单说就是：太累了。

OpenClaw 配置踩坑记：那些差点把我送走的问题

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 21:58:00 +0800

OpenClaw 配置踩坑记：那些差点把我送走的问题
#

踩了整整两天，记录下来希望别再踩第二次。

1. 模型配置那些破事
#

1.1 模型名写错了
#

写配置的时候顺手就写：

字节 Coze 平台实战：从零搭建 AI 智能体

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 21:42:00 +0800

字节 Coze 平台实战：从零搭建 AI 智能体
#

踩过不少坑，花了不少时间，终于把 Coze 这套东西摸透了。本文不整虚的，直接上干货。

1. 先说说为什么选 Coze
#

市面上 AI 应用开发平台不少，Coze 几个点比较实在：

Istio in Action 学习笔记

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 21:24:00 +0800

Istio in Action 学习笔记
#

Istio 是当下最流行的 Service Mesh（服务网格）方案之一，本文是学习《Istio in Action》书籍的详细笔记，涵盖从入门到进阶的核心知识点。

1. Istio 解决的问题
#

在微服务架构中，网络问题往往是最大的挑战之一：

Docker 常用命令速查手册

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 18:30:00 +0800

前言
#

Docker 是现代 DevOps 工作流中不可或缺的容器化工具。本文整理了日常工作中最常用的 Docker 命令，方便快速查阅。

镜像管理
#

查看镜像
#

docker images
docker image ls

搜索镜像
#

docker search nginx

拉取镜像
#

docker pull nginx:latest
docker pull nginx:1.21

删除镜像
#

docker rmi nginx:latest
docker rmi $(docker images -q) # 删除所有镜像

导出/导入镜像
#

docker save -o nginx.tar nginx:latest
docker load -i nginx.tar

容器管理
#

查看容器
#

docker ps # 查看运行中的容器
docker ps -a # 查看所有容器
docker container ls # 同 docker ps

创建并启动容器
#

docker run -d --name nginx -p 80:80 nginx:latest
docker run -it --name centos centos:7 /bin/bash

启动/停止/重启容器
#

docker start nginx
docker stop nginx
docker restart nginx

进入容器
#

docker exec -it nginx /bin/bash
docker attach nginx

查看容器日志
#

docker logs nginx
docker logs -f nginx # 实时查看
docker logs --tail 100 nginx # 查看最后100行

查看容器详情
#

docker inspect nginx

查看容器资源使用
#

docker stats
docker stats nginx

删除容器
#

docker rm nginx
docker rm -f nginx # 强制删除运行中的容器
docker rm $(docker ps -aq) # 删除所有容器

数据卷管理
#

创建数据卷
#

docker volume create mydata

查看数据卷
#

docker volume ls
docker volume inspect mydata

删除数据卷
#

docker volume rm mydata
docker volume prune # 删除未使用的数据卷

挂载数据卷
#

docker run -d -v mydata:/data nginx
docker run -d -v /host/path:/container/path nginx

网络管理
#

查看网络
#

docker network ls
docker network inspect bridge

创建网络
#

docker network create mynet
docker network create --driver bridge mynet

连接容器到网络
#

docker network connect mynet nginx

断开容器网络
#

docker network disconnect mynet nginx

删除网络
#

docker network rm mynet

系统清理
#

清理退出状态的容器
#

docker rm $(docker container ls -f "status=exited" -q)

清理未使用的镜像
#

docker image prune
docker image prune -a # 删除所有未使用的镜像

一键清理
#

docker system prune
docker system prune -a # 包括镜像
docker system prune --volumes # 包括数据卷

Dockerfile 构建
#

构建镜像
#

docker build -t myimage:v1 .
docker build -t myimage:v1 -f Dockerfile.custom .

Dockerfile 示例
#

FROM centos:7

LABEL maintainer="admin@example.com"

RUN yum install -y vim \
 && yum clean all

COPY app.py /app/

WORKDIR /app

EXPOSE 8080

CMD ["python", "app.py"]

容器转镜像（不推荐）
#

docker commit container_name image_name

注意：不推荐使用 commit 创建镜像。建议使用 Dockerfile 构建镜像，因为 commit 创建的镜像不可复现。

代码展示：苹果窗口风格代码框

yangzun@treesir.pub (Zayn) — Sat, 02 Aug 2025 17:20:00 +0800

查看我们全新的苹果窗口风格代码框，支持多种编程语言和复制功能。

欢迎来到我的博客！

yangzun@treesir.pub (Zayn) — Thu, 02 Jan 2025 10:00:00 +0800

我很兴奋地推出这个使用 Hugo 和令人惊叹的 Blowfish 主题构建的新博客！

为什么选择 Hugo 和 Blowfish？
#

在研究了各种博客平台和静态网站生成器后，我选择 Hugo 有以下几个原因：

Hugo 的优势
#

闪电般快速: Hugo 是最快的静态网站生成器之一
灵活性: 支持各种内容类型和自定义选项
SEO 友好: 内置 SEO 优化功能
Markdown 支持: 使用简单易读的 Markdown 编写内容

Blowfish 主题特色
#

精美设计: 简洁、现代、专业的外观
响应式: 在桌面、平板和移动设备上都表现出色
多种布局: 可选择各种首页和内容布局
配色方案: 多种内置配色方案
丰富功能: 支持评论、分析、社交分享等功能

接下来会写什么？
#

我计划写关于以下主题的内容：

Hugo 入门：初学者指南

yangzun@treesir.pub (Zayn) — Wed, 01 Jan 2025 15:30:00 +0800

Hugo 是最受欢迎的静态网站生成器之一，以其速度和灵活性而闻名。在本指南中，我们将介绍开始使用 Hugo 所需了解的一切。

什么是 Hugo？
#

Hugo 是一个用 Go 语言编写的快速现代静态网站生成器。它将你用 Markdown 编写的内容转换为包含 HTML、CSS 和 JavaScript 的完整网站。

Python DevOps 完整实战指南

yangzun@treesir.pub (Zayn) — Thu, 05 Oct 2023 20:40:24 +0800

Python 在 DevOps 领域扮演着重要角色，其简洁的语法、丰富的生态系统和强大的自动化能力使其成为运维自动化的首选语言。本指南将从 DevOps 理念开始，逐步深入到 Python 在各个 DevOps 场景中的实际应用，帮助您构建高效的自动化运维体系。

图：《Python for DevOps: Learn Ruthlessly Effective Automation》

DevOps 理念与文化
#

什么是 DevOps
#

DevOps 是一种文化、实践和工具的组合，旨在提高组织快速交付应用程序和服务的能力。它强调开发（Development）和运维（Operations）团队之间的协作与沟通。

SlimToolkit 与 GitLab CI/CD 集成实践

yangzun@treesir.pub (Zayn) — Thu, 05 Oct 2023 16:53:53 +0800

工具介绍
#

SlimToolkit 概述
#

SlimToolkit（原名 DockerSlim）是一个强大的开源工具，专门用于优化 Docker 容器镜像的大小、启动速度和安全性。

PVE AutoSnap 自动快照工具使用指南

yangzun@treesir.pub (Zayn) — Thu, 05 Oct 2023 16:40:38 +0800

工具简介
#

PVE AutoSnap 是一个用于 Proxmox VE 环境的自动快照管理工具，可以自动创建、管理和清理虚拟机快照。

项目地址：cv4pve-autosnap
主要功能：自动创建虚拟机快照、设置保留策略、批量管理多个虚拟机

安装配置
#

下载并安装工具
#

# 下载最新版本
wget https://github.com/Corsinvest/cv4pve-autosnap/releases/download/v1.14.8/cv4pve-autosnap-linux-x64.zip

# 解压文件
unzip cv4pve-autosnap-linux-x64.zip

# 移动到系统路径
mv cv4pve-autosnap /usr/bin/

# 设置执行权限
chmod a+x /usr/bin/cv4pve-autosnap

注意：请根据需要选择合适的版本，最新版本信息可查看 GitHub Releases

使用 Grafana Loki 构建网站访问统计分析系统

yangzun@treesir.pub (Zayn) — Sat, 29 Jul 2023 16:54:09 +0800

在网站运营过程中，访问数据分析是了解用户行为和优化网站性能的重要手段。本文将分享如何使用 Grafana Loki 构建一个轻量级且功能强大的网站访问统计分析系统。

项目背景
#

现有方案的局限性
#

在寻找网站统计解决方案的过程中，传统的统计工具存在一些局限性：

Gitea Actions ActRunner 基于 Systemd 部署安装

yangzun@treesir.pub (Zayn) — Tue, 25 Jul 2023 22:06:35 +0800

说明
#

Gitea是一个开源的自助式Git服务，用于托管和管理Git仓库。它是一个轻量级且易于安装和使用的解决方案，类似于GitHub或GitLab，可以在私有服务器上搭建自己的Git仓库服务。Gitea提供了一系列功能，使团队或个人能够方便地进行版本控制和协作开发，包括：

仓库管理：可以创建、克隆、推送和拉取Git仓库，管理分支和标签，查看提交历史和代码差异等操作。

用户和权限管理：可以创建用户账号，管理用户的访问权限，并为不同的用户或团队分配不同的角色和权限，以控制仓库的访问和操作。

问题追踪：提供了一个问题追踪系统，用户可以创建和管理问题、缺陷或需求，并与仓库的代码和提交相关联，方便团队进行协作和解决问题。

Pull请求：支持Pull请求（合并请求），允许用户在不直接修改主分支的情况下，通过提出Pull请求来建议将自己的代码合并到项目中。

代码审查：Gitea提供了代码审查功能，可以让团队成员对提交的代码进行审查、讨论和评论，以提高代码质量和团队协作。

集成与插件：Gitea支持与其他工具和服务的集成，如邮件通知、CI/CD工具和第三方插件等。

Gitea 从 1.19 开始支持 Actions，使用前提需要像 GitlabRunner 一样部署一个独立的 Runner 来管理 Job，名叫 ActRunner，具体可参考文档:

Sonatype Nexus Repository（Nexus3）私服文件下载至本地 - (使用进阶篇一)

yangzun@treesir.pub (Zayn) — Tue, 25 Jul 2023 20:47:22 +0800

说明
#

Sonatype Nexus Repository 是什么？
#

Sonatype Nexus Repository 是一个用于管理和分发软件组件的开源仓库管理系统。它提供了一个集中化的平台，使开发人员能够有效地存储、共享和发布各种类型的软件包。Nexus Repository 支持多种主流技术栈，并具有强大的安全性和可扩展性。通过使用 Sonatype Nexus Repository，团队可以更好地控制其软件构建过程，并确保高质量和稳定性的交付。 by ChatCPT

Nexus3 私服文件下载至本地的用途是什么？
#

比如我们要将 Nexus3 私服中的依赖包制品，进行迁移，因 Nexus3 基于 BlobStore 技术实现对文件的落盘存储，无法在对应节点中直接看到制品文件，此时则需要通过一些手段进行转换取出，虽然可以通过网页一个一个点击下载，但如果下载制品数量过多，则不会是个过于明智的选择。迁移的场景也有很多种，如:

迁移至其他实例，或离线环境

需要更换到其他类型的存储库如: JFrog

文件下载至本地
#

下面所展示的方法，使用到了 Nexus3 的API 进行实现，具体可参考如下文档：

使用 Kubernetes CronJob 自动备份 MySQL 数据到 MinIO

yangzun@treesir.pub (Zayn) — Mon, 24 Jul 2023 16:14:42 +0800

随着 Kubernetes 在生产环境中的广泛应用，越来越多的有状态应用（如 MySQL 数据库）也开始部署在 K8s 集群中。数据安全是生产环境的重中之重，本文将详细介绍如何使用 Kubernetes CronJob 实现 MySQL 数据库的自动化备份，并将备份文件安全地存储到 MinIO 对象存储中。

方案概述
#

备份架构
#

flowchart LR
MySQL[MySQL Pod
Database] -->|导出数据| CronJob[CronJob Pod
mysqldump]
CronJob -->|上传备份| MinIO[MinIO Server
Bucket]

方案优势
#

自动化: 使用 CronJob 实现定时自动备份，无需人工干预
可靠性: 备份文件存储在独立的对象存储中，提高数据安全性
可扩展: 支持多数据库实例的备份，易于扩展
监控友好: 可以通过 Kubernetes 原生监控查看备份任务状态
成本效益: 使用开源的 MinIO 作为存储后端，降低成本

环境准备
#

前置条件
#

组件	版本要求	说明
Kubernetes	v1.18+	支持 CronJob v1 API
MySQL	5.7+ / 8.0+	运行在 K8s 集群中
MinIO	任意版本	对象存储服务
网络连通性	-	CronJob Pod 能访问 MySQL 和 MinIO

自定义镜像
#

本方案使用了专门构建的备份镜像，包含了 mysqldump 和 MinIO 客户端工具。

Linux LVM 分区扩容完整指南

yangzun@treesir.pub (Zayn) — Mon, 24 Jul 2023 14:56:12 +0800

LVM 概述
#

什么是 LVM
#

LVM（Logical Volume Manager）是 Linux 系统中的逻辑卷管理器，它在物理存储设备之上提供了一个抽象层，使得存储管理更加灵活和动态。

Argocd Cli Usage Tips

yangzun@treesir.pub (Zayn) — Mon, 24 Jul 2023 14:19:17 +0800

说明
#

此篇文档，用于记录在使用 ArgoCD CLi 的过程中，所使用到的一些常用命令，且供参考。

使用记录
#

ArgoCD cli 安装文档，使用前，配置登录

修复 SSH 免密无法连接

yangzun@treesir.pub (Zayn) — Mon, 24 Jul 2023 14:01:29 +0800

说明
#

我们通常在远程连接目标服务器时，已避免经常性的输入密码，通常会通过 免密钥 的方式以解决每次连接多需要输入密码问题，但有的时候我们配置免密钥后，却未能生效，可以尝试使用下述方法进行解决。

SSH 免密钥方式
#

生成 SSH 公私钥

Git 版本控制完整实战指南

yangzun@treesir.pub (Zayn) — Fri, 23 Jun 2023 17:07:38 +0800

Git 是现代软件开发中不可或缺的分布式版本控制系统，它不仅能够追踪代码变更历史，还能支持复杂的团队协作和分支管理。本指南将从基础概念开始，逐步深入到高级技巧，帮助您全面掌握 Git 的使用。

Git 基础概念
#

什么是 Git
#

Git 是由 Linux 之父 Linus Torvalds 创建的分布式版本控制系统，具有以下特点：

NaiveProxy

yangzun@treesir.pub (Zayn) — Sun, 11 Dec 2022 15:47:03 +0800

说明
#

懂的自然懂，直接上文档。

Caddy 编译安装

wget https://go.dev/dl/go1.19.linux-arm64.tar.gz

tar -zxvf go1.19.linux-arm64.tar.gz -C /usr/local/


cat >> /etc/profile << EOF
GO_HOME=/usr/local/go
export PATH=\$PATH:\$GO_HOME/bin/:/root/go/bin
EOF

source /etc/profile


go install github.com/caddyserver/xcaddy/cmd/xcaddy@latest


xcaddy build --with github.com/caddyserver/forwardproxy@caddy2=github.com/klzgrad/forwardproxy@naive

mv caddy /usr/local/bin/caddy

mkdir /etc/caddy

Caddyfile 配置文件创建

Shell 脚本编程完整实战指南

yangzun@treesir.pub (Zayn) — Fri, 02 Dec 2022 15:12:34 +0800

Shell 是 Linux/Unix 系统的核心组件，既是命令行解释器，也是强大的脚本编程语言。掌握 Shell 编程对于系统管理员、运维工程师和开发者来说至关重要。本指南将从基础概念开始，逐步深入到高级应用，帮助您全面掌握 Shell 的使用技巧。

Shell 基础概念
#

什么是 Shell
#

Shell 是用户与 Linux 内核交互的接口，它具有以下特点：

Go 语言完整实战指南

yangzun@treesir.pub (Zayn) — Fri, 02 Dec 2022 14:58:28 +0800

Go 语言是 Google 开发的现代编程语言，专为构建简单、可靠、高效的软件而设计。本指南将从基础概念开始，逐步深入到高级特性和实际应用，帮助您全面掌握 Go 语言的开发技能。

Go 语言概述
#

什么是 Go
#

Go（也称为 Golang）是一种开源的编程语言，由 Google 在 2009 年发布。它具有以下核心特性：

Rke 集群集成 Kube-Vip 实现 Loadbalance Service 资源的使用

yangzun@treesir.pub (Zayn) — Tue, 12 Oct 2021 13:44:45 +0800

背景
#

Kube-Vip 最初是为 Kubernetes 控制平面提供 HA 解决方案而创建的，随着时间的推移，它已经发展为将相同的功能合并到 Kubernetes 的 LoadBalancer 类型的 Service 中。Kube-Vip 特点 如下：

VIP 地址可以是 IPv4 或 IPv6

带有 ARP（第2层）或 BGP（第3层）的控制平面

使用领导选举或 raft 控制平面

带有 kubeadm（静态 Pod）的控制平面 HA

带有 K3s/和其他（DaemonSets）的控制平面 HA

使用 ARP 领导者选举的 Service LoadBalancer（第 2 层）

通过 BGP 使用多个节点的 Service LoadBalancer

每个命名空间或全局的 Service LoadBalancer 地址池

Service LoadBalancer 地址通过 UPNP 暴露给网关

集群 master 节点一般不会很多，kube-vip 只需在 k8s 中的控制平面部署。这里使用方法采用 静态 pod + ARP 来简单实现。在大规模的场景下可以尝试使用 BGP ，这需要相应的 BGP 服务来做支撑。

CoreDNS 完整部署与管理指南

yangzun@treesir.pub (Zayn) — Sat, 25 Sep 2021 16:40:31 +0800

CoreDNS 是现代化的 DNS 服务器，以其插件化架构、高性能和易配置性成为 Kubernetes 默认 DNS 解决方案。本指南将从基础部署到企业级应用，全面介绍 CoreDNS 的部署、配置、优化和管理。

CoreDNS 概述
#

什么是 CoreDNS
#

CoreDNS 是用 Go 语言编写的现代化 DNS 服务器，具有以下核心特性：

Go 语言结构体（Struct）详解与实践

yangzun@treesir.pub (Zayn) — Sun, 15 Aug 2021 20:00:50 +0800

Go 语言中的结构体（Struct）是一种用户自定义的数据类型，用于将不同类型的数据组合在一起。虽然 Go 不是传统的面向对象语言，但通过结构体和方法，我们可以实现面向对象编程的核心概念。

什么是结构体
#

结构体是 Go 语言中实现数据封装的主要方式，它具有以下特点：

数据聚合: 将相关的数据字段组合在一起
类型安全: 编译时检查字段类型
方法绑定: 可以为结构体定义方法
内存效率: 字段在内存中连续存储

基础结构体定义
#

简单结构体示例
#

让我们通过一个图书管理的例子来学习结构体的使用：

使用 Docker Compose 5分钟部署一台邮件服务器

yangzun@treesir.pub (Zayn) — Tue, 03 Aug 2021 11:37:38 +0800

背景
#

由于 Gmail 邮箱在国内无法使用且 国内手机 号码无法继续注册账号原因，最近想着折腾一下自建一台 邮件服务器 玩玩。正好在国外有台 vps (搬瓦工的)，比较空闲，目前且用来做扶墙使用，有点浪费，决定使用此台服务器搭建 邮件服务器 。选择的部署方案选择了较为轻便的 docker，在了解网上主流的实现镜像后 analogic/poste.io & mailserver/docker-mailserver，由于目前 vps 资源为 2c 1g 的低配置，试着跑了一下前者，资源占用非常大(可能默认开了什么功能什么的)，在当前有限的配置下有点跑不动。了解后者这个项目后，可以在最低 1c 512m 下运行，最后决定选用后者 docker-mailserver 进行部署。

K3s 集群修改 Flannel CNI 插件网络模式

yangzun@treesir.pub (Zayn) — Thu, 29 Jul 2021 08:56:04 +0800

背景说明
#

在之前搭建的 k3s 集群中因为某些原因我将 openwrt 节点，进行了系统重装，更改固件为了 esir 高大全的 op 固件，由于其固件中没有将 vxlan 模块编译进内核当中，而 k3s 默认 使用的 cni 为 flannel 的 vxlan 模式，导致在初始化节点的时候会出现错误，导致节点添加不成功，我们知道原生 flannel 支持的模式不只单单只有 vxlan，还支持 host-gw、udp 模式。进行查阅 k3s 相关资料，看到 k3s 是支持切换多种网络模式的，于是决定将 flannel 模式更改为 host-gw 。

Nexus3 PyPI 私服 Blob Storage 异常修复记录

yangzun@treesir.pub (Zayn) — Thu, 22 Jul 2021 15:38:00 +0800

问题描述
#

在 DevOps 集成环境的测试环境中，发现多条 Pipeline 持续处于构建超时状态。初步排查以为是依赖版本兼容性问题导致 pip 无法找到合适版本，与开发团队联合排查后发现：开发环境正常，测试环境异常，且使用相同的代码和 Dockerfile 文件，排除了版本相关问题。具体错误表现如下：

检查 Nexus3 私服日志

docker logs -f --tail 100 nexus3

记录一次 JupyterLab 插件打包问题的修复

yangzun@treesir.pub (Zayn) — Tue, 20 Jul 2021 17:04:26 +0800

背景
#

在所关联项目的 jenkins pipeline ci 流水线中，开发告诉我生成的 pip 包中未有生成相关的 labextension 依赖文件夹，导致 pip 包虽然是安装成功了，但仍是一个不可用的状态。开发人员告诉我在 linux & windows 环境下均是可以正常生成相关依赖文件夹的，问我是不是哪里配置有点问题，思索了一下和他说会不会是 jenkins slave 使用的是 容器 的原因？给了他一个启动命令，测试在容器里面生成一下包看看，启动命令如下所示:

使用 Cronjob 定时清理 ElasticSearch 中的日志索引

yangzun@treesir.pub (Zayn) — Tue, 13 Jul 2021 11:45:00 +0800

背景
#

在日常使用 efk 日志系统的过程中，每天造成的日志索引量是巨大的，需要进行对相关的索引进行定期清理，来缓解后端储存的占用。如何实现在 kubernetes 中进行优雅的定期清理？本文将介绍使用 kubernetes 中的 Cronjob 资源对象进行其需求的实现。

常规情况下清理 n day 以前的数据

curl -XDELETE http://elasticsearch-logging.kube-system:9200/logstash-`date -d"n days ago" +"%Y.%m.%d"`

这种方法，是网上比较常规的方式，如某一天忘记执行了，就会出现数据未清理干净的情况，有点不优雅，如何解决？

Macos 一键使用 wkhtmltopdf 将 html 转换为 pdf

yangzun@treesir.pub (Zayn) — Mon, 12 Jul 2021 20:21:48 +0800

安装 wkhtmltopdf
#

使用 brew 进行安装
```
brew install --cask wkhtmltopdf
```

将目录下的所有 html 文件一键转换为 pdf 格式

for f in *.html; do wkhtmltopdf --load-error-handling ignore -n --enable-local-file-access $f "$f.pdf"; done

参考文档
#

https://segmentfault.com/a/1190000018988358

Kubernetes VPA 垂直 Pod 自动伸缩完整指南

yangzun@treesir.pub (Zayn) — Thu, 08 Jul 2021 14:41:34 +0800

VPA 简介
#

什么是 VPA？
#

Vertical Pod Autoscaler（VPA，垂直 Pod 自动伸缩器）是 Kubernetes 的一个组件，它可以根据 Pod 的实际资源使用情况，自动调整 Pod 的 CPU 和内存请求值（requests）。

使用 Kube-VIP 部署高可用 Kubernetes 集群

yangzun@treesir.pub (Zayn) — Thu, 24 Jun 2021 11:01:10 +0800

方案介绍
#

在私有环境中部署 Kubernetes 高可用集群时，传统方案需要准备硬件或软件负载均衡器来创建多控制平面集群。通常我们会选择使用 HAProxy + Keepalived 来实现这个功能：创建 2 个负载均衡器虚拟机，分配一个 VIP（虚拟 IP），通过 VIP 将流量重定向到后端的 Kubernetes 控制平面节点。架构如下图所示：

使用 Kaniko 在 Kubernetes 中构建 Docker 镜像

yangzun@treesir.pub (Zayn) — Tue, 15 Jun 2021 10:02:48 +0800

在 Kubernetes 环境中构建 Docker 镜像一直是一个挑战，传统的 Docker-in-Docker 方案存在安全风险和复杂性问题。Kaniko 作为 Google 开源的容器镜像构建工具，提供了一个安全、高效的解决方案。

什么是 Kaniko
#

Kaniko 是由 Google 开发的开源工具，专门用于在容器或 Kubernetes 集群内构建容器镜像。它的核心优势包括：

使用 Docker Compose 部署 Nexus3 Docker 私服并配置 Traefik 代理

yangzun@treesir.pub (Zayn) — Thu, 10 Jun 2021 09:51:36 +0800

环境说明
#

软件版本
#

操作系统：CentOS 7.9.2009
Docker 版本：20.10.7
Docker Compose 版本：1.18.0
Mkcert 版本：v1.4.3

端口规划
#

Nexus 私服端口规划
#

私服名称	私服作用	私服类型	私服端口
docker-custom	存放自定义 push 的镜像，与项目环境无关	hosted	8086
idocker.io	代理仓库和 custom 仓库的集合	group	8082
docker-dev	存放项目 dev 环境镜像	hosted	8083
docker-qa	存放项目 qa 环境镜像	hosted	8084
docker-prod	存放项目 prod 环境镜像	hosted	8085

除了上述 Docker 私服端口外，还有 Nexus3 管理面板端口 8081

修复 Rancher 导入集群时 Scheduler 和 Controller Manager 不健康问题

yangzun@treesir.pub (Zayn) — Tue, 08 Jun 2021 08:45:22 +0800

环境配置
#

Kubernetes 版本：v1.20.4 (KubeKey 部署)
操作系统：CentOS 7.9.2009
Rancher 版本：v2.4.15

准备 Kubernetes 测试环境
#

本次使用 KubeKey 进行一键部署。KubeKey 底层集群部署基于 kubeadm，详细信息可参考 GitHub 地址。

在 Kubernetes 中使用 localPv 部署 Gitlab

yangzun@treesir.pub (Zayn) — Tue, 01 Jun 2021 10:13:29 +0800

环境说明
#

Kubernetes Version: v1.20.4
Postgres Version: 12.7
Redis Version: 5.0.9

因在官方提供的 gitlab-ce 镜像中，内置了 Postgres & Redis 的安装，在实际生产使用过程中，想让其连接使用外部统一的服务进行使用，来合理统一的管理，并有效降低对应资源使用率，这里使用 dokcer 非官方镜像: sameersbn/gitlab:13.12.1 进行使用

快速删除 Rancher 中失败的 Pod 资源

yangzun@treesir.pub (Zayn) — Thu, 27 May 2021 08:59:56 +0800

问题描述
#

在 Rancher 管理的 Kubernetes 集群中，有时会出现副本集中的 Pod 部署失败的情况。如下图所示，失败的 Pod 数量可能达到上千个，手动逐一删除非常耗时。

解决方案
#

批量删除失败的 Pod
#

使用 kubectl 命令批量删除状态为 MatchNodeSelector 的失败 Pod：

Gocron 实践安装，实现统一定时任务管理平台

yangzun@treesir.pub (Zayn) — Wed, 26 May 2021 11:29:34 +0800

部署环境说明
#

操作系统: CentOS release 7.8.2003
Gocron Version: v1.5.3
Mysql Version: 5.5

Gocron 说明
#

gocron 是使用 go 语言开发的轻量级定时任务集中调度和管理系统, 可以用于替代 linux-crontab。

使用 Helm 配合 localPV 在 K8s 中部署 Mariadb 主程复制集群

yangzun@treesir.pub (Zayn) — Tue, 25 May 2021 11:33:17 +0800

环境说明
#

helm version: v3.3.1
kubernetes: v1.17.9
使用 helm chart: bitnami/mariadb
操作系统: CentOS 7.8.2003

helm 部署 `mariadb` 前的准备
#

添加 helm 私服
#

helm repo add bitnami https://charts.bitnami.com/bitnami

helm repo update # 更新仓库索引

helm search repo mariadb
bitnami/mariadb 9.3.12 10.5.10 Fast, reliable, scalable, and easy to use open-...

对 chart 进行定制更改优化
#

下载对应 chart 文件

使用 Helm 部署 Spinnaker 持续部署(CD)平台

yangzun@treesir.pub (Zayn) — Mon, 24 May 2021 16:33:49 +0800

环境说明
#

Kubernetes Version: v1.17.9
操作系统: CentOS 7.8.2003
Helm Version: v3.2.1
Spinnaker Version: 1.26.3

spinnaker 版本说明

spinnaker 组件说明
#

Deck：前端web页面端口9000

使用 helm 在 Kubernetes 中部署 Nexus 私服

yangzun@treesir.pub (Zayn) — Sun, 23 May 2021 15:50:31 +0800

环境说明
#

helm version: v3.3.1
kubernetes: v1.17.9
nexus: 3.29.0

部署
#

准备 storageClass
#

非 必要 操作，可以选择手动创建 pvc & pv，如果想部署 nfsStorageClass 的话，请参考早期整理的文档。此篇文档实战部署步骤中基于 nfsStorageClass 进行实现。如果是用于 生产环境 的话，还是建议使用 ssd 或 iops 较高的 磁盘 作为数据盘使用，数据盘管理方式可以使用 localPv or hostPath 绑定到对应节点进行运行。

Rancher 开启监控后的，阈值告警配置说明 (三)

yangzun@treesir.pub (Zayn) — Wed, 19 May 2021 08:41:26 +0800

环境说明
#

此文档为 rancher monitor 使用系列的 第三篇 ，主要介绍与 dingtalk 关联配置告警通知、prometheus 告警阈值的配置使用

配置安装 dingtalk webhook
#

webhook github 地址

Rancher 开启监控，及生产应用的优化配置工作说明 (一)

yangzun@treesir.pub (Zayn) — Mon, 17 May 2021 10:41:26 +0800

环境说明
#

kubernetes version: v1.17.9
rancher dashboard: v2.3.5
操作系统: centos 7.8.2003

基础环境配置
#

使用 kubekey 部署 kubernetes 集群
#

由于篇幅原因，此处省略部署说明，请参考较早期的文档说明

Rancher 开启监控后，exporter/metrics 的添加说明 (二)

yangzun@treesir.pub (Zayn) — Mon, 17 May 2021 10:41:26 +0800

环境说明
#

上期 介绍了 rancher prometheus operator 的安装和基础 targets 的修复工作。有的时候我们抓取的 exporter metrics 并不在同集群且与集群没有任何关联时，应该怎么和 rancher monitor 进行关联配置呢？下面文档将配置展示部署外部 exporter , 的安装说明、指标抓取、和监控系统的关联。

Velero 备份迁移工具安装与配置

yangzun@treesir.pub (Zayn) — Sun, 16 May 2021 18:00:36 +0800

环境准备
#

安装基础依赖
#

安装 Docker Compose：

Maven ReleasePlugin 的使用记录

yangzun@treesir.pub (Zayn) — Sun, 16 May 2021 17:52:05 +0800

`maven` settings.xml 配置使用展示
#

 <?xml version="1.0" encoding="UTF-8"?>
 <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
 <!-- localRepository
 | The path to the local repository maven will use to store artifacts.
 |
 | Default: ${user.home}/.m2/repository
 <localRepository>/path/to/local/repo</localRepository>
 -->
 <pluginGroups>
 <!-- pluginGroup
 | Specifies a further group identifier to use for plugin lookup.
 <pluginGroup>com.your.plugins</pluginGroup>
 -->
 </pluginGroups>

 <!-- proxies
 | This is a list of proxies which can be used on this machine to connect to the network.
 | Unless otherwise specified (by system property or command-line switch), the first proxy
 | specification in this list marked as active will be used.
 |-->
 <proxies>
 </proxies>

 <servers>
 <server>
 <id>user-snapshot</id>
 <username>yangzun</username>
 <password>12345678</password>
 </server>

 <server>
 <id>user-release</id>
 <username>yangzun</username>
 <password>12345678</password>
 </server>
 </servers>

 <mirrors>
 <mirror>
 <id>user-snapshot</id>
 <mirrorOf>*</mirrorOf>
 <url>http://mirror.treesir.pub/repository/maven-hub</url>
 </mirror>
 <mirror>
 <id>user-release</id>
 <mirrorOf>*</mirrorOf>
 <url>http://mirror.treesir.pub/repository/maven-hub</url>
 </mirror>
 </mirrors>

 <profiles>

 <profile>
 <id>nexus</id>
 <repositories>
 <repository>
 <id>central</id>
 <name>_nexus</name>
 <url>http://mirror.treesir.pub/repository/maven-hub/</url>
 <releases><enabled>true</enabled></releases>
 <snapshots><enabled>true</enabled></snapshots>
 </repository>
 </repositories>
 <pluginRepositories>
 <pluginRepository>
 <id>central</id>
 <name>_nexus</name>
 <url>http://mirror.treesir.pub/repository/maven-hub/</url>
 <releases><enabled>true</enabled></releases>
 <snapshots><enabled>true</enabled></snapshots>
 </pluginRepository>
 </pluginRepositories>
 </profile>

 </profiles>

 <activeProfiles>
 <activeProfile>nexus</activeProfile>
 </activeProfiles>
 </settings>

插件打包的使用记录说明
#

maven plugin 在打包过程中，是会基于当前分支，创建一个分支进行打包，并会将创建的分支 push 至远端。与项目的分支管理模式有所冲突，并不想push 至远端的话

使用 Docker Compose 部署 OpenConnect VPN 服务器

yangzun@treesir.pub (Zayn) — Sat, 15 May 2021 16:20:46 +0800

环境要求
#

本文档基于以下环境进行部署：

Docker Compose：1.18.0
操作系统：OpenWrt (x86)
Docker 版本：19.03.12
Docker 镜像：yangzun/docker-openconnect-ldap:latest

说明：该镜像基于 morganonbass/ocserv-ldap 进行了修改和优化，解决了原镜像无法正常启动的问题。

部署准备
#

安装 Docker Compose
#

yum install -y docker-compose

配置部署文件
#

创建项目目录
#

mkdir -p /data/docker-compose/openConnect
cd /data/docker-compose/openConnect

创建 Docker Compose 配置
#

cat > docker-compose.yaml << EOF
version: "3"
services:
 ocserv:
 container_name: ocserv
 image: yangzun/docker-openconnect-ldap:latest
 ports:
 - "1443:443/tcp"
 - "1443:443/udp"
 environment:
 LISTEN_PORT: 443
 TUNNEL_MODE: 'split-include'
 TUNNEL_ROUTES: '192.168.8.0/24'
 DNS_SERVERS: 192.168.8.1
 CLIENTNET: 192.168.248.0
 CLIENTNETMASK: 255.255.255.128
 BASEDN: 'dc=treesir,dc=pub'
 LDAPURI: 'ldap://192.168.8.1:389/'
 BINDDN: 'cn=admin,dc=treesir,dc=pub'
 BINDPW: '123456'
 SEARCHSCOPE: 'ou=users,dc=treesir,dc=pub'
 PAM_LOGIN_ATTRIBUTE: 'uid'
 CA_CN: 'VPN CA'
 CA_ORG: 'OCSERV'
 CA_DAYS: 9999
 SRV_CN: 'nps.treesir.pub'
 SRV_ORG: 'Example Company'
 SRV_DAYS: 9999
 volumes:
 - './config/:/config/'
 cap_add:
 - NET_ADMIN
 privileged: true
 restart: unless-stopped
EOF

配置说明：环境变量的详细说明请参考 Docker Hub 页面。OpenLDAP 的部署配置请参考 LDAP 部署文档。

K8s 部署 Lxcfs 准入控制器，实现容器中资源单独可见

yangzun@treesir.pub (Zayn) — Fri, 30 Apr 2021 14:10:31 +0800

环境说明
#

kubernetes version: v1.17.9 (kubeadm)
os: 7.8.2003 (Core)
kubernetes dashboard: rancher v2.4.15

概述
#

docker 使用 linux 内核中的 cgroup 实现了对容器使用资源的限制，默认容器启动后依旧挂载了宿主机的 /proc 目录，其中包涵了，meminfo、cpuinfo、stat、uptime 等资源信息。一些监控工具如 free、top、htop 或 业务应用 还依赖 /proc 下文件内容获取资源配置和使用情况。当它们在容器中运行时，实际还是查看到的是宿主机的资源使用，导致资源使用展示源不对，目前社区主流的解决方法是使用 lxcfs 的方法进行解决。

使用 Kubekey 一键离线/在线部署 kubernetes 集群

yangzun@treesir.pub (Zayn) — Mon, 26 Apr 2021 14:59:36 +0800

环境说明
#

概述
#

KubeSphere 是在 Kubernetes 之上构建的面向云原生应用的分布式操作系统，完全开源，支持多云与多集群管理，提供全栈的 IT 自动化运维能力，简化企业的 DevOps 工作流。它的架构可以非常方便地使第三方应用与云原生生态组件进行即插即用 (plug-and-play) 的集成。

Git 使用问题的记录

yangzun@treesir.pub (Zayn) — Sun, 25 Apr 2021 10:35:57 +0800

指定特定仓库拉取代码
#

git remote add origin https://github.com/demo/example.git
git pull https://repo.csheidou.com/forestry_afterend/prevention_fire_test.git master
git branch --set-upstream-to=origin/master
git status
git pull

更改远程仓库地址
#

git remote -v
git remote set-url origin https://github.com/demo/example.git
git pull origin master --allow-unrelated-histories
git push
git branch --set-upstream-to=origin/master

清理本地错误的用户信息
#

运行一下命令缓存输入的用户名和密码：
git config --global credential.helper wincred

清除掉缓存在git中的用户名和密码
git credential-manager uninstall

解决 Windows git pull 卡住不动问题
#

原因在 git clone 时后面仓库地址是非公开的需要验证用户及密码而windows 默认是已弹窗形式

OpenVpn 的安装，并配置关联 openLdap 认证

yangzun@treesir.pub (Zayn) — Thu, 22 Apr 2021 16:19:56 +0800

环境说明
#

docker-compose：1.23.2
操作系统: armbian (斐讯n1)

部署软件
#

openldap 部署
#

省略 openldap 的部署配置请参考之前整理的 文档

Centos7 执行 shutdown 无法正常关机的解决

yangzun@treesir.pub (Zayn) — Wed, 14 Apr 2021 10:48:42 +0800

环境说明
#

因为在公司中，有下班后有需要关闭 服务器 的操作，并且每天还需要去手动打开。有点违背极客精神，所有自己通过 shell script + cron 的形式进行每天定时的 开关服务器机 操作。但是服务器中不乏有一些比较老的机型，没有提供类似于 ipmi 管理功能，这些服务器自动启动依赖于主板自带的 网络唤醒 功能，如果服务器未正常关机时 (卡在关机界面)，第二天早上通过网络唤醒时是无法正常打开服务器的，需要管理人员的介入管理强制关机。这篇文档主要是介绍如何优化服务器的关机时间长，服务器关机卡死问题。

Git 日报生成脚本

yangzun@treesir.pub (Zayn) — Tue, 13 Apr 2021 13:41:01 +0800

功能简介
#

本脚本用于生成 Git 日报通知，将 GitLab 中指定项目组的所有项目 Git 提交信息以 HTML 表格形式发送给相关人员，适用于敏捷开发项目的日常管理。

环境要求
#

依赖工具

GitLab Pre-receive 钩子的配置与使用指南

yangzun@treesir.pub (Zayn) — Mon, 12 Apr 2021 17:25:58 +0800

环境说明
#

版本信息
#

GitLab 版本：13.10.2

如需了解 GitLab 服务器安装方法，请参考安装文档。本文将详细介绍如何在 GitLab 中添加和配置 pre-receive 钩子，并演示如何对 git push 操作进行限制。

Gitlab 和 jira 之间的集成

yangzun@treesir.pub (Zayn) — Fri, 09 Apr 2021 15:52:44 +0800

环境说明
#

Gitlab-ce 版本： 13.10.2

Jira 版本：v8.13.4

Jira
#

获取工作流结束 id
#

Docker 在 Centos7 中离线安装

yangzun@treesir.pub (Zayn) — Thu, 25 Mar 2021 11:12:50 +0800

环境说明
#

操作系统: Centos
Docker 版本: 19.03.8

离线版本安装
#

Docker-ce 版本 YUM源配置 - 参考文档

Jira Webhook Integration Jenkins

yangzun@treesir.pub (Zayn) — Tue, 16 Mar 2021 08:49:04 +0800

Jira Webhook 与 Jenkins 集成
#

此文档为归档数据，暂不具备参考意义

Jira 创建项目并新建模块关联 Gitlab 中对应仓库

Jenkins 创建 jira webhook manage pipeline

企业级 Prometheus 监控平台部署与运维完整指南

yangzun@treesir.pub (Zayn) — Tue, 09 Mar 2021 15:50:54 +0800

Prometheus 监控平台简介
#

什么是 Prometheus
#

Prometheus 是由 SoundCloud 开发并贡献给 CNCF（Cloud Native Computing Foundation）的开源监控和告警系统。作为云原生监控的事实标准，Prometheus 为现代化的微服务架构和容器化环境提供了强大的监控能力。

企业级 GitLab 平台部署与运维完整指南

yangzun@treesir.pub (Zayn) — Thu, 04 Mar 2021 16:31:06 +0800

GitLab 平台简介
#

什么是 GitLab
#

GitLab 是一个基于 Web 的 DevOps 生命周期工具，提供了 Git 仓库管理、代码审查、问题跟踪、CI/CD 流水线和 Wiki 等功能。作为一个完整的 DevOps 平台，GitLab 帮助团队协作开发、测试和部署应用程序。

企业级 Jenkins CI/CD 平台部署与配置完整指南

yangzun@treesir.pub (Zayn) — Tue, 02 Mar 2021 19:31:09 +0800

Jenkins 平台简介
#

什么是 Jenkins
#

Jenkins 是世界领先的开源自动化服务器，由 Kohsuke Kawaguchi 于 2004 年创建。作为 DevOps 工具链的核心组件，Jenkins 为软件开发生命周期提供了强大的自动化能力。

CentOS 7 编译安装 QEMU 及 libvirt 管理工具

yangzun@treesir.pub (Zayn) — Thu, 25 Feb 2021 09:07:25 +0800

环境说明
#

操作系统：CentOS 7.9.2009
QEMU 版本：5.2.0
libvirt 版本：5.4.0

注意：libvirt 高版本安装较为复杂，如需安装高版本请参考官方文档

编译安装 QEMU
#

注意：以下操作命令主要在 /data 目录下进行。

Raid 阵列卡 Megacli 管理工具的使用记录

yangzun@treesir.pub (Zayn) — Wed, 24 Feb 2021 20:54:13 +0800

安装
#

安装参考文档

使用参考文档

示例为： Centos7 中的安装步骤

wget https://docs.broadcom.com/docs-and-downloads/raid-controllers/raid-controllers-common-files/8-07-14_MegaCLI.zip

unzip 8-07-14_MegaCLI.zip

rpm -ivhU Linux/MegaCli-8.07.14-1.noarch.rpm

cp -a /opt/MegaRAID/MegaCli/MegaCli64 /usr/local/bin/MegaCli

命令使用记录
#

将某块物理盘下线/上线
#

MegaCli -PDOffline -PhysDrv[31:8] -a0
MegaCli -PDRbld -ShowProg -PhysDrv[31:8] `#[E:S]` -aAll # 查看 rebuild 状态
MegaCli -pdrbld -progdsply -physdrv[31:8] -aALL # 进度条显示 rebuild 状态
MegaCli -PDOnline -PhysDrv [1:4] -a0

配置示例

JIRA & Confluence 完整安装配置指南

yangzun@treesir.pub (Zayn) — Sun, 21 Feb 2021 11:02:00 +0800

系统环境要求
#

环境信息
#

组件	版本	说明
操作系统	CentOS 7+	推荐使用 CentOS 7 或更高版本
JIRA 版本	8.13.4	企业级项目管理工具
数据库	MySQL 5.7	存储 JIRA 数据
Java 环境	OpenJDK 1.8	JIRA 运行环境

💡 提示：可以访问 JIRA 官方下载页面查看最新版本信息

VMware ESXi 虚拟机克隆完整操作指南

yangzun@treesir.pub (Zayn) — Sun, 21 Feb 2021 10:09:38 +0800

在 VMware ESXi 环境中，虚拟机克隆是一个常见的运维操作，可以快速创建相同配置的虚拟机实例。本文将详细介绍如何在 ESXi 6.7 环境中使用命令行工具进行虚拟机克隆操作。

虚拟机克隆概述
#

什么是虚拟机克隆
#

虚拟机克隆是指创建现有虚拟机的完整副本，包括：

使用斐讯 N1 和 OpenWrt 搭建 K3s 集群

yangzun@treesir.pub (Zayn) — Tue, 26 Jan 2021 09:26:39 +0800

环境说明
#

软件版本
#

K3s 版本：v1.19.7+k3s1
Docker 版本：19.03.13 (N1)，19.03.12 (OpenWrt)
写盘工具：balenaEtcher

硬件配置
#

IP 地址	机型	配置	操作系统	角色
192.168.8.1	占美（机型不详）	4C 2G（CPU N2940）	OpenWrt（X86_64 自编译）	node/agent
192.168.8.112	斐讯 N1	4C 2G	Armbian（5.0.2-aml-s905）	master/server

OpenWrt 自编译
#

需要自编译的原因：之前使用 esir 打包的高大全 OpenWrt 固件部署 K3s 时发现，内核没有开启 vxlan 特性，导致部署失败。如果您使用的 OpenWrt 固件已开启 vxlan 特性，可跳过此步骤。

在 Kubernetes 中部署 NFS 动态存储类完整指南

yangzun@treesir.pub (Zayn) — Tue, 19 Jan 2021 14:54:30 +0800

在 Kubernetes 集群中，持久化存储是有状态应用的重要基础设施。NFS（Network File System）作为一种成熟的网络文件系统，可以为 Kubernetes 提供简单可靠的共享存储解决方案。本文将详细介绍如何部署 NFS StorageClass 实现动态存储供应。

什么是 StorageClass
#

StorageClass 是 Kubernetes 中的一种资源对象，用于描述存储的"类别"。它的主要作用包括：

动态供应: 自动创建 PersistentVolume（PV）
存储抽象: 为不同类型的存储提供统一接口
参数化配置: 支持不同的存储参数和策略
自动化管理: 减少手动创建 PV 的工作量

方案架构
#

本方案采用以下架构：

Kubernetes 部署企业级 Kafka 集群完整指南

yangzun@treesir.pub (Zayn) — Tue, 19 Jan 2021 13:44:03 +0800

Apache Kafka 简介
#

什么是 Apache Kafka
#

Apache Kafka 是一个开源的分布式事件流处理平台，由 LinkedIn 开发并贡献给 Apache 软件基金会。它被数千家公司用于高性能数据管道、流分析、数据集成和关键任务应用程序。

Traefik Ingress Controller 完整部署指南

yangzun@treesir.pub (Zayn) — Sun, 17 Jan 2021 16:15:32 +0800

Traefik 简介
#

什么是 Traefik？
#

Traefik 是一个现代化的云原生反向代理和负载均衡器，专为微服务架构设计。它就像一个智能的"交通指挥员"，能够自动发现您的服务并为它们配置路由规则。

修复 Rancher 单机部署升级后 Docker 无法启动问题

yangzun@treesir.pub (Zayn) — Sat, 16 Jan 2021 14:39:59 +0800

环境配置
#

操作系统：CentOS 7.9.2009
Docker 版本：18.09.9

问题复现
#

安装 Rancher
#

docker pull rancher/rancher:v2.3.5

docker run -d \
--restart=unless-stopped \
--name rancher \
-p 80:80 -p 443:443 \
--privileged \
rancher/rancher:v2.3.5

记录一次，因误删容器导致的容器恢复过程

yangzun@treesir.pub (Zayn) — Thu, 14 Jan 2021 20:09:58 +0800

环境说明
#

因在日常维护过程中升级了docker的版本 ，碰到了一个 docker 的一个 bug, 导致 docker 服务无法正常启动。在恢复 docker 服务的过程中把 /var/lib/docker/containers 下的所有文件给 清空 了，清空后 docker 服务可以正常运行，但发现原来的服务中还存留着一个还在使用的 cmdb 系统也被我跟着删除了，是之前的前辈部署的。好在自己有 做备份 的习惯，现记录一下被删除容器的恢复过程。

Coredns 出现间断性无法正常解析域名问题

yangzun@treesir.pub (Zayn) — Thu, 07 Jan 2021 14:34:16 +0800

问题描述:
#

Kubernetes 节点中，有一台节点使用 coredns 进行解析某个域名时，出现间断性无法正常解析问题，而解析另外一个域名时不会出现解析问题。

再次重复一下问题重点: 且在集群中的某台节点中出现，且使用某个域名时出现

环境说明：
#

操作系统: CentOS Linux release 7.9.2009
Kubernetes 集群: v1.17.4 （集群使用 rancher 自定义添加集群 一键部署）
Dashboard: Rancher-v2.3.5
Linux Kernel: 5.10.3-1.el7.elrepo.x86_64
Coredns : Coredns:1.6.5 + Node-local-dns

工具说明
#

测试时使用的容器: praqma/network-multitool:latest

部署 Nginx-Ingress 并配置暴露 kubernetes dashboard

yangzun@treesir.pub (Zayn) — Tue, 22 Dec 2020 09:24:55 +0800

环境说明
#

链接文档

软件版本说明
#

helm: v3.4.2
ingress: v3.16.1

Nginx Ingress
#

参考文档

企业级 Nexus3 制品仓库平台部署与运维完整指南

yangzun@treesir.pub (Zayn) — Tue, 22 Dec 2020 09:24:55 +0800

Nexus3 是世界领先的企业级制品仓库管理平台，为现代 DevOps 工具链提供统一的制品管理解决方案。本指南将从基础部署到企业级配置，全面介绍 Nexus3 的部署、配置、管理和运维最佳实践。

Nexus3 平台简介
#

什么是 Nexus3
#

Nexus Repository Manager 3 是由 Sonatype 公司开发的下一代制品仓库管理平台，作为 DevOps 工具链的核心组件，为软件开发生命周期提供统一的制品管理能力。

Kubeadm 部署 kubernetes-v1.19.x 集群

yangzun@treesir.pub (Zayn) — Mon, 21 Dec 2020 13:19:31 +0800

系统环境说明
#

使用操作系统: Centos-7.9.2009
操作系统内核版本: 4.4.248 (lt)
Docker容器版本: 18.09.9
Kubeadm 版本: 1.19.6
节点说明:
- master01: 192.168.8.70 ,192.168.88.70
- node01: 192.168.8.71 ,192.168.88.71
- (备注: 为每个节点配置了两个ip，对外服务网段为: 192.168.8.0/24, 集群内部通讯: 192.168.88.0/24)

OS 准备
#

系统初始化
#

确保已将selinux关闭

企业级 CentOS 7 系统初始化与优化完整指南

yangzun@treesir.pub (Zayn) — Mon, 21 Dec 2020 09:34:01 +0800

CentOS 7 系统初始化简介
#

概述
#

CentOS 7 作为企业级 Linux 发行版，在生产环境中广泛应用。新安装的系统需要进行全面的初始化配置和优化，以确保系统的安全性、稳定性和高性能。本指南提供了一套经过生产环境验证的完整初始化方案。

Docker 部署 OpenLDAP 统一身份认证服务

yangzun@treesir.pub (Zayn) — Fri, 18 Dec 2020 16:24:43 +0800

OpenLDAP 简介
#

什么是 OpenLDAP
#

OpenLDAP 是一个开源的轻量级目录访问协议（LDAP）实现，广泛用于企业级统一身份认证和目录服务。它提供了集中化的用户管理、身份验证和授权功能。

Kubernetes 集群控制平面组件频繁重启问题排查记录

yangzun@treesir.pub (Zayn) — Fri, 18 Dec 2020 16:24:43 +0800

环境说明
#

Kubernetes 版本：v1.19.6
操作系统：CentOS 7.9.2009

问题现象
#

最近在使用 Kubernetes 集群时，发现集群响应变慢。排查发现 Master 节点中 controller-manager 及 scheduler 组件频繁重启。

使用 Docker 快速部署 Redis 服务器

yangzun@treesir.pub (Zayn) — Mon, 30 Nov 2020 10:35:47 +0800

Redis 是一个高性能的内存数据库，广泛用于缓存、会话存储和消息队列等场景。本文将介绍如何在 CentOS 系统上使用 Docker 容器快速部署 Redis 服务器，让您在几分钟内就能拥有一个可用的 Redis 环境。

环境准备
#

在开始之前，请确保您的系统满足以下要求：

操作系统: CentOS 7 或更高版本
Docker 版本: 19.03.8 或更高版本
Redis 镜像: redis:5.0.4（本教程使用的版本）
系统权限: 需要 root 权限或 sudo 权限

部署步骤
#

第一步：系统优化配置
#

为了确保 Redis 能够稳定高效地运行，我们需要先对系统进行一些优化配置：

Docker 部署多网口 openWrt 软路由

yangzun@treesir.pub (Zayn) — Thu, 19 Nov 2020 17:56:52 +0800

环境说明:
#

操作系统: Centos 7.8.2003

内核版本: 4.14.129-bbrplus

Docker 版本: 19.03.12

使用 Docker 镜像: raymondwong/openwrt_r9:20.1.24-x86_64

网卡说明: 板载螃蟹网卡、绿联 usb3.0 千M 网卡

Docker 部署 OpenWrt 软路由及宿主机通信配置

yangzun@treesir.pub (Zayn) — Sun, 15 Nov 2020 16:09:10 +0800

环境配置
#

本文档基于以下环境配置进行部署：

宿主机 IP：192.168.8.102
OpenWrt 容器 IP：192.168.8.111 (macvlan 模式)
主路由网关：192.168.8.1
网络段：192.168.8.0/24
Docker 镜像：raymondwong/openwrt_r9:21.2.1-arm64
操作系统：ARMBIAN

部署 OpenWrt 软路由
#

1. 安装 Docker Compose
#

# Debian/Ubuntu 系统
apt install -y docker-compose

# CentOS/RHEL 系统
yum install -y docker-compose

2. 创建配置文件
#

首先创建工作目录并准备 Docker Compose 配置文件：

Kind 部署本地k8s集群的使用记录

yangzun@treesir.pub (Zayn) — Sun, 15 Nov 2020 14:24:42 +0800

参考资料
#

安装
#

curl -Lo ./kind "https://kind.sigs.k8s.io/dl/v0.9.0/kind-$(uname)-amd64"
chmod +x ./kind
mv ./kind /some-dir-in-your-PATH/kind

启动集群
#

注意启动集群前请确认 docker 服务是否启动

关于我

yangzun@treesir.pub (Zayn) — Mon, 01 Jan 0001 00:00:00 +0000

云原生与 DevOps 实践工程师，专注生产环境中的技术落地与经验沉淀。

博客内容
#

实战教程

手把手的技术实施指南，包含详细的操作步骤和配置说明
工具分享

各种开发运维工具的使用心得和最佳实践
问题解决

工作中遇到的技术难题和解决思路
技术思考

对新技术趋势和开发实践的一些个人理解

技术专长
#

领域	技术栈
容器化	Docker 部署、镜像构建、多容器编排
Kubernetes	集群搭建、应用部署、服务治理、监控告警
DevOps 工具链	Git、Jenkins、GitLab CI/CD、ArgoCD
系统运维	Linux 管理、网络配置、性能优化
云原生生态	微服务架构、服务网格、可观测性
AI 工程化	AI Agent、MCP 集成、Skills 系统

写作初衷
#

用简单的话把复杂的技术概念说清楚，分享能直接上手的操作步骤，帮大家避开我踩过的坑。

博客技术栈
#

graph LR
A["Hugo"] -->|静态生成| B["Blowfish 主题"]
B -->|Tailwind CSS| C["响应式设计"]
C --> D["GitLab CI/CD"]
D -->|自动部署| E["线上站点"]

联系方式
#

发送邮件 GitHub 主页

Zayn's Blog

每日技术实践简报 - 2026-04-02：博客 Git 工作流治理、Linux 笔记本选购调研与 AI 安全事件追踪

推荐阅读 #

今日技术实践 #

解决的问题 #

每日技术实践简报 - 2026-03-31：Claude Code 源码泄露、运维告警集中爆发与海南骑行决策

推荐阅读 #

今日技术实践 #

解决的问题 #

每日技术实践简报 - 2026-03-30：工作周报整理、编程范式梳理与运维治理体系沉淀

推荐阅读 #

今日技术实践 #

解决的问题 #

学到的新东西 #

实际产出 #

踩坑记录 #

其他思考 #

每日技术实践简报 - 2026-03-29：从 MCP 到一键发包的博客深度写作与 Skill 链优化

推荐阅读 #

今日技术实践 #

解决的问题 #

学到的新东西 #

实际产出 #

踩坑记录 #

其他思考 #

从 MCP 到一键发包：把 Teambition 评论里的 APK 自动上传 Nexus 的那些坑

推荐阅读 #

目录 #

每日技术实践简报 - 2026-03-28：从 MCP 到一键 APK 发布的 Skill 封装

推荐阅读 #

今日技术实践 #

解决的问题 #

学到的新东西 #

实际产出 #

踩坑记录 #

其他思考 #

每日技术实践简报 - 2026-03-27：GPU 分层选型与 OpenClaw 安全基线

推荐阅读 #

今日技术实践 #

解决的问题 #

学到的新东西 #

踩坑记录 #

明日计划 #

每日技术实践简报 - 2026-03-26

推荐阅读 #

今日技术实践 #

解决的问题 #

学到的新东西 #

踩坑记录 #

明日计划 #

每日技术实践简报 - 2026-03-25

今日技术实践 #

解决的问题 #

学到的新东西 #

踩坑记录 #

明日计划 #

推荐阅读 #

把一张 RX 6400 塞进虚拟机：PVE GPU 直通 + Windows Server RDS 部署全记录

3 行 YAML 接入生产级 GitLab CI/CD：gitlab-ci-templates 实战

一、3 行接入：把流水线从“项目资产”变成“平台能力” #

每日技术实践简报 - 2026-03-24

解决的问题 #

学到的新东西 #

踩坑记录 #

明日计划 #

推荐阅读 #

OpenClaw 记忆层降级策略：当 Working Memory 不可用时，如何保持稳定输出

1. 问题不是“挂了没”，而是“退化到什么程度还能用” #

每日技术实践简报 - 2026-03-23

解决的问题 #

学到的新东西 #

踩坑记录 #

明日计划 #

每日技术实践简报 - 2026-03-22

解决的问题 #

学到的新东西 #

踩坑记录 #

明日计划 #

每日技术实践简报 - 2026-03-21

解决的问题 #

推荐阅读
#

今日技术实践
#

解决的问题
#

推荐阅读
#

今日技术实践
#

解决的问题
#

推荐阅读
#

今日技术实践
#

解决的问题
#

学到的新东西
#

实际产出
#

踩坑记录
#

其他思考
#

推荐阅读
#

今日技术实践
#

解决的问题
#

学到的新东西
#

实际产出
#

踩坑记录
#

其他思考
#

推荐阅读
#

目录
#

推荐阅读
#

今日技术实践
#

解决的问题
#

学到的新东西
#

实际产出
#

踩坑记录
#

其他思考
#

推荐阅读
#

今日技术实践
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

推荐阅读
#

今日技术实践
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

今日技术实践
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

推荐阅读
#

一、3 行接入：把流水线从“项目资产”变成“平台能力”
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

推荐阅读
#

1. 问题不是“挂了没”，而是“退化到什么程度还能用”
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

解决的问题
#

学到的新东西
#

踩坑记录
#

明日计划
#

解决的问题
#

学到的新东西
#