跳转到内容
FeedCraft

高级定制

对于高级用户，FeedCraft 提供了一个管理后台来定制 RSS 的处理流程。

访问后台

Section titled “访问后台”
  1. 使用 Docker 部署 FeedCraft（参考快速开始）。
  2. 浏览器访问 http://你的服务器IP:10088。
  3. 使用默认凭据登录：
    • 用户名：admin
    • 密码：adminadmin (请登录后立即修改密码)

搜索提供商配置 (Search Provider)

Section titled “搜索提供商配置 (Search Provider)”

要使用 搜索转 RSS (Search to RSS) 功能，你必须配置搜索提供商。

在管理后台导航至 设置 (Settings) > Search Provider。

支持的提供商

Section titled “支持的提供商”

  • LiteLLM / OpenAI Compatible

    • API URL: 搜索服务的 API 端点（例如 http://litellm-proxy:4000/v1/search）。
    • API Key: 你的 API 密钥。（留空以保留现有密钥）
    • Tool Name: 特定函数调用工具名称（如果需要，例如某些 Agent 的 google_search）。工具名称将追加到 API URL 之后（例如 .../v1/search/google_search）。

  • SearXNG

    • API URL: 你的 SearXNG 实例基础 URL（例如 http://my-searxng.com）。/search 路径会自动追加。
    • Engines: (可选) 逗号分隔的搜索引擎列表（例如 google,bing）。

依赖服务 (Dependency Services)

Section titled “依赖服务 (Dependency Services)”

依赖服务 仪表盘 (设置 (Settings) > 依赖服务状态 (Dependency Services)) 提供了所有连接的外部服务的健康检查概览。

它监控以下服务的状态：

  • SQLite: 数据库连接。
  • Redis: 缓存服务连接及延迟。
  • Browser Provider: 无头浏览器提供方可用性（浏览器全文提取功能必须）。
  • LLM Service: 与配置的 AI 提供商的连接。
  • Search Provider: 与配置的搜索引擎的连接。

如果“增强模式”或“全文提取”等功能出现故障，请使用此仪表盘排查连接问题。

你可以使用 检查连接 (Check Connection) 按钮来验证 FeedCraft 是否可以成功连接到配置的搜索提供商。

高级配置

Section titled “高级配置”

Docker 环境变量

Section titled “Docker 环境变量”

你可以在 docker-compose.yml 中使用环境变量配置 FeedCraft。

  • FC_BROWSER_PROVIDER: 浏览器渲染提供方。支持 browserless-restful（Browserless REST /content）和 cdp（Chrome DevTools Protocol，例如 CloakBrowser cloakserve）。
  • FC_BROWSER_ENDPOINT: 所选浏览器提供方的地址。fulltext-plus 和 HTML 转 RSS 增强模式必须。
  • FC_PUPPETEER_HTTP_ENDPOINT: 旧版 Browserless 地址别名。仅在 FC_BROWSER_ENDPOINT 为空时继续生效。
  • FC_BROWSER_TIMEOUT: （可选）单次浏览器渲染超时。支持 Go duration（60s）或毫秒（60000），默认 60s。建议不超过 browserless 的 CONNECTION_TIMEOUT。
  • FC_BROWSER_MAX_CONCURRENCY: （可选）全局浏览器渲染最大并发数（默认：2）。避免 fulltext-plus 一次打开过多 Chrome 会话。
  • FC_REDIS_URI: Redis 连接地址。用于缓存，加快处理速度并减少 AI Token 消耗。
  • FC_HTTP_USER_AGENT_FEED: （可选）feed 类外部请求的默认 User-Agent，例如抓取 RSS/XML 资源时使用。搜索提供方请求目前也临时归入这一规则。
  • FC_HTTP_USER_AGENT_HTML: （可选）HTML 页面抓取的默认 User-Agent，例如全文提取和 HTML 转 RSS 工具使用。注意： 如果该值包含空格或括号，必须使用引号括起来。
  • FC_LLM_API_KEY: OpenAI 或兼容服务（如 DeepSeek, Gemini 等）的 API Key。
  • FC_LLM_API_MODEL: 默认使用的模型（如 gemini-pro, gpt-3.5-turbo）。支持多个模型： 你可以提供一个逗号分隔的模型列表（例如 gpt-3.5-turbo,gpt-4）。FeedCraft 会为每个请求随机选择一个模型，如果调用失败，会自动重试列表中的其他模型。
  • FC_LLM_API_BASE: API 接口地址。如果是兼容 OpenAI 的 API，通常以 /v1 结尾。
  • FC_LLM_API_TYPE: (可选) openai (默认) 或 ollama.
  • FC_LLM_MAX_CONCURRENCY: （可选）整个 FeedCraft 进程同时执行的 LLM API 请求上限（默认：3）。所有 feed、Recipe、AtomCraft 及其他 LLM 功能共享这一全局限制。文章任务可以并发进入队列，但实际同时执行的上游请求不会超过该值；缓存命中不占用并发额度。
  • FC_DOMAIN_MAX_CONCURRENCY: (可选) 网页抓取（如全文提取）时每个目标域名的最大并发数（默认: 3）。防止抓取目标服务器负载过高。
  • FC_PREHEATING_MAX_CONCURRENCY: （可选）后台预热任务的最大并发数（默认：2）。
  • FC_PREHEATING_QUEUE_SIZE: （可选）预热等待队列的最大任务数；默认与预热并发数相同。
  • FC_PREHEATING_TASK_TIMEOUT: （可选）单个预热任务的超时时间，使用 5m 等 Go duration 格式（默认：10m）。
  • LOG_LEVEL: (可选) 后端应用的日志级别 (例如 info, debug, trace)。覆盖 ENV 设置的默认级别。

外部服务

Section titled “外部服务”

为了发挥 FeedCraft 的全部功能，建议搭配 Redis 和浏览器渲染提供方部署。

version: "3"
services:
  app.feed-craft:
    # ... (参考快速开始)
    environment:
      FC_BROWSER_PROVIDER: browserless-restful
      FC_BROWSER_ENDPOINT: http://service.browserless:3000
      FC_REDIS_URI: redis://service.redis:6379/
      # ...


  service.redis:
    image: redis:6-alpine
    container_name: feedcraft_redis
    restart: always


  service.browserless:
    image: browserless/chrome
    container_name: feedcraft_browserless
    environment:
      USE_CHROME_STABLE: true
    restart: unless-stopped

如果要使用 CloakBrowser 替代 Browserless，可以直接连接官方 cloakserve 容器：

services:
  app.feed-craft:
    environment:
      FC_BROWSER_PROVIDER: cdp
      FC_BROWSER_ENDPOINT: http://service.cloakbrowser:9222?fingerprint=feedcraft


  service.cloakbrowser:
    image: cloakhq/cloakbrowser
    command: cloakserve --port=9222
    restart: unless-stopped

服务默认监听在 80 端口，你也可以在同一网络下的其他容器中，使用 http://app.feed-craft/xxx 这样来进行访问(比如 RSS 阅读器中通过这种方式来走内网通信订阅)。

FeedCraft v3.2.0