使用自走机器人有封号风险，后果自负
source: https://xtaolabs.com/
仓库地址：https://github.com/TeamPGM

安装软件包依赖

neofetch

此软件包用于显示系统信息，如您没有显示系统信息需求，您可以无需安装此软件包。

sudo apt install neofetch -y

zbar

此软件包用于处理二维码信息，如您没有处理二维码信息需求，您可以无需安装此软件包。

sudo apt install libzbar-dev -y

Pip

此软件包为必须依赖包，用于安装 Python 依赖。

sudo apt install python3-pip -y

Git

此软件包用于拉取 PagerMaid 仓库及用于 PagerMaid 的后续更新。

sudo apt install -y git

配置环境

为了您的操作不当而造成不可预期的后果，应避免应用直接运行在 root 用户，此处我们为 PagerMaid 创建用户。

  1. 创建用户

    创建 pagermaid 用户，并为其创建家目录：

    sudo useradd -m pagermaid

  2. 设置密码（可选）

    如果您有需求为用户设置密码，只需执行 sudo passwd pagermaid 即可。

  3. 为用户提供 sudo 权限（可选）

    如果您有需求让 PagerMaid 执行需要 root 权限的操作，则需进行以下操作：

    • 提供 sudo 权限

      sudo usermod -a -G sudo pagermaid

    • 使 pagermaid 用户无需密码认证使用 sudo

      在执行 visudo 后，在末尾追加以下内容：

      pagermaid ALL=(ALL) NOPASSWD:ALL

  4. 设置默认 Shell（可选）

    默认情况下，创建用户后，用户的默认 Shell 为 sh，对用户的操作十分不便。

    通常情况下，我们选用 shell 作为我们的默认 Shell，当然，您也可以选用诸如 zsh 的 Shell。

    如果您有需求修改默认 Shell，则需进行以下操作：

    sudo chsh -s /bin/shell pagermaid

    （如果您不使用 shell，可以修改 /bin/shell 为你所需设置的 Shell 的路径）

  5. 进入用户进行接下来的操作

    sudo su pagermaid       # 进入 pagermaid 用户
    cd ~                    # 进入 pagermaid 用户家目录

安装并配置 PagerMaid

拉取项目

git clone https://github.com/TeamPGM/PagerMaid-Pyro.git pagermaid

安装依赖包

pip3 install -r requirements.txt

修改配置文件

  1. 将配置 config.gen.yml 文件复制一份并且命名为 config.yml

    cp config.gen.yml config.yml        # 复制模板
    vi config.yml                       # 修改文件

  2. 设置 API

    在 Telegram 开发者面板 生成 API 信息，将 App api_id 和 App api_hash 分别填入 api_key 和 api_hash

  3. 代理配置（可选）

    此步是将安装插件的获取源文件更改为国内可以访问的反代源，但是可能因为 cdn 原因，插件更新不及时。

    git_source: "https://gitlab.com/Xtao-Labs/PagerMaid_Plugins/-/raw/master/"

  4. 二维码登录（用于无法接收到验证码）（可选）

    此步是将登录方式切换到手机扫码登录，解决无法收到验证码的问题，手机扫码途径：运行 APP - 设置 - 设备 - 扫码登录新客户端。

    qrcode_login: "True"

  5. 启用网页控制台

    请找到 PGP 的配置文件 config.yml ，修改为如下值

    web_interface:
      enable: "True"
      secret_key: "控制台密码"
      host: "0.0.0.0" // 或者上面你确认的 127.0.0.1 
      port: "3333"
      origins: ["*"]

登录账号

python3 -m pagermaid

如已有 pagermaid.session 可跳过下列步骤，注意权限配置。

填入完整的电话号码（如：+12569986522），随即 Telegram 将会向你的其他客户端发送验证码，填入验证码即可。如有两步验证密码，则再输入两步验证密码即可。

完成以上步骤后，按下 Ctrl + C 终止应用。

请注意保护好您已登录的 pagermaid.session 。此文件可以进行账号所有操作，请不要分享给他人使用。

进程守护

此步骤可以方便 PagerMaid 的自动运行，您无需在 PagerMaid 意外退出或主机重启后重新登录主机进行操作。

sudo cat <<'TEXT' > /etc/systemd/system/pagermaid.service
[Unit]
Description=PagerMaid-Pyro Telegram Utility Daemon
After=network.target
[Install]
WantedBy=multi-user.target
[Service]
Type=simple
User=pagermaid
Group=pagermaid
WorkingDirectory=/home/pagermaid/pagermaid
ExecStart=/usr/bin/python3 -m pagermaid
Restart=always
TEXT

常用指令

  • 启动程序：sudo systemctl start pagermaid
  • 设置为开机自启：sudo systemctl enable pagermaid
  • 停止程序：sudo systemctl stop pagermaid