摘要
在使用 fuclaude 的过程中,我遇到 Key 管理与多账号状态不可视的问题,于是做了一个管理增强版:fuClaudeBackend。它是一个轻量后端代理 + Key 管理后台,支持访客/站点登录、用户与 Key 管理、账号状态展示以及 Key 过期隐藏,适合「始皇」相关使用场景。
关键词
fuclaude / 代理 / Key 管理 / 管理后台 / Node.js
背景与动机
我在实际使用 fuclaude 时遇到几个痛点:
- Key 无法集中管理,生命周期不可视
- 多账号状态难以快速判断
- 访客与站点登录入口不够清晰
因此决定做一个管理增强版,既保留轻量部署的优势,又补齐关键管理能力。
项目简介
fuClaudeBackend 是基于开源 fuclaude 的轻量后端代理 + Key 管理后台。
主要多用户多账户fuclaude相关使用场景,支持更清晰的管理与可视化。
项目地址:
功能亮点
- 访客/站点登录
- 管理后台:用户与 Key 管理
- 选择账号页面(带状态展示)
- Key 过期时间支持(过期 Key 不展示)
界面截图




快速开始
bash
# 1) 复制配置文件
cp config.example.json config.json
# 2) 可选:初始化数据文件
cp data.example.json data.json
# 3) 启动
node sever.js
访问:
配置说明(config.json)
- ORIGINAL_WEBSITE:上游站点地址(建议自部署)
- SESSION_KEYS:{ id, label, value, expiresAt } 列表
- DEFAULT_KEY_ID:默认 Key ID
- SESSION_KEY:旧版单 Key(可留空)
- SITE_PASSWORD / GUEST_PASSWORD:登录密码
- PORT:端口
数据说明(data.json)
- keys:与 SESSION_KEYS 结构一致(value 为私密)
- defaultKeyId
- users:{ username, active, isolated, keys, createdAt, lastLoginAt, expiresAt }
关键细节:Key 过期时间
- expiresAt 支持任意 Date.parse() 可解析的字符串(推荐 ISO 8601)
- 管理后台可手动输入
- 为空时默认写入后 27 天
- 过期 Key 不会在 /choose 中展示
适用场景
- 多 Key 轮换管理
- 多账号状态可视化
- 访客/站点分角色登录
后续计划
- 审计日志
- 更细粒度的权限控制
- 更轻量的部署方式
参与与反馈
- 仓库:https://github.com/codezzzsleep/fuClaudeBackend
- Issue/建议:https://github.com/codezzzsleep/fuClaudeBackend/issues
如果你也在用 fuclaude,欢迎试试这个管理增强版,也欢迎提建议。