部署指南

June 6, 2026 · View on GitHub

这份文档面向想直接运行 FeedFuse 的用户，默认使用预构建镜像和 docker compose 完成部署。

如果你是要本地改代码或调试实现，请改看开发指南。

环境要求

已安装 Docker
已安装 Docker Compose

1. 准备安装目录并下载发布文件

mkdir -p feedfuse
cd feedfuse
curl -fsSL -o compose.yaml https://raw.githubusercontent.com/BryanHoo/FeedFuse/main/deploy/compose.yaml
curl -fsSL -o .env https://raw.githubusercontent.com/BryanHoo/FeedFuse/main/deploy/.env.example

2. 编辑 `.env`

至少需要修改这三个值：

IMAGE_PROXY_SECRET：改成你自己的随机密钥
AUTH_INITIAL_PASSWORD：改成初始用户首次登录密码
POSTGRES_PASSWORD：改成你自己的数据库密码

默认情况下，.env 已包含本地自托管所需的基础配置：

POSTGRES_DB
POSTGRES_USER
POSTGRES_PASSWORD
POSTGRES_PORT
WEB_PORT
IMAGE_PROXY_SECRET
AUTH_INITIAL_PASSWORD
AUTH_COOKIE_SECURE
RSS_NETWORK_MODE
RSS_ALLOWED_CIDRS

AUTH_COOKIE_SECURE=false 适合默认的 HTTP 端口访问，包含局域网 IP 访问。如果你在前面接了 HTTPS 反向代理，并且用户通过 https:// 访问 FeedFuse，建议改成 AUTH_COOKIE_SECURE=true。

RSS 网络访问默认使用 RSS_NETWORK_MODE=public，仅允许公网地址。常见模式：

public：默认，仅允许公网地址
fake-ip：额外允许 198.18.0.0/15
lan：额外允许常见 RFC1918 局域网地址
custom：只额外允许 RSS_ALLOWED_CIDRS 里的网段

只有在你明确需要兼容 fake-ip 或内网 RSS 时才调整这些值。例如：

RSS_NETWORK_MODE=fake-ip
RSS_NETWORK_MODE=custom
RSS_ALLOWED_CIDRS=192.168.0.0/16,10.0.0.0/8

3. 拉取镜像并启动服务

docker compose pull
docker compose up -d

启动后访问：

http://127.0.0.1:9559

docker compose 会同时启动：

db：PostgreSQL
web：FeedFuse Web 应用，启动前会自动执行数据库迁移
worker：后台任务进程，用于抓取全文、生成摘要、翻译和 AI解读

4. 首次使用

使用用户名 admin 和 .env 里的 AUTH_INITIAL_PASSWORD 登录
打开 设置中心 -> 账号与安全，修改当前账号用户名或密码
添加自己的 RSS 源，或通过 OPML 导入订阅
按需整理分类
如果需要 AI 能力，再到 设置中心 -> AI 补充配置
开始阅读，并按需要生成摘要、翻译或 AI解读

初始用户首次登录成功后，密码会写入数据库，后续继续使用应用内保存的账号密码登录。

5. 账号与权限

FeedFuse 支持单实例多用户使用。所有用户的 RSS 源、分类、文章状态、Fever 服务、AI 配置和阅读设置默认隔离。

初始用户是系统创建的第一个用户，首次用户名为 admin。这个账号可以改名，但仍保留初始用户权限。

角色说明：

管理员：可以新增用户，编辑、启用或禁用非初始用户
成员：只能管理自己的订阅、设置和账号资料
初始用户：拥有管理员能力，并且可以删除其他用户

删除用户会同步删除该用户拥有的订阅、分类、Fever 服务和任务数据，且无法恢复。

更完整的日常使用说明见使用指南。

6. 配置 AI

如果你只想先体验 RSS 阅读，这一步可以稍后再做。

启用 AI 后，FeedFuse 可以提供：

AI 摘要
标题翻译
正文翻译
沉浸式双语阅读
AI解读

配置路径：

打开设置中心，切到 AI
如果使用 OpenAI，填写：
- AI 模型：例如 gpt-4o-mini
- API 地址：https://api.openai.com/v1
- API 密钥：你的 OpenAI API key
如果使用兼容 OpenAI 的服务，填写服务商给你的：
- AI 模型
- API 地址（通常带 /v1）
- API 密钥
翻译默认选 复用主配置
只有翻译要单独走另一套服务时，才切到 单独配置，并填写：
- 翻译模型
- 翻译 API 地址（通常带 /v1）
- 翻译 API 密钥
等待右上角状态显示 已保存

7. 升级

直接重新拉取并启动即可：

docker compose pull
docker compose up -d

如果你想固定到某个版本方便回滚，可以把 compose.yaml 里的：

ghcr.io/bryanhoo/feedfuse-web:latest
ghcr.io/bryanhoo/feedfuse-worker:latest

改成具体版本号，例如 0.3.0。

从旧版本升级到多用户版本后，原有单用户数据会归属到初始用户。升级完成后先使用原 admin 登录，再到 设置中心 -> 账号与安全 检查账号资料。

补充说明

仓库根目录的 docker-compose.yml 主要用于从源码构建和调试，不是推荐的生产部署入口
如果你只是想“先跑起来”，优先使用这份文档里的发布文件方式

推荐方式