锦中人工智能助手(苏小锦)(标准版)安装部署手册

## 1.安装环境要求
### 说明
服务器软硬件方案，我们给出三种方案，分别为：阿里云百炼平台在线Api、阿里云在线云服务器以及私有化部署
1. 方案一阿里云百炼平台在线Api，可动态扩展硬件配置。
2. 方案二阿里云在线云服务器方案，以大学有在校师生8000人，最高同时在线率1%（80人）计算。
3. 方案三私有化部署同方案二，以大学有在校师生8000人，最高同时在线率1%（80人）计算。
4. 方案二、方案三以主模型以Deepseek-r1-distill-qwen-14b为基准计算。
5. 本方案中的费用基于2025年6月份的市场时价估算。
### 方案一 阿里云百炼平台（在线Api）

| 主模型                              | 用户输入平均Token | 用户输出平均Token | 输入成本（每千Token） | 输出成本（每千Token） | 一次请求成本（元） | TTFT（首字延迟）      | 出字速度（字符/s） | 每天预估费用（元） | 每年预估费用（万元） |
|----------------------------------|-------------|-------------|---------------|---------------|-----------|-----------------|------------|-----------|------------|
| DeepSeek R1 671B                 | 1.2k        | 0.8k        | 0.004         | 0.016         | 0.0176    | 19.563s(包含思考时间) | 38.35      | 2,872     | 105        |
| Deepseek V3 671B                 | 1.2k        | 0.8k        | 0.002         | 0.008         | 0.0088    | 1.727s          | 36.35      | 1,436     | 53         |
| Deepseek-r1-distill-qwen-7b      | 1.2k        | 0.8k        | 0.0005        | 0.001         | 0.0014    | 8.795s（包含思考时间）  | 112.72     | 228       | 9          |
| **Deepseek-r1-distill-qwen-14b（推荐方案）** | **1.2k**        | **0.8k**      |**0.001**        | **0.003**        | **0.0036**   | **11.186s(包含思考时间)** | **130.35**    |**588**      | **22**         |
| Deepseek-r1-distill-qwen-32b     | 1.2k        | 0.8k        | 0.002         | 0.006         | 0.0072    | 12.172s(包含思考时间) | 66.44      | 1,175     | 43         |
| qwen-plus                        | 1.2k        | 0.8k        | 0.0008        | 0.002         | 0.00256   | 3.657s          | 53.65      | 418       | 15         |
| qwen-plus-latest                 | 1.2k        | 0.8k        | 0.0008        | 0.002         | 0.00256   | 3.706s          | 49.59      | 418       | 15         |

### 方案二 阿里云 ECS云服务器
**方案二基于主模型 Deepseek-r1-distill-qwen-14b 估算**

| 服务器                  | 用途                                 | CPU     | 内存      | GPU            | 硬盘   | 网络带宽（Mbps） | 每年预估费用（万元） |
|----------------------|------------------------------------|---------|---------|----------------|------|------------|------------|
| ecs.gn7i-8x.16xlarge | 推理服务器（Deepseek-r1-distill-qwen14b） | 64 vCPU | 256 GiB | 8 * NVIDIA A10 | 2T   | 0          | 40         |
| ecs.u1-c1m2.2xlarge  | 应用服务器（DF）                          | 8 vCPU  | 16 GiB  | 无              | 200G | 0          | 0.80       |
| ecs.u1-c1m2.2xlarge  | 应用服务器（对话+中间件）                      | 8 vCPU  | 16 GiB  | 无              | 200G | 20         | 0.80       |
| ecs.u1-c1m2.2xlarge  | 数据库服务器                             | 8 vCPU  | 16 GiB  | 无| 500G | 0| 1|
|||||||| 总计：43万元    |

### 方案三 私有化部署
**方案三基于主模型 Deepseek-r1-distill-qwen-14b 估算**

| 服务器           | CPU                   | 内存                  | GPU           | 硬盘                | 预估费用（万元） |
|---------------|-----------------------|---------------------|---------------|-------------------|----------|
| 推理服务器         |  64 核 Intel Xeon Gold | 256GB DDR4/DDR5 ECC | 8* NVIDIA A10 | 2TB NVMe PCIe SSD | 25       |
| 应用服务器(dify)   | 8 核 Intel Xeon Gold   | 16GiB               | 无             | 200GB             | 2        |
| 应用服务器(对话+中间件) | 8 核 Intel Xeon Gold   | 16GiB               | 无             | 200GB             | 2        |
| 数据库服务器        | 8 核 Intel Xeon Gold   | 16GiB               | 无| 500GB             | 2        |
|||||| 总计：31万元  |
---------
方案三未计网络、电费、UPS、运维管理等费用，请用户根据实际情况自行估算。

## 2.安装步骤（Ubuntu服务器，数据库和应用各一台服务器）
基础环境安装
JDK 安装
[JDK安装教程](https://blog.csdn.net/qq_42557044/article/details/124935468 "JDK安装教程")

MySql 8 安装
[MySql 8 安装教程](https://blog.csdn.net/weixin_48088839/article/details/143756554 "MySql 8 安装教程")

Redis 安装
[Redis 安装教程](https://www.cnblogs.com/xiaobug/p/16007895.html "Redis 安装教程")

Nginx 安装
[Nginx 安装教程](https://blog.csdn.net/weixin_41302755/article/details/123175079 "Nginx 安装教程")

License 申请( http://app.jzkg.cn )
锦中人工智能助手(苏小锦)，是收费软件系统，需要有License才能正常部署。在您部署之前，应从官方获得正版的License。如果您还没有License，想先部署、测试的话，那么可以在部署之前，先到官方在线申请免费使用3天的License，在线申请url为：http://app.jzkg.cn 。

在申请License之前，需要先获得融合门户系统后端所在服务器的Ipv4地址（即Ip地址）、Ipv6地址和Mac物理地址。方法为在控制台中输入：ifconfig 命令即可看到。

申请成功后，您将得到文件：license.xml，将这个文件放到：与jar文件同级目录jzconfig下面即可。假设您的jar文件的路径为/home/jzjt/suxiaojin.jar，则将license.xml放在/home/jzjt/jzconfig/license.xml ，注意Linux系统区分大小写，默认license.xml 均小写。

## 后端部署

（1）将打包好的 jar 包上传至服务器指定文件夹中

（2）假设jar包名称为suxiaojin.jar,以后台运行方式启动即可

```shell
nohup java -jar suxaiojin.jar >/dev/null 2>&1 &
```

也可以引用外部配置文件，在默认配置文件位置的基础上，额外添加配置文件位置。Spring Boot 会先加载默认配置，再加载这些额外配置，额外配置会覆盖默认配置中的相同属性。假设配置文件的路径是”/home/jzjt/application.yml”
```shell
nohup java -jar suxiaojin.jar -spring.config.additional-location=/home/jzjt/application.yml
```

## 后端配置文件注意事项

下面是后端yml文件，需要修改的地方：
- 数据库redis，mysql的地址、账号和密码
- 苏小锦统一身份认证登录的相关信息，包括client-id、client-secret、redirect-uri、domain-prefix、pack-id；其中redirect-uri 这个修改为http://（智能体对话前端部署的域名）/login-callback.html ，其它几个参数都是对应统一身份认证上面的，修改为自己的即可
- dify平台智能体的key 和 base-url（部署dify 平台api调用的基地址）

```yaml
#服务器配置
server:
  port: 8002

#数据源配置
spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password:
      database: 2
      ssl:
        enabled: false
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    # MySql
    url: jdbc:mysql://localhost:3306/suxiaojin-j?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&serverTimezone=GMT%2B8&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true
    username: root
    password: root

# 苏小锦配置
suxiaojin:
#  dbDriverFolder: data/drivers/
  oauth:
    # keycloak类型的统一身份认证   后台管理那边的配置
    KEYCLOAK:
      # 客户端id
      client-id: suxiaojin-user
      # 凭据
      client-secret: 统一身份认证平台密钥
      # 登陆后回调路径，maxid 要验证
      redirect-uri: http://chat.jzkg.cn/login-callback.html
      # 忽略状态 默认就行
      ignore-check-state: true
      # 域名前缀
      domain-prefix: https://maxid-demo2.jzkg.cn/
      # maxid的领域id
      pack-id: master

# dify 平台相关设置
dify:
  api:
    base-url: https://aibase.jzkg.cn/v1
    key: dify平台对应智能体的密钥
    endpoints:
      chat-url: /chat-messages
      get-conversations-url: /conversations
      get-messages-by-conversationId-url: /messages
      post-message-feedback-url: /messages/
      delete-conservation-by-id-url: /conversations/
      stop-message-response-url: /chat-messages/
      audio-to-text-url: /audio-to-text

```

## 前端部署

本助手有两个前端，一个是智能体对话的界面，还有一个是后台管理界面。

![](/media/202507/2025-07-16_173605_397086.png)

假设用户对话界面的前端访问域名为： http://chat.jzkg.cn 。
（1）可使用Nginx、Apache等任何静态文件服务器部署前端，确保可以在公网访问前端。
（2）在Linux系统上解压前端文件。

对应nginx上面的配置如下，将上图中的所有前端文件直接复制到/var/www/html/chat（假设为你当前nginx配置文件存放地址）文件夹下，目录结构如下图所示：

![](/media/202507/2025-07-16_173909_953417.png)

下方nginx配置中http://127.0.0.1:8002 为后端部署对应的ip和端口：

```yaml
server {
        listen 80;

server_name chat.jzkg.cn;

location / {
                root /var/www/html/chat;
                index index.html;
        }
        location ^~/api {
                 proxy_pass http://127.0.0.1:8002;
                 rewrite "^/api/(.*)$" /$1 break;
       }

}

```

注意：https方式部署本系统，采用https时，上述80端口需改为443，同时应配置ssl证书

### 前端配置文件修改

#### 智能体对话界面前端配置文件修改

##### 1、login.html
对接统一身份认证登录，需要修改下方href的值：假设你前端部署的域名为：http://chat.jzkg.cn ，则herf 的值就是 http://chat.jzkg.cn/login-callback.html?target=user

```html

<div class="login-bottom-link">
	<a href="http://chat.jzkg.cn/login-callback.html?target=user"
	class="sso-login-link">统一身份认证登录</a>
</div>
```

##### 2、config.js
config.js 文件修改：
- 修改BASE_URL 中的 “http://localhost:8002” 部分，比如修改为http://chat.jzkg.cn/api ，/api 需要保留
- 修改LOGOUT_REDIRECT_URI，退出登陆后跳转的页面，修改为你自己的主页即可
- 修改统一身份认证客户端ID CLIENT_ID（对接统一身份认证使用）

```html
    BASE_URL: 'http://localhost:8002',
    URL_CHAT: '/blade-agent/chat',
    URL_FEEDBACK:'/blade-agent',
    URL_CONSERVATIONLIST:'/blade-agent/conversations',
    URL_MESSAGES:'/blade-agent/messages',
    URL_DELETECONSERVATION:'/blade-agent/conversations',
    URL_STOP:'/blade-agent/chat-messages',
    URL_AUDIOTOTEXT:'/blade-agent/audioToText',

URL_LOGOUT: '/blade-auth/oauth/logout',
    URL_AUTHORIZE_LOGOUT: '/suxiaojin-authorize/authorize/logout',

URL_LOGIN: '/blade-auth/oauth/token',

// 退出统一身份认证登录后跳转的地址
    LOGOUT_REDIRECT_URI:'http://localhost:5500/index.html',
    // 统一身份认证客户端ID
    CLIENT_ID:'suxiaojin-admin',
```

##### 3、login-callback.html

修改login-callback.html 中的authUrl, ？前面的地址改为自己统一身份认证的地址，? 后面的参数修改为自己的（包括scope,client_id,redirect_uri）,`在这里需要注意的是 这里的redirect_uri要和后端yml文件中配置的一致`

```shell
const authUrl = `https://maxid-demo2.jzkg.cn/realms/master/protocol/openid-connect/auth?response_type=code&scope=openid&client_id=suxiaojin-user&redirect_uri=http://chat.jzkg.cn/login-callback.html`

```

### 后台管理界面前端

需要修改config.js 配置文件：

- 修改 VITE_SSO_URL 中域名前缀(改为你的实际地址)
- VITE_REDIRECT_URI 不需要变
- 修改 VITE_SSO_LOGOUT_URL 中的域名前缀，替换为你的实际地址
- VITE_SSO_LOGOUT_REDIRECT_URI 配置你实际退出成功后的跳转地址（在这里你只需要修改 /admin前面域名相关东西即可）
- VITE_SSO_CLIENTID 修改为你实际的 统一身份认证平台client_id
- VITE_SSO_DOMAIN 修改为实际的 统一身份认证的 主域地址
- VITE_SSO_REALM 按需修改，根据你实际的统一身份认证平台配置的修改

```shell
window.__config = {
    // # 登录模式 SSO：统一身份认证   PWD：账号密码登录
    VITE_LOGIN_MODE: 'PWD',
    // # 备案号
    VITE_FOOTER_RECORD_NUMBER: '苏ICP备2021001193号-1',
    // # 首页路由
    VITE_HOME_PATH: '/portal/index',
    // # 平台名称   苏小锦 / 统一应用平台
    VITE_APP_TITLE: '苏小锦 人工智能体',
    // # 单点登录地址
    // # response_type: code 统一身份认证的对接方式
    // # scope：openid 统一身份认证对接的域类型
    // # client_id: 苏小锦后台管理 系统在统一身份认证平台的唯一代码 （配置同VITE_SSO_CLIENTID）
    // # redirect_uri: 统一身份认证登录成功后的回调地址。  由系统关联VITE_REDIRECT_URI
    VITE_SSO_URL: 'http://chat.jzkg.cn/login-callback.html?target=',
    VITE_REDIRECT_URI: 'admin',
    // # 单点登录的退出URL
    VITE_SSO_LOGOUT_URL: 'https://maxid-demo2.jzkg.cn/realms/master/protocol/openid-connect/logout',
    // # 单点登录退出成功后的跳转地址
    VITE_SSO_LOGOUT_REDIRECT_URI: 'http://chat.jzkg.cn/admin',
    // # 统一身份认证的clientId， 系统在统一身份认证平台的唯一代码
    VITE_SSO_CLIENTID: 'suxiaojin-user',
    // # 统一身份认证系统中，平台所属的域名称
    VITE_SSO_REALM: 'master',
    // # 统一身份认证系统的主域地址
    VITE_SSO_DOMAIN: 'https://maxid-demo2.jzkg.cn/'
}
```

### 其它说明
系统默认登录账号密码 都是admin