Web 应用 SEO

SEO 配置用于帮助搜索引擎理解 Web 应用的页面内容和网站结构。配置本身不保证收录或排名；页面能否被抓取，还取决于渲染模式、公开访问状态、内容质量和搜索引擎规则。

开始前

确认 Web 应用已经可以正常发布，并准备：

需要被搜索引擎访问的公开页面
每个页面的标题、描述和社交媒体展示内容
SSG 动态页面可能使用的路径参数范围
搜索平台或数据分析平台提供的验证信息

配置全局 SEO

进入设置 → SEO。渲染模式、网站地图、robots.txt、自定义 Header 和 Body 都是当前 Web 应用的全局配置。

修改 SEO 配置后，需要重新发布应用，更新才会在线上生效。

渲染模式

在 Zion 中选择页面渲染模式

CSR：页面由浏览器渲染，适合不依赖搜索引擎收录的应用。
SSG：发布时生成静态 HTML，适合内容相对稳定的公开页面。SSG 需要高级版及以上版本。
SSR：请求页面时由服务端生成 HTML。SSR 需要购买单租户服务器。

三种模式的完整差异和数据更新方式参阅页面渲染模式。

SSG 动态页面

只有选择 SSG 时才需要配置动态页面的路径参数范围。

如果页面路径包含参数，例如 /article/:slug，指定可能使用的参数值，使系统可以在发布时生成对应的 URL 和静态页面：

选择页面使用的路径参数。
选择提供参数值的数据表和字段。
添加筛选条件，只包含需要公开的记录。
检查生成的 URL 是否与页面路径一致。

⚠️

新增或修改需要生成的动态页面后，应重新发布应用，使新的静态页面和网站地图生效。

robots.txt

使用 robots.txt 指定允许或禁止抓取的路径。不要屏蔽需要被搜索引擎收录的页面和资源。


User-agent: *
Disallow: /admin/

自定义 Header 和 Body

自定义 Header 和 Body 包含两个独立的全局字段，保存后会应用到当前 Web 应用的所有页面：

字段	说明
Header 中的脚本/标签	添加需要放在页面 Header 中的脚本或标签，例如网站验证标签和需要提前加载的全局脚本
Body 中的脚本/标签	添加需要放在页面 Body 中的脚本或标签

添加第三方代码前，应确认代码来源及其需要加载的位置。修改后需要重新发布应用。

配置页面 SEO

页面 SEO 配置仅在 SSR 和 SSG 模式下可用。

选择页面后，在页面属性中配置以下内容。

SEO TDK

字段	说明
标题	页面 `<title>`，用于浏览器标题，并向搜索引擎提供首选的结果标题
描述	页面内容摘要，对应 meta description
关键词	多个关键词使用英文逗号分隔

社交媒体展示内容

字段	说明
标题	页面分享时显示的标题；可选择与 TDK 标题一致
描述	页面分享时显示的描述；可选择与 TDK 描述一致
缩略图	页面分享时显示的图片，仅支持动态绑定

Canonical URL

为重复或高度相似的页面指定规范 URL，使搜索引擎知道应优先识别哪个页面地址。

H 标签

添加页面中的 H1、H2、H3 等标题标签。每一项包含：

字段	说明
类型	标题标签的层级，例如 H1、H2 或 H3
内容	该标题标签对应的文本内容

使用 H1 表示页面主标题，再按内容层级使用 H2、H3，避免标题跨级。

设置图片 Alt 文本

为传达内容的图片提供准确的 Alt 文本，帮助搜索引擎和辅助技术理解图片。装饰性图片不需要重复附近已经出现的文字。

上传平台验证文件

搜索平台或数据分析平台可能要求在网站根目录放置指定的 .txt 文件，以验证网站所有权。

获取验证文件

从需要接入的平台下载验证文件，不要修改文件名或内容。

上传到网站根目录

打开 Zion 的设置 → 全局 → 上传文件至根目录，上传验证文件。

重新发布应用

保存文件后重新发布 Web 应用，使文件部署到生产环境的网站根目录。

完成平台验证

返回第三方平台并执行验证。验证失败时，确认可以通过生产域名和文件名直接访问该文件。

验证文件需满足以下要求：

仅支持 .txt 文件
单个文件不超过 1 KB
每个项目最多同时上传 5 个验证文件
新项目至少成功发布一次后才能上传

发布并验证

完成 SEO 设置后：

重新发布 Web 应用。
打开生产地址，检查页面标题、描述和社交媒体展示内容。
检查 /sitemap.xml 和 /robots.txt 是否符合预期。
使用 SSG 时，抽查不同路径参数对应的动态页面。
在搜索平台或数据分析平台完成站点验证。

如果生产环境没有显示最新设置，先确认发布已经完成，再检查当前页面使用的渲染模式和 SEO 配置范围。