第 3 章 · 01 自托管总览

第 3 章 · 01 自托管总览

本节摘要:本节是自托管部署的总入口。OpenSEO 免费且开源,自托管意味着应用本身成本为 0,你自带 DataForSEO API key,只为实际 API 用量向 DataForSEO 付费。有两条自托管路径:简单的 Docker(适合个人在本机用,上手最容易)与进阶的 Cloudflare(适合联网、跨设备或团队用,类 SaaS 体验,带自动数据库备份,且能跑在 Cloudflare 免费计划上)。本节先把两条路的取舍讲清,再讲 DataForSEO API key 的获取与配置,以及可选的 Google Search Console 与 AI 功能(SAM)。读完本节,你能判断该走哪条路,并准备好数据源凭证。

内容来源:原项目英文文档 web/content/docs/self-hosting/index.md,汉化并套用体系化模板。

学习目标

阅读完本节,你应当能够:

1. 说清 自托管 的成本结构(应用 0 元,只为数据付费)。
2. 对比 Docker vs Cloudflare 两条路径,选出适合自己的。
3. 获取并配置 DataForSEO API key。
4. 决定是否启用 可选功能(Google Search Console、AI/SAM)。
5. 知道新账号的 免费额度与最低充值。

一、自托管的成本逻辑

OpenSEO 免费且开源。自托管 = 应用本身成本 $0。你需要做的,只是自带一个 DataForSEO API key,直接为 API 用量向 DataForSEO 付费。

💡 关键概念:OpenSEO 自己不卖数据,数据来自第三方 DataForSEO。托管版会在 DataForSEO 请求上加收约 28% 费用;自托管省下的就是这笔加价,所以自托管成本通常略低于托管版。新 DataForSEO 账号含 $1 免费额度供测试,最低充值 $50。

二、两条自托管路径

1. 简单:Docker(推荐个人入门)

适合在你自己机器上做个人使用,是上手最容易的方式。详细步骤见下一节「Docker 自托管」。

2. 进阶:Cloudflare(联网 / 团队)

适合需要联网、跨多设备或与团队协作的自托管。它给你类 SaaS 的体验,带自动数据库备份,且能跑在 Cloudflare 的免费计划上。如果你对 Cloudflare 不熟,设置会稍多一些。(Cloudflare 详细部署属 P1 批次,本教程后续补充。)

⚠️ 注意:Docker 模式默认关闭应用鉴权(AUTH_MODE=local_noauth),只能在你自己的、受保护的网络或反代后使用,不要直接暴露到公网。需要联网的自托管,请走 Cloudflare 路径。

三、DataForSEO API key 的获取与配置

OpenSEO 用 DataForSEO 抓取 SEO 数据。DataForSEO 是付费第三方服务,与 OpenSEO 无关,你需要一个 API key 才能把 OpenSEO 连上去。

获取步骤:

1. 前往 DataForSEO 的 API Access 页面(app.dataforseo.com/api-access)。
2. 点击「Send by email」获取凭证。
3. 复制其中较长、标注为「Base64」的凭证。
4. 把它设为环境变量 DATAFORSEO_API_KEY,按部署方式不同:
   • Docker:写入 .env
   • Cloudflare:在仪表盘里作为 Worker secret 设置
   • 本地开发:写入 .env.local

💡 技巧:DATAFORSEO_API_KEY 的值是「你的 DataForSEO 邮箱与 API 密码」按 email:password 格式做 Base64 编码后的字符串。Docker 部署里,可用 docker compose config 确认这个值是否正确传入容器。

四、可选功能

1. Google Search Console

Search Console 是可选的,在自托管部署里用你自己的 Google OAuth 客户端即可工作。一次性设置约 10 分钟,详见 GitHub 上的自托管 Search Console 指南(SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md)。

2. AI 功能(SAM)

应用内的 SEO agent「SAM」等 AI 功能是可选的。设置环境变量 OPENROUTER_API_KEY 即可启用,在 openrouter.ai/settings/keys 创建 key。

⚠️ 注意:这两项都是「可选」,不影响 OpenSEO 核心的关键词、排名、竞品、反链功能。你需要 GSC 数据或应用内 AI agent 时再开。

五、选哪条路:决策建议

你要联网 / 团队用吗?
├─ 是 ─► Cloudflare(联网安全,类 SaaS,自动备份)
└─ 否 ─► 只在自己机器上用吗?
         ├─ 是 ─► Docker(最简单,本机跑)
         └─ 想要在多设备访问但不联网 ─► Docker + 自己的反代/隧道(需自行加鉴权)
​

本节要点回顾

1. 成本:应用 $0(开源),数据按量付给 DataForSEO;自托管省下托管版约 28% 加价。
2. 两条路:Docker(简单、本机、个人)与 Cloudflare(进阶、联网、团队、类 SaaS)。
3. API key:DATAFORSEO_API_KEY 是 Base64 编码的 email:password,Docker 写 .env、Cloudflare 设 Worker secret。
4. 额度:新 DataForSEO 账号 $1 免费测试额度,最低充值 $50。
5. 可选功能:Google Search Console(自带 OAuth,约 10 分钟)、AI/SAM(设 OPENROUTER_API_KEY)。
6. 安全:Docker 默认 local_noauth,绝不可直接暴露公网,联网请走 Cloudflare。
7. 决策:联网/团队 → Cloudflare;纯本机个人 → Docker。

决定走 Docker 路径的话,下一节我们一步步把 OpenSEO 在本地跑起来。