B站去水印APIDocker部署教程

一、为什么用 Docker 部署 B 站去水印 API

很多朋友想把自己收藏的 B 站视频保存到本地，但又不想留下平台水印。常见的做法是调用第三方接口或者自己写一个解析服务。为了让这套服务稳定、可移植、易迁移，我们推荐使用 Docker 来部署。

Docker 的好处在于：一次构建，到处运行。无论你用的是 Windows、macOS 还是 Linux，只要装了 Docker，环境基本一致，出问题的概率也大大降低。

二、部署前的准备工作

在开始之前，请确保你已经准备好以下环境：

• 一台可以联网的服务器或本地电脑，推荐 1 核 1G 以上配置
• 已安装 Docker 20.x 及以上版本
• 已安装 Docker Compose（可选，用于编排多容器）
• 一个顺手的 SSH 工具，例如 FinalShell、Xshell 或终端
• 基础的 Linux 命令行使用经验

提示：如果你是国内服务器，拉取镜像可能会比较慢，建议提前配置 Docker 镜像加速器，例如阿里云、腾讯云的镜像源。

三、获取项目源码

这里以 GitHub 上常见的开源项目为例。你也可以使用自己熟悉的解析逻辑，自己封装一个 API 服务。

1. 登录服务器，打开终端
2. 进入你想放置项目的目录，例如 /opt
3. 使用 git 命令拉取源码：git clone https://github.com/yourname/bilibili-no-watermark.git
4. 进入项目目录：cd bilibili-no-watermark

如果你不想用 git，也可以直接在本地下载压缩包，再通过 FTP 工具上传到服务器。

四、编写 Dockerfile

项目根目录下新建一个名为 Dockerfile 的文件，内容参考如下：

第一行指定基础镜像，这里以常见的轻量级 Python 镜像为例：

FROM python:3.10-slim

设置工作目录：

WORKDIR /app

复制依赖文件并安装：

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

复制项目代码并启动：

COPY . .
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

提示：上面的镜像源使用了清华源，国内服务器拉取依赖会快很多。如果你用的是 Node.js 或 Go，思路类似，只是基础镜像和启动命令不同。

五、构建并启动容器

Dockerfile 写好之后，就可以构建镜像了。在项目根目录下执行：

docker build -t bili-no-watermark:latest .

构建完成后，使用以下命令启动容器：

docker run -d --name bili-api -p 8000:8000 bili-no-watermark:latest

参数说明：

• -d：后台运行
• --name：给容器起个名字，方便管理
• -p 8000:8000：把宿主机的 8000 端口映射到容器内部

启动成功后，访问 http://你的服务器IP:8000/docs，如果能看到 API 文档页面，就说明服务跑起来了。

六、使用 Docker Compose 一键部署（可选）

如果你的项目需要同时启动多个服务，例如 API + Redis 缓存，可以编写 docker-compose.yml 文件：

示例内容：

version: '3'
services:
  api:
    build: .
    ports:
      - "8000:8000"
    restart: always
  redis:
    image: redis:7-alpine
    restart: always

保存后执行：

docker compose up -d

就能一次性把 API 和缓存服务都拉起来。

七、调用 API 解析视频

服务启动后，通常会提供一个解析接口，例如 /parse?url=视频链接。你可以直接用浏览器访问测试，也可以用 curl 命令：

curl "http://127.0.0.1:8000/parse?url=https://www.bilibili.com/video/BVxxxxxxxxxx"

返回的 JSON 里通常会包含无水印的视频地址、封面、标题等信息。把视频地址复制到下载工具里，就能保存到本地了。

八、常见问题与排查思路

1. 容器启动后立刻退出

查看日志：docker logs bili-api，大多数情况是依赖没装好或者端口被占用。

2. 接口返回 403 或解析失败

B 站的接口会校验 Cookie 和 Referer，可以在请求头里带上这些参数，或者在代码里模拟登录。

3. 拉取镜像太慢

配置 Docker 镜像加速器，例如在 /etc/docker/daemon.json 里添加：

{"registry-mirrors": ["https://mirror.ccs.tencentyun.com"]}

然后重启 Docker：systemctl restart docker

九、温馨提示与总结

通过 Docker 部署 B 站去水印 API，整个流程其实并不复杂：准备环境、拉取代码、写 Dockerfile、构建镜像、启动容器，最后调用接口即可。Docker 让环境问题变得可控，也让后续迁移和升级更加轻松。

再次提醒：解析出来的视频仅供个人学习、备份使用，请勿用于商业用途或二次分发，尊重原作者的劳动成果和平台的版权规则。本教程仅讨论技术实现，请合理合法地使用相关工具。