Skip to content

operations.md

Latest commit

 

History

History
79 lines (58 loc) · 1.75 KB

operations.md

File metadata and controls

79 lines (58 loc) · 1.75 KB

运维手册

首次部署

npm ci
cp .env.example .env
nano .env
npm run telegram:check
npm run migrate
npm run dev

Serv00 建议使用：

TELEGRAM_UPDATE_MODE=polling
AI_DRAFTS_ENABLED=false

常用命令

npm run build             # 编译 TypeScript
npm run check             # 类型检查
npm test                  # 编译并运行 node:test
npm run verify            # 依次执行类型检查、测试和安全审计
npm run migrate           # 应用幂等数据库迁移
npm run telegram:check    # 检查 Telegram token、群和权限

真实测试 Telegram 发送权限：

TELEGRAM_CHECK_SEND_TEST=true npm run telegram:check
TELEGRAM_CHECK_TOPIC_TEST=true npm run telegram:check

第二条会临时创建测试 Topic、发送测试消息，然后尝试删除该 Topic。

常驻运行

前台确认无误后再交给进程管理器：

npm run build
node dist/src/app/main.js

如果使用 PM2：

pm2 start dist/src/app/main.js --name inboxbridge
pm2 save
pm2 logs inboxbridge

备份

需要备份的核心文件：

.env
data/inboxbridge.sqlite

不要把这两个文件提交到 Git。迁移是幂等的，备份恢复后可以再次运行：

npm run migrate

排障

  • chat not found：bot 没进管理群，或 TELEGRAM_MANAGEMENT_CHAT_ID 填错。
  • not enough rights to create a topic：bot 不是管理员，或缺少 Manage Topics 权限。
  • message thread not found：Topic 已被删除或失效；InboxBridge 会在下一次用户来信时自动重建。
  • 管理员普通回复没有外发：检查 TELEGRAM_ADMIN_USER_IDS，以及 BotFather privacy mode。
  • 菜单没刷新：Telegram 客户端有缓存，重开聊天或重启客户端。