freebucks-proxy README

The project's README from github.com/trefeon/freebucks-proxy. As one markdown file: README.md.

freebuff-proxy

Go wire gateway in front of FreeBuff, with OpenAI-compatible and Anthropic endpoints plus an embedded Svelte dashboard.

What it is

Quickstart

cp .env.example .env   # then edit: AUTH_TOKENS, ADMIN_TOKEN, ...
go build ./backend/...
go run ./backend/cmd/freebuff-proxy

Then:

Defaults that matter (.env.example): SAFE_MODE=true (anti-ban preset), COST_MODE=free, 30 req/min and 1500 req/day Pacific limits.

Layout

Contributing

Protected main: branch → PR → green CI → squash merge, Conventional Commits. See AGENTS.md for the full operating guide. Never commit secrets.

freebucks-proxy (trefeon/freebucks-proxy)

Searching Database…

300 ·GitHub
archived
这是什么?一个位于 FreeBuff 前面的 Go 网关,对外提供兼容 OpenAI 和兼容 Anthropic 的聊天端点,把请求转换成 FreeBuff 的传输协议,并内置一个 Svelte 管理面板。
这是我自己运行的代理服务器,还是托管 API?它是一个自托管代理服务器(二进制或 Docker 容器),运行在你自己的机器上;它对外提供 /v1/chat/completions、/v1/models 和一个 /admin 管理面板。
怎么让它跑起来?参照 .env.example 配置好 .env 文件,然后启动 Go 后端(或使用附带的 Dockerfile/compose 配置),即可拉起网关和位于 /admin 的内嵌管理面板。
用它需要 FreeBuff 的认证 token 吗?需要——它依赖 FreeBuff 凭据。设置 AUTHTOKENS 会进入池化或混合模式;把 AUTHTOKENS 留空则切换到桥接模式,此时每个请求必须自带 token。
这个项目还在维护吗?不维护了——仓库已被明确标记为弃用且无人维护,因此后续不保证有更新、错误修复,也不保证兼容 FreeBuff 的变化。
谁会用这个?想用标准的 OpenAI 或 Anthropic API 客户端与 FreeBuff 通信、而不是直接使用 FreeBuff 原生传输协议的开发者。
三种运行模式是什么?池化模式使用共享 token 池(设置 AUTHTOKENS,禁用桥接);桥接模式转发每个请求自带的 token(AUTHTOKENS 为空);混合模式(设置 AUTHTOKENS 时的默认模式)对 APIKEYS 凭据使用池,而把其他凭据当作桥接 token 转发。
freebucks 的计量是怎么工作的?Freebucks 在会话开始时按每个会话小时收取一次,会话提前删除会退还,并按太平洋时间午夜的节奏补充,遵循 FreeBuff 的传输价格映射。
有内置的速率限制吗?有,默认的 .env.example 自带一个安全模式防封禁预设,把用量限制在每分钟 30 次请求、每天 1,500 次请求(按太平洋时间计)。
管理面板显示什么?它是一个直接嵌入 Go 二进制文件的 Svelte 单页应用,在 /admin 路径提供服务,用于管理和监控网关。
Creator
trefeon
Size
45.8 MB
Stars
300
Age
2mo
Commits · 90 Days