本地模式
默认如果只有你一人，或是一个已经处于可信网络之后的小团队，请选择这个。
- 完全没有登录页面——任何能访问该端口的人都可以看到全部项目。
- SQLite 存储在一个 Docker 卷中，无需运行第二个服务。
- 没有任何对外请求。此实例不依赖任何外部服务。
自主托管
一个镜像，运行在 你自己的基础设施上
该仪表盘以单个 Docker 镜像的形式发布，运行在你自己掌控的硬件上。支持三种数据库引擎，除非你主动配置，否则不会发送任何遥测数据，拉取镜像也无需账户。
拉取镜像
无需账户，无需登录镜像仓库，也无需检出源码——该镜像公开托管在 Docker Hub。
运行在你自己域名下的实例
i18n.example.com所有系统运行正常
v0.23.0服务器模式
- 数据库
1156 keys正常 - SMTP
smtp.example.com正常 - 翻译服务商
google-free正常
这是 GET /api/health在正在运行的实例上报告的内容——与你的编排系统和可用性监控读取的是同一个探测接口。
1
需要运行的容器数
3
数据库引擎数
2
支持的 CPU 架构数
0
默认遥测
自托管能带来什么，又需要付出什么代价
没有可供对比的托管版仪表盘——自托管本身就是这款产品的运行方式。真正该问的不是是否值得，而是你需要自己承担什么。
始终留在你这一边
- 你的源代码。 扫描器从你自己的网络内部读取代码仓库。不会有任何内容被上传以提取其中的键值。
- 你的翻译数据。 翻译数据保存在你为容器指定的数据库中——可以是卷中的一个 SQLite 文件，也可以是你已经在运行的 Postgres/MySQL 服务器。
- 你的服务商密钥。 DeepL、Google、LibreTranslate：调用请求从你的实例发出，并使用你自己的会话密钥加密存储。
- 你的网络边界。 公开的端口默认绑定到 127.0.0.1。在你决定开放之前，其他任何设备都无法访问。
变成你自己的工作
- TLS 与反向代理。 镜像本身不终止 TLS。要将其暴露到 localhost 之外,需要在前面部署 Caddy、nginx 或 Traefik。
- 备份，以及对备份的验证。 一个数据卷或一次数据库转储。内置 CLI 可以将一切导出为 JSON，但恢复工作仍需你自己完成。
- 升级。 拉取新标签并重启即可。迁移会在启动时自动执行，失败的迁移不会被记录，因此下次启动时会重新尝试。
- 服务器模式下的登录。 在一个实例上支持多个账户需要一个兼容 JWKS 的 OIDC 颁发方——可以是你自己的，也可以使用我们运营的。本地模式完全没有登录功能。
你想如何运行它
三种模式，一个镜像。模式决定了是否存在登录页面、以及实例依赖什么——不会改变产品本身。
服务器模式
多团队如果需要多人在同一实例上拥有各自的账户，请选择这个。
- 登录、角色，以及“草稿 → 已审核 → 已批准”的工作流。
- 联网数据库——PostgreSQL 或 MySQL。
- 需要一个随时可访问、兼容 JWKS 的 OIDC 颁发方：可以是你自己的，也可以使用我们运营的。
桌面版
无需 Docker如果你完全不想运行服务端，请选择这个。
- 内置服务端的 macOS、Windows、Linux 原生安装包。
- 翻译保存在本地 SQLite 中——不会离开这台设备。
- 登录仍然通过你的在线账户完成。
你的数据库，你的 compose 文件
三种引擎都拥有相同的 27 张表，因此选择并非关乎正确性，而是关乎你打算如何备份实例，以及还有谁需要访问它。
一个文件，一个容器
这是发布镜像默认提供、桌面应用也在使用的方式。无需第二个服务，也无需管理任何凭据。整个实例只是这一个文件加一个 Docker 卷。
端口绑定的地址是
127.0.0.1，这是刻意的设计：只能从本机访问，其他任何地方都无法访问。本地模式没有登录页面，因此只应在你已经信任的代理、防火墙或 VPN 之后放宽这一绑定。自托管会带来什么不同
| 对比项 | 桌面应用 | 自主托管 |
|---|---|---|
| 安装 | 下载后直接打开 | docker compose up -d |
| 数据库 | 内置 SQLite | SQLite、PostgreSQL 或 MySQL |
| 数据存储的位置 | 你的本机 | 您的基础设施 |
| 更新 | 自动 | docker compose pull && docker compose up -d |
| 团队访问 | 仅限本机上的你 | 整个团队——服务器模式需要一个 OIDC 提供方（您自己的，或我们的） |
接下来
其余流程都记录在文档中
本页面只解决一个决定：是否自行运行、以哪种模式、使用哪种引擎。首次成功启动之后的一切内容都统一记录在一处文档中，因此永远只存在一个版本。
- 环境变量 ——每一项的默认值和适用范围。
- SMTP ——工作流通知；如果留空主机地址,则完全不会发送通知。
- 角色与权限 ——当多人共用同一实例时,谁可以审批翻译。
- Webhook ——你自己的系统可以响应的已签名事件。
- 备份与恢复 ——数据卷、数据库转储，以及可将一切导出为 JSON 的 CLI。
- 故障排查 ——实际会遇到的错误,以及每种错误的含义。