运维笔记 & 踩坑记录¶
树莓派环境下的各种配置、部署、踩坑记录。
树莓派环境¶
- OS： Linux 6.12.47+rpt-rpi-2712
- 用户： pi
- 工作目录： ~/hermes-workspace/
- Hermes 配置： ~/.hermes/
已发现的坑¶
Git push HTTPS 失败（SSL 问题）¶
RPi 上 git push 到 GitHub 使用 HTTPS 协议会报 SSL 错误。解决方案： 使用 SSH 协议。
git remote set-url origin git@github.com:tuxknight/<repo>.git
SSH key 已注册到 GitHub，全通权限（SSH + token + workflow scope）。
Claude Code RPi 超时¶
Claude Code 在 RPi 上运行时，复杂任务可能因 CPU 负载过高导致超时。解决方案： 将任务拆分为更小的 prompt，分批执行。
树莓派散热¶
Pi 在 CPU 持续负载下会重启（降频保护）。API 方案优先于本地计算： - 语音转录 → Deepgram API（不用本地 faster-whisper） - 构建 → 远程 CI（不用本地编译）
USB 安全策略¶
Fuyuan 公司安全策略禁用了所有 USB 存储设备。SD 卡扩容只能： - RPi 自克隆（USB 读卡器插 RPi 的 USB 口） - 找不受管制的个人电脑操作
npm 全局安装权限¶
npm install -g 在 RPi 上可能因为权限问题无法访问。解决方案： 使用 npx 临时调用。
工具配置¶
Cloudflare API¶
- Token 变量名：
CLOUD_FLARE_TOKEN - Token 前缀：
cfut_ - Account ID：
82d1989c6098f7d42c9958550b0150cd - Wrangler 使用：
export CLOUDFLARE_API_TOKEN=***
GitHub¶
- 用户名：
tuxknight - SSH key：已注册
- 新仓库创建：
gh repo create <name> --private --source . --push
部署流程¶
- 本地修改 →
git push（SSH） - GitHub webhook → Cloudflare Pages 自动部署
- 验证：访问
https://cbrain-1iz.pages.dev