KO
|
EN
gitlite — search
Search
#typescript
#ai-agents
#deepseek-harness
#dsh-plugin
#open-source
#ai
#cli
#dsh
#claude-code
#codex
#developer-tools
#react
Dreamina-Token-Manager
★ 28
Open GitHub ↗
No description available.
Download README (.md)
Explore Similar Repositories
Dreamina_auto_Sign
:
自动注册Dreamina账号并保存，无限制使用Seedance2.0 Fast。
NexusAPI
:
将多个 AI 服务（Gemini Business、Dreamina、Kiro 等）转换为 OpenAI 兼容接口，支持多账号自动注册、负载均衡、图像生成、视频生成、多模态能力与内置管理面板。
-Dreamina-free-api
:
即梦Dreamina free api，适配手机浏览器
Comfyui_Free_Dreamina
:
这个插件为ComfyUI提供了Dreamina(即梦国际版)的文生图和图生图功能，让你可以在ComfyUI工作流中使用Dreamina的强大生成能力。
DreaminaTool
:
即梦插件
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
Dreamina-Token-Manager
?
Download (.md)
# Dreamina Token Manager 一个用于管理 Dreamina AI 服务 SessionID Token 的完整解决方案，提供自动化的账户管理、SessionID 获取与刷新、以及 API 代理功能。 ## 📋 功能特性 ### 🔐 账户管理 - **批量账户添加**：支持单个或批量添加 Dreamina 账户 - **自动登录验证**：使用 Playwright 自动登录并获取 SessionID - **账户状态监控**：实时显示账户登录状态和 Token 有效期 - **数据持久化**：支持文件存储和 Redis 两种存储模式 ### 🔄 SessionID 管理 - **自动刷新**：智能检测即将过期的 SessionID 并自动刷新 - **手动刷新**：支持单个或批量强制刷新所有账户 - **过期预警**：24小时内过期的账户会有明显标识 - **负载均衡**：多个账户间轮询分配，提高并发性能 ### 🌐 API 代理 - **透明代理**：将请求透传到目标 AI 服务 - **自动 Token 注入**：自动将有效的 SessionID 注入到请求头 - **负载均衡**：多个账户间智能分配请求 - **目标配置**：支持动态配置代理目标地址 ### 🎨 Web 管理界面 - **现代化 UI**：基于 Vue 3 + Tailwind CSS 的响应式界面 - **实时更新**：通过 SSE 实现任务状态实时推送 - **批量操作**：支持批量添加、删除、刷新等操作 - **数据导出**：支持导出账户列表 ### 🐳 部署支持 - **Docker 部署**：提供完整的 Docker 镜像和 Compose 配置 - **PM2 集群**：支持多进程部署，提高稳定性 - **Redis 集成**：可选的 Redis 支持用于分布式部署 ## 🚀 快速开始 ### 环境要求 - Node.js >= 16.0.0 - npm >= 8.0.0 - 可选：Redis（用于分布式部署） - 可选：Docker & Docker Compose ### 安装部署 #### 方式一：直接部署 ```bash # 1. 克隆项目 git clone <repository-url> cd Qwen2API # 2. 安装依赖 npm install # 3. 安装前端依赖并构建 cd public npm install npm run build cd .. # 4. 配置环境变量 cp .env.example .env # 编辑 .env 文件配置必要参数 # 5. 启动服务 npm run dev # 开发模式 npm start # 生产模式 ``` #### 方式二：Docker 部署 ```bash # 1. 使用 Docker Compose（推荐） docker compose -f docker-compose.yml up -d # 2. 使用 Redis 模式 docker compose -f docker-compose-redis.yml up -d # 3. 查看服务状态 docker compose ps ``` #### 方式三：PM2 部署 ```bash # 1. 安装 PM2 npm install -g pm2 # 2. 启动服务 npm run pm2 # 3. 查看状态 npm run pm2:status # 4. 查看日志 npm run pm2:logs ``` ## ⚙️ 配置说明 ### 环境变量配置 创建 `.env` 文件并配置以下参数： ```env # 服务配置 SERVICE_PORT=3000 # 服务端口 LISTEN_ADDRESS=0.0.0.0 # 监听地址（可选） # API 密钥配置 API_KEY=sk-dreamina-admin,sk-user1 # API 密钥列表，逗号分隔 # 数据存储配置 DATA_SAVE_MODE=file # 存储模式：none/file/redis REDIS_URL=redis://localhost:6379 # Redis 连接地址（Redis 模式时必需） # 代理配置 PROXY_TARGET= # 透传目标地址 PROXY_TIMEOUT_MS=600000 # 代理超时时间（毫秒） # 功能开关 SIMPLE_MODEL_MAP=false # 简化模型映射 OUTPUT_THINK=false # 输出思考过程 CACHE_MODE=default # 缓存模式 # 日志配置 LOG_LEVEL=INFO # 日志级别：DEBUG/INFO/WARN/ERROR ENABLE_FILE_LOG=true # 启用文件日志 LOG_DIR=./logs # 日志目录 MAX_LOG_FILE_SIZE=10 # 最大日志文件大小（MB） MAX_LOG_FILES=5 # 保留日志文件数量 # 代理日志 PROXY_LOG_BODY=false # 记录请求体 PROXY_LOG_BODY_MAX=2048 # 请求体最大记录长度 ``` ### 数据存储模式 #### 1. None 模式（`DATA_SAVE_MODE=none`） - 数据仅保存在内存中 - 服务重启后数据丢失 - 适合临时测试环境 #### 2. File 模式（`DATA_SAVE_MODE=file`） - 数据保存在 `data/data.json` 文件中 - 服务重启后数据持久化 - 适合单机部署 #### 3. Redis 模式（`DATA_SAVE_MODE=redis`） - 数据保存在 Redis 中 - 支持多实例共享数据 - 适合分布式部署 ## 📖 使用指南 ### Web 管理界面 1. **访问界面** ``` http://localhost:3000 ``` 2. **登录认证** - 输入 API 密钥进行身份验证 - 管理员密钥：`API_KEY` 中的第一个密钥 3. **添加账户** - 点击"添加账号"按钮 - 支持单个添加或批量添加 - 格式：`email:password` 4. **管理账户** - 查看账户状态和 SessionID 有效期 - 单个或批量刷新 SessionID - 删除不需要的账户 5. **配置代理** - 设置透传目标地址 - 实时查看代理状态 ### API 接口 #### 账户管理接口 ```bash # 获取所有账户 GET /api/dreamina/getAllAccounts Authorization: Bearer <API_KEY> # 添加账户 POST /api/dreamina/addAccount Authorization: Bearer <API_KEY> Content-Type: application/json { "email": "user@example.com", "password": "password123" } # 批量添加账户 POST /api/dreamina/addAccounts Authorization: Bearer <API_KEY> Content-Type: application/json { "accounts": [ "user1@example.com:password1", "user2@example.com:password2" ] } # 刷新单个账户 SessionID POST /api/dreamina/refreshSessionId Authorization: Bearer <API_KEY> Content-Type: application/json { "email": "user@example.com" } # 批量刷新 SessionID POST /api/dreamina/refreshAllSessionIds Authorization: Bearer <API_KEY> # 强制刷新所有 SessionID POST /api/dreamina/forceRefreshAllSessionIds Authorization: Bearer <API_KEY> # 删除账户 DELETE /api/dreamina/deleteAccount Authorization: Bearer <API_KEY> Content-Type: application/json { "email": "user@example.com" } # 删除所有账户 DELETE /api/dreamina/deleteAllAccounts Authorization: Bearer <API_KEY> ``` #### 代理配置接口 ```bash # 获取代理目标 GET /api/proxy/target Authorization: Bearer <API_KEY> # 设置代理目标 POST /api/proxy/target Authorization: Bearer <API_KEY> Content-Type: application/json { "target": "https://api.example.com" } ``` #### 代理接口 ```bash # 透传所有 API 请求 ALL /api/* Headers: - Authorization: Bearer <API_KEY> - 其他标准 HTTP 头 系统会自动： 1. 验证 API 密钥 2. 选择可用的 Dreamina 账户 3. 注入 SessionID 到请求头 4. 转发请求到目标地址 5. 返回响应给客户端 ``` ## 🔧 开发指南 ### 项目结构 ``` Qwen2API/ ├── src/ # 后端源码 │ ├── config/ # 配置文件 │ ├── middlewares/ # 中间件 │ ├── routes/ # 路由定义 │ ├── utils/ # 工具类 │ ├── server.js # 服务器入口 │ └── start.js # 启动脚本 ├── public/ # 前端源码 │ ├── src/ # Vue 源码 │ ├── dist/ # 构建产物 │ └── package.json # 前端依赖 ├── data/ # 数据存储目录 ├── logs/ # 日志目录 ├── docs/ # 文档资源 ├── docker-compose.yml # Docker 编排文件 ├── ecosystem.config.js # PM2 配置文件 └── package.json # 后端依赖 ``` ### 核心模块 #### 1. DreaminaAccount (`src/utils/dreamina-account.js`) - 账户管理核心类 - 负责账户的增删改查 - 自动刷新 SessionID #### 2. DreaminaTokenManager (`src/utils/dreamina-token-manager.js`) - SessionID 获取和管理 - Playwright 自动登录 - Token 有效性验证 #### 3. DataPersistence (`src/utils/data-persistence.js`) - 数据持久化抽象层 - 支持多种存储模式 - 统一的数据访问接口 #### 4. ProxyRouter (`src/routes/proxy.js`) - API 请求代理 - 负载均衡算法 - SessionID 自动注入 ### 开发命令 ```bash # 开发模式（后端热重载） npm run dev # 构建前端 cd public && npm run build # 启动生产环境 npm start # PM2 进程管理 npm run pm2 # 启动 npm run pm2:restart # 重启 npm run pm2:logs # 查看日志 npm run pm2:status # 查看状态 npm run pm2:delete # 删除进程 ``` ### 代码规范 - **语言**：JavaScript (Node.js CommonJS) - **风格**：单引号、无分号、2 空格缩进 - **命名**： - 文件名：`kebab-case` - 类名：`PascalCase` - 变量/函数：`camelCase` - **设计原则**：KISS、DRY、YAGNI、SOLID ## 🔍 监控与日志 ### 日志系统 系统提供完整的日志记录功能： ```bash # 查看应用日志 tail -f logs/app.log # 查看 PM2 日志 npm run pm2:logs # 查看 Docker 日志 docker compose logs -f ``` ### 日志级别 - **DEBUG**：详细的调试信息 - **INFO**：一般信息记录 - **WARN**：警告信息 - **ERROR**：错误信息 ### 关键监控指标 1. **账户状态**：登录成功率、SessionID 有效期 2. **代理性能**：请求成功率、响应时间 3. **系统资源**：内存使用、CPU 负载 4. **错误统计**：失败请求、异常次数 ## 🚨 故障排查 ### 常见问题 #### 1. 账户登录失败 **症状**：添加账户时提示登录失败 **解决方案**： - 检查账户密码是否正确 - 确认网络连接正常 - 验证 Dreamina 网站可访问性 - 查看详细日志确定具体原因 #### 2. SessionID 刷新失败 **症状**：自动刷新或手动刷新失败 **解决方案**： - 检查账户密码是否已更改 - 确认 Dreamina 登录流程未变更 - 验证网络连接稳定性 - 查看日志中的错误信息 #### 3. 代理请求失败 **症状**：API 请求返回错误 **解决方案**： - 检查代理目标地址是否正确 - 确认有可用的 Dreamina 账户 - 验证 API 密钥有效性 - 检查网络连接和防火墙设置 #### 4. 前端页面无法访问 **症状**：浏览器显示 404 或 500 错误 **解决方案**： - 确认前端已正确构建：`cd public && npm run build` - 检查 `public/dist` 目录是否存在 - 验证服务器启动是否正常 - 查看服务器日志获取详细错误信息 ### 调试模式 启用详细日志进行问题诊断： ```env # .env 文件 LOG_LEVEL=DEBUG ENABLE_FILE_LOG=true PROXY_LOG_BODY=true ``` ## 🤝 贡献指南 ### 提交规范 使用 Conventional Commits 规范： ```bash feat: 添加新功能 fix: 修复问题 docs: 文档更新 style: 代码格式调整 refactor: 代码重构 test: 测试相关 chore: 构建过程或辅助工具的变动 ``` ### Pull Request 流程 1. Fork 项目仓库 2. 创建功能分支：`git checkout -b feature/your-feature` 3. 提交更改：`git commit -m "feat: 添加新功能"` 4. 推送分支：`git push origin feature/your-feature` 5. 创建 Pull Request ### 代码审查 - 确保代码风格一致 - 添加必要的测试 - 更新相关文档 - 验证功能正常工作 ## 📄 许可证 本项目采用 ISC 许可证。详见 [LICENSE](LICENSE) 文件。 ## 🙏 致谢 感谢以下开源项目的支持： - [Express.js](https://expressjs.com/) - Web 框架 - [Vue.js](https://vuejs.org/) - 前端框架 - [Tailwind CSS](https://tailwindcss.com/) - CSS 框架 - [Playwright](https://playwright.dev/) - 自动化测试 - [PM2](https://pm2.keymetrics.io/) - 进程管理 - [Axios](https://axios-http.com/) - HTTP 客户端 ## 📞 支持 如果您在使用过程中遇到问题，请： 1. 查看本文档的故障排查部分 2. 检查 [Issues](../../issues) 页面 3. 创建新的 Issue 描述问题 4. 提供详细的错误信息和复现步骤 --- **注意**：本项目仅用于学习和研究目的，请遵守相关服务的使用条款和法律法规。
