都是零碎但真实的坑 —— 不是网关坏了,是没人记得住那些步骤。
换端口、换目录、清缓存,每次都得翻文档确认哪个脚本才是对的那个。
少改一处,客户端就开始 401,而提示通常什么都说不出来。
不重打,上游一更新就把 Codex 拦掉,报错还看不出跟补丁有关。
公网入口莫名其妙就没了,得记得那条带 --bg 的命令。
日志里只有一串 0xC000013A,得逐条排查才知道是被谁关掉的。
装 Python 要 UAC,装错位数比没装更难查,官网只给个下载链接就没了。
萝卜盒把这些都收进一个托盘程序里,每一步都有对应的按钮和状态提示。
点击即用,不用记命令;出问题时告诉你到底缺什么、点哪个能修。
启动 / 停止 / 重启网关、开关公网入口、复制接入地址与 Key、立即签到、检查更新(发现新版本时托盘直接带角标)、开机自启。
网关状态、端口、PID、可用模型数、响应延迟、脱敏补丁健康度、凭证池健康与积分,一屏看完。
96px 自绘状态环加大状态字与双主按钮,打开就知道现在什么状态、下一步该点哪。
Ctrl+K 模糊匹配任意功能,不用记它藏在哪个标签页;Ctrl+1..N 切页签、Ctrl+R 重启网关、Ctrl+Shift+C 复制接入包。
暗 / 亮双基调、四套强调色、三档字号,分段控件式导航与自绘开关。切换即时生效,窗口位置自动记忆。
本机 / 局域网 / Tailscale / 公网各一个,一键复制;API Key 可显隐。
一键写入 Codex 的 config.toml 与 Claude Code 的 settings.json,改前自动备份,可一键还原。
实时 tail 网关日志,关键字 / 正则过滤,ERROR 与 WARN 分级着色,可清空、可导出。
统计 / 模型 / 凭证 / 日志 / 设置五个子页签,直接调网关的 REST 接口,与前端构建产物解耦 —— 网关怎么升级都不会坏。
基于本地余额快照反推消耗,累计 / 今日消耗与每账号明细,柱状图加环形图,纯本地不依赖上游。
检测脱敏词表是否被上游冲掉,缺失自动补回 —— 这是升级后最容易被忽略、又最致命的一步。
萝卜盒更新只换自己(静默安装 / 原地覆盖后自动重启);网关更新只换网关源码,保留凭证与配置,并自动重打补丁。
一次点击体检九项:指针、网关源码、解释器与依赖、端口、API Key、启动参数、脱敏补丁、内置 WebUI、旧计划任务。能修的当场修好并复检,全程逐行回显。
机器上一个可用解释器都没有时,自动下载官方嵌入式 Python(约 50MB,免安装、免管理员),补 _pth、引导 pip、装齐依赖。按架构选包,多镜像回退。
本机找不到网关时直接从上游拉一份:下载、解包、打补丁、补内置 WebUI,拿到手即可运行。
配置、日志、备份、下载中转整体搬到别的盘,缓解 C 盘压力。顺序是先复制、再写指针、最后删旧,中途失败不丢数据。
每次启动自动修正失效的网关目录、Python 路径、被占用的端口;首次运行四步向导带「一键修复环境」,本机没 Python 会自动装一份内置的。
从零到能用,中间那堆命令都不需要你手敲。
双击运行,不用装 Python、不用配环境变量、不用管理员权限。
自动探测解释器、缺什么装什么;本机一个 Python 都没有就装内置的那份。
点一下就起。起不来时告诉你缺什么、点哪个按钮能补,不用自己翻 traceback。
一键写入 Codex 或 Claude Code 的配置,复制接入地址与 Key,粘贴到客户端即可用。
不引第三方 UI 库、图表库与浏览器内核 —— 少一个依赖就少一份体积和升级风险。
能,而且不用你自己去装。点「一键配置环境」,发现机器上一个可用解释器都没有时,萝卜盒会自动下载一份官方的嵌入式 Python 放进数据目录(约 50MB,免安装、不需要管理员权限、不写注册表、不碰 Program Files),然后补 _pth、引导 pip、装齐依赖。它跟着数据目录走,卸载或迁移时一起处理。
说明网关源码目录只下了一半:converter.py 在,但它第一段就要 import app/ 包,而那个包不在。到「设置 → 运行环境」点「一键配置环境」,它会就地补齐 —— 路径不变,登录凭证与配置都保留,不会另拉一份把你现有的东西甩掉。这种目录在体检阶段就会被判出来,点启动也会在起进程之前直接告诉你怎么补。
九成是脱敏补丁被升级冲掉了。到「概览」看「脱敏补丁」那一行,点「一键重打补丁」然后重启网关即可。补丁守护就是为这件事存在的。
这是代理连不上,不是下载源挂了。到「更新 → 下载通道」点「保存并诊断」,会逐条列出每个候选通道(手动 / 系统 / 环境变量 / 直连)是否可达。萝卜盒会自动跳过探活失败的通道,通常不用管。
到「设置 → 外观」:暗 / 亮两种基调,四套强调色(萝卜红 / 青柠 / 电紫 / 湖蓝),三档字号。改完立刻生效,不用重启。
默认最小化到托盘(设置里可关),网关继续在后台提供服务,托盘图标能随时看状态。
可以。升级永远不会动安装位置:安装版静默升级会显式带上当前目录,便携版原地覆盖。真正占地方的数据目录(配置 / 日志 / 备份 / 下载中转,备份一份可能几百 MB)到「设置 → 数据与磁盘 → 迁移数据目录到其他盘」整体搬走即可。
Ctrl+K 命令面板(模糊搜任意功能)、Ctrl+1..N 按顺序切页签、Ctrl+R 重启网关、Ctrl+Shift+C 复制接入包、F5 刷新、Ctrl+, 设置。
扫码联系获取安装包。也可直接在 GitHub Releases 下载最新版本。
微信扫码 · 备注「萝卜盒」获取最新版安装包
Windows 10 / 11 · 便携版与安装版均可