玄道智控平台

# 常见问题

文档版本 内容修订 修订人 修订日期
V1.0 正式发布 王垚 2021-02-05
V1.1 追加关闭用户认证，重连数据库 王垚 2021-02-22
V1.2 添加更新密钥的方式 王垚 2021-03-23
V1.3 添加证书作用说明和 Win10 配置端口证书 王垚 2021-03-23
V1.4 多开窗口不显示问题 张宇 2021-04-27
V1.5 跨域配置，弹窗屏蔽时间设置 王垚 2021-08-08
V1.6 添加 USB 串口处理方式 郭程豪 2025-05-06
V1.7 添加显卡拼接屏无法全屏处理方案 王垚 2025-05-12

# 如何获取软件？

下载地址: 上海三思玄道智控 (opens new window)

通过上面的链接可以下载到玄道智控软件的各个系统版本(cyberhub),请下载适合目标设备的软件，解压安装。适用于在 x86 和 arm 架构下的 64 位通用操作系统上运行, 如果需要 MIPS/LoongArch 架构等特殊版本或者特殊操作系统适配, 请联系研发团队获取.

img_021

程序名称 架构 适用操作系统
cyberhub_x.x.x_windows_x64.zip x64 Window10及以上
cyberhub_x.x.x_windows_arm64.zip arm64 Window10及以上
cyberhub_x.x.x_mac_x64.zip x64 MacOS(Intel 版本)
cyberhub_x.x.x_mac_arm64.zip arm64 MacOS(M1、M2版本)
cyberhub_x.x.x_linux_x64.deb x64 Ubuntu、CentOS、中标麒麟、UOS 等
cyberhub_x.x.x_linux_arm64.deb arm64 Ubuntu、CentOS、中标麒麟、UOS 等

# 无法登录?

在开启 HTTPS 认证情况下登录过系统，关闭 HTTPS 后再去登录，发现无法登录。请重新开启 HTTPS 或者按照如下步骤操作： img_001

img_002

问题原因： 由于之前在 HTTPS 下设置了用户的 sid 到 Cookie 中，切换到 HTTP 模式后，浏览器读到了 HTTPS 设置的数据，拒绝重新设置新的 Cookie 数据，导致无法正常完成认证流程，清除 Cookie 数据或者重新开启 HTTPS 认证即可解决该问题。

相关链接：Browsers ignore Set-Cookie response header if we try to set a cookie which was Secure before (opens new window)

# 无法将网页添加到桌面?

在安卓平板上，无法在 Chrome 中将网页添加到桌面。可能是因为权限不足，需要开启添加到桌面的权限，在按照以下步骤操作：

设置 => 权限管理 => Google Chrome => 发送到桌面 =>开启发送到桌面权限

# 如何关闭用户认证模式？

到用户目录下检查 Sansi/CCS-Platform/config/ccs-server.json 配置文件。

将 true 修改为 false，即可关闭用户认证模式。之后重启软件即可关闭用户权限认证。

img_004

# 如何连接到新的数据库？

到用户目录下检查 Sansi/CCS-Platform/config/ccs-server.json 配置文件。

将 arangodb 字段后对面的内容删除，调整到如下所示，重启软件，即可重新指定数据库。

img_005

# 更新用户根密钥?

在配置文件中存在一个 encrypt_key 属性，该属性用于生成加密密钥，如果需要调整加密信息，请直接修改该属性即可。

可以将该属性指定为任意字符串，或者将该属性置空，当该属性为空时，会自动生成一段随机字符串填充该属性。

注意：当更新完用户密钥后，需要重新放置证书文件，否则证书无法正常解密可能导致程序出现异常。

img_006

# 如何开启拼控服务跨域

到用户目录下检查 Sansi/CCS-Platform/config/ccs-server.json 配置文件。

设置 proxy 为 true，并设置 proxy_cy 为拼控服务地址。

img_007

# 修改弹窗屏蔽时间

到用户目录下检查 Sansi/CCS-Platform/config/ccs-editor.json 配置文件。

当设备发生故障时，会弹窗提示用户，每检查一次就会进行提示一次，如果用户觉得提示过于频繁，可以通过设置弹窗屏蔽时长来限制弹窗的弹出频率。可以调整的参数有两个：

参数名称 参数类型 参数描述
SYSTEM_NOTIFY_WAIT_TIME number 系统级别的弹窗提示频率，默认为 600 秒，即 10 分钟
WEB_NOTIFY_WAIT_TIME number WEB 网页的弹窗提示频率，默认为 5 秒

notify_config_001

# 无法访问到服务?

无法正常访问服务请按照以下步骤检查：

img_003

# SSL 证书生成和用途

# 证书生成脚本
# 支持一键生成绑定IP的证书，生成的文件格式如下：
# pfx: Transfer 服务端证书
# crt + key：中控服务端证书
# pem: ArangoDB 服务端证书
#
# cer 或者 crt: 客户端证书

psw=Sansi@1280
if [ ! -d cert ]; then
  mkdir cert
fi
function makeSSL() {
  NAME=$1
  DNS=$2
  IP=$3
  echo $NAME $DNS $IP
  if [ ! -d "cert/$IP" ]; then
    mkdir "cert/$IP"
  fi
  openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout "cert/$IP/$NAME.key" \
    -out "cert/$IP/$NAME.crt" -subj "/CN=$NAME-$IP" -addext "subjectAltName=DNS:$DNS,IP:$IP"
    
  cat "cert/$IP/$NAME.crt" "cert/$IP/$NAME.key" >"cert/$IP/$NAME.pem"
  
  openssl x509 -in "cert/$IP/$NAME.crt" -out "cert/$IP/$NAME.cer" -outform der
  openssl pkcs12 -export -inkey "cert/$IP/$NAME.key" -in "cert/$IP/$NAME.crt" -passout pass:"$psw" -out "cert/$IP/$NAME.pfx"
  echo "end ssl"
}

echo -n "请输入指定 IP 地址(默认为 localhost):"
read ip
echo "ip = $ip"
if [ "$ip" = "localhost" ]; then
  makeSSL localhost localhost 127.0.0.1
elif [ "$ip" = "127.0.0.1" ]; then
  makeSSL localhost localhost 127.0.0.1
elif [ "$ip" = "" ]; then
  makeSSL localhost localhost 127.0.0.1
else
  makeSSL SANSI_CCS ccs.sansi.com "$ip"
fi

# Windows 10 配置端口证书

为 Windows 服务端口安装证书，安装文件的格式需要携带证书和私钥，此处以 pfx 格式的证书为例讲解安装过程。

备注： CCS_Transfer 服务配置 SSL 需要通过服务端口进行绑定

安装过程中如果出现 SSL 证书添加失败, 错误: 1312 指定的登录会话不存在。 (opens new window) 请检查证书安装位置是否在本地计算机->个人下。

# 1. 安装证书

双击 pfx 文件进入安装程序，之后安装步骤执行即可。

win_ssl_00

win_ssl_01

win_ssl_02

win_ssl_03

Sansi 签发的证书默认密码为 Sansi@1280。

win_ssl_04

win_ssl_05

win_ssl_06

win_ssl_07

win_ssl_08

# 2. 查看证书指纹

接下来为查看证书指纹和检查证书是否安装到正确位置的过程。

首先使用快捷键 Win + R 打开运行窗口，在输入框里吗输入 MMC 打开控制台管理程序。

win_ssl_09

打开控制台管理程序后在右上角文件处选择 文件 -> 添加/删除管理单元

win_ssl_10

win_ssl_11

win_ssl_12

win_ssl_13

win_ssl_14

添加完证书管理单元后，去查看对应目录中是否已经安装好了证书。选择 证书 -> 个人 -> 证书 进行查看，如下图所示表明证书已经正确安装了。双击证书，查看证书详情。

win_ssl_15

win_ssl_16

将指纹信息记录下来，稍后会用到。

# 3. 证书绑定

先使用管理员身份运行 PowerShell 。

win_ssl_17

之后在 PowerShell 中通过命令绑定端口或者解除绑定。其流程如下。

win_ssl_18

相关指令：

PS C:\Users\ccc> netsh 													# 进入网络配置
netsh> http show sslcert												# 查看端口绑定状态
netsh> http add sslcert ipport=0.0.0.0:9009 certhash=537cf713b335168bec44f03f815d04f2f3855715 appid={00112233-4455-6677-8899-AABBCCDDEEFF} 										# 绑定端口，注意替换 certhash 为证书指纹
netsh> http delete sslcert ipport=0.0.0.0:9009 	# 解除绑定
netsh> quit																			# 退出网络配置

# 多开窗口不显示问题

部分型号的集中式拼接器单个输出信号最大支持开8个窗，多开窗口会不显示。

# 所有服务都无法显示日志？

no_log.png

问题原因： HTTPS 证书不安全，导致 WSS 无法获取到日志信息

# 处理方式1: 关闭 https, 步骤如下

  1. 点击右上角【菜单】按钮，选择【服务设置】

no_log_method_1.png

  1. 在弹出页面中，关闭【HTTPS】,保存并重启

no_log_method_2.png

# 处理方式2: 导入 https 证书

安装 HTTPS 证书

# 安装 HTTPS 证书

# ⚠️注意：从 0.9.4 版本开始默认支持 HTTPS。开启 https 后访问地址为 https://127.0.0.1:1280 。

证书采用的是动态生成的方案，每一台主机安装后都会根据自身的 IP 列表来生成证书，因此访问不同的主机想要不报错，就需要安装不同的证书。

由于采用的是自签名证书，首次从浏览器访问会报错，弹出警告信息，此时按照红色箭头指示点击 “高级” 按钮。

image-20240125104909157

点击继续前往的链接访问页面。

image-20240125105058461

继续前往后可以看到页面，但此时页面依旧是报错的。

image-20240125104720311

这时需要通过菜单功能获取证书，点击右上角的菜单进入服务配置。

image-20240125123142168

通过获取 SSL 证书功能来得到当前使用的证书。

⚠️注意：重置证书会生成一个全新的证书，会导致之前已安装的证书失效，大部份情况下请不要重置证书。

如果服务器的 IP 地址有变动，则可以通过重置功能来重新生成证书。

image-20240125123339424

image-20240125123558884

点击下载后，就可以在浏览器的下载目录找到一个 cer 文件。

# Windows 安装证书

在下载目录找到 Shanghai Sansi CCS Daemon.cer 文件。

image-20240125124132888

双击后选择加密外壳扩展进行安装。

image-20240125124442318

点击安装证书。

image-20240125124724682

默认情况下给当前用户安装，如果需要多个用户共享使用，请选择本地计算机。

image-20240125124852021

将证书按照下面的步骤安装到受信任的根证书颁发机构中。

  1. 选择将所有的证书都放入下列存储。
  2. 点击浏览。
  3. 选择受信任的根证书颁发机构。
  4. 点击确定。
  5. 点击下一步。

image-20240125134738506

检查存储位置为受信任的证书颁发机构后，点击完成。

image-20240125134830747

如果弹出了警告信息，点击“是”按钮。

image-20240125135012731

提示导入成功。

image-20240125125216545

点击确定关闭证书弹窗。

image-20240125125316928

安装完成后关闭浏览器，之后重新打开再次输入地址即可，就不会再提示警告问题了。

image-20240125135510051

# Linux 安装证书

Linux 下暂时未进行相关功能测试，后续需要的时候进行补充。

# Mac 安装证书

在访达中找到已经下载的证书，双击进行安装。

image-20240125140258163

找到并打开钥匙串 App。

  1. 找到登录。
  2. 找到证书。
  3. 找到 "Shanghai Sansi CCS Daemon" 的证书文件。

image-20240125140804441

双击证书文件打开，点击展开信任。

image-20240125141101231

点击“始终信任”，然后关掉窗口。

image-20240125141330617

使用指纹或者密码通过验证。

image-20240125141445728

如果看到证书上面多了一个加号说明设置成功。

image-20240125141537839

之后关闭浏览器后再次进入，就不会再提示警告问题了。

image-20240125141705186

# USB串口地址无法固定

# 使用 by-path 方式

# USB串口地址

sansi@ok3588:~$ ls -l /dev/serial/by-path/
total 0
lrwxrwxrwx 1 root root 13 Apr 13 09:32 platform-fc800000.usb-usb-0:1:1.2-port0 -> ../../ttyUSB2
lrwxrwxrwx 1 root root 13 Apr 13 09:32 platform-fc800000.usb-usb-0:1:1.3-port0 -> ../../ttyUSB3
lrwxrwxrwx 1 root root 13 Apr 13 09:32 platform-fc800000.usb-usb-0:1:1.4-port0 -> ../../ttyUSB4
lrwxrwxrwx 1 root root 13 Apr 13 09:33 platform-xhci-hcd.5.auto-usb-0:1.1:1.0-port0 -> ../../ttyUSB0
lrwxrwxrwx 1 root root 13 Apr 13 09:33 platform-xhci-hcd.5.auto-usb-0:1.2:1.0-port0 -> ../../ttyUSB1

USB1 /dev/serial/by-path/platform-xhci-hcd.5.auto-usb-0:1.2:1.0-port0
USB2 /dev/serial/by-path/platform-xhci-hcd.5.auto-usb-0:1.1:1.0-port0
USB3 /dev/serial/by-path/platform-xhci-hcd.5.auto-usb-0:1.4:1.0-port0

# 注意事项

每次执行 ls -l /dev/serial/by-path/ 命令，-> ../../ttyUSBx 会变更，但是不要担心，人眼看到的 USB1 的物理地址，一定是 /dev/serial/by-path/platform-xhci-hcd.5.auto-usb-0:1.2:1.0-port0

# 新建设备命名规则文件

# 查看对应物理链路地址

需要先连接串口设备

udevadm info -a -n /dev/ttyUSB3 | grep KERNELS

    # 输出结果
    KERNELS=="ttyUSB3"
    KERNELS=="9-1.3:1.0"
    KERNELS=="9-1.3"
    KERNELS=="9-1"
    KERNELS=="usb9"
    KERNELS=="xhci-hcd.5.auto"
    KERNELS=="fc400000.usb"
    KERNELS=="usbdrd3_1"
    KERNELS=="platform"

# 新建规则文件

sudo vim /etc/udev/rules.d/99-sansi.rules

# 在规则文件中写入地址

按下 i 键后写入以下数据

SUBSYSTEM=="tty", KERNELS=="9-1.2:1.0", SYMLINK+="ttySansiUSB1"
SUBSYSTEM=="tty", KERNELS=="9-1.1:1.0", SYMLINK+="ttySansiUSB2"
SUBSYSTEM=="tty", KERNELS=="9-1.4:1.0", SYMLINK+="ttySansiUSB3"
SUBSYSTEM=="tty", KERNELS=="9-1.3:1.0", SYMLINK+="ttySansiUSB3"

按下 ESC，并按下 wq 按键后回车退出。

# 重新加载规则

sudo udevadm control --reload-rules
sudo udevadm trigger

# 验证结果

需要连接串口设备

ls -l /dev/ttySansi*

# 多个显卡输出拼接为一个画面后窗口无法全屏

1.桌面右键打开NVIDIA控制面板
2.在顶部工具栏打开桌面
3.依次打开桌面 -> surround显示器
4.将“最大化跨越所有显示器窗口”选项勾选后完美解决

surround

# 多拼接器部署注意事项

  1. 如现场需部署3个拼接器，那么Hulk需要部署3套、拼接器插件3套、对应前端配置也需要一一对应
  2. 需修改拼接器插件的grpc端口、日志端口
  3. Hulk需修改服务端口（默认是9090）grpc端口、web访问端口、websocket推送端口、拼接器配置中修改前端访问接口的对应端口号
  4. 服务配置修改后需要在前端拼接器配置中点击初始化才能生效

←