如何用 TubePress 向你的视频网站批量导入数千个视频

逐个手动添加视频适合演示，但真正的tube网站需要以填充好的目录上线。本指南将向您展示如何使用 TubePress 向您的tube网站批量导入视频——CSV 与 JSON 的区别、如何精确映射列、可复制的实际 CSV 示例、重复检测和批量分配的工作方式，以及如何按计划持续导入新鲜内容。TubePress 每次导入可处理超过 10,000 个视频，并可扩展至拥有 500,000 多个视频的数据库，因此无论您是在为全新网站添加种子内容还是为大型网站补充内容，同一工作流均适用。

TubePress 是一款完全免费、可自托管的成人tube网站 CMS，基于现代 PHP 8.4 构建，无加密文件，无需 Composer，也无需 Node.js。如果您尚未安装，入门指南将引导您完成 5 步 Web 安装程序，您也可以先在线体验 demo。

CSV 与 JSON：应使用哪种导入格式？

TubePress 支持 CSV 和 JSON 两种格式进行批量导入。两者产生相同的结果——选择哪种格式取决于您的数据来源。

• CSV 是正确的默认选择。大多数内容提供商、电子表格和现有tube数据库都会导出此格式，在任何电子表格应用中都可以轻松编辑，并且可以清晰地将每行映射为一个视频。除非有特殊原因，否则请使用 CSV。
• JSON 更适合您的数据源已经生成结构化数据的情况——例如 API 响应、爬虫输出或包含嵌套字段的内容流。当单个视频拥有大量标签或演员时，JSON 的可读性也更好，因为这些内容会成为数组，而不是单元格内的分隔字符串。

两种格式都经过相同的导入流程：解析文件、映射字段、检测重复项、应用批量分配并写入数据行。因此，您可以为团队统一采用一种格式，无需再为此烦恼。

TubePress 视频导入的精确列映射

导入器的优势在于您的文件标题无需与 TubePress 的内部字段名称匹配。导入时，您可以将每个源列映射到 TubePress 字段，因此可以直接导入现有目录而无需重新格式化。您通常映射的字段涵盖核心视频实体，以及 TubePress 用于跨其六种实体类型（视频、分类、标签、演员、工作室、评论）组织内容的关联关系。

分类、标签、演员和工作室都是一等实体，因此您导入的任何尚不存在的值都会被自动创建并关联。这正是单个导入文件就能搭建起完整有序网站的原因。

实际 CSV 示例

以下是一个可直接复制的小型 CSV 示例。注意标题行（导入时进行映射）、引号单元格内以逗号分隔的多值，以及与产品文档完全一致的通用标签：

title,description,video_url,thumbnail_url,duration,categories,tags,performers,studio
"Beach Day POV","Sunny outdoor clip in full HD.",https://cdn.example.com/v/1001.mp4,https://cdn.example.com/t/1001.jpg,612,"Amateur,Outdoor","HD,POV","Alex Rivers","Riverside Media"
"Studio Session 12","Behind-the-scenes set.",https://cdn.example.com/v/1002.mp4,https://cdn.example.com/t/1002.jpg,845,"Studio","HD,Behind The Scenes","Jamie Lin","Riverside Media"
"Late Night Vol 3","Low-light indoor shoot.",https://cdn.example.com/v/1003.mp4,https://cdn.example.com/t/1003.jpg,1207,"Amateur","POV,Verified","Alex Rivers,Jamie Lin","Northside Films"

同样的三行数据以 JSON 格式表示时，只需将多值字段嵌套为数组：

[
  {
    "title": "Beach Day POV",
    "description": "Sunny outdoor clip in full HD.",
    "video_url": "https://cdn.example.com/v/1001.mp4",
    "thumbnail_url": "https://cdn.example.com/t/1001.jpg",
    "duration": 612,
    "categories": ["Amateur", "Outdoor"],
    "tags": ["HD", "POV"],
    "performers": ["Alex Rivers"],
    "studio": "Riverside Media"
  }
]

如果您的列标题已与这些字段名称匹配，则映射只需一键完成。如果不匹配，只需在导入界面中将每个源列指向对应的 TubePress 字段即可——无需事先在电子表格中重命名列。

重复检测：安全地重复导入同一内容流

重新运行内容流是正常操作——提供商每周都会在同一导出文件中添加新视频片段。TubePress 内置的重复检测功能会将传入的行与数据库中已有的内容进行比对，跳过已有视频，因此第二次导入只会添加真正新的视频。这正是计划性、重复性导入切实可行的原因：您可以将导入器指向同一个不断增长的文件或内容流，而不会累积重复的视频副本。

批量分配：一次性标记整批导入内容

除文件中每行的分类和标签外，TubePress 还允许您一步完成对整批导入内容的批量分配。如果您正在导入来自同一工作室的内容包，或希望本次导入的每个视频都带有特定分类或标签，只需在导入时设置一次，而无需逐行编辑 10,000 行。您可以批量分配分类、标签、演员和工作室——非常适合按来源、按细分领域或按导入日期组织上线内容。

TubePress 目录：一键导入，AI 标题重写

如果您还没有自己的内容流，TubePress 目录是填充网站的最快途径。您可以浏览精选视频包并一键导入——无需构建 CSV。相比直接导入原始内容流，以下两点优势让其更胜一筹：

• AI 标题重写为每个导入的视频生成独特、SEO 友好的标题，确保您不会发布与运行相同内容包的其他网站相同的重复标题。独特标题对搜索至关重要；请参阅 tube 网站 SEO 指南，了解其与整体策略的关联。
• 自动翻译将标题渲染为您网站配置的语言，与 TubePress 的 30 多种界面语言和逐页内容翻译功能完美配合。

新免费账户可获得 150 个免费积分用于体验目录导入。由于 TubePress 本身免费使用且可自托管，目录是免费 CMS 之上的可选加速工具——而非功能付费墙。这与付费加密平台有着显著区别；如果您仍在选择 CMS，请查看完整对比。

使用 Cron 计划定期导入

对于需要保持内容新鲜的网站，您不应手动运行导入。TubePress 内置了一套 CronManager 伪 cron API，平台已将其用于每 10 分钟重新计算 CTR 排名、执行定期每日数据库备份等任务。您可以将定期导入挂载到同一调度系统，使新内容自动入库。

CTR 排名值得在此了解，因为它直接奖励稳定供应的新鲜内容。每个视频的排名计算方式如下：

ctr_score = (views / (impressions + 50)) * EXP(-0.01 * days_age)

较新的视频通过 EXP(-0.01 * days_age) 衰减项获得时效加成，分数每 10 分钟重新计算一次，并过滤机器人流量。定期导入可持续保有新的 days_age = 0 视频进入轮换，这正是该排名算法旨在呈现的行为。如果您希望日后自定义评分，还有 13 个覆盖钩子可供使用。

可重复的导入工作流

1. 将目录导出或整理为 CSV（默认）或 JSON。
2. 上传文件，将每个源列映射到对应的 TubePress 字段。
3. 为整批导入设置批量分配——工作室、上线分类、日期标签。
4. 让重复检测自动跳过数据库中已有的内容。
5. 执行导入：约 10,000 个视频入库。
6. 为持续保持内容新鲜，通过 CronManager 定期调度导入，并/或使用带 AI 重写标题的目录内容包。

同一流程可从首次上线扩展至拥有 500,000 多个视频的内容库，而无需改变操作方式。目录建立完成后，将精力转向 SEO 和变现——内容量只是基础。您可以在功能页面查看所有导入器和排名的详细信息。

准备好批量导入您的目录了吗？免费下载 TubePress，几分钟内即可上线内容丰富的 tube 网站。