企业官网建设流程全解析

ParseHubBot 是一款 Telegram 多平台聚合解析机器人，支持抖音、B站、YouTube、小红书等 16+ 主流平台。本文带你快速掌握 ParseHubBot 配置方法：3 个必填环境变量让机器人跑起来，再学会平台级代理池与 Cookie 池，一次搞定网络与权限问题。🚀

一、ParseHubBot 是什么？为什么配置很重要？

ParseHubBot 让你在任何 Telegram 聊天窗口直接发送链接，即可解析并转发视频/图文内容。它的配置分为两层：

理解这两层的关系，是玩转 ParseHubBot 配置的关键。

二、必填环境变量：3 步让 ParseHubBot 跑起来 ⚡

ParseHubBot 使用.env文件加载基础配置，加载逻辑定义在 core/config.py 中。以下是必须提供的 3 个变量：

# ✅ 必填（缺一不可） API_ID= # Telegram API ID，登录 https://my.telegram.org 获取 API_HASH= # Telegram API Hash，同上获取 BOT_TOKEN= # 机器人 Token，向 @BotFather 申请

💡 提示：API_ID和API_HASH在同一页面获取，BOT_TOKEN则需要单独找 @BotFather 创建机器人。

三、可选环境变量：代理、缓存与调试参数详解 🔧

3.1 BOT_PROXY：机器人连接 Telegram 的代理

如果你的服务器在境外，或本地网络无法直连 Telegram，可通过BOT_PROXY为机器人自身设置代理：

BOT_PROXY= # 例：http://127.0.0.1:7890

注意：该代理只影响机器人与 Telegram 之间的通信，不影响它去解析各平台内容（解析代理见下文平台配置）。

3.2 缓存相关环境变量

ParseHubBot 内置了解析结果缓存，可重复解析同一链接时秒回：

⚠️ 注意：CACHE_CLEANUP_INTERVAL不能大于CACHE_TIME，否则 ParseHubBot 启动时会报错退出，这是 core/config.py 中的强制校验规则。

3.3 WD_ 前缀：守护进程看门狗参数

ParseHubBot 自带断线自动重连、异常重启的看门狗机制（core/watchdog.py），通过WD_前缀环境变量调整：

一般无需修改默认值，适合需要精细控制容灾行为的进阶用户。

四、快速部署：Docker 一键运行 🐳

推荐用 Docker 运行 ParseHubBot，配置文件通过环境变量与挂载卷传入：

mkdir parse_hub_bot && cd parse_hub_bot docker run -d \ --restart=always \ -e API_ID=你的API_ID \ -e API_HASH=你的API_HASH \ -e BOT_TOKEN=你的BOT_TOKEN \ -v ./logs:/app/logs \ -v ./data:/app/data \ --name parse-hub-bot \ ghcr.io/z-mio/parse_hub_bot:latest

关键点是-v ./data:/app/data挂载：平台配置文件platform_config.yaml就放在宿主机的./data/config/目录下，修改后容器内即时生效。

💡 也可以源码运行：git clone https://gitcode.com/gh_mirrors/pa/parse_hub_bot后执行uv sync && uv run bot.py（入口 bot.py）。

五、平台级代理池：为不同平台定制网络出口 🌐

这是 ParseHubBot 配置中最强大的部分。data/config/platform_config.yaml允许你为每个平台单独指定解析代理与下载代理，实现"国内平台直连、海外平台走代理"的混合出口策略。

5.1 配置文件结构与示例

官方示例文件见 data/config/platform_config.yaml.exa，完整字段如下：

# 全局默认代理（平台未单独配置时回退使用） # 支持单个地址(字符串)或多个地址(列表，随机选取) default_parser_proxies: http://127.0.0.1:7890 # 解析代理（单个） default_downloader_proxies: # 下载代理（代理池） - http://127.0.0.1:7890 - http://127.0.0.1:7891 # 平台独立配置 platforms: <platform_id>: # 平台 ID，见下文支持列表 disable_parser_proxy: false # 是否禁用解析代理（直连） disable_downloader_proxy: false # 是否禁用下载代理（直连） parser_proxies: # 该平台专用解析代理池 - http://proxy1:port downloader_proxies: # 该平台专用下载代理池 - http://proxy2:port cookies: # 该平台 Cookie 列表（随机选取） - "cookie_string_1" - "cookie_string_2"

5.2 代理优先级：4 级决策一目了然

解析代理和下载代理各自独立决策，遵循以下优先级（实现见 core/platform_config.py 的roll_parser_proxy/roll_downloader_proxy方法）：

禁用代理 (disable_*_proxy: true) ↓ 未禁用 平台专用代理 (parser_proxies / downloader_proxies) ↓ 未配置 全局默认代理 (default_parser_proxies / default_downloader_proxies) ↓ 未配置 直连（不使用代理）

💡 代理池中有多个地址时，每次请求会随机选取一个，天然实现负载均衡。

5.3 常见配置场景实战 ✅

场景 1：国内平台直连，海外平台走代理

default_parser_proxies: http://127.0.0.1:7890 default_downloader_proxies: http://127.0.0.1:7890 platforms: bilibili: disable_parser_proxy: true disable_downloader_proxy: true douyin: disable_parser_proxy: true disable_downloader_proxy: true xhs: disable_parser_proxy: true disable_downloader_proxy: true

场景 2：YouTube 使用独立代理池

platforms: youtube: parser_proxies: - http://proxy-us-1:8080 - http://proxy-us-2:8080 - http://proxy-eu-1:8080 downloader_proxies: - http://proxy-us-1:8080 - http://proxy-eu-1:8080

场景 3：B站解析直连 + 下载走代理 + Cookie 轮换

platforms: bilibili: disable_parser_proxy: true downloader_proxies: - http://127.0.0.1:7890 cookies: - "SESSDATA=xxx; bili_jct=xxx; buvid3=xxx" - "SESSDATA=yyy; bili_jct=yyy; buvid3=yyy"

5.4 支持的平台 ID 速查表

platforms下的键必须是合法平台 ID（写错会导致 ParseHubBot 启动失败并提示）：

六、Cookie 池：绕过登录墙与限流的最佳实践 🍪

部分平台需要登录态或存在严格限流，配置 Cookie 后解析成功率大幅提升。

6.1 支持 Cookie 的平台

• Twitter / X
• Instagram
• YouTube
• Bilibili
• 抖音
• TikTok
• 快手
• 小红书

6.2 如何获取与配置 Cookie

1. 浏览器登录目标平台，按 F12 打开开发者工具；
2. 在 Network 标签中任选一个请求，复制 Request Headers 里的Cookie完整字符串；
3. 粘贴到platforms.<平台ID>.cookies列表中。

Cookie 池的妙处在于：填入多组 Cookie 后，ParseHubBot 每次请求会随机轮换使用（roll_cookie方法实现），分散单账号的请求压力，有效降低被封风险：

platforms: twitter: cookies: - "auth_token=your_token_here; ct0=your_ct0_here" douyin: cookies: - "sessionid=账号1的cookie" - "sessionid=账号2的cookie"

七、配置排错清单：启动失败怎么办？🐛

📌 小贴士：修改platform_config.yaml后无需重新构建镜像，Docker 部署下只需重启容器即可生效：docker restart parse-hub-bot。

八、总结

本文完整覆盖了 ParseHubBot 配置两大核心：

1. 环境变量：API_ID/API_HASH/BOT_TOKEN三件套必填，BOT_PROXY解决 Telegram 连通性，CACHE_*与WD_*按需调优；
2. 平台配置：platform_config.yaml支持全局默认代理 + 平台专属代理池 + Cookie 池，四级优先级让"哪个平台走哪个出口"一目了然。

掌握这两层配置，你就能把 ParseHubBot 打造成一台稳定、高效的私有链接解析中心。🎉