magpie 团队共享：给同事发网关密钥、局域网共享与多台电脑同步（2026 年 11 月）

在你这台打开 设置 → 局域网共享，给同事建一把网关密钥（magpie gateway-key add 加名字），让他的工具把 base URL 指向你这台网关的局域网地址，API key 填这把网关密钥。你的服务商 key 留在 magpie 里，不发给同事。同事自己也装了 magpie，就把你这台加成 Remote magpie。安装与添加 QCode 见 /magpie-claude-code-guide。

能。每把网关密钥可以单独设限额：按 tokens、估算花费或两者，按天、周、月或每 N 天、每 N 小时，最多五条，还可以只放行部分模型；用尽后这把密钥得到 429，其他人不受影响。作者在 issue #1496 里说明用量按密钥统计：用量 → 概览 → 网关密钥 按密钥汇总 tokens 与花费，用量 → 请求 可以按密钥筛选，导出的 CSV 有 caller_key_id 与 caller_key_name 两列。同事自己打开网关地址加 /me、输入密钥，就能看到自己的限额与用量。

两种。一次性：magpie backup 生成口令加密的备份文件，在另一台运行 magpie restore magpie.magpie-backup。持续对齐：设置 → 同步与备份 选 WebDAV、S3 或私有 GitHub 仓库，网关运行时每 3 分钟让各台更新一次，服务器上只存密文；作者在 issue #28 写明 WebDAV 同步自 v0.1.76 起提供，其他电脑用同一个口令加入。同步相关的 issue #2269 截至 2026-11-10 仍是打开状态，作者已回复修复随下一版发布，见上文。

给请求带上已启用的网关密钥。开启局域网共享（或把网关放到网络上）后，来自其他机器的请求必须带已启用的网关密钥，否则得到 401；本机回环上不要求。用 magpie gateway-key add 给这位同事或这台电脑建一把，填进对方工具的 API key；magpie 在 Docker 里时，命令前加 docker exec magpie。401 的报错原文与其他报错的处理见 /magpie-errors-and-fixes。

发给每个人的是网关密钥。你在服务商那里的 API key（例如 QCode 的 cr_ 密钥）只保存在跑网关的那台；网关密钥可以随时停用、轮换或删除，删除即撤销这把密钥的远程访问，轮换保留名字、限额和用量记录。需要在 QCode 这边也按人分 Key、分额度时，看 /claude-code-team-shared-keys：企业团队版每人一把子 Key、各有独立配额。

可以。官方 Docker 镜像是 ghcr.io/yetone/magpie（linux/amd64 与 linux/arm64），3425 是网关，3430 是浏览器界面，环境变量 MAGPIE_WEB_KEY 让界面密钥重启后不变；在浏览器界面的 Gateway → Gateway keys，或用 docker exec magpie magpie gateway-key add "Docker client" 给每个客户端建密钥。容器里不必打开局域网共享，容器外的请求一律要带已启用的网关密钥。不用容器时，magpie daemon install 把 magpie serve 装成后台服务（Linux 是 systemd 用户服务，macOS 是 launchd）；Windows 用 magpie autostart on 在登录时打开 magpie，由它提供网关。