OEM / WEBSITE
选择每个节点的官网
标准 OEM 官网和自有官网都可以使用。每个节点独立选择,同一家公司的多个节点也可以填写同一个自有官网。
在后台怎样选择
- OEM:进入「节点系统配置」,选择自己的节点,在「节点官网」选择官网方式。
- 超管:进入「节点实例 → 详情 → 节点官网」,可查看并调整该节点的选择。
- 保存后等待节点心跳同步。页面显示的是已保存配置;只有节点实际应用并完成浏览器验收后,才算切换完成。发生配置冲突时,点击「重新读取」后再保存。
方式一:标准 OEM 官网
- 使用包含官网选择能力的标准节点版本,完成节点部署、域名 HTTPS 和首次配置登记。
- 选择「标准 OEM 官网(随节点提供)」并保存。
- 在「品牌与官网」填写名称、Logo、介绍和联系方式;需要收录时,再配置 SEO。
- 打开节点域名根地址,确认展示自己的品牌。无需额外安装官网容器或数据库。
方式二:自有官网
- 准备独立的官网域名,例如
www.example.com;节点继续使用node.example.com。 - 将官网解析到自己的网站托管服务,部署自己的网页产物并配置有效 HTTPS 证书。已有公司官网可以直接使用。
- 确认官网可访问,再在后台选择「自有官网(单独部署)」并填写最终 HTTPS 地址。地址不能含账号密码、查询参数或片段,也不能使用节点自身域名。
- 在自有官网添加「登录节点」和「进入节点」链接,使用后台显示的对应地址。
- 等待节点同步后,浏览器访问节点根页会打开自有官网。手机和桌面 App 仍进入节点应用。
这里选择官网不会自动创建网站、申请证书或部署客户网页,也不会替你开通跨域登录。自有网页若嵌入登录注册模块,仍需走应用申请、批准及精确来源配置。
已有 Nginx 服务器的静态站部署示例
把已构建并审核的官网产物部署到 /srv/oem-site/current,保留上一版目录用于回滚。在现有网站服务器增加独立虚拟主机,替换域名和证书路径;不要覆盖节点原有虚拟主机。
server {
listen 443 ssl;
server_name www.example.com;
ssl_certificate /etc/ssl/oem-site/fullchain.pem;
ssl_certificate_key /etc/ssl/oem-site/privkey.pem;
root /srv/oem-site/current;
index index.html;
location / { try_files $uri $uri/ =404; }
}
执行 nginx -t 验证配置后,再通过该服务器已有服务管理方式重载 Nginx。如果官网是单页应用,可将对应站点的回退改为 try_files $uri $uri/ /index.html。配置说明见 Nginx HTTPS 文档与 静态文件路由文档。
部署后核验
- 节点公开配置
/cosmac/instance/config应包含website_entry_schema: 1,且website.entry与后台保存值一致。没有这个字段的旧节点,需要先通过正常镜像升级安装兼容版本。 - Bot 与 Web 要来自同一兼容发行版本;仅后台升级不等于节点已经支持。
- 打开节点根页,确认标准官网或自有官网符合选择;自有官网的页面不能再跳回节点根页,避免循环。
- 节点
/#/login、/#/app保持可达,Matrix 和 Connect API 仍正常。这里不会更换 Matrix server name、清空数据或改变聊天归属。 - 自有官网自行维护 SEO;外部模式下节点首页停止收录。当前根页跳转由 Web 执行,不是服务端永久 SEO 重定向。
怎样恢复标准官网
在同一表单改回「标准 OEM 官网」并保存,等待节点同步;以前填写的标准官网内容继续保留。不需要改节点 DNS 或重装数据库。若回滚自有网站,切回该网站的上一版部署目录即可。