中文使用手册 - jadrian77/SaveRestrictedContentBot GitHub Wiki

目录

  1. 准备工作
  2. 启动项目
  3. 常见问题

准备工作

获取必要的 Key 值

  • 步骤 1:如何申请 Key
    • 账号的API_ID 和 API_HASH

      1. 使用telegram账号登录到https://my.telegram.org/
      2. 点击API development tools进入创建应用Create new application。
      3. 填写应用的基本信息后点击Create application(如果使用了不干净的代理ip请求可能会失败,多更换方式进行尝试)。
    • 创建 BOT_TOKEN 机器人的账号

      • 在telegram中搜索Botfather,并发起私聊,按提示一步步创建bot机器人。
    • 生成 SESSION 控制机器人的会话

      1. 打开这个网址https://telegram.tools/session-string-generator
      2. 选择Pyrogram后填入API ID、API HASH和机器人bot的token

      这个会话session是唯一的,后面生成新的会使之前生成的失效。

    • 创建 FORCESUB 使用这个机器人必须关注的telegram频道

      • 在telegram中新建一个频道,并将机器人添加进频道内,且将机器人设置为管理员,使用此机器人的功能的用户必须先关注此频道
    • AUTH 拥有这个机器人和运行此项目者的telegram账号id

      • 在telegram中搜索myidbot,并发起私聊,获取自己telegram账号的id
  • 步骤 2:配置环境变量
    export API_ID ="your_key_here" && export API_HASH ="your_key_here" && export SESSION ="your_key_here" && export BOT_TOKEN ="your_key_here" && export FORCESUB ="your_key_here" && export AUTH ="your_key_here"
    
    • 或者(两者取其一即可)编辑 .env 文件
    API_ID = 12345678
    API_HASH = number123andletterabc
    BOT_TOKEN = 124567890:number123andletterabc-number123andletterabc
    SESSION = number123andletterabc-number123andletterabc-number123andletterabc
    FORCESUB = channlName
    AUTH = 1234567890
    
  • 配置自己的代理(可选的,非必要,当主机无法直接连接telegram服务时需要):
    export PROXY_TYPE ="your_key_here" && export PROXY_HOST ="your_key_here" && export PROXY_PORT ="your_key_here"
    
    • 或者(两者取其一即可)编辑 .env 文件
      PROXY_TYPE = "http"
      PROXY_HOST = "127.0.0.1"
      PROXY_PORT = "7890"
    

启动项目

方式一:通过源代码启动

  1. 克隆仓库
    git clone https://github.com/jadrian77/SaveRestrictedContentBot.git
    
  2. 安装依赖
    pip install -r requirements.txt
    
  3. 编辑.env 文件,填写获取到的key
    API_ID = ...
    ......
    
  4. 运行项目
    python -m main
    

方式二:通过打包文件启动

  1. 下载最新 Release 包
    wget -O "forward_bot.tar.gz" $(curl -s https://api.github.com/repos/Jadrian77/SaveRestrictedContentBot/releases/latest | grep "browser_download_url" | cut -d '"' -f 4)
    
  2. 解压
    tar -xf forward_bot.tar.gz
    
  3. 编辑.env 文件,填写获取到的key
    API_ID = ...
    ......
    
  4. 运行
    ./manage_forward_bot.sh start
    

额外的配置

在config.ini文件内:

SAVE_FILE          #控制在需要下载的消息时,在结束后保留下载而不是删除
COPY_TO_CHANNEL    #控制是否同时向强制关注的频道发送相同的一份消息

常见问题

  • Q1:申请API_ID 和 API_HASH失败?

挂了代理的,多找几个干净的ip代理,多尝试更换设备,更换浏览器等行为,

  • Q2:启动后遇到网络连接timeout?

本机可能无法直连,需要配置一下代理。

  • 返回首页: Home