在Linux上部署kuku的tg机器人

在Linux上部署kuku的tg机器人

背景与核心痛点：KukuBot 是一款基于 Telegram 官方 Bot API 开发的高效自动化机器人，支持 B站/微博动态视频推送、Oracle Cloud 实例监控管理、游戏王查卡及多平台通知。本文详细整理在 Linux 环境下基于 Docker Compose 及原生 JAR 包的双模式部署、依赖配置与运维实操。

目录

项目概述

KukuBot是从QQ机器人移植到Telegram平台的增强版机器人，利用官方Bot API实现更稳定的服务和更多功能。

📌 项目地址：https://github.com/kukume/tgbot
🤖 演示Bot：https://t.me/kukume_bot

核心功能

  • 哔哩哔哩/微博动态推送（含视频）
  • 自动签到系统
  • 游戏王卡牌查询
  • Oracle Cloud管理
  • 网易BUFF/悠悠有品监控
  • 多平台消息推送

💡 特色：支持>50MB视频推送（需自建API服务器）

Docker部署方案

1. 安装Docker

# Debian/Ubuntu
sudo apt update && sudo apt install docker.io docker-compose -y

2. 配置docker-compose.yml

version: "3"
services:
  tgbot:
    image: kukume/tgbot
    container_name: tgbot
    ports: 
      - 8080:8080
    environment:
      KUKU_TELEGRAM_TOKEN: "你的BotToken"
      KUKU_TELEGRAM_CREATOR_ID: "管理员ID"
      KUKU_TELEGRAM_PROXY_TYPE: "HTTP"
      KUKU_TELEGRAM_PROXY_HOST: "代理IP"
      KUKU_TELEGRAM_PROXY_PORT: "代理端口"
    depends_on:
      - mongo

  mongo:
    image: mongo:4
    volumes:
      - ./db:/data/db

3. 启动服务

docker compose up -d

JAR包部署方案

1. 安装MongoDB

docker run -d --name mongodb -p 27017:27017 -v $(pwd)/db:/data/db mongo:4

2. 安装FFmpeg

sudo apt install ffmpeg -y

3. 配置application.yml

spring:
  data:
    mongodb:
      uri: mongodb://localhost/tg
kuku:
  telegram:
    token: "你的BotToken"
    creatorId: "管理员ID"

4. 启动应用

java -jar tgbot.jar

更新指南

Docker方式

docker compose down
docker rmi kukume/tgbot
docker compose up -d

JAR方式

替换jar文件后重启服务：

java -jar tgbot.jar

常用指令

指令 功能
/info 获取用户ID
/setting 下载日志
/log 查看任务日志
/manager 管理面板
/ygo 游戏王查卡

日志收集

  • Docker 方式：
    docker compose logs > bot.log
  • JAR 方式： 查看 /tmp 目录下的日志文件。

注意事项

  • 视频推送超过50MB需自建API服务器。
  • ARM架构建议使用Docker部署。
  • 定期备份 ./db 目录防止数据丢失。
  • 🔗 自建API服务器教程：https://www.kuku.me/archives/41/