准备工作
- 海外Linux VPS (大陆的没法上TG,在大陆内VPS里连VPN可能会被封机子。这里推荐毛子的老牌且非常便宜的 Justhost: 最低5.93/月,可以避免性能浪费)
- 基础的 linux 操作知识
购买 VPS (以Justhost为例)
首先打开 Justhost,选择 VPS 下的所有计划。
接下来往下拉即可看到 5.93/月的服务器,然后点进去即可购买(可能是因为我是老客户,所以是 6.66/月,反正也不贵)
购买后即可在用户中心找到 VPS 的 ip 和密码,使用 SSH 即可连接成功
安装 PagerMaid-Pyro (有陌生人私聊验证插件)
环境准备(Debian11为例,Ubuntu 一样的,Centos也可以看官方文档)
# 更新软件包列表
apt update
# 安装依赖
apt install --upgrade python3 python3-pip neofetch libzbar-dev tmux nano git -y
# 拉取仓库
git clone https://github.com/TeamPGM/PagerMaid-Pyro.git pagermaid && cd pagermaid
安装 python 依赖
pip3 install -r requirements.txt
修改配置文件(可选,但推荐配置一下)
# 将配置 config.gen.yml 文件复制一份并且命名为 config.yml
cp config.gen.yml config.yml
然后去 telegram API官网 生成 api 填入配置文件内,只需要复制 api_id
和 api_hash
值填入 api_key
和 api_hash
即可 。其他配置项可自行查看修改
提示:可以使用 nano config.yml
编辑文件,修改好后按 ctrl + x
退出编辑按 y
再回车两次即可保存完成。(也可以使用 vi
来编辑文件。当然,也能用 vscode 的 ssh 插件来连接服务器然后直接用 vscode 编辑)
开始使用
启动并后台运行 pagermaid-pyro
修改好配置文件后
# 开启一个新的虚拟终端(可以断开 ssh 后依然保持运行终端内脚本)
tmux new -s tguserbot # tguserbot 可以改成你喜欢的,没有啥影响
python3 -m pagermaid
# 此步会要求填入完整的电话号码(eg:+1234567890)然后 tg 会向你的其他客户端/手机号发送验证码,填入验证码后,回车,如有两步验证密码,则再输入两步验证密码即可。# 如果想退出脚本按 ctrl+c 即可
# 看到登陆成功后即可按 ctrl+b 然后按 d 将 tmux(虚拟终端) 放后台然后直接断开 ssh 连接(如果直接断开 ssh 也可以)
在 TG 上继续使用
使用此 userbot 都是在 TG 任意聊天框输入指令然后发送消息。以下所有命令都是这样使用的。pyro 的指令均以英文逗号开头
常用指令
# 安装插件
,apt install <插件名>
# 卸载插件
,apt remove <插件名>
# 查看状态
,status
# 获取帮助
,help
# 获取当前系统时间
,time
# 快速更新
,update
# 重启应用程序(需要使用官方文档进程守护的方式来启动 pagermaid-pyro)
,restart
# 重载插件
,reload
推荐的插件
- pmcaptcha : 私聊人机验证插件(非 tg 会员必备, 会员可以在tg隐私设置开启将陌生人私聊归档不提醒)
- netease : 网易云音乐点歌
- clean_member : 多种方式清理群成员
- google : 快速谷歌搜索
- ytdl : 下载 youtube / bilibili 视频并上传到 tg
- his : 群成员历史消息记录查询
其他插件可以看官方插件仓库
后话
- 请一定要为你的 VPS 设置安全的密码,如果可以,更推荐使用密钥登陆且修改默认 ssh 端口
- 也可以尝试使用 heroku 来运行这个脚本(但是 heroku 马上就不免费了,收费的价格好像是比这个 vps 贵的)
- 请务必保存好登陆 pagermaid-pyro 后在 pagermaid 目录下生成的
pagermaid.session
文件,此文件可以进行账号所有操作,请不要分享给他人。
- 请不要滥用 userbot 去骚扰他人等恶意行为,恶意行为被举报轻则限制私聊重则封号
- 没了,享用吧:)