通用安装命令

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

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

一行命令更新

curl -fsSL https://ai.seek.ninglon.com/install.sh | sudo bash -s -- -k

-k 参数自动关闭端口占用进程、备份当前版本（含 conf/ 配置）、下载最新版、重启服务并健康检查（失败自动回滚，含 conf/ 一并恢复）。.env 不被覆盖。默认不覆盖 conf/ 目录。

强制覆盖配置更新（-F）

curl -fsSL https://ai.seek.ninglon.com/install.sh | sudo bash -s -- -p 8001 -d /opt/teachseek -k -F

-F 参数强制覆盖 conf/ 配置目录（用新版系统配置替换旧配置）。旧 conf 已在备份中保留，可通过 rollback.sh 回滚恢复。.env 不受影响。适用于：新版系统配置变更需要同步到服务器时。

生产环境部署（宝塔 Supervisor）

# Deploy1（端口 16524）
curl -fsSL https://ai.seek.ninglon.com/install.sh | sudo bash -s -- -p 16524 -d /opt/teachseek -k -F

# Deploy2（端口 3000）
curl -fsSL https://ai.seek.ninglon.com/install.sh | sudo bash -s -- -p 3000 -d /opt/teachseek2 -k -F

生产环境 Deploy1 和 Deploy2 均使用宝塔 Supervisor 模式（默认）。-k 强制关闭端口占用，-F 强制同步新版 conf/ 配置。首次安装时需先配置 .env 后重新运行。无外网时使用离线安装（见下方）。

离线安装（内网/无外网环境）

当服务器无法访问 Release 服务器（ai.seek.ninglon.com）时，可将安装包和脚本手动复制到服务器进行离线安装。安装包不会被删除，可重复使用。

1. 在有外网的机器上下载安装包和脚本：
   复制

   # 下载安装包
   curl -O https://ai.seek.ninglon.com/release/teachseek-v8.0.4-0829-0133.tar.gz
   
   # 下载安装脚本
   curl -O https://ai.seek.ninglon.com/install.sh

2. 将两个文件复制到目标服务器（U盘、scp、宝塔面板上传等方式）
3. 在目标服务器上执行离线安装：
   复制

   # 生产环境 Deploy1（端口 16524）— 替代在线 curl 命令
   sudo bash install.sh -f teachseek-v8.0.4-0829-0133.tar.gz -p 16524 -d /opt/teachseek -k -F
   
   # 生产环境 Deploy2（端口 3000）— 替代在线 curl 命令
   sudo bash install.sh -f teachseek-v8.0.4-0829-0133.tar.gz -p 3000 -d /opt/teachseek2 -k -F
   
   # 基本离线安装（默认端口 8001）
   sudo bash install.sh -f teachseek-v8.0.4-0829-0133.tar.gz

-f / --file 参数指定本地 tarball 路径，脚本会自动从文件名提取版本号，跳过在线下载，解压后安装。安装包不会被删除，可重复用于安装或回滚。首次安装后需编辑 .env 配置文件，然后重新运行安装命令启动服务。

指定版本安装

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

指定端口和安装目录

curl -fsSL https://ai.seek.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 -- -s r1

使用 -s 参数指定 Release 服务器：r1（Release1）、r2（Release2）、auto（默认，优先 Release2，故障切换到 Release1）。

试运行（不实际执行）

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

安装反馈接收服务

curl -fsSL https://ai.seek.ninglon.com/install.sh | sudo bash -s -- -p 8881 -d /opt/teachseek_feedback

安装后编辑 .env 配置 FEEDBACK_RECEIVER_USERNAME 和 FEEDBACK_RECEIVER_PASSWORD，然后以反馈模式启动：

./teachseek --feedback-only --port 8881

反馈接收服务提供：免认证提交端点（POST /api/feedback/submit）+ 密码登录查看页面（GET /）。CORS 全开，支持跨域提交。