安装

TubePress 的安装方式与任何经典 PHP 应用程序相同：上传文件，在浏览器中打开您的域名，然后按照简短的网页向导操作。无需命令行，无需构建步骤。

大约需要五分钟。开始之前，请确认您的服务器满足系统要求，并准备好数据库信息。

下载 TubePress

从下载页面获取最新版本。这是一个单一的小型 ZIP 文件，包含完整的、可编辑的 PHP 源代码—无需许可证密钥，也不含 ionCube。

上传到您的服务器

解压 ZIP 文件，通过 FTP/SFTP 或主机的文件管理器将内容上传到服务器。有一条关键规则：您的网站根目录必须指向 public/ 目录，而不是项目根目录。其他所有目录—config/、src/、storage/、themes/、plugins/—位于文档根目录上一级，永远不会被直接访问。

运行网页安装程序

在浏览器中访问您的域名。由于尚未存在 config/installed.php 标记文件，TubePress 会直接引导您进入安装向导。共有六个步骤：

1. 欢迎。简短的介绍页面—点击继续即可开始。
2. 系统检查。验证您的 PHP 版本、扩展模块和可写文件夹。当所有必需的检查项通过后，将自动进入下一步；若有任何检查失败，每个检查项会展开并说明修复方法。
3. 数据库。输入数据库主机、名称、用户名和密码。TubePress 会连接数据库，如有权限则自动创建（共享主机上则使用已有数据库），执行所有 SQL 迁移，并写入 config/database.php。主机字段同时支持 host:port 格式或套接字路径。
4. 管理员账户。创建您的管理员账户—用户名（3–50 个字符）、有效的电子邮件地址，以及至少 8 个字符的密码。
5. 设置。为您的网站命名（描述可选）。网站 URL 会自动检测，每页视频数默认为 24—这些均可在之后修改。
6. 完成。TubePress 将初始化默认页面、设置和 SEO 默认值，写入安装标记，并提供您新后台管理面板的访问链接。

文件权限

Web 服务器用户（通常为 www-data）必须拥有并能够写入以下三个位置：config/（保存设置）、storage/（日志、临时文件和备份）以及 public/uploads/（媒体文件）。系统检查会标记所有不可写的位置。

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

只有这三个路径需要对服务器开放写入权限；目录树的其余部分可以保持只读。

Apache 与 Nginx

两者均完全支持，并在安装过程中自动检测。

• Apache — 设置 AllowOverride All，使内置的 .htaccess 文件能够处理干净的 URL 并阻止访问敏感目录。安装完成后，TubePress 会创建 public/themes 和 public/templates 符号链接，以使主题资源正常解析。
• Nginx — 添加标准的 try_files … /index.php?$query_string 规则，将 /themes/ 和 /templates/ 别名指向项目文件夹，并对 config/、src/ 和 storage/ 路径设置 deny。完整配置片段请参阅系统要求。

本地开发（localhost）

TubePress 可在无需特殊配置的纯 HTTP localhost 环境下运行—安装程序、会话和登录均无需 HTTPS 即可正常工作。两种便捷选项：

• 本地 Web 服务器（最接近生产环境）—将 Apache 或 Nginx 指向 public/ 文件夹，方法与上述相同。
• PHP 内置服务器（零配置）—在项目根目录下运行以下命令，然后打开 http://localhost:8000。

php -S localhost:8000 -t public public/router.php

内置的 router.php 提供干净的 URL，前端控制器直接提供主题和管理后台资源—因此即使不配置资源别名，样式也可以开箱即用。

安装完成后

使用刚刚创建的账户登录 /admin，开始设置您的网站。入门指南将引导您完成网站标识、品牌形象、首批视频上传以及上线检查清单。建议尽早加固管理员登录—请参阅安全。

后续步骤