TransBridge 🌉

TransBridge 是一个强大的翻译 API 代理服务，通过调用各种大模型 API 实现高质量的机器翻译功能，并提供兼容 DeepL API 接口格式。它提供了丰富的配置选项、灵活的缓存机制和完善的日志记录，可以作为多种大模型翻译服务的统一代理。

🌟 主要特点

• OpenAI 兼容服务支持：可配置 OpenAI、Ollama、DeepSeek、ChatGLM 等兼容 /v1/chat/completions 的服务
• 多模型加载均衡：支持基于权重的模型选择策略
• 上游限流：支持按 provider/model 配置最大并发、滑动窗口 QPS 和 QPM
• 多级缓存机制：灵活配置内存缓存、bbolt 本地持久化缓存和 Redis 缓存
• API 兼容：提供简化 /translate、DeepL v2 风格 /deepl/v2/translate 和沉浸式翻译批量接口
• 认证安全：支持 API 密钥认证
• 日志记录：异步日志系统，支持自动轮转
• 本地管理后台：支持模型、Token、Prompt 版本、请求统计和历史日志管理
• SQLite 持久化：管理后台数据、统计数据和审计数据重启后保留
• 翻译质量防护：跳过数据/单位/化学式等不应翻译内容，异常模型输出不写入缓存
• 高性能设计：异步日志、缓存优化等提升性能
• 跨平台：支持 Linux、macOS 和 Windows

🚀 快速开始

直接体验

🌐 演示地址：https://fruitbars.github.io/transbridge/

🔗 API服务: https://freeapi.fanyimao.cn/ 使用 Authorization: Bearer tr-98584e33-f387-42cc-a467-f02513bd400d 进行调用

curl --location --request POST 'https://freeapi.fanyimao.cn/translate?token=tr-98584e33-f387-42cc-a467-f02513bd400d' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "你好啊",
    "source_lang": "cn",
    "target_lang": "en"
}'

在沉浸式翻译中直接使用

DeepLx

在沉浸式翻译中直接配置地址使用：https://freeapi.fanyimao.cn/translate?token=tr-98584e33-f387-42cc-a467-f02513bd400d 详细配置说明可以参考:#3

自定义API

本地搭建使用

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tr-98584e33-f387-42cc-a467-f02513bd400d" \
  -d '{
    "source_lang": "zh",      
    "target_lang": "en",      
    "text_list": ["需要翻译的内容"] 
  }' \
  "http://127.0.0.1:8080/immersivel"

获取项目

git clone https://github.com/fruitbars/transbridge.git
cd transbridge

编译

从源码编译需要 Go 1.25 或更高版本。项目使用 modernc.org/sqlite 提供无 CGO 的 SQLite 管理后台存储，低于 Go 1.25 的工具链会在 go mod download 阶段失败。

使用编译脚本 (推荐)

项目提供了便捷的编译脚本 build.sh，可以轻松编译各种平台的版本：

# 添加执行权限
chmod +x build.sh

# 编译当前平台
./build.sh

# 编译所有平台
./build.sh --all

# 只编译 Linux 版本
./build.sh --linux

# 创建完整发布包
./build.sh --release

编译产物会存放在 dist/ 目录中，发布包位于 dist/release/ 目录。

支持./build.sh --linux等其他平台参数--darwin,--windows

手动编译

如果不想使用编译脚本，也可以手动编译：

# 为当前平台编译
go build -o transbridge

# 为 Linux 编译
GOOS=linux GOARCH=amd64 go build -o transbridge-linux-amd64

配置

创建配置文件 config.yml：

cp config.example.yml config.yml

按需修改 config.yml 中的上游 API 地址、模型名称和认证 token。核心结构如下：

server:
  port: 8080

providers:
  - provider: "openai"
    api_url: "https://api.openai.com/v1/chat/completions"
    api_key: "your-api-key-1"
    timeout: 30
    is_default: true
    models:
      - name: "gpt-3.5-turbo"
        weight: 10
        max_tokens: 2000
        temperature: 0.3

prompt:
  template: "Translate the following {{source_lang}} content to {{target_lang}}: {{input}}"

transapi:
  tokens:
    - "your-api-key"

storage:
  enabled: true
  type: "sqlite"
  path: "data/transbridge.db"

admin:
  enabled: true
  path: "/admin"
  username: "admin"
  password: "change-me"
  local_only: true

log:
  enabled: true
  file_path: "logs/translation.log"
  max_size: 100
  max_age: 30
  max_backups: 10
  queue_size: 1000

运行

./transbridge -config config.yml

使用示例

DeepL v2 风格接口：

curl -X POST "http://localhost:8080/deepl/v2/translate" \
  -H "Authorization: DeepL-Auth-Key your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": ["Hello world"],
    "source_lang": "EN",
    "target_lang": "ZH"
  }'

简化接口：

curl -X POST "http://localhost:8080/translate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world",
    "source_lang": "EN",
    "target_lang": "ZH"
  }'

📋 详细文档

• 配置详解
• API 接口文档
• 部署指南
• 技术文档

🔧 安装为系统服务

使用提供的脚本来安装为系统服务：

# 下载可执行文件后执行
chmod +x install-transbridge.sh
sudo ./install-transbridge.sh

这将创建一个系统服务，并自动启动。

🤝 贡献

欢迎贡献代码或提出建议！

📜 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

🙏 致谢

• go-openai - OpenAI API 客户端
• lumberjack - 日志轮转库

⚠️ 免责声明

本项目仅供学习和研究之用，请勿用于商业用途。使用本项目时请遵守相关 API 服务提供商的服务条款。