本文按 PagerMaid-Pyro 的容器示例说明数据与插件挂载、首次交互登录及后续运维。默认不开放 Web 面板；启用时需配置自己的随机密钥和受限监听地址。
PagerMaid-Pyro 是运行在个人 Telegram 账号上的工具。这里的登录授权与 BotFather 创建的普通机器人 Token 不同；插件也能使用该账号的权限，安装前要检查代码来源。项目仓库
一、准备持久化目录
在打算长期保存数据的目录执行：
mkdir -p pagermaid/data pagermaid/plugins
cd pagermaid
当前上游容器示例分别挂载 /pagermaid/workdir/data 和 /pagermaid/workdir/plugins。把整份 Git 仓库挂到 workdir 可能覆盖镜像内文件。配置文件的位置应按实际版本确认，不能假定始终位于 config/config.yml。官方容器配置
二、首次启动并完成交互授权
docker run -it \
--name pagermaid \
--restart unless-stopped \
-v "$PWD/data:/pagermaid/workdir/data" \
-v "$PWD/plugins:/pagermaid/workdir/plugins" \
teampgm/pagermaid_pyro:latest
首次运行按镜像提示输入所需参数。Telegram 的 api_id 与 api_hash 在自己的 API development tools 申请；这是开发应用标识，不是短信验证码或二步验证密码。Telegram 获取应用标识说明
登录方式取决于当前版本提供的交互入口与 Telegram 的认证要求。不能保证某个国家区号一定收不到短信，也不能以旧版本的扫码经验替代当前提示。不要反复提交错误验证码；确认电话区号、二步验证状态和服务器是否能连接服务。
初始化完成后，按 Ctrl-P 再按 Ctrl-Q 从容器脱离，进程继续运行。需要重新进入交互界面时：
docker attach --sig-proxy=false pagermaid
查看和重启：
docker logs --tail 100 pagermaid
docker restart pagermaid
容器会话文件具有账号访问能力。备份 data 与所需插件时限制目录权限，不公开上传、不在排障截图里展示验证码、API hash 或完整会话。本文使用 latest 演示首次安装；实际运行应记录已验证镜像的 digest，升级前备份，在确认登录、插件和会话加载正常后再更新。
三、确实需要 Web 面板时
当前上游支持 WEB_ENABLE、WEB_SECRET_KEY、WEB_HOST 与 WEB_PORT。默认方案不启用 Web；若需要面板，先生成足够长的随机密钥，通过权限受限的环境文件或当前进程环境注入，不要在多个部署间共享固定的公开字符串。
新增的容器选项应包含：
-p 127.0.0.1:3333:3333
-e WEB_ENABLE=true
-e WEB_HOST=0.0.0.0
-e WEB_PORT=3333
-e WEB_SECRET_KEY
这里要求当前终端已经设置 WEB_SECRET_KEY，最后一项只传变量名，避免把密钥直接写在命令中。容器内监听 0.0.0.0 才能经端口映射访问，宿主机映射则限制到回环地址；两个地址属于不同网络层。远程访问可使用 SSH 隧道，或经过自己配置的 HTTPS 反向代理和访问控制，不把账号面板直接暴露公网。
更改环境变量需要重建容器，先确认原容器已停止、data 与 plugins 已备份并将同样的卷挂回。不要仅执行 docker restart 后就假定新变量生效。
四、排障时先确认哪一层
登录失败先看交互授权与网络；容器重建后重新要求登录，应检查持久化目录、挂载路径和文件权限；面板不可访问则核对容器监听、宿主机端口映射与代理。插件异常应隔离插件并读取具体日志，不通过重新创建账号会话来掩盖错误。
评论区