EasyLLM

EasyLLM 是一个轻量级 OpenAI / Codex 账号管理与本地编码对接工具，后端使用 Go，前端使用 Vue 3。它把账号导入、Token 刷新、配额查询、Codex CLI 配置切换和本地 OpenAI 兼容代理集中到一个本机界面里，不提供公网部署服务。

核心能力

• 统一管理 OpenAI / Codex OAuth 账号、API Key 账号和 Codex CLI 本机配置。
• 一键切换 Codex 当前账号，自动写入 ~/.codex/auth.json 与本机代理配置。
• 批量导入 Token、CPA、refresh token 列表和 EasyLLM 备份文件，适合多账号迁移与恢复。
• 内置 OpenAI 兼容本地代理，提供 /v1/responses、/v1/chat/completions、/v1/models 等接口。
• 支持 round_robin、random、least_used 调度策略，并可按账号状态自动跳过不可用账号。
• 支持配额刷新、Token 刷新、账号可用性检查和 Codex 本地 API 服务注入。
• 支持本机 API Key 鉴权、IP 黑名单、HTTP 代理转发和本地 SQLite 持久化。
• 默认不保留代理请求日志，减少提示词、响应内容和账号敏感信息落盘。
• 支持脚本启动、手动构建、Windows zip 和 macOS App 打包分发。

项目优势

• 轻量低占用：macOS M4 空闲状态实测，EasyLLM App 外壳约 78 MB RSS，后端 easyllm 约 32 MB RSS，合计约 110 MB，CPU 约 0.0%。实际占用会随账号数量、导入任务和并发请求变化。
• 本机优先：脚本模式默认监听 127.0.0.1:8022，macOS App 默认从 8022 起自动选择可用本机端口；账号、Token、配置和 SQLite 数据都留在本机，不依赖公网托管服务。
• Codex 友好：围绕 Codex CLI 的账号池、切换、代理注入和配置修复设计，减少手动编辑 auth.json / config.toml 的成本。
• OpenAI 兼容：本地代理保持 OpenAI 风格接口，现有脚本、工具和客户端可以直接指向 EasyLLM。
• 批量维护效率高：账号导入、配额刷新、Token 刷新、导出备份和恢复集中在一个界面里完成。
• 安全边界清晰：默认不记录代理请求内容，敏感运行产物已加入忽略规则，并提供 pre-push 隐私检查脚本。
• 开源可分发：采用 Apache-2.0 许可，仓库结构精简到 OpenAI / Codex 主线，方便二次开发和本地审计。

文档入口

• 使用指南：账号导入、Codex CLI 接入、代理池、API 示例。
• 开发说明：本地环境、常用命令、测试与构建。
• 项目结构：源码目录、运行产物和维护约定。
• macOS App：原生 App 打包与运行数据位置。

快速开始

Release 包

从 GitHub Releases 下载对应系统的压缩包：

系统 / 设备	下载文件	启动方式
Windows 10/11 64 位	EasyLLM-*-windows-amd64.zip	解压后运行 start-easyllm.bat
Mac Apple Silicon（M1/M2/M3/M4）	EasyLLM-*-macos-arm64.zip	解压后运行 EasyLLM.app
Mac Intel 芯片	EasyLLM-*-macos-amd64.zip	解压后运行 EasyLLM.app

不确定 Mac 芯片类型时，点击系统左上角 Apple 菜单 →「关于本机」，查看“芯片”或“处理器”。

默认访问：

http://localhost:8022

一键脚本

git clone https://github.com/Xchat1/EasyLLM.git
cd EasyLLM
cp .env.example .env
./scripts/start.sh --build

访问：

http://localhost:8022

根目录 ./start.sh 仍可用，它会转发到 ./scripts/start.sh。

手动构建

cd web
npm install
npm run build
cd ..

CGO_ENABLED=1 go build -o easyllm .
./easyllm

macOS App

./scripts/build-macos-app.sh
open build/macos/EasyLLM.app

生成 macOS Release zip：

./scripts/build-macos-app.sh --package --version 2.0.0

Windows Release zip 由 Windows / PowerShell 环境执行：

.\scripts\package-windows.ps1 -Version 2.0.0 -Arch amd64

基础配置

复制 .env.example 为 .env 后按需修改：

变量	默认值	说明
SERVER_PORT	8022	HTTP 服务端口
SERVER_HOST	127.0.0.1	监听地址
DB_SQLITE_PATH	DATA_DIR/easyllm.db	SQLite 文件路径；留空时和 macOS App 共用同一套本地数据
DATA_DIR	系统应用配置目录下的 EasyLLM/data	本地数据目录；macOS 为 ~/Library/Application Support/EasyLLM/data
SECRET_KEY	空	JWT/会话密钥，建议设置长随机值以便重启后保持登录
DEFAULT_PASSWORD	空	可选；留空时首次访问 Web UI 创建登录密码；如设置需至少 8 位
PROXY_ENABLED	false	出站 HTTP 代理开关
PROXY_HOST	空	出站代理主机
PROXY_PORT	空	出站代理端口

隐私与安全

• 不要提交 .env、auth/、Token/CPA JSON、EasyLLM 导出备份、私钥、API Key 或数据库文件。
• 建议启用仓库内置 pre-push 钩子：

git config core.hooksPath .githooks

• EasyLLM 面向本机使用，脚本模式默认监听 127.0.0.1:8022；不要把包含账号 Token 的本地服务对公网开放。

技术栈

层	技术
后端	Go、Gin、GORM
前端	Vue 3、Vite、Tailwind CSS
数据库	SQLite
运行	本地脚本、手动构建、Windows zip、macOS App

License

EasyLLM is licensed under the Apache License 2.0.

交流与反馈

_{扫码加入 Codex JSON 共享群；二维码过期时请查看仓库中的最新图片。}