ARTICLE · 1070750
操作教程|通过1Panel应用商店快速安装Laya

Laya是一款面向结构化决策的开源模型,它用Choice(单选)、Score(评分)和Noul(是否概率判断)三类问题,对文本或JSON状态做一次推理,得到可以直接用于业务判断的答案。Laya Server将其推理能力封装为独立服务,接口兼容TypeSafe Jev(System One)线协议,同时自带一个简洁的网页控制台。
2026年9月24日,Laye开源AI决策模型上架至1Panel应用商店。您可以在1Panel应用商店中一键安装Laya Server。本文从安装、登录、创建密钥到第一次接口调用,为您完整演示整个调试流程。
一、前置条件
■ 一台已安装1Panel开源面板的服务器,并且已配置好Docker环境;
■ 服务器可访问外网,用于拉取应用镜像;
■ 无需GPU,CPU即可运行。镜像已内置multilingual模型,安装后无需额外下载模型文件。
二、在1Panel应用商店中安装Laya Server
1. 登录1Panel开源面板,从左侧菜单进入“应用商店”页面;
2. 在应用商店中搜索“Laya”,找到Laya Server,点击“安装”按钮即可;
3. 在安装表单中填写相关参数(如表1所示);
4. 点击“确认”按钮,等待镜像拉取和安装完成,如提示放行端口请选择放行;
5. 安装完成后,在1Panel应用商店“已安装”列表中找到Laya Server,点击“跳转”按钮,或者直接访问http://服务器IP:端口。
表1 Laya Server安装参数列表
参数名称 | 说明 |
Web UI端口 | 控制台与接口的访问端口,默认为8080,被占用时可以修改。 |
管理员用户名 | 控制台登录账号,默认为admin。 |
管理员密码 | 至少10个字符,请妥善保存。 |
提示:Web UI端口可以在选择“已安装”→“参数”后进行修改。管理员用户名和密码在安装时设置,请提前保存。
三、登录控制台
1. 用浏览器打开http://服务器IP:端口,登录至Laya Server控制台;
2. 在页面右上角可以切换简体中文、English、繁體中文语言选项;
3. 输入管理员用户名和密码,点击“登录”按钮。

▲附图 Laya Server Playground页面
四、创建API Key
1. 在Laya Server的左侧菜单选择“API Keys”选项;
2. 在“API Keys”页面中点击“创建密钥”按钮,填写一个方便识别的名称(例如“生产环境”);
3. 点击“创建”按钮,完整密钥会在弹窗中显示一次,请立即复制保存。
注意:完整密钥只显示一次,之后只能看到掩码。服务端只保存SHA-256摘要。如果密钥泄露或丢失,在“API Keys”页面对应的API Key条目中点击“撤销”按钮后重新创建即可。
五、在Playground中试跑一次
1. 在Laya Server的左侧菜单选择“Playground”选项,进入“Playground”页面;
2. 保持“表单”模式,在“State”栏目中输入需要判断的文本或JSON,也可以点击“英文样例”或“中文样例”链接进行快速填充;
3. 在“Questions”栏目中添加问题:填写问题ID、选择问题类型(choice/score,还需填写选项或等级)、填写判断说明;
4. 在“Model”下拉框中选择“auto”或“multilingual”;
5. 点击“运行推理”按钮,在右侧的“响应”栏会返回answers和本次消耗的usage。
表2 Laya Server问题类型说明
问题类型 | 说明 | 典型场景 |
choice | 多选一,返回命中标签与置信度 | 意图分类、部门路由 |
score | 有序评分,返回等级期望值 | 紧急程度、情绪强度 |
noul | 是/否判断,返回0–1的概率 | 是否需要退款、是否可能流失 |
六、从代码调用推理接口
Laya Server的API接口遵循Jev(TypeSafe System One)线协议。在对接Jev客户端时,将Base URL指向本服务,并将“Model”选项设置为auto或者multilingual。
curl -X POST http://服务器IP:端口/v1/systemone \-H 'Authorization: Bearer YOUR_API_KEY' \-H 'Content-Type: application/json' \-d '{"state": {"message": "I was charged twice and need a refund today."},"questions": {"refund": {"type": "noul", "instructions": "Does the customer ask for a refund?"},"team": {"type": "choice","instructions": "Which team should handle this?","criteria": {"billing": "payments and refunds", "support": "technical issues"}}},"model": "auto"}'
相关参数说明:
■ state:字符串、JSON对象或数组;
■ questions:1–50个问题,支持choice/score/noul;
■ model:可选auto(默认)或者multilingual。发布镜像内置multilingual模型,显式请求english或typed-decisions会返回422。
成功响应包含answers、model与实际Token用量usage;无效密钥返回401,请求校验失败返回422。
七、配置域名与HTTPS(可选)
1. 从1Panel面板左侧菜单进入“网站”页面,创建一个反向代理网站;
2. 代理目标填写为http://127.0.0.1:端口;
3. 在该网站设置的“HTTPS”选项中开启HTTPS,即可通过域名安全访问。
八、升级与数据
■ 升级:在“应用商店”→“已安装”中找到Laya Server,点击“升级”按钮即可。升级只重建容器,数据不会丢失;
■ 数据:SQLite数据库保存在应用安装目录的data目录中,请纳入常规备份;
■ 卸载:在1Panel应用商店“已安装”列表卸载该应用即可。如需保留数据,请在卸载前备份应用安装目录下的data目录。
