jmbits

jmbits 是一个基于 NexusPHP v1.5 beta 二次开发的 PT（Private Tracker）站点系统。项目最初用于探索校园 PT 社区的搭建方式，并作为一个完整 PHP Web 项目的实践样例。

该项目在原 NexusPHP 的基础上，对界面风格、站点首页、种子发布、资源浏览、论坛等模块进行了定制化改造，目标是构建一个具有社区属性的 PT 站点。

说明：这是一个较早期的历史项目，代码风格、PHP 版本兼容性和安全实现方式可能不适用于现代生产环境。若用于学习或二次开发，建议先完成依赖升级、安全加固和本地测试环境隔离。

项目背景

开发这个项目的主要目的：

• 为校园场景探索一个定制化 PT 站点方案；
• 在 NexusPHP 开源代码基础上进行二次开发，而不是直接使用原生界面和默认功能；
• 通过一个真实 PHP 项目练习 Web 开发、数据库设计、权限控制、文件上传和社区系统实现；
• 尝试将 PT 站点从单纯资源索引扩展为带有公告、论坛、投票、排行榜等功能的社区系统。

主要功能

站点首页

• 站点公告展示；
• 最新种子列表；
• 友情链接；
• 投票模块；
• 基础站点信息聚合。

种子系统

• 种子列表浏览；
• 分类、来源、媒介、编码、清晰度、制作组等多维筛选；
• 活种 / 死种状态筛选；
• 收藏筛选；
• 免费、2X 上传、半价下载等 PT 促销状态；
• 种子详情、评论、下载与统计。

种子发布

• .torrent 文件上传；
• 发布权限校验；
• 分类与二级分类选择；
• 标题、副标题、简介填写；
• 匿名发布支持；
• torrent 文件解析、info hash 计算与 private tracker 标记处理。

社区论坛

• 论坛版块；
• 主题发布；
• 回复、引用、编辑；
• 已读记录；
• 论坛统计；
• 用户活跃信息展示。

站点运营功能

• 公告管理；
• 投票管理；
• 友情链接管理；
• 用户权限判断；
• 缓存与基础统计；
• 排行榜、FAQ、字幕、求种等页面模块。

技术栈

• PHP
• MySQL
• LAMP 环境
• NexusPHP v1.5 beta
• Bootstrap / jQuery 等前端资源

快速开始

1. 准备运行环境

需要先准备一个基础 LAMP 环境：

• Linux / Apache / MySQL / PHP；
• PHP 版本建议使用与旧版 NexusPHP 兼容的环境；
• MySQL 建议使用兼容旧版 mysql_* API 的配置或自行迁移到 mysqli / PDO。

2. 导入数据库

将 db 目录中的 SQL 文件导入 MySQL：

mysql -u root -p < db/your_database_file.sql

实际 SQL 文件名请以仓库中的 db 目录为准。

3. 修改配置

进入 config 目录，根据自己的环境修改配置项，重点包括：

• 数据库地址；
• 数据库用户名和密码；
• 站点域名；
• 邮件发送配置；
• tracker announce 地址；
• 文件上传目录；
• 缓存相关配置。

4. 配置目录权限

确保 Web 服务进程对必要目录具备写入权限，例如：

• torrent 文件保存目录；
• 缓存目录；
• 临时上传目录；
• 日志目录。

5. 启动站点

将项目部署到 Apache Web 根目录后，通过浏览器访问站点域名或本地地址。

目录结构说明

由于本项目继承自 NexusPHP，整体仍采用传统 PHP 项目结构。常见目录和文件职责如下：

.
├── config/          # 站点配置文件
├── db/              # 数据库初始化 SQL
├── include/         # 公共函数、数据库连接、BT/torrent 相关逻辑
├── lang/            # 多语言文案
├── pic/             # 图片资源
├── styles/          # 前端样式资源
├── index.php        # 站点首页
├── torrents.php     # 种子浏览与筛选
├── upload.php       # 种子发布页面
├── takeupload.php   # 种子上传处理逻辑
├── forums.php       # 论坛模块
└── README.md        # 项目说明文档

不同分支或历史版本中的目录名称可能略有差异，请以实际仓库内容为准。

版本记录

v0.1.0 / 2016-12-22

• 完成灰色调前端界面；
• 删除部分不需要的功能；
• 对原 NexusPHP 进行较大幅度定制。

v0.2.0 / 2017-02-20

• 将整体界面重写为扁平化风格；
• 继续调整站点页面和部分业务逻辑。

后续可改进方向

如果继续维护该项目，建议优先考虑以下方向：

• 将旧版 mysql_* 数据库 API 迁移到 mysqli 或 PDO；
• 增加参数绑定，系统性降低 SQL 注入风险；
• 对用户输入、富文本内容和页面输出进行 XSS 加固；
• 增加 CSRF 防护；
• 整理配置模板，避免敏感信息进入仓库；
• 增加 Docker / Docker Compose 本地开发环境；
• 梳理安装脚本和数据库迁移脚本；
• 补充自动化测试和基础 CI；
• 将上传、搜索、论坛、用户权限等核心模块逐步拆分重构。

项目截图

首页

论坛

求种

种子

字幕

排行榜

FAQ

License

本项目基于 NexusPHP 二次开发。具体授权请结合原始 NexusPHP 项目许可和本仓库代码实际情况确认。

免责声明

本项目仅用于技术学习、历史项目归档和合法合规的私有站点系统研究。使用者应遵守所在地法律法规以及相关内容版权要求。