1. 项目概述一个集中管理ChatGPT与Claude账号的利器如果你手头有几个ChatGPT Plus账号或者团队里几个人共享一个Claude Pro每次登录都要来回切换浏览器、复制粘贴令牌是不是觉得特别麻烦更别提还要操心账号的用量统计、会话隔离和自动续期了。我之前就深受其扰直到我发现了PandoraHelper这个项目。它本质上是一个自托管的账号管理与共享平台基于开源的Pandora和Pandora-Next项目构建但提供了一个集中式的Web管理界面让你能像管理一个SaaS服务一样管理你所有的OpenAI和Anthropic账号。简单来说PandoraHelper帮你做了几件核心的事第一它把你的多个ChatGPT或Claude账号的访问令牌Access Token/Refresh Token集中存储和管理起来第二你可以基于这些主账号创建出多个带有精细权限控制的“共享账号”分发给朋友或团队成员使用第三它提供了一个几乎1:1复刻官方ChatGPT/Claude的Web聊天界面用户无需任何额外配置登录就能用。这对于小团队共享资源、个人管理多账号或者想安全地给家人朋友分享AI能力来说是一个非常优雅的解决方案。我自己部署使用了一段时间无论是稳定性还是功能的完整性都远超预期。2. 核心功能与设计思路拆解2.1 为什么要用PandoraHelper解决什么痛点在没有这类工具之前共享AI账号主要有几种原始方式直接共享主账号密码极不安全、使用浏览器的多用户配置文件切换麻烦、或者手动分发Access Token有泄露风险且无法控制用量。这些方式都存在管理混乱、安全风险高、无法追踪使用情况的问题。PandoraHelper的设计思路非常清晰“主账号集中管控子账号按需分发”。它将复杂的令牌管理和会话代理逻辑封装在后端对最终用户呈现的只是一个简单的登录页面和熟悉的聊天界面。这种设计带来了几个核心优势安全性提升用户永远接触不到主账号的Refresh Token或密码。他们使用的是由系统生成的、具有时效性和用量限制的Share Token。即使Share Token泄露影响范围也仅限于该共享账号的配额不会危及主账号。管理便捷性所有账号的状态、令牌有效期、用量统计都在一个管理后台清晰展示。支持自动刷新令牌避免了因令牌过期导致的服务中断。精细化的共享控制这是我认为最实用的部分。你可以为每个共享账号设置模型调用次数限制例如限制某个共享账号每月只能使用50次GPT-4。有效期设置共享链接几天或几周后自动失效。会话隔离确保不同共享账号之间的聊天记录完全独立互不可见。站点限制限制该共享账号只能在特定的域名下使用如果你部署了多个前端。道德审查开关可以启用或禁用内容安全策略。2.2 架构与核心组件解析PandoraHelper可以看作是一个“胶水层”和“控制面板”。它的核心依赖是Pandora-Next的服务端能力。简单拆解一下其工作流程后端 (go-nunu框架)负责用户认证、账号管理、Share Token的生成与策略执行、数据统计等业务逻辑。它通过调用Pandora-Next的API来执行实际的令牌刷新、会话创建等操作。前端 (Slash-Admin)提供管理员后台和用户登录/聊天界面。管理员后台用于配置用户界面则是一个代理将用户的聊天请求转发给后端的Pandora-Next服务再由其与OpenAI/Anthropic的官方API通信。数据存储默认使用SQLite数据库data.db将所有配置、账号信息、使用记录存储在一个文件中部署非常轻量。Pandora-Next服务这是真正的“发动机”。PandoraHelper通过配置中的pandora.domain指向Pandora-Next的反代地址。用户的所有聊天请求最终都由Pandora-Next来处理并转发至官方API。这种解耦的设计很棒意味着你可以单独维护和升级Pandora-Next服务而PandoraHelper主要专注于上层管理功能。注意项目文档中提到的oaifree.com和fuclaude.com是原作者提供的公共反代服务地址。对于生产环境或个人重度使用强烈建议自建Pandora-Next服务以避免公共服务的不可控因素如限流、宕机。下文会详细说明如何将PandoraHelper与你自己的Pandora-Next服务对接。3. 部署实战从零开始搭建你的私有AI账号管家纸上得来终觉浅我们直接动手部署。我将以最常用的Docker Compose方式为例因为它能更好地管理服务依赖和生命周期。同时我会涵盖如何集成自建的Pandora-Next服务。3.1 前期准备与环境假设一台服务器可以是云服务器如腾讯云、阿里云的轻量应用服务器、本地NAS甚至是一台常年开机的旧电脑。系统推荐 Linux如 Ubuntu 22.04。已安装Docker和Docker Compose如果还没安装可以执行以下命令以Ubuntu为例# 安装Docker curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # 安装Docker Compose插件 sudo apt-get update sudo apt-get install docker-compose-plugin # 验证安装 docker --version docker compose version一个域名可选但推荐如果你希望通过域名访问并配置HTTPS需要准备一个域名。本文会演示使用Nginx Proxy ManagerNPM来轻松管理反向代理和SSL证书。3.2 部署自有的Pandora-Next服务关键步骤这是保证服务稳定性的关键。我们使用Pandora-Next的官方Docker镜像。创建专用目录并编写配置mkdir -p ~/pandora-helper/pandora-next cd ~/pandora-helper/pandora-next创建config.json文件这是Pandora-Next的核心配置。一个最简化的、用于对接PandoraHelper的配置如下{ bind: 0.0.0.0:8181, proxy_api_prefix: , timeout: 600, license_id: YOUR_LICENSE_ID_HERE }重要license_id需要去Pandora-Next的项目页面通常是GitHub获取。请遵循其开源协议的要求。这是一个必须的步骤。创建Docker Compose文件 创建docker-compose.yml文件version: 3.8 services: pandora-next: image: pengzhile/pandora-next container_name: pandora-next restart: unless-stopped ports: - 8181:8181 volumes: - ./config.json:/app/config.json - ./data:/app/data - ./logs:/app/logs environment: - TZAsia/Shanghai启动Pandora-Next服务docker compose up -d使用docker logs pandora-next查看日志确认服务在8181端口启动成功。此时你的Pandora-Next服务地址就是http://你的服务器IP:8181。3.3 部署PandoraHelper并连接自有服务现在来部署主角PandoraHelper并让它使用我们刚部署的Pandora-Next。创建PandoraHelper目录和配置文件mkdir -p ~/pandora-helper/helper/data cd ~/pandora-helper/helper创建config.json文件。这里需要修改pandora.domain部分指向我们自建的Pandora-Next。{ security: { admin_password: YourStrongAdminPassword123! // 必须修改且长度大于8位 }, http: { host: 0.0.0.0, port: 9000, title: My AI Hub, rate: 100 }, database: { driver: sqlite, dsn: ./data/data.db }, share: { random: true, custom: true }, pandora: { domain: { chat: http://你的服务器IP:8181, // 修改为你的Pandora-Next地址 token: http://你的服务器IP:8181, // 同上 index: http://你的服务器IP:8181, // 同上 claude: http://你的服务器IP:8181/api/claude // Claude服务路径 } }, log: { level: info, encoding: console, output: console, log_file_name: ./logs/server.log, max_backups: 30, max_age: 7, max_size: 1024, compress: true } }实操心得admin_password务必设置得复杂且唯一这是管理后台的钥匙。pandora.domain中的四个地址在自建环境下通常可以指向同一个Pandora-Next服务地址端口8181。claude路径可能需要根据你使用的Pandora-Next版本进行调整如果Claude无法工作可以尝试先改为和前面一样的地址。创建PandoraHelper的Docker Compose文件 创建docker-compose.yml文件version: 3.8 services: pandora-helper: image: q11391/pandora-helper container_name: pandora-helper restart: unless-stopped ports: - 9000:9000 volumes: - ./data:/app/data - ./config.json:/app/config.json environment: - TZAsia/Shanghai # 如果你的Pandora-Next和Helper不在同一台机器需要确保网络可达。 # 在同一台机器时可以使用 extra_hosts 或直接使用服务器内网IP。启动PandoraHelperdocker compose up -d访问http://你的服务器IP:9000你应该能看到PandoraHelper的登录页面。访问http://你的服务器IP:9000/admin用你设置的admin_password登录管理后台。3.4 使用Nginx Proxy Manager配置域名与HTTPS可选但推荐为了安全和使用方便强烈建议配置域名和HTTPS。Nginx Proxy Manager (NPM) 提供了图形化界面来管理反向代理和申请Let‘s Encrypt免费SSL证书。部署NPMmkdir -p ~/npm/data cd ~/npm创建docker-compose.ymlversion: 3.8 services: app: image: jc21/nginx-proxy-manager:latest container_name: nginx-proxy-manager restart: unless-stopped ports: - 80:80 - 81:81 - 443:443 volumes: - ./data:/data - ./letsencrypt:/etc/letsencrypt配置反向代理启动NPM后访问http://你的服务器IP:81初始邮箱adminexample.com密码changeme。登录后首先修改密码。点击 “Proxy Hosts” - “Add Proxy Host”。Details标签Domain Names: 填写你的域名如ai.yourdomain.com。Scheme:httpForward Hostname / IP: 填写你服务器的内网IP如192.168.1.100如果NPM和PandoraHelper在同一台机器填host.docker.internal或172.17.0.1(Docker网关)。Forward Port:9000(PandoraHelper的端口)。SSL标签勾选 “Force SSL”。申请SSL证书点击 “Request a new SSL Certificate”勾选 “I agree...”点击保存。成功后会显示绿色证书图标。保存后你就可以通过https://ai.yourdomain.com安全地访问PandoraHelper了。4. 核心功能配置与使用详解部署完成后我们进入管理后台看看如何具体使用。4.1 添加与管理主账号登录管理后台 (/admin)进入“账号管理”。获取账号令牌这是第一步。你需要获取你的ChatGPT或Claude账号的Refresh Token或Access Token。ChatGPT浏览器登录ChatGPT网页版打开开发者工具 (F12)在Application-Cookies中找到__Secure-next-auth.session-token的值。使用这个值可以通过一些开源工具如pandora项目提供的脚本来获取Refresh Token。更简单的方法是使用浏览器插件如 “ChatGPT Token” 等使用时请注意插件安全性。Claude流程类似需要获取sessionKey对应的令牌。注意事项Refresh Token权限很高可以生成新的Access Token请妥善保管。PandoraHelper支持填入Refresh Token这样系统可以帮你自动刷新保证服务不间断。如果只填入Access Token有效期较短则需要手动更新。在PandoraHelper中添加账号点击“新建”在“Refresh Token”或“Access Token”字段粘贴你获取到的令牌。“Email”字段填写该账号对应的邮箱便于标识。“密码”字段可以随意填写它仅用于在PandoraHelper后台显示与真实账号密码无关。保存后该账号会出现在列表中。如果提供了Refresh Token可以点击“刷新”按钮手动刷新Access Token系统也会在每日凌晨自动执行此操作。4.2 创建并配置共享账号Share Token这是发挥PandoraHelper威力的核心操作。在“账号管理”列表中找到你想分享的主账号点击其“共享”列下的 “” 号。弹出的配置项非常丰富这里详细解释每一个Unique Name / 密码这是最终用户登录PandoraHelper前端 (/login) 时使用的凭证。可以理解为子账号的用户名和密码。有效期设置该共享账号的过期时间。到期后自动失效非常适合临时分享。站点限制可以填入允许使用该Share Token的域名多个用英文逗号隔开。如果你有多个部署了PandoraHelper前端的站点这个功能可以防止令牌被滥用。GPT-3.5 / GPT-4 次数设置该共享账号总共能调用对应模型的次数。达到上限后该共享账号将无法再使用该模型。每天重置限额这是一个非常实用的功能勾选后上面设置的“次数”限制将变为每日限额。系统会在每天凌晨重置计数。例如你设置GPT-4次数为10并勾选此项那么用户每天最多只能用10次GPT-4第二天又会恢复10次。显示用户信息如果勾选用户在聊天界面的设置菜单中会看到主账号的邮箱。通常建议关闭以保护隐私。会话隔离强烈建议开启。确保不同共享账号之间的聊天历史完全独立。如果不开启所有使用同一主账号生成的共享账号将看到同一个聊天历史列表。临时聊天开启后该共享账号的所有对话都不会被保存到历史记录中。适合用于一次性、无需上下文的任务。配置完成后点击保存系统就会生成一个唯一的Share Token。你可以将这个Token直接分发给用户他们需要自行配置到支持Pandora-Next的客户端但更好的方式是直接告诉他们PandoraHelper的登录地址、Unique Name和密码让他们通过Web界面使用体验最好。4.3 用户端使用体验对于最终用户来说体验非常简单打开你提供的PandoraHelper网站地址如https://ai.yourdomain.com。点击登录输入你分配给他们的Unique Name和密码。登录成功后会跳转到一个与官方ChatGPT/Claude界面几乎一模一样的聊天页面。他们可以自由选择可用的模型取决于主账号的权限和你设置的限制开始对话。用户完全感知不到背后复杂的账号管理和令牌流转他们获得的是一个稳定、可控、界面熟悉的AI助手服务。5. 高级配置、维护与故障排查5.1 配置文件与环境变量详解除了基础的config.jsonPandoraHelper的所有配置都支持通过环境变量覆盖这在Docker或K8s环境中非常方便。环境变量的命名规则是将JSON的路径用下划线连接并转为大写。例如security.admin_password-SECURITY_ADMIN_PASSWORDhttp.port-HTTP_PORTpandora.domain.chat-PANDORA_DOMAIN_CHAT在Docker Compose中可以这样配置environment: - SECURITY_ADMIN_PASSWORDMySuperSecretPass - HTTP_TITLETeam AI Portal - PANDORA_DOMAIN_CHAThttp://my-pandora-next:81815.2 数据备份与迁移所有数据账号信息、共享配置、使用记录都存储在data.db这个SQLite文件中。定期备份这个文件就是备份了整个系统。备份直接复制./data/data.db文件即可。迁移在新服务器上部署好PandoraHelper的Docker容器后先停止服务用备份的data.db文件覆盖新生成的空文件然后修改config.json中的服务器相关配置如域名最后重启容器即可。5.3 常见问题与排查实录在实际部署和使用中我遇到过一些典型问题这里分享排查思路问题1用户登录后聊天界面一直“连接中”或报错。排查思路这几乎总是因为pandora.domain配置错误导致前端无法连接到后端的Pandora-Next服务。首先确保你的Pandora-Next服务本身是健康的。访问http://你的Pandora-Next地址:8181应该能看到一个简单的页面或返回信息。进入PandoraHelper管理后台的“分享管理”找一个Share Token尝试“复制”并在其他支持Pandora-Next的客户端如ChatGPT-Next-Web中测试。如果同样失败证明是Pandora-Next服务或令牌本身的问题。检查PandoraHelper的config.json确保pandora.domain下的所有地址都能从PandoraHelper容器内访问。在Docker中如果服务在同一台主机可以使用宿主机的内网IP或Docker的网关IP如172.17.0.1而不是localhost。查看PandoraHelper和Pandora-Next的Docker日志寻找错误信息。docker logs pandora-helper --tail 50 docker logs pandora-next --tail 50问题2共享账号的用量限制不生效。排查思路首先确认在创建共享账号时是否正确设置了“次数”并点击了保存。然后在“分享管理”页面查看该Share Token的详情确认限额信息是否显示正确。可能原因Pandora-Next服务有它自己的缓存机制。有时策略更新会有延迟。可以尝试在PandoraHelper后台对该Share Token点击“禁用”再“启用”强制同步策略到Pandora-Next。问题3主账号的Access Token无法自动刷新。排查思路确保添加主账号时填入的是Refresh Token而非Access Token。只有Refresh Token才具有续期能力。检查Pandora-Next服务的日志看刷新任务是否在执行是否有报错如网络问题导致无法连接OpenAI。问题4Docker容器启动失败提示端口被占用。排查思路检查9000或8181端口是否已被其他程序占用。sudo lsof -i:9000 sudo netstat -tulpn | grep :9000如果被占用可以修改docker-compose.yml中ports的映射例如将- 9000:9000改为- 9001:9000然后通过http://服务器IP:9001访问。5.4 性能与扩展建议资源消耗PandoraHelper本身非常轻量占用内存和CPU极少。主要的资源消耗在于Pandora-Next服务以及它代理的AI对话。对于小规模使用几十个用户1核2G的服务器绰绰有余。高可用对于更严肃的用途可以考虑将PandoraHelper的data.db文件放在网络存储上并使用Docker Swarm或Kubernetes部署多个实例实现负载均衡和故障转移。不过对于绝大多数个人和小团队场景单机部署加上定期备份已经足够可靠。安全加固务必使用HTTPS避免令牌在传输中被截获。admin_password设置强密码。定期检查并更新PandoraHelper和Pandora-Next的Docker镜像到最新版本以获取安全更新。在防火墙中只开放必要的端口如80, 443, 22。部署并熟练使用PandoraHelper后管理多个AI账号就从一件琐事变成了一种享受。它清晰地划分了管理者和使用者的边界既提供了强大的控制力又保证了最终用户的简洁体验。无论是用于小团队的协作还是个人账号的整理这都是一款值得投入时间部署的精良工具。