踩坑_文章标签_编程笔记

烂笔头 2 周，1天前

用 kkFileView 搭一个文件在线预览服务

内网想看个 pptx 或 xlsx，往往要先下载再装 Office。本文记录用 kkFileView 搭文件在线预览服务的全过程：靠 LibreOffice 把 Office 文档转成 PDF 或图片，浏览器直接看，支持 Office、WPS、PDF、压缩包、...

内网想看个 pptx 或 xlsx，往往要先下载再装 Office。本文记录用 kkFileView 搭文件在线预览服务的全过程...

容器化 128 0

烂笔头 2 周，6天前

NPM 续期证书不自动 reload？renew_hook 让它续期即生效

NPM 的 Let's Encrypt 证书自动续期成功后，nginx 并不会立即加载新证书——这是官方设计而非 bug。本文从源码层面拆解 create 与 renew 两条流程的差异，解释 NPM 为何不 reload，并用 certbot 原生 rene...

NPM 的 Let's Encrypt 证书自动续期成功后，nginx 并不会立即加载新证书——这是官方设计而非 bug。本文从...

工作经验 108 0

烂笔头 2 周，6天前

new-api 重试配置最佳实践：RetryTimes 与状态码范围

new-api 的重试机制常被误解：RetryTimes 不是简单的失败重试次数，它决定渠道档位能下探多深；状态码范围决定哪些错误值得降级。本文结合多档位渠道实战讲清两者关系——为什么 6 次重试刚好覆盖 7 档链路、429 原生可重试根本不需要渠道级映射、4...

new-api 的重试机制常被误解：RetryTimes 不是简单的失败重试次数，它决定渠道档位能下探多深；状态码范围决定哪些错...

AI 251 0

烂笔头 2 周，6天前

new-api 网关改写实战：param_override 与 header_override 的两个坑

两个看似无关的 new-api 渠道故障，根因都藏在渠道级改写机制里：客户端传了上游不认的参数值（reasoning_effort=max），以及降级渠道莫名丢失请求头（x-opencode-session）。第二个尤其诡异——直击渠道正常、多档重试降级必失败...

两个看似无关的 new-api 渠道故障，根因都藏在渠道级改写机制里：客户端传了上游不认的参数值（reasoning_effor...

AI 264 0

烂笔头 3 周前

new-api 分流与重试降级实战：三个免费渠道如何做到逐级兜底

new-api 网关里优先级决定选渠顺序、权重只影响同档分摊，而失败重试默认是关闭的。本文从一次真实的 429 限流事故出发：三个同档免费渠道互不兜底、限流后请求直接降级到低优先级，服务频繁报错。通过开启 RetryTimes、状态码映射把 429 改成可重试...

new-api 网关里优先级决定选渠顺序、权重只影响同档分摊，而失败重试默认是关闭的。本文从一次真实的 429 限流事故出发：三...

AI 374 0

烂笔头 3 周，2天前

new-api 数据同步实践：全量拷贝与增量同步

两个 new-api 实例之间做数据同步：先用 pg_dump 逻辑迁移完成整库拷贝（用户、渠道、令牌、设置全量搬到备实例），跑通后收敛成只同步渠道的增量方案（channels 与 abilities 两表镜像，脚本化手动触发）。文章对比逻辑迁移与物理拷贝的取...

两个 new-api 实例之间做数据同步：先用 pg_dump 逻辑迁移完成整库拷贝（用户、渠道、令牌、设置全量搬到备实例），跑...

数据库&中间件 147 0

烂笔头 3 周，2天前

new-api 协议转换后 Codex 报错两连：会话头缺失与 developer role

用 new-api 做接口协议转换后，Codex / opencode 客户端经网关调用上游连续撞上两个报错：一个是 opencode 托管服务强制的 x-opencode-session 会话请求头，一个是 DeepSeek 官方 API 拒收的 devel...

用 new-api 做接口协议转换后，Codex / opencode 客户端经网关调用上游连续撞上两个报错：一个是 openc...

AI 314 0

烂笔头 1月前

用 OpenList 把数据备份到 115 网盘

在容器化主机 203 上部署 OpenList、挂载 115 网盘，把备份做成技能驱动的独立流程。方案：本地 tar 打包 + curl WebDAV PUT 直传，远端按备份/主机名/服务名/子目录组织，每服务独立脚本。重点分享踩坑与处理：WebDAV ...

在容器化主机 203 上部署 OpenList、挂载 115 网盘，把备份做成技能驱动的独立流程。方案：本地 tar 打包 + ...

NAS 176 0

烂笔头 1月，1 周前

Clash Verge 添加直连规则：让 VPN 流量不被代理劫持

Mac 上同时运行 GlobalProtect VPN 和 Clash Verge 代理时，VPN 的内网流量会被 Clash 接管，导致公司内网 IP 无法访问。本文从问题现象和原因分析入手，介绍在 Clash Verge 配置中添加 IP-CIDR 直连规...

Mac 上同时运行 GlobalProtect VPN 和 Clash Verge 代理时，VPN 的内网流量会被 Clash ...

个人笔记 389 0

烂笔头 1月，1 周前

堡垒机 Mac 客户端磁盘映射失效排查与修复

公司堡垒机 Mac 客户端（AccessClient）磁盘映射失效，而 Windows 正常。通过加调试日志确认会话走 MrdLoader 分支，抓取生成的 .rdp 文件发现 drivestoredirect 为空，根因是 MrdLoader 字段映射缺少 ...

公司堡垒机 Mac 客户端（AccessClient）磁盘映射失效，而 Windows 正常。通过加调试日志确认会话走 MrdL...

工作经验 184 0

文章标签：踩坑