视频网站管理后台使用手册

0开始之前

后台管理的是面向用户的视频网站（下称 C 端）上的全部内容：片库、广告、通知、分类与展示样式。多数配置保存即生效，C 端刷新页面就能看到，没有单独的「发布」动作——所以改之前先想清楚影响面。

三块最常用的功能

七块菜单里，日常真正天天打交道的是三块：把片子上到网站、把广告投出去、把 C 端页面配成想要的样子。先把这三条主线过一遍，后面的分章看起来会轻松很多。

一、把片子上到 C 端

整条链路里后台只负责后三步，而且顺利的时候只剩「上架」这一下。文件命名和上传见 3.2，核对与修正见 3.4。

二、把广告投出去

广告分框外（列表页和详情页的图片广告）和框内（播放时的贴片、循环视频广告）两类，配置路径不同，见 4.1；投放计划的每个字段见 4.5。

三、配 C 端页面

「分类与展示」这一组菜单决定 C 端长什么样。多数配置保存即生效，改完刷新 C 端就能看到。下面用 C 端实际页面对照，看每一处分别由后台哪一页控制。

顶部这排栏目就是「页面配置」里的列表，名称、顺序、每个栏目收哪些内容全在那一页设置（6.4）。「新鲜热播」是系统固定栏目，改不了也删不掉。

大图本身是栏目的封面视频（在页面配置里挑一部影片）；上面的类型标签来自影片的视频子类型；年份、集数这些角标则由样式与显示开关逐项控制——开关关掉就不显示，开着但影片没填对应字段也不会显示。

往下滚动的每一行（热门视频、喜剧片、剧情片……）对应页面配置里该栏目的展示项，选了哪些子类型和标签、拖成什么顺序，C 端就按这个排。

手机首页顶部的轮播来自手机轮播图（横竖版式也在那里切）；轮播下面那条横幅就是框外广告，由投放计划投到「首页广告位」上。如果「移动端标题页视频栏样式」选了模式二，轮播不展示——配了轮播但手机上看不到，先查这个开关。

筛选栏出现哪些维度由筛选栏模式决定（模式一含电影/剧集/热播/类目/国家/标签，模式二只有热播/类目/标签）；具体可选项则来自视频子类型和视频标签。

搜索框下面的推荐词就是搜索页关键字配置里选中并排好序的那些。

C 端位置 ↔ 后台配置对照表

登录与界面

访问后台地址，输入用户名、密码和验证码登录。验证码点一下图片可以刷新。

登录后左侧是菜单栏，右侧是内容区。菜单栏不是写死的——它由「系统 → 菜单管理」里配置的数据生成，并按当前账号的角色过滤。所以你看到的菜单可能比同事少，这不是 bug。

通用操作与权限

列表页的共同结构

大部分列表页长得一样：顶部是搜索条件，右上角是新建/批量操作按钮，中间是表格，底部是分页。

• 搜索：填好条件点「搜索」。多数搜索框是模糊匹配（比如视频名称输入「权力」能搜到《权力的游戏》）。
• 表头筛选：列名旁边带小箭头的（如视频种类、子类型、上架状态）点开可以按值筛选，和搜索框叠加生效。
• 排序：列名旁边带上下箭头的（如播放次数、播放基数）可以点击排序。
• 批量操作：先勾选左侧复选框，右上角的批量按钮才会亮起。
• 每页条数：分页器左边可以切 10/20/50 条。

时间怎么显示

后台所有时间都按你电脑所在时区换算后展示，不是服务器时间。跨时区协作对时间时留意这点。

权限是怎么算的

权限分两层：

一条容易踩的规则：如果某个授权码整个系统里从来没配置过，那么所有人默认都有这个权限；一旦有人配了这个码，就只有被授权的角色能看到按钮。也就是说，给一个功能加权限控制，是「从无到有」地收紧，不是放开。

1总览

总览

登录后的首页，看站点整体水位。上排五个数字卡片，下面是一张可切换指标的趋势图。

五个数字

卡片下方的小三角是与昨日的差值：上升红色、下降绿色、无变化显示「持平」。数字很大时会缩写（如 1.2万），把鼠标停在卡片上能看到完整数字。

报表统计

五个指标按钮（网站浏览数、活跃用户、新增注册用户、视频播放数、上传视频数）切换曲线，右侧 7天 / 30天 / 90天 切时间跨度。数据首次加载后会缓存，来回切换不会重复请求。

2用户管理

用户管理

这里管的是 C 端注册用户（在网站上注册看片的人），跟「系统 → 管理员用户」是完全两套账号体系，不要混。

列表字段

顶部搜索框按用户名模糊匹配。

能做的三件事

右上角「创建」可以手工建号，邮箱、密码、昵称必填。批量勾选后点右上角「封禁」可一次封多个。

3视频管理

片库相关的一切都在这里。理解一个前提能省很多事：后台里一条「视频」不是一个文件，而是一个「影片条目」——它下面挂着若干「分集」，分集才对应真正的播放地址。电影通常只有 1 集，剧集有 N 集。

3.1 内容上线全流程

概览见 0 · 三块最常用的功能，这里是每一步的细节。

3.2 用上传器上传视频

视频文件不从后台上传，走独立的上传器客户端。上传器在本地跑一个服务，浏览器里操作，文件直传云端，传完回调后台自动建条目。上传前的文件命名和目录结构决定了后台能不能正确识别，这一步值得花时间做对。

上传前：文件夹与文件命名

系统靠文件夹名去 TMDB 搜片，名字写对了元信息就能自动匹配上，写错了就得在后台手工补一遍。年份可以不写，但写上匹配会准很多（同名影片太多）。

电影

一个电影一个文件夹，正片、预告片、封面、海报、字幕全放进去。

剧集

剧集以季为单位——一季就是后台里的一个影片条目。每一集建一个单集文件夹，把该集的正片、剧照、字幕放进去；整季共用的预告片、封面、海报1、海报2 放进第一集的文件夹。上传时把这一季所有单集文件夹一起传，顺序无所谓。

启动上传器

Windows：双击 ucloud.exe，出现控制台窗口即启动成功，直接跳到第 4 步。

macOS：需要先给执行权限。

1. 准备好 ucloud.bin

   放在一个好找的目录，比如「下载」。

2. 打开「终端」，进入文件所在目录

   输入 cd 加一个空格，把文件夹拖进终端窗口，回车。

3. 加执行权限并运行

   依次执行 chmod +x ucloud.bin 和 ./ucloud.bin。看到「服务器已配置 / WebSocket 端点」等提示，就是起来了。

4. 打开上传页面

   如果页面提示 WebSocket 连接失败，把服务地址改成 wss://localhost:8080/api/v1/ws/events 再点重试。左上角状态显示「已连接」即成功。

5. 在「设置」页填回调地址

   粘贴技术提供的回调地址，点「保存配置」。这个地址就是后台「系统 → 上传器 Webhook」里生成的 URL（见 7.2）。

6. 进「上传」页，选择本地文件夹

   电影选电影文件夹，剧集选单集文件夹——10 集就把 10 个单集文件夹都加上。

7. 点文件夹右侧的加号加入待上传

   可以一次加多个。

8. 点「分析文件」，确认无误后点「开始上传」

   分析完会显示文件数、总大小和分组数。

9. 等待完成

   进度全绿、显示「完成」即上传成功。

3.3 剧集/电影管理

视频管理›剧集/电影管理

筛选

• 视频名称：模糊匹配。
• icloud状态：选「（部分）失效视频」可以把播放地址失效的片子筛出来，用来排查播放报错。
• 表头筛选：视频种类、视频子类型、上架状态三列可点表头筛选。

列表字段

操作菜单

每行右侧「操作」下拉里有六项：

批量操作

勾选多行后，右上角可以批量上架、批量下架、删除。批量上架只对当前是下架的生效，批量下架反之。

3.4 新增与编辑影片

视频管理›剧集/电影管理›添加 / 编辑

多数片子不需要进这一页。如果对应的 Webhook 开了「查询TMDB」，条目建出来时简介、海报、演职员就已经填好了，直接上架即可。只有当自动匹配错了片、信息缺失，或者要人工调整分类、标签、热播标记时，才需要在这里编辑。

需要补信息时，这一页最省事的用法是让 TMDB 帮你填。

用 TMDB 自动填充

1. 先选对「视频种类」

   选「剧集」会去 TMDB 搜剧集库，选其他（电影等）搜电影库。选错了搜不到想要的结果。

2. 在「视频名称」里输入片名

   下拉会给出带海报、评分、年份、简介的候选，挑一个点它。

3. 剧集要再选一次「季」

   选完剧集后会多出「选择季」一栏，选中某一季时会问你「是否获取该季的详细信息并自动填充表单」，选「是」。

4. 确认自动填充的内容

   简介、封面、海报、上映时间、时长、评分、集数、导演、主演、编剧、国家、标签会被填上，视频名称变成「剧名 + 季名」。

5. 手动补齐剩下的

   年龄分级、清晰度、子类型这些 TMDB 给不了，自己选。

6. 点「保存修改 / 添加」

字段说明

保存时会连带发生什么

• 剧集 + 选了季：保存后会按 TMDB 的分集列表批量创建分集，带上每集的标题、时长、简介、剧照。新建模式下逐集创建，播放地址是占位的 .mp4，需要后续补。
• 填了系列名：保存后自动把这部片挂到该系列末尾；系列不存在会先创建。

3.5 分集与字幕

视频管理›剧集/电影管理›操作 › 剧集

列表按分集展示，字段包括剧集编号、标题、播放次数、时长、icloud 状态、上架状态。每行可以编辑、上架/下架、弹幕。

分集编辑页

页面分上下两张卡片：

3.6 弹幕管理

视频管理›剧集/电影管理›操作 › 剧集›弹幕

按分集查看用户发的弹幕，字段有用户ID、内容、出现时间（mm:ss）、类型（滚动 / 顶部 / 底部）、发送时间。

只能删除，单条删或勾选后批量删，不能编辑。要禁止某个用户继续发弹幕，去「用户管理」对他永久禁言；要预防某类词出现，去「敏感词管理」配词库。

3.7 系列管理

视频管理›系列管理

系列是把同一 IP 的多部作品打包展示的分组。开启「按系列展示」后，C 端列表里同系列的片子会合并成一张卡片。

4广告管理

4.1 广告类型与投放链路

站点的广告分两大类，配置路径完全不同：

不管哪一类，链路都是同一条：

上传广告素材

登录上传器，进「广告管理」页，点「添加上传」，选择包含广告图片（框外广告）或广告视频（视频内广告）的文件夹。

4.2 广告文件管理

广告管理›广告文件管理

上传器传上来的广告素材都在这里，是一个只读为主的媒体池。字段包括文件名、格式、媒体地址、大小、时长、创建人。

可以点右上角新建手工登记一个文件（用于素材已在云端、但没走上传器回调的情况），需要填文件名、文件格式、媒体地址。已有记录只能查看，不提供编辑。

配广告时用得上的是媒体地址——在广告仓库里「广告文件选择」下拉搜文件名，选中后媒体地址会自动带过去。

4.3 广告仓库

广告管理›广告仓库

把一个素材登记成一条「广告」：给它起名字、配跳转链接。一条广告可以被多个投放计划复用。

三种状态

新增广告

详情

详情弹窗下半部分列出关联的投放计划（计划名称、广告位、状态、生效时段）。点某张计划卡片会跳到投放计划页并定位到它；点「新增计划」会带着这条广告直接跳去新建计划。排查「这条广告为什么没露出」时，从这里看它到底挂没挂计划最快。

4.4 广告位

广告位是「广告能出现的位置」，分两个菜单维护。

框内贴片广告位

广告管理›框内贴片广告位

卡片上显示「广告进度」和「当前计划」数量，点「查看」能看到挂在这个位上的计划列表。

框外广告位

广告管理›框外广告位

字段更简单：名称、备注、是否开启。名称就是 C 端的位置，常见的是首页广告（网站主页、剧集、电影等列表页）和详情页广告（视频详情页）。

「是否开启」是这个位的总闸。关掉后，挂在它下面的计划即使是上架状态也不会展示。

4.5 投放计划

广告管理›投放计划

广告真正「投出去」的地方。一条计划 = 一条广告 + 一个广告位 + 一段时间 + 一组投放条件。

新建计划

1. 左侧「选择广告」

   从广告仓库里挑一条。选中后下方会显示它的创建时间、媒体类型、媒体地址和跳转链接，用来确认没选错。

2. 填「计划名称」

   必填，建议和广告名称呼应，便于在列表里检索。

3. 选「广告位类型」

   框内广告(贴片) / 框外广告 / 框内广告(循环)。选完类型，下面的表单会跟着变。

4. 选「广告位名称」

   下拉的选项来自对应类型的广告位。框外广告选「首页广告」或「详情页广告」；框内贴片选「前贴片」这类。循环广告没有这一项，改为填登录用户和游客两个间隔秒数（从第 0 秒起算，开播即插一次）。

5. 选「生效日期」

   必填的起止日期区间。

6. 设「投放时段」

   默认「不限」；选「自定义」可以用时间轴细分每天的投放时段。

7. 选「绑定视频类型」

   只在这些视频子类型的内容上投放。框内广告必选至少一个（有全选/全部取消按钮）；框外广告这一项是灰的，不需要选。

8. 选「用户设备类型」

   移动设备(苹果) / 移动设备(安卓) / PC / 其它，至少选一个。

9. 设「跳过广告」

   允许跳过时要填跳过时间（秒），即播放几秒后出现跳过按钮。框外广告不适用，选项是灰的。

10. 选「状态」并保存

    选上架中保存后立即开始投放；选仓库中则先存着不投。

字段速查

上下架与修改

详情

「详情」里能看到这条计划关联的广告、广告位和效果数据，适合复核配置。

列表筛选

顶部三个条件：计划名称/关联广告名称（模糊）、广告类型、计划状态。

4.6 循环广告

循环广告是「播放过程中每隔一段时间插一次」的视频广告，间隔按登录用户和游客分别设置，可以给游客更密的广告。配置方式就是投放计划里把「广告位类型」选成框内广告(循环)，然后填两个间隔秒数——它没有广告位可选，位置由间隔决定。

间隔之外，循环广告和别的计划一样受生效日期、投放时段、绑定视频类型、用户设备类型约束，也可以单独设置是否允许跳过。要停掉循环广告，把对应计划下架即可。

4.7 营销报表

广告管理›投放计划›营销报表

按投放计划维度看效果数据：曝光次数（按浏览器）、曝光次数（按设备类型）等分布图，以及计划的基本信息和明细。用来判断某条计划投得值不值、哪个端的量更大。

5通知与用户触达

5.1 通知列表

通知管理›通知列表

站内通知，用户在 C 端的消息中心能看到。通知分两类：

可以单条删除，也可以勾选后批量删。

5.2 视频推送

通知管理›视频推送

推送的发起点不在这里，而在「剧集/电影管理 → 操作 → 推送」。这个页面看的是推送后的效果。

点每行的「推送记录」，可以看到逐个用户的送达明细和已读状态。

5.3 工单管理

工单管理

C 端「联系我们」提交的用户反馈都进这里。页面顶部有「全部工单」和「待处理」两个统计卡片。

筛选

上方一排状态标签（全部 / 未处理 / 处理中 / 已处理 / 不予处理，各带数量），右侧是类型下拉。标签上的数字是全局统计，不受当前分页影响。

处理工单

点行尾「变更状态」，在弹窗里选一个新状态即可，选中立刻提交。

工单编号形如 #GD0012；讯息列过长会截断，鼠标悬停能看到全文。提交时间是相对显示的（今天 / 昨天 / 月-日）。

6分类与展示

这一组菜单决定 C 端「长什么样」——分类怎么分、首页排什么、筛选栏有哪些选项。改动大多立刻对全站生效，改之前先确认。

6.1 视频子类型

分类与展示›视频子类型

剧情片、动作片、动画……C 端筛选栏里的主要类目，也是影片编辑页「视频子类型」的选项来源。

排序是拖拽 + 保存两步。拖完必须点「保存」才生效，和标签页的上移/下移（即时保存）不一样。

6.2 视频标签

分类与展示›视频标签

比子类型更细的标记，一部片子可以打多个标签（编辑页里是复选框），这点和只能选一个的子类型相反。TMDB 自动填充时会按名称把题材匹配到这里的标签上，所以标签名尽量和常见题材名一致（如「动作」「科幻」「恐怖」），匹配率更高。

每行可上移 / 下移 / 编辑 / 删除，上移下移点了就保存。顺序影响 C 端筛选栏里标签的排列。

6.3 样式与显示开关

分类与展示›样式与显示开关

显示开关（左栏）

浏览全部页与搜索页样式（右栏）

筛选栏模式

移动端标题页视频栏样式

模式一左右滑动的横向列表；模式二 竖屏 2×2、横屏 4×1 的网格（且不再展示轮播）。

6.4 页面配置

分类与展示›页面配置

配置 C 端顶部导航的栏目以及每个栏目里展示什么内容。表格顺序就是 C 端导航的顺序。

新增 / 编辑栏目

6.5 搜索页关键字配置

分类与展示›搜索页关键字配置

决定 C 端搜索页上给用户的推荐关键字。左边「可选项」是全部子类型和标签（前缀标了 [子类型] / [标签]），选中后移到右边「已选项」。

• 支持搜索过滤，条目多时好找。
• 已选项里每条右侧有上下箭头，可以调顺序，顺序就是 C 端展示顺序。
• 配好后点保存；点「重置」是丢弃当前改动、重新拉线上配置，不是清空。

6.6 手机轮播图

分类与展示›手机轮播图

页面顶部先选轮播图样式：竖向 / 横向，切换即保存。下面是轮播条目列表。

列表里每行可上移 / 下移 / 编辑 / 删除，顺序即 C 端轮播顺序，上移下移点了立即保存。

7系统

站点级配置和后台自身的权限管理。这一章的操作影响面最大，尤其是菜单、角色和用户，改错会让同事进不了后台。

7.1 SEO 配置

系统›SEO配置

网站的品牌与搜索引擎相关信息。Logo、favicon 支持直接上传图片，上传后自动填入地址。

改完点保存。必填项没填会拦下并提示。

7.2 上传器 Webhook

系统›上传器Webhook

上传器把视频传完之后，靠一个回调地址通知后台建条目。这一页就是生成和管理这些回调地址的地方——上传教程里让你粘贴的「技术提供的回调地址」，就在这里复制。

新建一条

7.3 敏感词管理

敏感词管理（一级菜单）

弹幕的词库过滤。命中的弹幕会被拦下，不会出现在播放器里。

顶部可按词搜索、按状态筛选，支持勾选后批量删除。

敏感词管的是「以后发的弹幕」。已经发出来的违规弹幕要去 3.6 弹幕管理 里删；反复发的用户去 用户管理 里永久禁言。

7.4 菜单管理

系统›菜单管理

后台自己的菜单树，同时也是权限的定义处。页面进不去、按钮看不到，根子都在这一页。

三种类型

要补一个进不去的页面时

1. 点「新增菜单」（或在目标目录那行点「新增子级」）
2. 类型选「菜单」，父级选对应目录
3. 组件路径填页面地址

   本手册每节开头的路径面包屑对应的就是这些页面，具体地址找技术确认。

4. 保存后到「角色管理」把这个菜单分配给相应角色

   只建菜单不分配，非 admin 角色还是看不到。

5. 重新登录后台

   菜单在登录时加载一次，刷新页面不一定立刻生效。

7.5 角色管理

系统›角色管理

角色 = 一组菜单权限。字段是角色名称、状态（正常/停用）、备注。

分配菜单

点「分配菜单」，在树里勾选这个角色能用的菜单和按钮，确定即保存。

admin 角色是内置超管，不能编辑、不能分配菜单、不能删除，按钮是灰的。

7.6 后台用户管理

系统›后台用户管理

后台管理员账号，和 C 端用户完全分开。

7.7 Google Analytics 配置

系统›Google Analytics 配置

7.8 账号信息

账号信息（一级菜单）

看自己的账号资料：用户名、姓名、手机号、邮箱、角色、备注。这一页所有人都能进，不受菜单权限限制。

• 编辑信息：改姓名、手机号、邮箱、备注。用户名和角色改不了。
• 修改密码：需要填当前密码。新密码要求至少 6 位、必须同时包含字母和数字，两次输入一致。

A速查与排错

A.1 状态与枚举速查

视频

广告

工单

其它

A.2 常见问题排查

A.3 字幕语言代码

上传字幕时文件名末尾要带语言代码，格式 …_字幕.语言代码.vtt，例如 小镇爱无限_2021_字幕.zh_CN.vtt。目前只支持 VTT 格式。