进阶 docs.invidious.io 2026-10-13 23:01:14 · 33 阅读

第10章 Invidious 第 10 章:安装指南与硬件要求

第10章:安装

安装完成后,请查看安装后配置步骤。 注意:任何 PaaS 或 SaaS 提供商/软件(如 Heroku、YunoHost、Repli 等)均不受支持。若强行使用,风险自负。由于 Invidious 资源占用高、带宽需求大,且在技术上属于代理,这些服务很容易导致问题,甚至可能因“滥用”而封禁你的账号(大多数提供商不喜欢代理服务)。如果你正在使用此类服务并希望报告问题,请注明你使用的是哪家。

硬件要求

运行 Invidious 和 Invidious companion 至少需要 20GB 磁盘空间和 2GB 空闲内存,前提是遵循安装后配置建议定期重启。公共实例理想配置为:至少 60GB 磁盘空间、4GB 内存、2 核 vCPU、200 Mbps 网络链接以及 20TB 流量配额(无流量限制或无限流量更佳)。 编译 Invidious 至少需要 2.5GB 空闲内存(建议安装至少 4GB)。 如果内存不足(例如在廉价 VPS 上),可以设置 SWAP 文件或分区,确保内存加 SWAP 总量大于等于 4GB。

需要迁移(新功能):Invidious companion

Invidious companion 取代了 inv-sig-helper 和 youtube-trusted-session-generator。你不再需要运行 youtube-trusted-session-generator。

Docker

Invidious 的 Docker 镜像仅在 Quay 上提供,因为与 Docker Hub 不同,Quay 是免费且开源的软件。本教程中使用的 docker-compose.yml 文件体现了这一点。 开始前请确保已安装 Docker Engine 和 Docker Compose。

Docker-compose 方法(生产环境)

此方法使用来自 quay 的预构建 Docker 镜像。 注意:目前必须克隆仓库,这是因为需要将 init-invidious-db.sh 文件和 config/sql 目录挂载到 postgres 容器(见下方 docker-compose 文件中的 volumes 部分)。此“问题”未来将得到解决。 确保运行较新的 Docker Compose V2:https://docs.docker.com/compose/install/linux/。如果你能成功运行 docker compose 命令(两个单词之间有空格),说明它已经安装好了。 执行以下命令: git clone https://github.com/iv-org/invidious.git
cd invidious
生成两个密钥:一个用于 Invidious(HMAC_KEY),一个用于 Invidious companion(invidious_companion_key) pwgen 16 1 # Invidious 的第一步(HMAC_KEY)
pwgen 16 1 # Invidious companion 的第二步(invidious_companion_key)
用以下内容编辑 docker-compose.yml: services:
invidious:
image: quay.io/invidious/invidious:latest
restart: unless-stopped
# 如果从外部 IP 访问,请删除 "127.0.0.1:"
ports:
- "127.0.0.1:3000:3000"
environment:
# 请阅读以下文件以获取所有可用配置选项及其语法列表:
# https://github.com/iv-org/invidious/blob/master/config/config.example.yml
INVIDIOUS_CONFIG: |
db:
dbname: invidious
user: kemal
password: kemal
host: invidious-db
port: 5432
check_tables: true
invidious_companion:
# 用于 invidious 和 invidious companion 内部通信的 URL
# 除非 Invidious companion 不在同一个 docker compose 文件中运行,否则无需更改
- private_url: "http://companion:8282/companion"
# 不建议使用与 HMAC KEY 相同的密钥。请生成一个新密钥!
# 使用第二步生成的密钥
invidious_companion_key: "CHANGE_ME!!"
# external_port:
# domain:
# https_only: false
# statistics_enabled: false
# 使用第一步生成的密钥
hmac_key: "CHANGE_ME!!"
healthcheck:
test: wget -nv --tries=1 --spider http://127.0.0.1:3000/api/v1/stats || exit 1
interval: 30s
timeout: 5s
retries: 2
logging:
options:
max-size: "1G"
max-file: "4"
depends_on:
- invidious-db

companion:
image: quay.io/invidious/invidious-companion:latest
# 请阅读以下文件以获取所有可用环境变量及其语法列表:
# https://github.com/iv-org/invidious/blob/master/config/config.example.yml
environment:
# 使用第二步生成的密钥
- SERVER_SECRET_KEY=CHANGE_ME!!SAME_AS_INVIDIOUS_COMPANION_SECRET_KEY_FROM_INVIDIOUS_CONFIG
restart: unless-stopped
# 仅当为 Invidious companion 配置了 "public_url" 时才取消注释
# 或者如果你想在程序中通过 API 使用 Invidious companion。
# 如果从外部 IP 访问,请删除 "127.0.0.1:"
#ports:
# - "127.0.0.1:8282:8282"
logging:
options:
max-size: "1G"
max-file: "4"
cap_drop:
- ALL
read_only: true
# youtube 库缓存
volumes:
- companioncache:/var/tmp/youtubei.js:rw
security_opt:
- no-new-privileges:true

invidious-db:
image: docker.io/library/postgres:14
restart: unless-stopped
volumes:
- postgresdata:/var/lib/postgresql/data
- ./config/sql:/config/sql
- ./docker/init-invidious-db.sh:/docker-entrypoint-initdb.d/init-invidious-db.sh
environment:
POSTGRES_DB: invidious
POSTGRES_USER: kemal
POSTGRES_PASSWORD: kemal
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]

volumes:
postgresdata:
companioncache:
注意:此 compose 文件专为真正的“生产”环境设计,即 Invidious 位于反向代理之后。如果你更喜欢直接访问 Invidious,请将 ports: 部分下的 127.0.0.1:3000:3000 替换为 3000:3000。 运行 docker 组合: docker compose up -d

Docker-compose 方法(开发环境)

此方法从源代码构建 Docker 镜像。 如果没有配置 Invidious companion,播放功能将无法正常工作。 git clone https://github.com/iv-org/invidious.git
cd invidious
docker-compose up

手动安装

Linux

安装 Crystal

请按照此处针对你的发行版的说明操作:https://crystal-lang.org/install/ 注意:Invidious 目前支持以下 Crystal 版本:1.14.x / 1.15.x / 1.16.x / 1.17.x / 1.18.x / 1.19.x。

安装依赖

Arch Linux sudo pacman -S base-devel librsvg postgresql ttf-opensans Debian/Ubuntu sudo apt install libssl-dev libxml2-dev libyaml-dev libgmp-dev libreadline-dev postgresql librsvg2-bin libsqlite3-dev zlib1g-dev libpcre3-dev libevent-dev fonts-open-sans 基于 RHEL 及类似 RHEL 的系统(RHEL, Fedora, AlmaLinux, RockyLinux...) sudo dnf install -y openssl-devel libevent-devel libxml2-devel libyaml-devel gmp-devel readline-devel postgresql-devel librsvg2-devel sqlite-devel zlib-devel gcc open-sans-fonts

添加 Invidious 用户并克隆仓库

sudo useradd -m invidious
sudo su - invidious
git clone https://github.com/iv-org/invidious
exit

设置 PostgreSQL

systemctl enable --now postgresql
sudo -i -u postgres
psql -c "CREATE USER kemal WITH PASSWORD 'kemal';" # 在此将 'kemal' 更改为更强的密码,并更新 config/config.yml 中的 `password`
createdb -O kemal invidious
exit

设置 Invidious

sudo su - invidious
cd invidious
make

# 按喜好配置 config/config.yml
cp config/config.example.yml config/config.yml

# 编辑 config.yaml 以包含 invidious companion

编辑 config/config.yaml

添加:
invidious_companion:
# 用于 invidious 和 invidious companion 内部通信的 URL
- private_url: "http://localhost:8282/companion"
# 不建议使用与 HMAC KEY 相同的密钥。请生成一个新密钥!
invidious_companion_key: "CHANGE_ME!!"

# 部署数据库
./invidious --migrate

exit

用于 Invidious 的 Systemd 服务

cp /home/invidious/invidious/invidious.service /etc/systemd/system/invidious.service
systemctl enable --now invidious.service

设置 Invidious companion

# 从二进制发布版 wget
# https://github.com/iv-org/invidious-companion/releases/tag/release-master

wget https://github.com/iv-org/invidious-companion/releases/download/release-master/invidious_companion-x86_64-unknown-linux-gnu.tar.gz

# 或使用 https://docs.deno.com/runtime/ 编译
git clone https://github.com/iv-org/invidious-companion.git
deno task compile

# 手动启动
SERVER_SECRET_KEY=CHANGE_ME!!SAME_AS_INVIDIOUS_COMPANION_SECRET_KEY_FROM_INVIDIOUS_CONFIG ./invidious_companion
查看关于环境变量的更多文档:https://github.com/iv-org/invidious-companion/wiki/Environment-variables sudo wget https://github.com/iv-org/invidious-companion/raw/refs/heads/master/invidious-companion.service -O /etc/systemd/system/invidious-companion.service
sudo systemctl enable --now invidious-companion.service

MacOS

我们建议安装 Docker Desktop,然后按照我们的 Docker 指南进行操作,这将使安装更容易。 但如果你经验更丰富,可以遵循社区关于 MacOS 的安装指南。

Windows

Invidious 使用的编程语言 Crystal 目前官方尚不支持 Windows,但你仍然可以安装 Invidious: * 通过安装 Docker Desktop,然后遵循我们的 Docker 指南。 * 通过安装 Windows Subsystem for Linux (WSL),然后遵循我们的 Linux 指南。 * 通过安装 Windows 专用版的 Crystal。请注意,目前我们尚无 Invidious 在这些“不支持”的构建版本上经过测试的记录。 未经 Invidious 开发者官方支持! 你的平台未在列表中吗(Podman, BSD, LXC 等)? 请查看社区安装指南:此处

安装后配置

强烈建议

详细的配置说明请参阅配置指南。 * 你必须为参数 hmac_key 设置一个随机生成的值!在 Linux 上,你可以使用命令 pwgen 20 1 来生成。 * 由于各种问题,Invidious 必须经常重启,至少每天一次,理想情况下每小时一次。 * 如果你使用反向代理,必须配置 Invidious 以通过它正确提供服务: * https_only: true:如果你通过 https 提供服务,将其设置为 true。 * domain: domain.ext:如果你通过域名提供服务,在此处设置。 * external_port: 443:如果你通过 https 提供服务,将其设置为 443。 * use_pubsub_feeds: true:如果你的实例在互联网上,允许更快地获取新视频通知(详细说明)。 * use_innertube_for_captions: true:如果你提供公共实例或在数据中心托管 Invidious,允许解锁字幕(详细说明)。

高级(提升性能)

出于性能考虑,你可以配置 Invidious companion 直接在你的反向代理下提供视频流服务。 当多个用户使用时,这将大大改善播放体验。 取消注释 Invidious config.yaml 中 invidious_companion: 参数的 public_url,并如下配置: 配置 public_url 与 Invidious 使用的域名相同,或者在一个单独的域名上(如果你愿意)并使用路径 /companion。 示例:https://MYINVIDIOUSDOMAIN/companion 或 https://COMPANION.MYINVIDIOUSDOMAIN/companion。 然后配置你的反向代理: * NGINX * Apache2 * Caddy * Traefik

更新 Invidious

更新 Docker 安装

docker-compose pull
docker-compose up -d
docker image prune -f

更新手动安装

sudo su - invidious
cd invidious
git pull
make
exit
systemctl restart invidious.service

使用

./invidious

Logrotate 配置

echo "/home/invidious/invidious/invidious.log {
rotate 4
weekly
notifempty
missingok
compress
minsize 1048576
}" | tee /etc/logrotate.d/invidious.logrotate
chmod 0644 /etc/logrotate.d/invidious.logrotate

评论 (0)