快速开始

选择适合你的方式。所有方式均免费且开源（Apache 2.0）。

Docker（Web 应用）

docker pull ghcr.io/wsj-br/transrewrt:latest

docker run -d \
  -p 5000:5000 \
  -v transrewrt-data:/app/data \
  -e PROVIDER_API_KEY=your-api-key \
  --name transrewrt \
  ghcr.io/wsj-br/transrewrt:latest

将 PROVIDER_API_KEY 替换为你的提供商对应的变量（例如 OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、XIA_API_KEY 等），并设置其值。完整列表请参见配置。

然后打开 http://localhost:5000，在公开服务之前修改默认管理员密码。

Docker Compose

wget https://github.com/wsj-br/transrewrt/raw/refs/heads/master/production.yml -O transrewrt.yml
# Edit the file to add your API keys, or use a `.env` file. Set TZ if needed.
docker compose -f transrewrt.yml up -d

Windows

从发布页面下载最新的 Transrewrt Setup x.y.z.exe。
运行安装程序。
打开应用并在设置 → API 配置中输入 API 密钥。至少配置一个提供商；OpenRouter 是获取免费模型的常用选择。

Linux

从发布页面下载适合你 CPU 的 .AppImage（x64 或 arm64，包括 Raspberry Pi 4+）：

chmod +x Transrewrt-x.y.z-x64.AppImage && ./Transrewrt-x.y.z-x64.AppImage

在设置 → API 配置中输入 API 密钥。

如果 Chromium 输出 GPU / EGL 错误但应用仍能正常运行，你可以禁用硬件加速：

TRANSREWRT_DISABLE_GPU=1 ./Transrewrt-x.y.z-arm64.AppImage

macOS

从发布页面下载适用于您 Mac 的 .dmg：

Apple Silicon — Transrewrt-x.y.z-arm64.dmg
Intel — Transrewrt-x.y.z-x64.dmg

打开磁盘映像，将 Transrewrt 拖到“应用程序”中。在设置 → API 配置中输入 API 密钥。

或者清除隔离属性：

xattr -dr com.apple.quarantine /Applications/Transrewrt.app

更新

Windows — 从发布页面下载较新的 Transrewrt Setup x.y.z.exe 并运行。设置和数据会保留。
Linux — 下载较新的 .AppImage 并替换旧文件。设置和数据会保留。
macOS — 下载较新的 .dmg，打开它，将 Transrewrt 拖到“应用程序”中，替换现有应用。设置和数据会保留。
Docker — 拉取新镜像并重新创建容器。数据持久保存在 /app/data 卷中：

docker pull ghcr.io/wsj-br/transrewrt:latest
docker stop transrewrt && docker rm transrewrt
# then run the same `docker run` command as above
# or, with Docker Compose:
docker compose -f transrewrt.yml pull && docker compose -f transrewrt.yml up -d

后续步骤

获取 API 密钥
运行一次简单的翻译以确认一切正常
阅读翻译、改写和转换指南