Xinf证书更新#

本文档介绍如何更新Xinference企业版的证书。

前置要求#

在开始证书更新之前，请确保：

  • Xinference服务已正常启动

  • 可以访问WebUI界面（即使显示证书过期提示）

  • 具有管理员权限

  • 网络连接正常，可以访问API接口

概述#

Xinference企业版需要有效的证书才能正常使用。首次部署或证书过期时，会出现以下情况：

  • 访问WebUI界面时显示”License is expired.”提示

  • 部分功能受限或无法使用

  • 需要获取设备信息并申请新证书

证书更新流程：

  1. 获取设备信息：通过API或WebUI获取MAC地址

  2. 申请证书：将设备信息发送给技术支持

  3. 更新证书：通过WebUI或API更新证书

  4. 验证生效：确认证书更新成功

获取设备信息#

方法一：通过WebUI界面#

  1. 访问WebUI：打开浏览器访问 http://<your-ip>:8000

  2. 查看提示：证书过期时会自动弹出对话框显示设备信息

  3. 复制信息：从对话框中复制MAC地址等设备信息

方法二：通过API接口#

使用以下命令获取设备的MAC地址信息：

curl --request GET 'http://<your-ip>:<your-port>/v1/license'

重要

参数说明：

  • <your-ip>：替换为Xinference服务的IP地址

  • <your-port>：替换为Xinference服务端口（通常为9997）

示例：

curl --request GET 'http://192.168.1.100:9997/v1/license'

响应示例：

{
    "message": "Request Successful.",
    "data": {
        "mac_address": "98:0E:27:AF:09:2D"
    }
}

申请证书#

获取设备信息后，需要向技术支持申请证书：

申请流程#

  1. 收集信息：

    • 设备MAC地址

    • 公司名称和联系信息

    • 使用用途说明

    • 预期使用期限

  2. 提交申请：

    • 发送邮件给技术支持团队

    • 或通过客服渠道提交申请

    • 包含完整的设备信息和申请说明

  3. 获取证书：

    • 技术支持会生成对应的证书文件

    • 通过邮件或其他安全方式发送证书

    • 证书通常为Base64编码的字符串

更新证书#

获得证书后，可以通过以下两种方式更新：

方法一：通过WebUI界面#

  1. 访问WebUI：打开浏览器访问 http://<your-ip>:8000

  2. 打开证书对话框：如果证书已过期，会自动弹出；否则可在设置中找到

  3. 输入证书：将获得的证书字符串粘贴到输入框中

  4. 提交更新：点击确认按钮完成更新

  5. 验证结果：页面会显示更新结果

方法二：通过API接口#

使用以下命令通过API更新证书：

curl --request POST 'http://<your-ip>:<your-port>/v1/license' \
--header 'Content-Type: application/json' \
--data-raw '{
    "license_key": "<your-license-key>"
}'

重要

参数说明：

  • <your-ip>：替换为Xinference服务的IP地址

  • <your-port>：替换为Xinference服务端口（通常为9997）

  • <your-license-key>：替换为获得的实际证书字符串

示例：

curl --request POST 'http://192.168.1.100:9997/v1/license' \
--header 'Content-Type: application/json' \
--data-raw '{
    "license_key": "a0df6K-hhOdeVM5tht2yuL-ddOhScqVJ8UeMy1aOGgL7WvGg93J7GgatSWaOMujL8NGE8oPJq6tDmMBYDuQ_xA=="
}'

响应示例：

{
    "message": "Request Successful."
}

备注

出现”Request Successful”即表示更新成功，可以正常访问Xinf服务了。

验证证书生效#

更新证书后，建议进行以下验证：

功能验证#

  1. 刷新WebUI：重新加载浏览器页面

  2. 检查状态：确认不再显示证书过期提示

  3. 测试功能：尝试访问各个功能模块

  4. 模型加载：测试模型加载和推理功能

API验证#

# 检查证书状态
curl --request GET 'http://<your-ip>:<your-port>/v1/license'

# 测试模型列表API
curl --request GET 'http://<your-ip>:<your-port>/v1/models'

默认凭据#

WebUI访问凭据#

  • 用户名：administrator

  • 密码：administrator

警告

安全建议：

  • 首次登录后请立即修改默认密码

  • 使用强密码，包含字母、数字和特殊字符

  • 定期更换密码以确保安全

常见问题#

证书更新失败#

如果证书更新失败，请检查：

  • 证书字符串是否完整且正确

  • 网络连接是否正常

  • 服务是否正常运行

  • 是否有足够的权限

证书仍然显示过期#

如果更新后仍显示过期：

  • 清除浏览器缓存并重新访问

  • 重启Xinference服务

  • 检查系统时间是否正确

  • 联系技术支持确认证书有效性

更多问题解决方案请参考：故障排除

相关文档#

备注

  • 证书更新是使用Xinference企业版的必要步骤

  • 建议在部署完成后立即进行证书更新

  • 如遇到问题，请及时联系技术支持