📁 Xnetdisk_bot 官方文档

全能资源管家:700万+资源随搜随取,免费节点天天更新,卡密商店自动发货,会员折扣每日免费,签到领经验、邀请返佣,一键克隆开自己的机器人。

机器人:@xnetdisk_bot 前台:pan.kukude.cc

关于 Xnetdisk_bot

Xnetdisk_bot 是基于 ThinkPHP 6.1 的网盘资源机器人 + 前台站:机器人内可搜资源、领免费节点、买卡密、开会员、签到、邀请返佣;前台站可浏览资源库与软件库、下单支付、查看订单与账户。

环境要求

更新日志

大版本节点(完整记录见包内修复说明):

config.yml 详细说明

本产品是 PHP 应用,没有 config.yml。配置分两处:后台设置页(日常改动全在这里)与 config/ 目录(源码自带,部署时不动)。

部署总览

三条路线,按熟练度选:

三种路线装完都要做同一收尾:设 Webhook、配网关、加计划任务(定时发布与队列)。

单二进制部署(推荐小白)

本产品是 PHP 应用,不提供单二进制包;小白路线对应的是一键安装包:源码 + vendor + install.sql 已配套打好,解压即用,不用 composer。
  1. 下载一键安装版压缩包,解压到站点根目录(如 /www/wwwroot/pan.kukude.cc)
  2. 网站运行目录(文档根目录)设为 public/
  3. 按包内一键安装说明走安装向导:填数据库信息(自动建库、导入 40 张表)、设管理员账号密码、填 Bot Token(自动取机器人用户名并设 Webhook)
  4. 安装完成会生成 install.lock,向导自动锁定;装完删除 public/install.php(如包内含)
  5. 登录后台(/admin/login,如改过自定义入口则走自定义地址)配置网关、群组、套餐
一键安装包只用于全新安装。已有数据的站不要整包覆盖,按差分补丁升级(见升级与迁移)。

手动部署

  1. 上传源码到站点根目录,运行目录设为 public/,PHP 选 7.4+,装好所需扩展
  2. 新建数据库(utf8mb4),导入 install.sql(40 张表)
  3. 配置数据库连接:复制 .env.example 为 .env 填好,或改 config/database.php
  4. 确保 runtime/ 可写(Web 服务器用户),删 runtime/temp/* 清模板缓存
  5. HTTPS 配好后,到后台机器人管理点“设置 Webhook”,Webhook 地址形如 https://域名/webhook/<bot_id>
  6. 到后台机器人管理点“设置菜单”,注册机器人命令菜单

Docker Compose 部署

官方暂不提供 Docker 镜像与 Compose 文件。推荐走 aaPanel / 1Panel 面板部署,步骤见下面两节;已有 Docker 经验的用户可自建 PHP + MySQL + Nginx 容器,按手动部署一节的步骤装。

aaPanel 手动部署

  1. aaPanel → 网站 → 添加站点,填域名,PHP 选 7.4+,数据库选 MySQL(记下库名与账号密码)
  2. 网站设置 → 网站目录 → 运行目录选 public;伪静态选 ThinkPHP 规则;SSL 申请并开启强制 HTTPS
  3. 文件管理进站点根目录,上传源码压缩包并解压到根目录(不要多一层文件夹)
  4. 数据库 → 导入 install.sql;根目录 .env 填好数据库信息
  5. 计划任务 → Shell 脚本:定时发布与队列
    cd /www/wwwroot/你的域名 && php think publish:scheduled
    cd /www/wwwroot/你的域名 && php think queue:work --queue=all
    定时发布每分钟一次;队列建议常驻或每分钟拉起
  6. 后台机器人管理 → 设置 Webhook、设置菜单;支付网关页填好各渠道参数

1Panel 部署

  1. 1Panel → 网站 → 创建网站 → 运行环境选 PHP 7.4+,数据库选 MySQL,记下库名与账号密码
  2. 网站设置 → 运行目录改为 public;伪静态选 ThinkPHP;SSL 开启 HTTPS
  3. 文件管理上传源码解压到站点根目录;数据库管理导入 install.sql;根目录 .env 填好
  4. 计划任务加两条 Shell(与 aaPanel 一节相同):php think publish:scheduled(每分钟)、php think queue:work --queue=all
  5. 后台设 Webhook、设菜单、配网关,收尾与 aaPanel 相同

后台管理入门

后台地址:/admin/login(如开启自定义后台入口,则走自定义地址)。登录后左侧菜单:

多管理员:后台支持多管理员与角色权限,敏感操作(节点、卡密、通知、定时消息、推送)按角色授权。

卡密管理

钱包与礼品卡

优惠券与活动价

暂无独立优惠券系统。折扣与活动价通过以下方式实现:会员等级折扣价(不同等级不同价)、每日免费解锁次数(等级权益)、后台直接改套餐价与资源价做活动。

会员等级

分销推广

分销商系统

分销商系统就是一键克隆:用户在机器人内点“🤖 一键克隆”,自带 Token 或号池领取,开一个属于自己的机器人号。

通知中心配置

安全最佳实践

常见问题

支付配置与回调指南

升级与迁移

备份与恢复

运维 CLI(admin 子命令)

本产品是 PHP 应用,没有 admin 子命令;运维靠定时任务与队列命令,站根目录下执行:
php think publish:scheduled   # 每分钟:定时帖子发布、X 自动推送、通知日报
php think queue:work --queue=all  # 广播群发队列(建议常驻或每分钟拉起)

社区共享项目

User 前台 API 文档

前台站(pan.kukude.cc)功能:资源浏览与搜索、软件库浏览、付费购买、会员开通、订单与账户、签到与邀请。

站点对接说明

  1. BotFather 建机器人,拿到 Token
  2. 后台机器人管理新增机器人,填 Token,点“设置 Webhook”(地址形如 https://域名/webhook/<bot_id>)
  3. 点“设置菜单”注册命令菜单;配好支付网关与群组/资源
  4. 需要外部调用时,后台建 API Token 给对接方;对接方凭 Token 与 Webhook 地址接入

站点对接 API 文档

官方服务说明

自营服务(官方出品,售后找官方):

Telegram Bot 服务介绍

📁 Xnetdisk_bot|全能资源管家:700万+资源随搜随取,免费节点天天更新,卡密商店自动发货,会员折扣每日免费,签到领经验、邀请返佣。

机器人:@xnetdisk_bot 前台:pan.kukude.cc

支持 Xnetdisk_bot 发展,成为赞助商请联系:@xbot666(赞助档位与权益私聊定)。

暂无,虚位以待。