FAQ: 使用许可证激活系统时报错怎么办？

问题1：激活界面提示「...序列号已被其他实例绑定...」

这是因为许可证同一时刻只能绑定一份安装实例，该序列号已被激活绑定过，必须报废旧实例才能激活新系统。企业管理员使用注册邮箱账号登录丰盘在线服务门户 ，点击序列号旁边的「报废」按钮， 确认之后，该主机实例将与序列号自动解绑，序列号释放后可重新用于激活新系统。

需要特别提醒的是，您不应该继续使用报废登记的旧主机实例，后续该系统的许可证将自动失效，并且无法重新激活，也无法升级至新版本，我们对该系统也不提供人工技术支持。

了解更多关于许可证相关的细节，请查阅 软件授权及版本升级。

问题2：激活界面提示网络超时、Timeout、HTTP异常等错误

丰盘支持私有化部署，但是安装、升级以及许可证激活更新均需要服务器联网才能进行。出现上述字样的报错，说明该容器内部的进程无法访问丰盘的激活服务器。常见的情况例如企业主机处于纯内网环境，不管是宿主机还是容器内部，均无法访问外网。

有些企业采用定制的Linux发行版，新装Docker之后可能需要重启才能正常工作，您可以运行下面命令重启Docker以及丰盘进程，然后回到网页端再次激活，看看问题是否解决。

# 重启Docker服务，所有容器将自动下线
sudo systemctl restart docker
# 按依赖次序启动丰盘相关容器服务
sh /opt/xpan/tools/xpc.sh up

如果重启后仍出现问题，我们进入下面的诊断环节。

提示

注意：每个诊断步骤都会同时校验「丰盘OTA服务器」和「百度服务器」，如果二者同时失败，说明是本地主机或局域网环境的问题，如果仅丰盘OTA服务器验证失败，您可以联系我们 在线客服 协助排查故障。

步骤1：诊断宿主机是否正常联网

运行下面命令将测试验证宿主机能否连通互联网。

# 宿主机上运行 curl（或wget） 命令
# 命令会打印丰盘OTA服务器时间如：
# ✅"2025-11-07 07:11:25"
curl https://ota.xpan.ekbcloud.com/api/v1/op/time
wget -qO- https://ota.xpan.ekbcloud.com/api/v1/op/time

# 运行下面测试百度服务器是否正常
# ✅预期的输出结果，应该能看到“百度”二字
curl https://www.baidu.com/
wget -qO- https://www.baidu.com/

如果宿主机网络无法访问互联网，请检查网卡配置是否正常、iptables本机防火墙规则是否配置正确，或者联系企业网络管理员询问局域网出口是否配置了外网流量拦截防火墙。解决此问题后重新执行激活流程。

如果宿主机网络顺畅、局域网无拦截，那么您应该可以看到丰盘OTA服务器的时间以及百度网页正文信息。我们进入步骤2的诊断环节。

步骤2：诊断Docker网络是否正常联网

如果主机访问互联网正常，那么我们接下来需要排查下Docker网络的问题。

提示

需要注意，Docker网络采用虚拟网卡技术进行流量路由，如果宿主机iptables配置不当，很容易导致Docker网络无法正常使用。 以下命令都是在Docker虚拟网络里执行，通过 --network=xpan 或者 --network=testnet 参数指定运行的网卡。

先诊断下Docker网络的DNS解析是否正常。

docker run -it --rm --network=xpan registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest /bin/sh -c "nslookup ota.xpan.ekbcloud.com"

docker run -it --rm --network=xpan registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest /bin/sh -c "nslookup www.baidu.com"

# ✅️预期的正常结果示意：
Server:         127.0.0.11
Address:        127.0.0.11:53

Non-authoritative answer:
Name:   ota.xpan.ekbcloud.com
Address: 106.55.2.26

# ❌解析故障的结果类似：
Server:         127.0.0.11
Address:        127.0.0.11:53

server can't find ota.xpan.ekbcloud.com: NXDOMAIN

如果DNS解析正常，我们接下来验证IP连通性的问题。

# 运行下面命令，您将测试丰盘虚拟网络xpan能否直连丰盘OTA服务器
# 预期应该能看到丰盘OTA服务器时间戳如：
# ✅"2025-11-07 07:11:25"
docker run -it --rm --network=xpan registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest -fsSL -m 10 https://ota.xpan.ekbcloud.com/api/v1/op/time

# 如果上述命令异常，
# 那么我们接下来排除丰盘的干扰因素，单独诊断本机Docker安装配置的问题。
# 在Docker上面创建全新的测试网络，并测试能否连接百度
# ✅预期的输出结果，应该能看到“百度”二字
docker network create --driver=bridge testnet || true &&
docker run -it --rm --network=testnet registry.cn-hangzhou.aliyuncs.com/ekbc/curl:latest -fsSL -m 10 https://www.baidu.com &&
docker network rm testnet

如果经过上述诊断及故障排除后，仍无法解决您的问题。或者您遇到了其他方面的激活问题，您可以 联系我们 获得帮助。