一键安装

通过 curl | bash 一键安装/更新 AI问数系统

通用安装命令

curl -fsSL https://teachseek.ai.ninglon.com/install.sh | sudo bash

首次安装后,脚本会自动生成 sample.env 模板。请将其复制为 .env 并填入实际配置后重新运行安装命令启动服务。

指定版本安装

curl -fsSL https://teachseek.ai.ninglon.com/install.sh | sudo bash -s -- -r v8.0.4-0710-0001

指定端口和安装目录

curl -fsSL https://teachseek.ai.ninglon.com/install.sh | sudo bash -s -- -p 8002 -d /opt/teachseek-2

试运行(不实际执行)

curl -fsSL https://teachseek.ai.ninglon.com/install.sh | sudo bash -s -- --dry-run

.env 配置文件说明

首次安装自动生成 sample.env 模板,复制为 .env 后填入实际配置

配置流程

  1. 首次安装后,安装目录下会生成 sample.env 模板文件
  2. 复制 sample.env.envcp sample.env .env
  3. 编辑 .env 填入实际的数据库、LLM 等配置
  4. 重新运行安装命令即可启动服务

注意:后续更新不会覆盖已有的 .env 文件,各环境配置独立维护。

配置项说明

配置项 说明 示例
PORT 服务监听端口,安装脚本会读取此值作为默认端口 8001
DATABASE_URL 数据库连接串。支持 MySQL 和达梦 DM8 mysql+pymysql://user:pwd@host:3306/db
JWT_SECRET JWT 认证密钥,请使用随机字符串 your-jwt-secret-key
JWT_EXPIRE_MINUTES JWT 过期时间(分钟) 1440(24小时)
DEFAULT_ADMIN_USERNAME 管理员用户名(首次启动自动创建) admin
DEFAULT_ADMIN_PASSWORD 管理员密码(首次启动自动创建) your-password
LLM_API_KEY 大模型 API 密钥 your-api-key
LLM_BASE_URL 大模型 API 地址 https://api.example.com/v1
LLM_MODEL 模型名称 qwen3.5-27b
CORS_ORIGINS 跨域允许的域名,多个用逗号分隔 https://your-domain.com
LOG_LEVEL 日志级别 INFO

参数说明

安装脚本支持的命令行参数

参数 全称 说明
-r --release 指定安装版本号(默认从 LATEST.md 自动获取)
-p --port 指定服务端口(默认从 .env 读取 PORT 变量,再默认 8001)
-d --dir 指定安装目录(默认 /opt/teachseek)
-k --kill-port 强制关闭占用端口的进程(默认不启用)
-F --force-config 强制覆盖 config 目录(保留 .env 不动)
-m --mode 部署模式:supervisor(默认)或 nohup
-V --version 显示脚本自身版本号
-n --dry-run 试运行模式,只打印执行步骤不实际操作
-h --help 显示帮助信息

环境要求

部署前请确认服务器满足以下条件

项目 要求 说明
操作系统 统信 UOS / CentOS 7+ / Ubuntu 20+ Linux x86_64
磁盘空间 500MB+ 程序文件 + 日志 + 备份
网络 需访问千问模型 API vLLM 内网或阿里云 API
权限 root(sudo) 安装脚本需 root 权限执行
数据库 MySQL 5.7+ 或 达梦 DM8 根据部署环境选择

安装流程

脚本自动执行以下步骤

  1. 前置检查:验证 root 权限、磁盘空间、curl 可用性
  2. 获取版本号:从 LATEST.md 自动获取最新版本(或使用 -r 指定)
  3. 下载部署包:从 Release 目录下载通用 tar.gz 包(3 次重试)
  4. 端口检测:从 .env 读取 PORT,检测占用情况(-k 可强制关闭)
  5. 停止旧服务:Supervisor 模式或 nohup 模式优雅关闭
  6. 备份当前安装:自动备份到 {目录}.bak.{时间戳}
  7. 安装文件:解压部署包,.env 不覆盖,conf 覆盖,sample.env 始终更新
  8. 启动服务:Supervisor(默认)或 nohup 模式
  9. 健康检查:8 次重试,失败自动回滚到备份