部署与获取
支持 Windows 安装包、容器镜像与 macOS / Linux 发布包,均在您自有的环境中运行
下载 TrueAGT
提供两种方式:手动下载官方发布包(Windows 安装包 / Linux 发布包;macOS 版本待上线)自行安装;已安装用户也可通过软件的「设置 → 关于 → 检查更新」自动升级(客户端从官方升级源自动拉取并校验安装包)。
环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 及以上、主流 Linux 发行版(x86_64 / ARM64);macOS 版本规划中,当前待上线 |
| 运行时 | 随发布包内置运行时,无需另行安装 |
| 内存 | 建议 2 GB 及以上(实际需求随并发会话数与模型端点而变化) |
| 存储 | 建议 10 GB 及以上可用空间,用于会话数据与每日备份 |
| 网络 | 需可访问所配置的模型服务端点;内网离线场景可对接本地模型服务 |
| 默认端口 | 8765(可通过配置调整) |
方式一:Windows 安装包
运行安装程序并跟随向导完成安装,内置运行时,无需预先安装 Python;桌面快捷方式即可启动,浏览器会自动打开控制台。
如需以自定义配置或参数启动,在命令行执行:
TrueAGT.exe --config config.json # 以指定配置文件启动
TrueAGT.exe --host 0.0.0.0 --port 8765 # 覆盖监听地址与端口
TrueAGT.exe --demo # 无模型环境先体验离线演示
需以 Windows 服务形态常驻时,使用发布包内的 deploy/install_service.bat。
方式二:Docker 容器
docker run -d --name trueagt -p 8765:8765 -v ./data:/app/data trueagt
容器镜像随发布包提供。生产部署建议将配置文件与数据目录挂载到宿主,并通过反向代理启用 HTTPS。
方式三:macOS / Linux 发布包
macOS 版本计划支持,当前待上线,尚未发布签名 / 公证的安装包;Linux 提供 AppImage(单文件、免安装)以及 .deb / .rpm 包,均可按发布包内提供的服务模板以常驻服务方式运行(systemd)。
生产环境建议
- 通过反向代理配置正式 HTTPS 证书,避免直接暴露服务端口。
- 配置每日自动备份并定期验证可恢复性;密钥文件需单独妥善保管。
- 启用 Prometheus 指标采集与告警通知,监控磁盘、内存与错误率。
- 按最小权限原则分配账号角色,敏感操作保持审计留痕。
- 面向公众提供服务前,完成相应的备案与安全评估程序(详见 合规说明)。
完整步骤参见 。