TubePress 简介
TubePress 是什么、它背后的设计理念，以及这套 CMS 是如何构建起来的。
欢迎阅读 TubePress 文档。TubePress 是一款免费、自托管的视频管网站内容管理系统。您下载后安装在自己的服务器上，一切尽归您所有——代码、数据库、视频和受众群体。无需许可证费用，没有高级套餐，没有用量限制，也没有经 ionCube 加密的文件。每一行代码都是可读的现代 PHP。
本手册涵盖完整流程：安装 TubePress、填充内容、使网站快速美观、对视频进行排名和变现，以及——在您需要时——接入驱动 AI 与内容目录的可选云服务。
TubePress 是什么？
TubePress 之于视频管网站，正如 WordPress 之于博客：这是一个完整、可扩展的平台，处理所有复杂环节——视频上传与转码、大型媒体库的整理、快速分发、排名优化以及流量变现——同时简单到可以在普通主机上运行。
它采用纯 PHP 构建，不依赖任何框架：无 Composer 运行时依赖，无需 Node.js 构建步骤，没有加密文件。它运行在普通的 LAMP 或 LEMP 堆栈上（Apache 或 Nginx + PHP + MySQL/MariaDB）。这使其托管成本低廉、易于审计且可自由修改。
| 原则 | 对您意味着什么 |
|---|---|
| 免费且自托管 | 无论个人还是商业用途，均无需许可证费用。可在自己的服务器上随意部署多个网站。 |
| 开放可读的源码 | 纯 PHP 8——无 ionCube，无加密。可随意阅读、修改和扩展。 |
| 为规模化而设计 | 已在拥有数十万视频的媒体库中经过测试：分块任务、CTR 排名，以及无需系统 crontab 的伪 cron。 |
| 无供应商锁定 | 标准 MySQL 数据库结构与磁盘文件。可随时备份、迁移主机或导出数据。 |
| 可扩展 | 类似 WordPress 的主题与插件系统，支持动作钩子和过滤器钩子。 |
您可以构建什么
TubePress 开箱即用，包含生产级视频管网站所需的一切。以下主要功能——每项在文档后续部分均有深入介绍——包括：
TubePress 的结构
了解目录结构会让后续一切操作更轻松。TubePress 将固定可更新的核心与您可自由安装和卸载的附加组件分离。更新仅涉及核心部分，因此您的主题、插件和内容永远不会被覆盖。
tubepress/
├── config/ App, database & install configuration
├── src/ The core engine (never edit to customise)
│ ├── Core/ App, Router, Database, CronManager, managers
│ ├── Auth/ Authentication & permission gate
│ ├── Models/ Video, Category, Performer, User, Setting…
│ ├── Admin/ Admin panel controllers
│ ├── Front/ Public-facing controllers
│ ├── Helpers/ Format, uploads, SEO, rate limiting…
│ ├── Plugin/ Hook system & plugin manager
│ └── Theme/ Theme manager & renderer
├── sql/ Numbered, auto-run database migrations
├── templates/ Admin panel & install wizard views
├── public/ Web root — index.php, uploads/
│
├── themes/ ← add-ons: drop-in themes (active: "simply")
├── plugins/ ← add-ons: drop-in plugins (agegate, backup, ctr)
└── lang/ Translation files (en, fr, de, es, ar…)您将在架构参考文档中深入了解这些模块。目前，请牢记黄金法则：通过主题、插件和设置进行自定义——切勿直接编辑核心文件。
免费软件，可选云服务
CMS 本身完全免费，可独立运行。此外，您还可以将网站关联到免费的 tubepress.io 账户，以解锁可选的按用量付费云服务——否则您需要自行搭建大量基础设施：
- 内容目录——从包含 40 万余部随时可发布视频的媒体库导入，无需自行抓取。
- AI 功能——通过托管 AI 代理生成标题、描述和翻译。
- 应用市场——安装经授权的高级插件和主题。
- 支持与公告——在管理面板内提交工单并接收产品更新。
这些服务采用预付费积分计费，新账户附赠 150 免费积分。运营视频管网站无需使用这些服务——它们只是在您希望更快推进时的可选项。详情请参阅关联您的账户。
本文档的组织结构
侧边栏按功能目标对文档进行分组：
- 快速入门——服务器要求、安装及初上手指南。
- 管理面板与内容——媒体库日常运营。
- 导入、媒体与外观——填充网站内容、转码与界面样式。
- SEO 与增长——排名、变现与多语言。
- 账户、用户与管理——云服务、会员、安全与维护。
- 开发者参考——架构、钩子、主题 API 与 CLI。
- 参考与帮助——完整设置列表、故障排查与 FAQ。
使用侧边栏顶部的筛选框（按 / 键）可直接跳转至任意页面。