PtokaX NMDC Hub 软件

PtokaX 是用于 Direct Connect 网络的 NMDC Hub 服务器。兼容的 DC++ 客户端连接到 Hub 后，可以查看用户、聊天、搜索文件并接收 Hub 消息。Hub 不承载实际的点对点文件传输，因此 Hub 运行正常并不代表某位用户一定能够向另一位用户上传或下载文件。

PtokaX 不是 ADC 或 ADCS 服务器，也不是 DC++ 客户端。当你的用户、脚本和集成依赖传统 NMDC 行为时，才应选择它。

PtokaX 的历史与范围

PtokaX 长期存在于传统 NMDC Hub 社区中。公开项目区域链接到项目网站、下载页、Wiki 和论坛。独立项目索引记录了 GPL-3.0-only 许可和上游 Subversion 源码位置。0.5.x 系列的公开资料和较早的论坛讨论可作为版本记录，但不能证明某个脚本或配置示例适用于你安装的构建。

必须明确协议边界。NMDC 是用于客户端到 Hub 与客户端到客户端通信的文本协议。PtokaX 协调其中的 Hub 端。要完成点对点传输，客户端仍需具备可用的主动或被动连接、NAT 和防火墙配置以及传输槽位。

运行 PtokaX Hub

1. 从项目来源下载所选版本，记录版本号，并将原始归档文件和已发布的校验信息与部署记录一起保存。
2. 使用专用操作系统账户运行 Hub。可执行文件、配置、日志和 Lua 脚本应由该账户拥有，而不应放在共享桌面目录中。
3. 仅开放已配置 Hub 使用的监听端口。通过用户实际使用的网络路径测试登录、聊天、搜索、注册和真实客户端到客户端传输。
4. 在更换版本前备份配置和脚本数据。先在可舍弃的 Hub 上测试升级或脚本，并保留已知可用的旧版本以便回退。

启动文件和准确配置会因 PtokaX 版本及操作系统构建而不同。在将旧论坛示例复制到公共 Hub 前，请阅读所选版本附带的文档。

管理与 Lua 脚本

PtokaX 拥有庞大的 Lua 脚本生态。脚本可以改变审核、注册、聊天行为、统计和数据库访问。应把脚本视为可执行服务器代码，而不是主题文件。在加载前审查来源、作者、所需 Lua API、依赖库、保存的数据和失败行为。

• 在已安装的 Hub 上使用 !help 查看当前管理员可用的命令集。不要假定另一 PtokaX 版本中的命令存在或使用相同参数。
• 每次只测试一项脚本改动。保存此前脚本和配置的副本，并验证登录、主聊天、私信、注册、封禁和重启行为。
• 不要把密码、数据库凭据或私密用户数据粘贴到聊天命令、论坛帖子或脚本日志中。
• 脚本失败时，在请求帮助前保存完整错误、PtokaX 版本、Lua 版本、脚本修订、触发操作和最小可重现配置。

NMDC 安全与故障排查

NMDC 协议参考将 $MyPass 记录为明文协议数据。即使设置了密码，也不能把 NMDC 管理员登录当成加密连接。应限制管理员账户，只允许可信运营者访问，保护日志和备份；若凭据出现在转录或支持请求中，应立即轮换。

Hub 无法启动时，先确认准确版本、操作系统、监听端口和日志路径。客户端能连接但传输失败时，要把 Hub 登录和搜索问题与客户端主动或被动连接、NAT、防火墙、槽位和点对点传输问题分开调查。项目网站或 Wiki 不可用时，请使用官方论坛确认预期资源，不要用未经验证的镜像二进制文件替代项目下载。

经核实的 PtokaX 资源

以下资源按所有权和用途分类。项目端点和历史社区材料的可用性可能变化，因此在生产环境使用下载、脚本或管理工具前，应确认版本和兼容性。

历史项目元数据将上游检出位置记录为 svn://www.ptokax.org/PtokaX。这是 Subversion 源码位置，而不是浏览器 URL。只有在确认要检查的目标和发布分支后，才使用 SVN 客户端。

相关 Direct Connect 阅读材料

请使用 Direct Connect 了解协议和客户端背景，使用 Verlihub 和 uHub 比较其他 Hub 服务器系列，使用 文章 查看完整文章库，并使用 Hub 搜索 检查公开 Hub 记录。