部署指南
行业智体支持通过可视化客户端向 Linux 服务器自动部署。部署工具会通过 SSH 连接服务器，自动完成环境检查、授权校验、镜像上传、服务配置、容器启动和 HTTPS 证书配置，整个过程不需要用户手动输入服务器命令。
部署前准备
一台可通过 SSH 访问的 Ubuntu / Debian 系 Linux 服务器，建议使用 root 或具备 sudo 权限的账号
最低 2 核 CPU、2 GB 内存、5 GB 可用磁盘；建议 4 核以上、4 GB 以上内存、10 GB 以上可用磁盘
服务器 80、443 端口在首次部署时应保持空闲；如使用域名，请先将域名解析到服务器公网 IP
准备好安装包、Docker 镜像 tar 文件和 license.key 授权文件
Docker 和 Docker Compose 如未安装，部署向导会自动安装；用量较高时按并发容器数扩容
部署流程
启动 Windows 部署客户端
打开行业智体部署工具，填写服务器 IP、SSH 端口、账号和密码或密钥。客户端会建立 SSH 连接，不需要手动登录服务器执行命令。
获取并校验机器码
客户端会读取服务器机器信息并生成机器码。使用该机器码在获取 License 页面领取或购买授权，再在客户端中选择 license.key 文件完成校验。
执行服务器预检
部署工具会检查 CPU、内存、磁盘、系统架构、Docker、Docker Compose、GPU、80/443 端口占用和已有安装目录，并给出推荐实例数。
上传镜像并写入配置
选择包含应用服务和调度服务的 Docker 镜像 tar 文件。工具会先校验镜像内容，再上传到服务器，并写入 License、服务配置、访问域名和运行实例数。
自动安装并启动服务
工具会自动安装或补齐 Docker、Docker Compose 和可选的本地模型运行环境，加载镜像，启动数据库、知识库、应用服务、调度器和网关服务。
域名与 HTTPS
如果部署时填写域名，部署工具会按该域名生成网关配置，并在服务器上申请 Let's Encrypt 证书。请确保域名已经解析到服务器公网 IP，且 80 端口可以从公网访问。证书申请成功后，工具会安装自动续期任务，每天定时检查证书状态。
扩容与维护
已部署服务器可以通过同一客户端调整应用实例数。扩容时工具会读取当前服务状态，按目标实例数平滑启动更多应用容器，并重新加载网关服务。扩容前请确保 License 已覆盖目标并发容器数。
常见排查
- SSH 连接失败：检查服务器 IP、端口、账号、密码或密钥，以及服务器安全组是否放行 SSH 端口。
- 证书申请失败：检查域名解析、80 端口、防火墙和是否有其他程序占用端口。
- 镜像校验失败：请确认 tar 文件同时包含应用服务镜像和调度服务镜像。
- 系统依赖安装失败：确认服务器为 Ubuntu / Debian 系统，且可以访问系统软件源。
- 实例数过高：按照预检结果降低实例数，或升级服务器 CPU、内存和 GPU 资源。