文章
记录技术实践、产品思考、读书笔记与项目复盘
共 290 篇文章 · 26 个分类
在持久化环境里从零部署 ComfyUI：踩坑记录与可移植启动脚本
本文介绍在系统盘重启重置、数据目录持久化的Linux机器上部署ComfyUI的方法，涵盖Conda环境建在持久化目录、git克隆TLS报错解决、Python 3.12版本适配、依赖安装技巧，以及可移植启动脚本和systemd开机自启配置，核心思路是不依赖被重置的系统shell配置，重启后可直接运行。
使用 Docker 部署 WireGuard（wg-easy）并实现内网互通
本文介绍使用Docker部署WireGuard的Web管理面板wg-easy，采用host网络模式，结合MASQUERADE规则和路由器静态路由，实现局域网设备访问VPN客户端。通过设置客户端AllowedIPs分流，避免全部流量走隧道，保持本地网络畅通。
Virtio网卡百兆之谜：真相与修复
KVM虚拟机内ethtool显示网卡百兆，实际内部通信却达23Gbps？这并非硬件故障，而是Virtio半虚拟化网卡的速度显示占位值。本文深入排查vCPU队列、硬件卸载、物理网卡状态，给出启用TSO/SG、配置永久生效等核心修复方案，助你突破虚拟化网络性能瓶颈。
在 Docker 容器内使用 Docker：完整指南
本文介绍通过挂载宿主机Docker Socket，在容器内安装Docker CLI即可操作宿主机Docker Daemon，无需额外运行Daemon。涵盖原理、适用场景、环境准备、安装步骤、权限配置、验证方法、完整脚本及常见问题，强调安全注意事项。
Pi Agent 使用指南：从安装到配置本地模型的完整教程
Pi 是轻量级终端 Coding Agent，支持多种大模型 provider。本文详细介绍了两种安装方式（官方脚本和 npm），以及通过 models.json、settings.json、auth.json 配置本地模型的方法，重点解决常见的 401 鉴权问题，并提供了可一键完成安装与配置的 shell 脚本，适合快速接入 OpenAI 兼容服务。
Git多远程仓库同步实战指南
同时使用多个远程仓库时，执行 git pull 后本地分支没有变化？本文将深入剖析问题根源——git pull 仅拉取到远程跟踪分支，不会自动合并。通过完整的测试流程（正常合并、冲突处理、dev分支同步）和详细步骤，帮助你掌握从拉取到推送的核心技巧，并附常见问题排查与最佳实践建议。
Ubuntu桌面一键代理脚本
在Ubuntu桌面环境下，临时使用代理却不影响全局设置？本文介绍两种仅当前终端生效的代理开启脚本：双击弹窗版和终端激活版，附带桌面快捷方式创建与验证方法。轻量无侵入，适合开发与日常使用。
Docker部署Code-server的两种方案
本文详细介绍两种在Docker中部署Code-server并打通Docker环境的方案：官方镜像手动安装Docker CLI与社区增强镜像自动集成Docker。通过docker-compose配置、环境变量设置、权限处理等步骤，帮助你快速搭建浏览器中的云端IDE，实现远程开发与容器管理。两种方案各有优劣，可根据需求选择。
Ubuntu Server 原生部署 KasmVNC 中文桌面指南
本文详细介绍了在 Ubuntu Server（无 GUI）上原生安装 KasmVNC 并配置 XFCE 桌面和中文环境的完整步骤，全程不使用 Docker。包含中文界面汉化、输入法安装、开机自启两种方式以及常见问题排查，助你通过浏览器轻松获得高性能远程桌面。
Claude Code权限配置全攻略
每次使用Claude Code都被权限弹窗打断？本文详解settings.json白名单/黑名单配置、--allowedTools参数、持久化设置及安全alias，三步实现免确认全自动开发，同时规避高危操作风险。
三条测试流式curl命令（OpenAI / Anthropic，分别对应 /chat、/responses、/message 流式接口）
本文提供了OpenAI和Anthropic三家主流AI接口的流式curl调用示例。涵盖OpenAI的/chat和/new Responses接口，以及Anthropic的/message接口。详细展示了SSE流式请求的关键参数、头部设置及JSON体结构，并补充了调试技巧如-N参数和无缓冲输出，帮助开发者快速实现流式响应对接。
Claude Code与Codex安装配置指南
本文详解如何在本地安装并配置 Claude Code 和 Codex CLI 工具，通过环境变量和配置文件将 API 请求路由至阿里云百炼等第三方服务商。涵盖从 Node.js 环境准备、npm 全局安装到 settings.json 及 config.toml 的具体参数设置，助你灵活调用多种大模型，提升开发效率。