中文使用手册 - 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