域名

域名是用于标识在线位置（如网站）的文本型地址。相较于数字 IP 地址，域名更易记忆和识别。

Odoo Online 和 Odoo.sh 数据库默认使用 odoo.com 子域名（例如，[mycompany.odoo.com]）。

但也可以通过以下方式使用自定义域名：

  • 注册免费域名（仅限 Odoo Online 数据库）<domain-name/register>
  • 配置已有域名（适用于已拥有的域名）<domain-name/existing>

::: seealso

要为 Odoo Online 数据库注册一年免费域名：

  1. 登录账号，前往 数据库管理器。
  2. 在数据库名称旁点击 fa-gear（齿轮）按钮，选择 fa-globe 域名。

  1. 搜索想要的域名并检查可用性。

:::: tip ::: title 提示 :::

如果没有出现域名注册选项，请确保已安装 Website 应用。 ::::

  1. 选定域名，填写 域名所有者 表单，点击 注册。域名将直接关联到数据库。

  1. 接下来，需要 将域名映射到 Odoo 网站 <domain-name/website-map>。

:::: important ::: title 重要 :::

系统会向 Domain Owner 表单中填写的邮箱发送来自 noreply@domainnameverification.net 的验证邮件。务必验证邮箱，以保持域名有效并在到期前收到续费报价。 ::::

  • 免费域名仅在首年免费。之后 Odoo 与域名注册商 Gandi.net 合作管理域名，并收取 Gandi.net 的续费费用。
  • Odoo 会在域名到期前数周向 Domain Owner 表单中填写的邮箱发送续费报价。确认报价后，域名将自动续费。

:::: note ::: title 备注 :::

  • 仅适用于 Odoo Online 数据库。
  • 每位客户限 一个 域名。
  • 仅限 新 域名的注册。
  • 适用于 One App Free 计划。请确保网站内容足够原创，以便 Odoo 验证请求合法并符合 Odoo 可接受使用政策。由于请求量大，审核可能需要数天时间。
    ::::

管理免费域名的 DNS（域名系统） 记录，步骤如下：

  1. 打开 数据库管理器，点击数据库名称旁的 fa-gear（齿轮）按钮，选择 fa-globe 域名，然后点击 DNS。
  • A：保存域名的 IP 地址。系统自动创建，不可编辑或删除。
  • CNAME：将一个域名或子域名指向另一个域名。系统自动创建，用于将 www. 子域映射到数据库。若更改数据库名称，需同步修改 CNAME。
  • MX：指示邮件服务器投递邮件的目标。
  • TXT：可用于多种用途（例如验证域名所有权）。

DNS 记录的修改可能在全球范围内 最长 72 小时 生效。

:::: note ::: title 备注 :::

如需帮助管理域名，请 联系 Odoo 支持。 ::::

免费域名一年优惠 不包含邮箱。可通过以下两种方式将域名与邮箱关联：

  1. 创建子域（如 subdomain.yourdomain.com）作为数据库的别名域。这样用户即可通过 email@subdomain.yourdomain.com 收到并在数据库中创建记录。

  2. 在 数据库管理器 → 域名 → DNS → 添加 DNS 记录，选择 CNAME，填写：

    • 名称：子域（如 subdomain）
    • 内容：原数据库域名并在末尾加点（如 mycompany.odoo.com.）
    • 点击 添加记录。

  3. 在 域名 页面点击 使用我的自有域名，输入别名域名，点击 验证，然后 确认。

  4. 在数据库的 设置 中的 别名域 字段填写别名域名，点击 创建 并 保存。

配置 MX 记录 即可使用外部邮件服务。步骤同上，选择 MX，填写相应的 名称、内容 与 优先级，具体值请参考所使用的邮件服务商文档。

::: seealso

Google Workspace
  1. 注册 Google Workspace。在设置过程中选择 使用已有域名，输入你的域名（如 yourdomain.com）。
域名所有权验证
  1. 登录 Google Workspace，点击 切换到手动验证。
  2. 选择 gandi.net 作为 域名主机，点击 继续。
  3. 复制 TXT 记录 中的 值。
  4. 在 Odoo 的 数据库管理器 → 域名 → DNS → 添加 DNS 记录，选择 TXT，填写：
    • 名称：@
    • 内容：复制的值
    • 点击 添加记录。
  5. 返回 Google Workspace，勾选底部的复选框并点击 确认。

::: seealso Google Workspace 管理帮助：通过 TXT 记录验证域名 :::

将邮件重定向至 Gmail
  1. 在 Odoo 中添加 MX 记录：
    • 名称：@
    • 优先级：1
    • 内容：smtp.google.com.
  2. 在 Google Workspace 管理控制台激活 Gmail 并完成后续步骤。

::: seealso Google Workspace 管理帮助：设置 MX 记录 :::

如果已经拥有域名，可按照以下步骤将其用于 Odoo 网站。

:::: warning ::: title 警告 :::

为避免 SSL 证书验证 问题，请严格按以下顺序操作：

  1. 在迁移域名前先设置 URL 重定向，保持 SEO。
  2. 添加 CNAME 记录。
  3. 裸域名重定向（可选但推荐）。
  4. 将域名映射到 Odoo 数据库。
  5. 将域名映射到 Odoo 网站。
    ::::

将域名指向 Odoo 数据库地址需要添加 CNAME 记录。

CNAME 目标地址应为数据库创建时的地址，例如 mycompany.odoo.com。

CNAME 目标地址为项目主地址或特定分支地址，可在 Odoo.sh 的 设置 → 项目名称 或 分支 → 设置 → 自定义域名 中查看。

具体操作视 DNS 服务商而定。

::: seealso

注意：此步骤可选，但建议完成。

将裸域名（如 yourdomain.com）永久重定向（301）至 www.yourdomain.com：

  • http://yourdomain.com → https://www.yourdomain.com
  • https://yourdomain.com → https://www.yourdomain.com

若 DNS 服务商不支持 HTTPS 裸域重定向，推荐使用 Cloudflare。

  1. 注册并登录 Cloudflare。

  2. 添加域名并进行 快速 DNS 扫描。

  3. 选用免费套餐。

  4. 按指引完成激活。

  5. 添加两条 CNAME 记录：

    • 记录 1（裸域 → www）

      • 类型：CNAME
      • 名称：@（或 yourdomain.com）
      • 目标：www.yourdomain.com
      • 代理状态：Proxied

    • 记录 2（www → Odoo 数据库）

      • 类型：CNAME
      • 名称：www.yourdomain.com
      • 目标：mycompany.odoo.com
      • 代理状态：DNS only

  6. 在 Rules → Create Rule → Products 中创建 301 重定向规则，将裸域指向 https://www.yourdomain.com。

  7. 在 SSL/TLS 中将加密模式设为 Full。

:::: warning ::: title 警告 :::

映射前必须已 添加 CNAME 记录。否则会导致 SSL 证书验证 失败，出现 证书名称不匹配 警告。若映射后仍出现错误，请等待最多 5 天，或提交支持工单并附上 CNAME 截图。

::::

在 数据库管理器 → 域名 中点击 使用我的自有域名，输入域名（如 www.yourdomain.com），点击 验证 并 确认。

在 Odoo.sh 的 分支 → 设置 → 自定义域名 中输入域名并 添加。

::: seealso Odoo.sh 分支：设置标签 <odoo-sh/branches/tabs/settings> :::

SSL 加密让访客通过安全的 https:// 协议访问网站。Odoo 为每个映射到数据库的域名自动生成 Let’s Encrypt 证书。

注意：裸域名（无子域）不会生成 SSL 证书。

  • 证书生成可能需要 24 小时。
  • 验证过程会在映射后 5 天 内多次尝试。
  • 如使用其他证书服务，可自行保留或切换至 Odoo。

注意：若已安装 Website 应用，可跳过本节，直接进行 域名映射到网站。

Web 基础 URL 决定数据库的主站地址以及发送给客户的所有链接（报价、门户等）。

  • 若使用自定义域名登录数据库，系统会自动将 Web 基础 URL 更新为该域名。
  • 若不希望自动更新，可在 开发者模式 → 设置 → 技术 → 系统参数 中添加参数 web.base.url.freeze = True。
  • 也可手动设置 web.base.url 参数为完整的 https://www.yourdomain.com（不带末尾斜杠）。

映射网站域名的作用：

  • 将域名设为网站的主要访问地址，帮助搜索引擎正确索引。
  • 同时将域名设为数据库的基础 URL，影响邮件中的门户链接。
  • 多站点情况下，可为特定站点指定域名。

操作路径：Website → Configuration → Settings，在 Domain 字段填写完整网址（如 https://www.yourdomain.com），点击 保存。

警告：映射后原始数据库地址（如 mycompany.odoo.com）将不再被 Google 索引。若两者已被索引，需使用 Google Search Console 进行处理。

备注：多公司多站点时，请在 Website → Configuration → Settings 中选择对应的 Company，确保 Odoo 使用正确的 base URL。