更新时间：2026-08-21 11:55:33 | 阅读：51 | 收藏：0 收藏 # Windows 安装指南 > **读者**：已从产品页下载 `go-ai-platform-setup.exe` 的客户或客户侧运维。 > **不包含**：如何从源码编译、打安装包、上传发版——那些是厂商交付流程。 ## 你需要准备什么 | 项目 | 说明 | |------|------| | 系统 | Windows 10/11 或 Server 2019+（64 位） | | 硬件建议 | 4 核 / 8 GB 内存 / 系统盘 40 GB+ | | 安装包 | 产品页提供的 `go-ai-platform-setup.exe` | | 权限 | 建议以**管理员**运行安装向导 | | 网络 | 本机回环即可验收；对外访问需放行 **8080**（或你反代的 HTTPS 端口） | 安装程序可按向导选择：复用本机已有 PostgreSQL / Redis，或由向导下载安装 PostgreSQL，并自动准备 Redis（若本机没有可用实例）。 默认不会安装 Docker、MinIO；素材默认落在本机磁盘目录。 ## 安装步骤 1. 从产品页下载并运行 `go-ai-platform-setup.exe`。 2. 选择安装目录（默认 `D:\go-ai`）。 3. 按提示填写： - **PostgreSQL 密码**（新建或已有实例） - **管理端管理员密码**（至少 12 位，用于登录 `/admin/`） - **Client 密钥**（至少 16 位，安装程序会写入配置） 4. 等待向导完成解压与初始化（建库、迁移、注册 Windows 服务）。 5. 浏览器打开验收地址： - 健康检查：`http://127.0.0.1:8080/health` - C 端：`http://127.0.0.1:8080/` - 管理端：`http://127.0.0.1:8080/admin/` 静默安装示例（由运维编排时使用）： ```text go-ai-platform-setup.exe /VERYSILENT /DIR="D:\go-ai" /PGPASSWORD=... /ADMINPASSWORD=... /CLIENTSECRET=... ``` 可选 `/PGMODE=download`：本机无 PostgreSQL 时由向导下载安装。 ## 安装后如何启停 安装成功后一般已注册并启动服务 `go-ai-server`、`go-ai-client`。 | 方式 | 操作 | |------|------| | 服务（推荐） | 双击安装根下 `start-services.cmd` / `stop-services.cmd`，或在「服务」里管理 `go-ai-server` / `go-ai-client` | | 前台排障 | 双击 `start-foreground.cmd`，各开一个窗口看实时日志；关掉窗口即停 | 常用日志位置： - 安装过程：`D:\go-ai\install.ps1.log`（路径以你选的安装根为准） - 服务输出：`D:\go-ai\service.out.log`、`service.err.log`（client 在 `D:\go-ai\client\` 下同名文件） 若向导显示完成但服务未起来：在安装根执行 `finish-install.cmd`（或 `_bundle\scripts\finish-install.cmd`），再查看上述日志。 ## 首次登录后建议做的事 1. 使用安装时设置的管理员账号登录 `/admin/`。 2. 在系统设置中确认产品名、Logo 等品牌信息（若已采购 OEM）。 3. 录入 **Provider** 与模型（密钥只保存在你方管理端，不要发给第三方）。 4. 按商务约定完成**授权激活**（见《授权激活说明》）。 5. 用 C 端跑一条最小任务，确认 client 在线、任务能完成。 ## 防火墙与安全 - 对外只暴露业务入口（通常经 HTTPS 反代到 8080）。 - **不要**把 `5432`（PostgreSQL）、`6379`（Redis）、以及路径 `/internal/*` 暴露到公网。 ## 卸载 - 使用 Windows「应用和功能」卸载本产品：会停止并移除 go-ai 服务，并删除安装目录（以安装器行为为准）。 - **不会**自动删除你本机原有的 PostgreSQL / Redis 系统服务，也**不会**自动 `DROP` 业务库；若需清库请自行在数据库中处理。 ## 常见问题 | 现象 | 处理 | |------|------| | 打不开页面 | 确认服务已启动；本机访问 `8080`；查 `service.err.log` | | 管理端进不去 | 核对安装时的管理员密码；确认地址为 `/admin/` | | 有界面但任务不跑 | 管理端查看 client 是否在线；核对 Client 密钥是否被改乱 | | 图片打不开 | 确认服务在跑且本机磁盘素材目录可写（默认 filesystem 存储） | | 安装半途失败 | 看 `install.ps1.log`；修好依赖后运行 `finish-install.cmd` | 下一步： - [首次配置指南](/doc-2) - [授权激活说明](/doc-7) - [运维、升级、备份与恢复手册](/doc-5) 评论区
