📁 Xnetdisk_bot 官方文档
全能资源管家:700万+资源随搜随取,免费节点天天更新,卡密商店自动发货,会员折扣每日免费,签到领经验、邀请返佣,一键克隆开自己的机器人。
机器人:@xnetdisk_bot 前台:pan.kukude.cc
关于 Xnetdisk_bot
Xnetdisk_bot 是基于 ThinkPHP 6.1 的网盘资源机器人 + 前台站:机器人内可搜资源、领免费节点、买卡密、开会员、签到、邀请返佣;前台站可浏览资源库与软件库、下单支付、查看订单与账户。
- 📁 资源库:不限级分类,机器人内 /res 浏览、关键词搜索,投稿审核制
- 💾 软件库:多级分类、按平台开关、付费软件、CSV 批量导入
- 📡 节点分享:免费节点天天更新,机器人内直接领取
- 🛍 卡密商店:卡密自动发货,兑换即开通对应权益
- 👑 会员体系:等级折扣、每日免费解锁、终身会员
- 🤖 一键克隆:用户开一个属于自己的机器人号,独立菜单、返利与提现
环境要求
- PHP 7.4+(推荐 PHP 8.1),扩展:pdo_mysql、curl、mbstring、bcmath、openssl、fileinfo
- MySQL 5.7+(推荐 8.x),字符集 utf8mb4
- Web 服务器 Nginx / Apache,站点必须支持 HTTPS(Telegram Webhook 强制要求)
- 域名一个,BotFather 申请的机器人 Token 一个
- aaPanel 或 1Panel 面板(推荐小白走面板部署)
更新日志
大版本节点(完整记录见包内修复说明):
- v145:资源导出 CSV 首列防 SYLK 误判修复
- v144:资源 CSV 导出
- v143:克隆号底部标识开关
- v136–v142:软件库(多级分类、付费、批量导入、分平台开关、搜索)
- v135:自定义后台入口
- v128:用户启动检测(私聊启动状态、裂变启动统计)
- v126–v127:克隆号双向私聊、提现满 100 元
- v121–v122:机器人克隆(后台克隆、用户一键克隆)
- v120:代码审计 + 安全加固 8 项(越权、回调金额校验、登录限流、SSRF、上传 MIME 等)
- v115:SMTP 订单邮件通知
- v107–v109:前台多语言 + 日夜切换
- v84:通知机器人(事件推送、每日报告)
- v82:X 自动推送
- v40:安全审计(网关真验签 + 金额校验、按号 Webhook 密钥)
config.yml 详细说明
本产品是 PHP 应用,没有 config.yml。配置分两处:后台设置页(日常改动全在这里)与
config/ 目录(源码自带,部署时不动)。- 后台设置页:机器人设置(Token、欢迎语、菜单)、支付网关、VIP 套餐价格、佣金比例、克隆档位价格、号池领取开关、通知事件开关
- 后台生成的配置(绝不手动改、绝不进安装包):
config/pay.php(网关值)、config/notify.php、config/x.php、config/mail.php、config/software.php——全部由后台保存时生成 - 源码自带配置:
config/app.php、config/database.php、config/log.php、config/cache.php、config/cookie.php、config/session.php、config/view.php - 数据库连接:
.env(安装向导生成)或config/database.php,二选一,.env 优先
部署总览
三条路线,按熟练度选:
- 一键安装包(推荐小白):下载一键安装版,解压 + 导入 install.sql + 按向导填信息,见下方单二进制部署一节
- 面板手动部署:aaPanel / 1Panel 新建站点,上传源码,导入数据库,设运行目录与伪静态
- 手动部署:有 root SSH 的用户直接用命令行完成同样步骤
三种路线装完都要做同一收尾:设 Webhook、配网关、加计划任务(定时发布与队列)。
单二进制部署(推荐小白)
本产品是 PHP 应用,不提供单二进制包;小白路线对应的是一键安装包:源码 + vendor + install.sql 已配套打好,解压即用,不用 composer。
- 下载一键安装版压缩包,解压到站点根目录(如
/www/wwwroot/pan.kukude.cc) - 网站运行目录(文档根目录)设为
public/ - 按包内一键安装说明走安装向导:填数据库信息(自动建库、导入 40 张表)、设管理员账号密码、填 Bot Token(自动取机器人用户名并设 Webhook)
- 安装完成会生成
install.lock,向导自动锁定;装完删除public/install.php(如包内含) - 登录后台(
/admin/login,如改过自定义入口则走自定义地址)配置网关、群组、套餐
一键安装包只用于全新安装。已有数据的站不要整包覆盖,按差分补丁升级(见升级与迁移)。
手动部署
- 上传源码到站点根目录,运行目录设为
public/,PHP 选 7.4+,装好所需扩展 - 新建数据库(utf8mb4),导入
install.sql(40 张表) - 配置数据库连接:复制
.env.example为.env填好,或改config/database.php - 确保
runtime/可写(Web 服务器用户),删runtime/temp/*清模板缓存 - HTTPS 配好后,到后台机器人管理点“设置 Webhook”,Webhook 地址形如
https://域名/webhook/<bot_id> - 到后台机器人管理点“设置菜单”,注册机器人命令菜单
Docker Compose 部署
官方暂不提供 Docker 镜像与 Compose 文件。推荐走 aaPanel / 1Panel 面板部署,步骤见下面两节;已有 Docker 经验的用户可自建 PHP + MySQL + Nginx 容器,按手动部署一节的步骤装。
aaPanel 手动部署
- aaPanel → 网站 → 添加站点,填域名,PHP 选 7.4+,数据库选 MySQL(记下库名与账号密码)
- 网站设置 → 网站目录 → 运行目录选
public;伪静态选 ThinkPHP 规则;SSL 申请并开启强制 HTTPS - 文件管理进站点根目录,上传源码压缩包并解压到根目录(不要多一层文件夹)
- 数据库 → 导入 install.sql;根目录
.env填好数据库信息 - 计划任务 → Shell 脚本:定时发布与队列
定时发布每分钟一次;队列建议常驻或每分钟拉起cd /www/wwwroot/你的域名 && php think publish:scheduled cd /www/wwwroot/你的域名 && php think queue:work --queue=all - 后台机器人管理 → 设置 Webhook、设置菜单;支付网关页填好各渠道参数
1Panel 部署
- 1Panel → 网站 → 创建网站 → 运行环境选 PHP 7.4+,数据库选 MySQL,记下库名与账号密码
- 网站设置 → 运行目录改为
public;伪静态选 ThinkPHP;SSL 开启 HTTPS - 文件管理上传源码解压到站点根目录;数据库管理导入 install.sql;根目录
.env填好 - 计划任务加两条 Shell(与 aaPanel 一节相同):
php think publish:scheduled(每分钟)、php think queue:work --queue=all - 后台设 Webhook、设菜单、配网关,收尾与 aaPanel 相同
后台管理入门
后台地址:/admin/login(如开启自定义后台入口,则走自定义地址)。登录后左侧菜单:
- 机器人管理:多 Bot 列表,新增/编辑机器人,设置 Webhook、设置菜单、克隆机器人
- 帖子管理:发帖、自定义 inline 按钮、定时发布、投稿审核
- 资源库 / 软件库:分类树、资源与软件的增删改查、付费开关、批量导入
- 用户管理:用户列表、启动状态筛选、等级与到期、裂变上下级
- 订单 / 财务:订单列表、补单、提现审核、佣金明细
- 卡密 / 通知 / 系统设置:卡密商品与库存、通知机器人事件开关、网关与套餐价格
多管理员:后台支持多管理员与角色权限,敏感操作(节点、卡密、通知、定时消息、推送)按角色授权。
卡密管理
- 后台卡密商店建商品:名称、价格、对应权益(会员天数 / 资源解锁等)、库存卡密
- 卡密批量导入(文本 / CSV),用户购买后自动发货,兑换即开通
- 卡密兑换记录与库存余量在后台可查;卖完自动下架
钱包与礼品卡
- 钱包:用户余额 = 佣金入账 - 提现;余额明细在“我的账户”可查
- 提现:机器人内申请,满 100 元起提;后台审核打款(批准 = 已线下打款,驳回 = 额度返还)
- 礼品卡:以卡密形式发放,见卡密管理;用户凭卡密兑换对应权益
优惠券与活动价
暂无独立优惠券系统。折扣与活动价通过以下方式实现:会员等级折扣价(不同等级不同价)、每日免费解锁次数(等级权益)、后台直接改套餐价与资源价做活动。
会员等级
- 等级:普通、银牌、季度金牌、年度钻石、终身;套餐按月 / 季 / 年 / 终身售卖,天数与价格后台自由设置
- 权益:等级折扣价、每日免费解锁次数(普通用户无);全站免费等级直接免费看
- 终身会员到期为 9999 年,终身会员不能再买任何套餐;换等级走后台直接改
- 付费资源购买方式:直接购买,或办会员享折扣;游客可付,游客解锁只本会话有效;已绑定 TG 账号走持久解锁
分销推广
- 三级分销返佣:邀请链接(
ref_+ 用户 ID)绑定上下级,返佣比例后台可调,明细在佣金记录可查 - 裂变管理:后台看直接邀请人数与启动情况(已启动 / 未启动),机器人没法主动私信未启动用户
- 邀请奖励:签到领经验、邀请返佣与提现打通,见钱包与礼品卡
分销商系统
分销商系统就是一键克隆:用户在机器人内点“🤖 一键克隆”,自带 Token 或号池领取,开一个属于自己的机器人号。
- 克隆号有自己的菜单、命令、返利、提现与客服体系,与主号隔离
- 克隆号用户私聊可双向转发给号主(需号主先给克隆号发 /start),号主回复即抄回用户,不暴露号主身份
- 克隆号底部可开“本号由@用户名创建”标识(一键开关,后台可改用户名)
- 克隆号主在前台自助配收款渠道、自建付费群、改介绍与欢迎语(本节为网盘机器人版;付费入群机器人另有独立克隆体系)
通知中心配置
- 通知机器人:独立 Bot,收订单、提现、签到等事件推送;后台通知设置页按事件开关
- 每日报告:定时任务每天推送运营日报(需开每日报告开关,否则事件收不到属正常)
- 测试通知走旁路(不经过事件开关),收到测试不代表事件推送已开
安全最佳实践
- 每号重设 Webhook:后台机器人管理逐个点“设置 Webhook”,否则无密钥的旧 Webhook 可被伪造推送冒充操作
- 扫一遍
public/storage下有无.php文件,有则删 - 开自定义后台入口,改掉默认
/admin猜测路径;多管理员按角色授权,不要全给超级权限 - 后台生成的配置(含网关密钥)绝不进安装包、不截图外发;Token、ApiToken 只填后台,不贴聊天记录
- 支付回调只认验签 + 金额校验通过的订单;补单只对“待支付”行操作
常见问题
- 机器人没反应 / Webhook 500:先看
runtime/log/<年月>/<日>.log尾巴;常见是 PHP 语法错、Token 失效、Webhook 未重设 - 新页面空白或 500:先
grep路由文件确认新路由已覆盖,再删runtime/temp/*,别只看视图和方法在不在 - 保存成功但字段为空:先查数据库缺不缺列,缺列先跑升级 SQL;ORM 会静默丢掉未知字段
- 克隆号收不到用户私聊:号主须先给自己的克隆号发 /start,否则转发失败;拉黑用户不转发,命令不转发
- 菜单改了机器人里还是旧的:后台点一次“设置菜单”重新注册;命令菜单注册一次长期有效
- 页面改了用户那边还是旧的:静态文件无版本号会被浏览器缓存,用户 Ctrl+F5 或无痕打开
- 支付回调不到账:查网关后台回调地址与密钥、订单金额是否一致、回调是否被重试循环(日志占位符问题已在 v120 后修复)
支付配置与回调指南
- 支持渠道:易支付(支付宝 / 微信 / QQ 钱包)、TokenPay(USDT-TRC20 / TRX / USDC-TRC20)、BEPUSDT(USDT-BSC)
- 配置:后台支付设置页填各渠道参数(接口地址、商户号、密钥)并保存;保存后配置写进
config/pay.php,不要手动改这个文件 - TokenPay 说明:自建开源版,凭证是服务端的 ApiToken;下单与回调均验签,回调只认状态成功 + 金额一致的订单
- 回调:回调地址按后台支付设置页的提示填到网关后台;回调处理做验签、金额校验与幂等,重复回调不会重复发货
- 查账:订单管理看每单网关单号与状态;补单只对“待支付”行操作,补单 = 人工确认到账后发放权益
升级与迁移
- 差分补丁升级(老站唯一正确方式):① 先跑补丁包里的升级 SQL;② 再覆盖补丁文件;③ 删
runtime/temp/*清模板缓存 - 一键安装包只用于全新安装,不要拿整包覆盖老站
- 覆盖不全自查:新页面 500 先
grep路由文件确认新路由在不在,再看视图与方法;只看按钮在不在证明不了路由 - 迁移:整站文件打包 + 数据库导出;新环境解压、导入库、改
.env数据库信息与域名,到后台逐号重设 Webhook
备份与恢复
- 备份:站点文件(源码 +
public/uploads+public/storage)与数据库(mysqldump 导出)分开存,升级前必备一份 - 恢复:新环境按部署一节装好空站,导入数据库备份,覆盖上传目录文件,改
.env,删runtime/temp/*,重设 Webhook - 注意:备份里不要含后台生成的配置与真实密钥外发;恢复后先改管理员密码
运维 CLI(admin 子命令)
本产品是 PHP 应用,没有 admin 子命令;运维靠定时任务与队列命令,站根目录下执行:
php think publish:scheduled # 每分钟:定时帖子发布、X 自动推送、通知日报
php think queue:work --queue=all # 广播群发队列(建议常驻或每分钟拉起)
- 日志位置:
runtime/log/<年月>/<日>.log,出问题先看当天日志尾巴 - 模板缓存:
runtime/temp/*,覆盖文件后删
社区共享项目
- 投稿流程:用户在机器人内点“我要投稿”,提交资源 → 后台审核 → 通过上架
- 节点分享:免费节点天天更新,用户在机器人内直接领取,也可投稿节点
- 资源共享:资源库与软件库均可投稿;分类、平台、付费属性由后台终审
User 前台 API 文档
前台站(pan.kukude.cc)功能:资源浏览与搜索、软件库浏览、付费购买、会员开通、订单与账户、签到与邀请。
- 前台账号与机器人账号绑定:绑定 TG 账号后走持久解锁,未绑定游客解锁只本会话有效
- API Token:后台可建 API Token,供外部系统调用前台数据;Token 只在后台查看与轮换,不要外发
- 机器人命令(完整列表见机器人内 /help):
/start、/help、/res、/search、/soft、/clone、/balance、/invite
站点对接说明
- BotFather 建机器人,拿到 Token
- 后台机器人管理新增机器人,填 Token,点“设置 Webhook”(地址形如
https://域名/webhook/<bot_id>) - 点“设置菜单”注册命令菜单;配好支付网关与群组/资源
- 需要外部调用时,后台建 API Token 给对接方;对接方凭 Token 与 Webhook 地址接入
站点对接 API 文档
- Webhook:
POST https://域名/webhook/<bot_id>,按号分流;机器人管理里每号有独立 Webhook 密钥,密钥错返回 403 - 回调:支付网关回调走后台支付设置页给出的地址,验签 + 金额校验 + 幂等
- 认证:外部调用凭后台颁发的 API Token;Token 泄露立即在后台轮换
官方服务说明
自营服务(官方出品,售后找官方):
- Xnetdisk_bot:网盘机器人,见本页 Telegram Bot 服务介绍
- 付费入群机器人:全自动付费入群 + 一键克隆,前台 tg.kukude.cc
Telegram Bot 服务介绍
📁 Xnetdisk_bot|全能资源管家:700万+资源随搜随取,免费节点天天更新,卡密商店自动发货,会员折扣每日免费,签到领经验、邀请返佣。
机器人:@xnetdisk_bot 前台:pan.kukude.cc
成为赞助商
支持 Xnetdisk_bot 发展,成为赞助商请联系:@xbot666(赞助档位与权益私聊定)。
白银赞助商清单
暂无,虚位以待。