独立部署

在自己的机器接待客户。

使用自己的 Telegram Bot、飞书应用、翻译服务和 PostgreSQL。不用注册渡桥，不用公网域名，也没有网页工作台。

这是命令行转发程序

启动方式是 standalone。状态保存在你自己的 PostgreSQL。Docker Compose 可以一起跑程序和数据库。跨天回复、扫码登录、WhatsApp 渠道是托管工作台的能力，见两种模式接入和接入说明。

你的机器
+---------------------------------------+
| Go 转发程序 + 本地配置 + PostgreSQL    |
|   +-- 主动连接飞书（长连接）           |
|   +-- 主动获取 Telegram 消息（长轮询） |
|   +-- 调用你配置的翻译服务             |
+---------------------------------------+
渡桥 SaaS 不参与；运行机器需要能访问两端。

1. 准备自己的机器人

准备专用 Telegram Bot，并开启聊天管理能力。在自己的飞书组织创建企业自建应用，开启机器人和消息权限。准备一个内部客服群。

不要让独立程序与托管服务同时使用同一个 Telegram Bot。程序发现已有回调会停止轮询，避免抢收消息。

2. 填写本地配置

把发布包里的 .env.standalone.example 复制为 .env.standalone，权限设为 600。填写自己的机器人凭据、翻译服务和数据库。密钥留在自己的机器。

cp .env.standalone.example .env.standalone
chmod 600 .env.standalone
./duqiao keygen

把生成结果保存为 BRIDGE_ENCRYPTION_KEY，只生成一次。已有数据时不能换这个密钥。TELEGRAM_OWNER_ID 是接待账号本人，不是客户。

3. 连接飞书

先填写 FEISHU_APP_ID 和 FEISHU_APP_SECRET，再启动发现工具：

./duqiao discover-feishu --env-file .env.standalone

显示已连接后，在飞书「事件与回调 → 事件配置」选择「使用长连接接收事件」，保存。开通消息与附件权限，订阅消息与机器人进群/退群事件，并完成企业内发布。

把机器人加入客服群，准备接待的客服在群里 @它发一句话。工具只输出群编号和客服编号，不发送客户消息。把 FEISHU_CHAT_ID、FEISHU_OPERATOR_OPEN_IDS 填回配置，按 Ctrl+C 停掉发现工具，再启动正式程序。

不需要 Encrypt Key、Verification Token 或公网回调地址。商店应用不适用此方式。

4. 授权 Telegram 并启动

由接待账号本人在 Telegram 里关联自己的 Bot，选择允许管理的私聊，并允许回复。先只开放自己的测试聊天。

BRIDGE_POLICY=ru 表示首次俄语自动接待，all 表示接待授权范围内全部客户。独立版没有人工审核工作台，不要选 manual。核对配置后设 BRIDGE_ENABLED=true。

./duqiao standalone --env-file .env.standalone

如果用仓库提供的 Docker Compose（会同时启动专用 PostgreSQL）：

docker compose --env-file .env.standalone -f compose.standalone.yaml up -d --build --wait

发现工具也可以用同一镜像：

docker compose --env-file .env.standalone -f compose.standalone.yaml run --rm --no-deps bridge discover-feishu

本机状态入口：127.0.0.1:18787/status。/readyz 只说明程序和数据库可用，不能当作两端已经收发成功。不要连接已有托管库；不要用 down -v 删数据卷。

5. 用自己的测试账号试聊

俄语来信 → 飞书中文 → 客服话题内回复 → Telegram 译文
    |
同一客户继续发 VIN、图片、文件 → 分别核对两端
    |
重启程序 → 原有接待状态与话题保留

连接成功只表示通道在线。实际收发仍取决于授权、权限和发布。已接待客户的后续消息不再受首次语言规则限制。机器人被移出飞书群后接待会暂停，重启不会自动恢复；修好成员和授权后，先用 BRIDGE_ENABLED=false 启动一次，再改回 true。

数据与维护

配置和数据库由你自己管理。发送成功的正文会清理，失败内容最长临时保留 24 小时，运维元数据默认保留 30 天。备份 PostgreSQL 和原来的加密密钥。

当前独立版不自动迁移旧 Python 数据，也不提供 Telegram 文件夹接管。更换接待账号、飞书应用、客服群或 Telegram Bot 时，换一套专用数据库，避免沿用旧话题和去重状态。

希望我们负责部署和维护？

使用渡桥托管工作台。商家自建飞书应用也推荐长连接，只填 App ID 和密钥即可开始接入。Telegram 扫码、WhatsApp 渠道都在工作台完成。

回到渡桥工作台 →