gentlesprite/telegram_restricted_media_downloader repository overview

⁠免责声明

本项目以GNU GPL-3.0协议开源发布。严禁使用本软件从事任何违反法律法规、侵犯他人合法权益或干扰平台正常运营的行为。

所有使用本软件的行为及其后果均由使用者自行承担全部法律责任，开发者不对任何使用行为及其后果负责。

本项目按“原样”提供，不附带任何明示或暗示的保证。

⁠下载地址

⁠通过Docker运行

Docker环境运行配置文件模板参考（前提：需完全按照后续教程提供的命令启动Docker）：

api_hash: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
api_id: 'xxxxxxxx'
bot_token: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
download_type:
- video
- photo
- document
- audio
- voice
- animation
- video_note
- live_photo
is_shutdown: false
links: /app/TRMD/links.txt
max_retries:
  download: 5
  upload: 3
max_tasks:
  download: 3
  upload: 3
proxy:
  enable_proxy: true
  hostname: 192.168.1.10
  scheme: socks5
  port: 10808
  username: null
  password: null
save_directory: /app/downloads/%CHAT_NAME%/%MIME_TYPE%
session_directory: /app/sessions
temp_directory: /app/temp

由于Docker容器的工作目录为/app，配置文件中的路径应填写容器内路径，实际文件通过docker run的-v卷挂载映射至宿主机目录：

• *另挂载./form:/app/form为程序内部统计/表单导出目录（/app/form）。
• *代理hostname（示例192.168.1.10）仅作为参考，实际部署时需替换为各自代理服务器的ip地址（可通过ip addr或ifconfig查看本机局域网IP）。若运行环境已可直接访问Telegram服务器，则可不启用代理：将enable_proxy设为false。

方式1：

• 确保docker已安装并配置环境变量。

• 使用docker从远程仓库拉取镜像，注意TRMD版本需要≥2.0.2：

  docker pull gentlesprite/telegram_restricted_media_downloader:latest
  

  Copy

• 首次使用时需要进入容器配置文件：

  docker run -it --rm \
    --name trmd \
    -v ./config:/app/TRMD \
    -v ./sessions:/app/sessions \
    -v ./downloads:/app/downloads \
    -v ./temp:/app/temp \
    -v ./form:/app/form \
    -p 2921:2921 \
    -e TZ=Asia/Shanghai \
    gentlesprite/telegram_restricted_media_downloader:latest \
    python main.py --config /app/TRMD/config.yaml --port 2921
  

  Copy

• 如果是通过Windows使用wsl2运行docker：

  docker run -it --rm --name trmd -v ./config:/app/TRMD -v ./sessions:/app/sessions -v ./downloads:/app/downloads -v ./temp:/app/temp -v ./form:/app/form -e TZ=Asia/Shanghai gentlesprite/telegram_restricted_media_downloader:latest python main.py --config /app/TRMD/config.yaml --port 2921
  

  Copy

• 如果已配置完成的情况下，直接创建并启动容器：

  docker run -it -d \
    --name trmd \
    -v ./config:/app/TRMD \
    -v ./sessions:/app/sessions \
    -v ./downloads:/app/downloads \
    -v ./temp:/app/temp \
    -v ./form:/app/form \
    -p 2921:2921 \
    -e TZ=Asia/Shanghai \
    gentlesprite/telegram_restricted_media_downloader:latest \
    python main.py --config /app/TRMD/config.yaml --port 2921
  

  Copy

• 如果是通过Windows使用wsl2运行docker：

  docker run -it -d --name trmd -v ./config:/app/TRMD -v ./sessions:/app/sessions -v ./downloads:/app/downloads -v ./temp:/app/temp -v ./form:/app/form -p 2921:2921 -e TZ=Asia/Shanghai gentlesprite/telegram_restricted_media_downloader:latest python main.py --config /app/TRMD/config.yaml --port 2921
  

  Copy

方式2：

• 确保git、docker、docker-compose已安装并配置环境变量。

• 使用git克隆仓库：

  git clone https://github.com/Gentlesprite/Telegram_Restricted_Media_Downloader.git
  

  Copy

• 进入项目文件夹：

  cd Telegram_Restricted_Media_Downloader
  

  Copy

• 首次使用时需要进入容器配置文件：

  docker-compose run --rm --service-ports --name trmd trmd
  

  Copy

• 如果已配置完成的情况下，直接创建并启动容器：

  docker-compose up -d
  

  Copy

以上两种方式启动后，通过在终端或在Telegram中向机器人发送/help命令查看Web配置以访问网页面板（包含端口、账号、密码与访问链接），类似下表：

账号密码由系统随机生成，使用浏览器打开http://127.0.0.1:2921⁠网页输入账号密码即可进入。

• 仅在已配置机器人的情况下，也可在Telegram中向机器人发送/help命令查看上述Web配置。
• 网页面板默认使用2921端口，可通过-p、--port参数指定自定义端口，端口被占用时自动分配可用端口。
• 网页面板在后台启动网页服务，终端仍可正常操作；关闭浏览器窗口不会影响程序运行，程序退出时面板自动关闭。
• 首次通过账号密码登录成功后，面板会向此浏览器下发一个有效期30天的Cookie，使用此浏览器的访问行为在软件重启或重新访问后依然免密。
• 如需远程访问，请自行查看并替换ip地址为公网ip，并开放2921或自定义的端口。

其他命令：

• 如需查看运行日志：

  docker logs trmd
  

  Copy

• 不再使用时，停止并删除容器：

  docker stop trmd && docker rm trmd
  

  Copy

⁠联系作者

Telegram:@Gentlesprite⁠

邮箱:[email protected]⁠

⁠支持作者