---
title: "实战笔记：本地部署 RSSHub 并获取 YouTube 订阅"
type: source
tags: [rsshub, youtube, docker, self-hosted]
date: 2026-04-23
---

## Source File
- [[raw/Home Office/实战笔记：本地部署 RSSHub 并获取 YouTube 订阅.md]]

## Summary（用中文描述）
- 核心主题：通过本地部署 RSSHub 解决 YouTube 频道订阅跟踪问题
- 问题域：国内网络无法直接访问 YouTube，以及 YouTube 官方缺乏订阅通知机制
- 方法/机制：在 Ubuntu Server 宿主机上使用 Docker Compose 部署 RSSHub，通过 YouTube Data API v3 稳定获取频道更新，配合本地 HTTP 代理实现容器内科学上网
- 结论/价值：提供了一套稳定、低成本（免费 API 额度）的 YouTube 订阅 RSS 化方案

## Key Claims（用中文描述）
- YouTube Data API v3 提供充足免费额度，足以支撑个人用户每月使用
- 配置 YOUTUBE_KEY 环境变量是解决 YouTube 抓取失败的核心手段
- 通过 HTTP_PROXY / HTTPS_PROXY 代理可解决容器内访问 YouTube 的网络问题
- 防火墙放通端口后，局域网内其他设备均可访问 RSSHub 服务
- 验证成功的标志：访问 RSSHub 频道 URL 返回 XML 列表且无 `fetch failed` 错误

## Key Quotes
> "这是解决 YouTube 订阅最稳定的方案，每月有足够的免费额度供个人使用。" — 方案定性

> "配置 YOUTUBE_KEY=AIzaSy... 后，通过 HTTP_PROXY=http://127.0.0.1:10808 实现容器内科学上网" — 核心配置逻辑

## Key Concepts
- [[RSSHub]]：开源 RSS 聚合器，支持为各种不支持 RSS 的网站生成 RSS 源
- [[YouTube Data API v3]]：Google 官方 API，通过申请 API Key 可稳定获取 YouTube 频道/视频数据
- [[Docker Compose]]：Docker 编排工具，用于定义和运行多容器 Docker 应用
- [[HTTP_PROXY]]：HTTP 代理环境变量，RSSHub 容器通过此变量将出站请求经代理发出

## Key Entities
- [[RSSHub]]：开源项目（diygod/rsshub），提供 YouTube RSS 路由
- [[Google Cloud Console]]：YouTube Data API Key 的申请入口

## Connections
- [[YouTube Content Pipeline]] ← uses ← [[RSSHub]]
- [[RSSHub]] ← requires ← [[YouTube Data API v3]]
- [[Docker Compose]] ← hosts ← [[RSSHub]]
- [[Home Office]] ← location ← 当前笔记归属 Home Office 分类

## Contradictions
- 与 [[how-to-get-the-rss-feed-for-any-youtube-channel]] 可能存在互补：
  - 冲突点：对方文章介绍的是无需 API Key 的第三方服务方案
  - 当前观点：自建 RSSHub + YouTube API Key = 稳定可控
  - 对方观点：第三方 RSS 生成服务 = 零配置但依赖外部服务稳定性