把 Escriba 带回家

Escriba 以一个预构建的 Docker 镜像形式发布，已经内置了它所需的一切 —— ffmpeg、Tesseract OCR、Whisper 以及一个嵌入式 Redis。无需额外接驳任何 服务。拉取镜像、设置密码，你就拥有了一个运行在自己基础设施上、私密的 文档转 Markdown 引擎。

为什么要自托管？

你的文档在你自己的机器上完成转换，并在之后立即删除。不留存任何内容， 不向任何第三方云发送任何东西。掌控权始终留在人这一层 —— 由你决定哪些内容能抵达 LLM。

快速上手

拉取镜像，用一条命令运行它：

运行 Escriba

docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" \
-e GOD_PASSWORD="change-me" \
ghcr.io/diegoparras/escriba:latest

然后打开 **http://localhost:8000**，用你设置的 GOD_PASSWORD 登录。

注意

该镜像内置了 ffmpeg、Tesseract OCR、Whisper 和嵌入式 Redis。无需任何额外 服务。用 openssl rand -hex 32 生成密钥。

在你的平台上部署

一切都从上面那个唯一的镜像运行。挑选你使用的平台。

EasyPanel

1. Project → + Service → App，然后将 Source → Docker Image 设为 ghcr.io/diegoparras/escriba:latest。
2. 添加你的环境变量（参见 配置）。
3. 在 Domains 下，设置 Container Port 8000，添加你的域名并启用 HTTPS。
4. Deploy。

Docker Compose

git clone https://github.com/diegoparras/escriba.git
cd escriba
cp .env.example .env          # set your secrets
docker compose up -d --build

Portainer

Stacks → Add stack → Repository，使用 https://github.com/diegoparras/escriba，compose 路径为 docker-compose.yml （或在网页编辑器中粘贴 compose 文件）。设置好环境变量并 部署；应用监听 8000 端口。

Dokploy

Create Application → GitHub（仓库 diegoparras/escriba），选择 Build Type: Dockerfile，添加你的环境变量，将域名指向 Container Port 8000 并启用 HTTPS，然后部署。

Plain Docker

docker build -t escriba .
docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" -e GOD_PASSWORD="change-me" escriba

若需 TLS，请在前面放一个反向代理。用 Caddy 时，两行的 Caddyfile 即可 为你提供自动 HTTPS：

Caddyfile

example.com {
    reverse_proxy localhost:8000
}

最小配置

所有设置都是环境变量。推荐的最小配置：

.env

SECRET_KEY=<openssl rand -hex 32>   # required in production
GOD_PASSWORD=<a strong password>
ANGEL_PASSWORD=<optional>
HUMAN_PASSWORD=<optional>

如果未设置任何密码，启动时会生成一个随机的 GOD_PASSWORD 并打印到 容器日志中。完整清单请见 配置。

系统要求

基础应用很轻量：一台单核 / 2 GB 的 VPS、约 5 GB 磁盘空间，确实 足以起步，而且 Escriba 会根据你的 CPU 扩展 worker 数量。可选的企业级 PII 脱敏模块（Anonimal）较重 —— 只在你需要时才挂载它。

部署前先心中有数

我们为每一种部署方式 —— 基础应用、企业级脱敏，以及繁重的转写 —— 都列出了 诚实的最低与推荐配置，这样你就不会因为机器原因而感觉它“跑不起来”。 查看完整系统要求 →

完整部署指南 全部配置选项