AcFun去水印APIDocker部署教程

一、为什么需要自部署 AcFun 去水印 API

AcFun（A站）作为国内老牌弹幕视频网站，拥有不少独家番剧和 UP 主原创内容。很多用户希望下载视频后用于二次创作、离线观看或素材整理，但官方视频往往带有平台水印，影响使用体验。市面上虽然有一些第三方解析接口，但稳定性参差不齐，且存在隐私泄露风险。通过 Docker 自部署一套 AcFun 去水印 API，可以将解析服务掌握在自己手中，既稳定又安全，还能根据需要灵活扩展。

二、准备工作与环境要求

2.1 硬件与系统要求

• 操作系统：推荐 Linux（Ubuntu 20.04+、Debian 11+、CentOS 8+），Windows/macOS 也可运行 Docker Desktop；
• 内存：至少 1GB 可用内存；
• 硬盘：预留 2GB 以上空间用于镜像和缓存；
• 网络：可正常访问 Docker Hub 以及 AcFun 域名。

2.2 软件依赖

• Docker Engine 20.10 及以上版本；
• Docker Compose（可选，用于简化编排）；
• curl 或 Postman，用于接口测试。

三、拉取并启动去水印 API 容器

3.1 拉取镜像

打开终端，执行以下命令从 Docker Hub 拉取社区维护的 AcFun 去水印 API 镜像（以 acfun-watermark-remover 为例，请根据实际镜像名称替换）：

docker pull yourname/acfun-watermark-remover:latest

如果拉取速度较慢，可配置国内镜像加速器，例如阿里云、腾讯云或中科大镜像源。

3.2 创建配置目录

为方便管理配置和日志，建议在主机创建独立目录：

mkdir -p /opt/acfun-api/config
mkdir -p /opt/acfun-api/logs

3.3 启动容器

使用 docker run 命令快速启动一个容器，并将端口映射到主机的 9000 端口：

docker run -d \
  --name acfun-api \
  -p 9000:9000 \
  -v /opt/acfun-api/config:/app/config \
  -v /opt/acfun-api/logs:/app/logs \
  --restart unless-stopped \
  yourname/acfun-watermark-remover:latest

3.4 使用 Docker Compose（推荐）

在 /opt/acfun-api 目录下新建 docker-compose.yml 文件，内容如下：

version: '3.8'
services:
  acfun-api:
    image: yourname/acfun-watermark-remover:latest
    container_name: acfun-api
    ports:
      - \"9000:9000\"
    volumes:
      - ./config:/app/config
      - ./logs:/app/logs
    restart: unless-stopped

保存后执行 docker compose up -d ���可一键启动。

四、接口测试与使用说明

4.1 健康检查

容器启动后，等待约 5–10 秒，可通过以下命令检查服务状态：

curl http://localhost:9000/health

如果返回 {"status":"ok"}，说明 API 已正常运行。

4.2 去水印解析接口

核心接口为 /parse，支持 GET 和 POST 两种方式。以 GET 为例：

curl \"http://localhost:9000/parse?url=https://www.acfun.cn/v/ac12345678\"

返回结果通常包含无水印视频直链、封面图、标题、时长等字段，示例：

{
  \"code\": 200,
  \"title\": \"示例视频标题\",
  \"video_url\": \"https://xxx.xxx.com/play.m3u8\",
  \"cover\": \"https://xxx.xxx.com/cover.jpg\",
  \"duration\": 596
}

4.3 常见参数说明

• url：必填，AcFun 视频完整链接；
• quality：可选，指定清晰度（如 1080p、720p）；
• format：可选，指定输出格式（mp4、m3u8 等）；
• callback：可选，JSONP 回调函数名。

五、反向代理与 HTTPS 配置

如果希望通过域名访��并启用 HTTPS，可使用 Nginx 或 Caddy 进行反向代理。下面以 Nginx 为例，给出一个最小可用配置：

server {
  listen 80;
  server_name api.yourdomain.com;

  location / {
    proxy_pass http://127.0.0.1:9000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

配置完成后执行 nginx -s reload，再通过 certbot --nginx -d api.yourdomain.com 申请 Let's Encrypt 免费证书即可启用 HTTPS。

六、常见问题与排查思路

6.1 容器启动后立即退出

• 查看日志：docker logs acfun-api；
• 确认端口未被占用：netstat -tlnp | grep 9000；
• 检查目录挂载权限，必要时在主机侧执行 chmod -R 777 /opt/acfun-api。

6.2 接口返回 403 或解析失败

• 确认网络可访问 AcFun 域名；
• 更新镜像版本：docker pull yourname/acfun-watermark-remover:latest；
• 部分视频存在版权保护，接口可能无法解析，属于正常现象。

6.3 ��取镜像超时

配置国内镜像加速器，例如编辑 /etc/docker/daemon.json：

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

保存后重启 Docker：systemctl restart docker。

七、安全与合规提醒

自部署 API 仅供个人学习和技术研究使用，请勿用于商业牟利或大规模爬取。下载的视频版权归原作者及平台所有，二次传播前请务必获得授权，尊重 UP 主的劳动成果。

八、温馨提示

通过 Docker 部署 AcFun 去水印 API，整体流程并不复杂：准备好环境、拉取镜像、启动容器、测试接口、配置反向代理，即可拥有属于自己的解析服务。建议初次部署时先在本地或测试服务器上跑通流程，再迁移到生产环境；同时记得定期备份配置目录，及时更新镜像版本，以获得更好的稳定性和安全性。祝部署顺利，玩得开心！