windows本地部署AgentDesk下面给你一套适合小白的“Windows 本地运行 AgentDesk 远程服务器 Docker 运行 Qdrant”的完整流程。我建议采用这个结构你的 Windows 电脑 ├─ AgentDesk 后端Go8083 ├─ AgentDesk 前端Next.js3000 ├─ SQLite 数据库本机 data/app.db └─ 连接远程 Qdrant服务器:6334 远程 Linux 服务器 └─ Docker 中运行 Qdrant1、准备 Windows 本地环境打开 PowerShell逐项检查git--version go version node-v pnpm-v你需要满足Git任意较新版本Go1.26 或更高Node.js20 或更高pnpm已安装如果 pnpm -v 报错先执行corepack enable corepack prepare pnpmlatest--activate如果上述命令也不可用可以安装 pnpmnpm install-g pnpm然后重新打开 PowerShell再执行pnpm-v安装Go官网下载地址如下https://go.dev/dl/找到 Windows 对应的安装包下载类似 go1.xx.x.windows-amd64.msi 的文件。amd64适用于大多数 Intel、AMD 64 位电脑。arm64适用于 ARM 架构的 Windows 电脑。双击下载的 .msi 文件。按照安装向导操作保持默认配置即可。然后重新打开 PowerShell再执行如下指令2、准备远程服务器上的 Qdrant以下假设远程服务器是 Linux并且已经安装 Docker。先登录服务器确认 Docker 可用docker version如果能显示 Client / Server 信息说明 Docker 正常。1. 创建 Qdrant 持久化存储卷cd/data_4/googosoft_file/AAA_agent/docker volume create qdrant-storage这一步很重要Qdrant 的知识向量会存到这个 Volume 中。没有它删除并重建容器后可能丢失知识库向量。查看卷的详细信息docker volume inspect qdrant-storage输出如下2. 生成并保存一个 API Key在服务器上执行openssl rand-base6448# XgrPnZzZK6lcozGO3rK63zn5Ox5sl6Oq0YxtefB7/tWAV2Hq0gS0PyTwEhCVS0/5复制输出的一整段内容保存到密码管理器。下面用它替代 你的高强度密钥。3. 启动 Qdrant如果你通过公司内网、WireGuard、Tailscale 等 VPN 连接服务器可以先使用下面这个较易操作的方案docker run-d \--name qdrant \--restart unless-stopped \-p127.0.0.1:6333:6333\-p6334:6334\-v qdrant-storage:/qdrant/storage \-e QDRANT__SERVICE__API_KEY你的高强度密钥\ qdrant/qdrant:固定版本号请把 固定版本号 换成你准备使用的具体版本例如 v1.17.0不要长期使用 latest。具体docker run-d \--name qdrant \--restart unless-stopped \-p127.0.0.1:6333:6333\-p6334:6334\-v qdrant-storage:/qdrant/storage \-e QDRANT__SERVICE__API_KEYXgrPnZzZK6lcozGO3rK63zn5Ox5sl6Oq0YxtefB7/tWAV2Hq0gS0PyTwEhCVS0/5\ qdrant/qdrant:v1.17.0或者docker run-d \--name qdrant \--restart unless-stopped \-p127.0.0.1:6333:6333\-p6334:6334\-v/data_4/googosoft_file/AAA_agent/qdrant-storage:/qdrant/storage \-e QDRANT__SERVICE__API_KEY你的真实API密钥\ qdrant/qdrant:v1.17.0参数含义6334AgentDesk 实际连接的 Qdrant gRPC 端口。127.0.0.1:6333:6333REST/API/Web UI 只允许在服务器本机访问不暴露到公网。qdrant-storageQdrant 持久化数据卷。QDRANT__SERVICE__API_KEY要求所有请求携带密钥。–restart unless-stopped服务器重启后自动恢复。检查容器docker ps在服务器本机验证 REST 服务和 API Keycurl-Hapi-key: 你的高强度密钥http://127.0.0.1:6333/collections# 例如curl -H api-key: XgrPnZzZK6lcozGO3rK63zn5Ox5sl6Oq0YxtefB7/tWAV2Hq0gS0PyTwEhCVS0/5 http://127.0.0.1:6333/collections正常时会返回 JSON而不是 Unauthorized 或连接失败。3、处理远程访问安全3、下载并配置 Windows 本地项目进入项目目录Set-Location E:\googosoft\agent-desk-main先检查配置文件是否已存在Test-Path.\config\config.yaml如果输出 False复制模板Copy-Item.\config\config.example copy.yaml.\config\config.yaml然后用 VS Code 或记事本打开code.\config\config.yaml找到并修改 vectorDB 部分。VPN / 内网 Qdrant 配置示例vectorDB:type:qdrant qdrant:host:10.10.10.20grpcPort:6334apiKey:填写你刚才保存的 API KeyuseTls:false把 10.10.10.20 换成远程 Qdrant 服务器的内网或 VPN IP。公网 TLS Qdrant 配置示例vectorDB:type:qdrant qdrant:host:qdrant.example.com grpcPort:6334apiKey:填写你刚才保存的 API KeyuseTls:true这里建议使用域名和受 Windows 信任的 TLS 证书。项目当前只暴露 useTls 开关并没有提供单独配置自签名证书 CA 文件的位置初次部署不建议使用自签名证书。同时确认本地 SQLite 保持如下设置即可db:type:sqlite dsn:file:./data/app.db?_busy_timeout5000这样本地会自动创建data/app.db data/storage/4、先测试 Windows 到 Qdrant 的网络在 Windows PowerShell 中执行Test-NetConnection10.10.10.20-Port6334把 IP 换成实际 Qdrant 地址。如果是 False先不要启动 AgentDesk优先检查host 是否正确Docker 容器是否运行远程服务器是否开放 6334云安全组是否允许访问VPN 是否已连接Windows 是否被公司网络策略限制出站连接。5、安装前端依赖仍在项目根目录时执行Set-Location.\web pnpm install首次安装会比较久。成功后应出现 node_modules且命令正常结束。然后返回项目根目录Set-Location..6、启动后端在第一个 PowerShell 窗口中确保当前目录是项目根目录Set-Location E:\googosoft\agent-desk-main执行go run-tags dev./cmd/server看到类似“服务启动于 8083 端口”的日志后不要关闭此窗口。浏览器访问http://127.0.0.1:8083/api/health
windows本地部署AgentDesk下面给你一套适合小白的“Windows 本地运行 AgentDesk 远程服务器 Docker 运行 Qdrant”的完整流程。我建议采用这个结构你的 Windows 电脑 ├─ AgentDesk 后端Go8083 ├─ AgentDesk 前端Next.js3000 ├─ SQLite 数据库本机 data/app.db └─ 连接远程 Qdrant服务器:6334 远程 Linux 服务器 └─ Docker 中运行 Qdrant1、准备 Windows 本地环境打开 PowerShell逐项检查git--version go version node-v pnpm-v你需要满足Git任意较新版本Go1.26 或更高Node.js20 或更高pnpm已安装如果 pnpm -v 报错先执行corepack enable corepack prepare pnpmlatest--activate如果上述命令也不可用可以安装 pnpmnpm install-g pnpm然后重新打开 PowerShell再执行pnpm-v安装Go官网下载地址如下https://go.dev/dl/找到 Windows 对应的安装包下载类似 go1.xx.x.windows-amd64.msi 的文件。amd64适用于大多数 Intel、AMD 64 位电脑。arm64适用于 ARM 架构的 Windows 电脑。双击下载的 .msi 文件。按照安装向导操作保持默认配置即可。然后重新打开 PowerShell再执行如下指令2、准备远程服务器上的 Qdrant以下假设远程服务器是 Linux并且已经安装 Docker。先登录服务器确认 Docker 可用docker version如果能显示 Client / Server 信息说明 Docker 正常。1. 创建 Qdrant 持久化存储卷cd/data_4/googosoft_file/AAA_agent/docker volume create qdrant-storage这一步很重要Qdrant 的知识向量会存到这个 Volume 中。没有它删除并重建容器后可能丢失知识库向量。查看卷的详细信息docker volume inspect qdrant-storage输出如下2. 生成并保存一个 API Key在服务器上执行openssl rand-base6448# XgrPnZzZK6lcozGO3rK63zn5Ox5sl6Oq0YxtefB7/tWAV2Hq0gS0PyTwEhCVS0/5复制输出的一整段内容保存到密码管理器。下面用它替代 你的高强度密钥。3. 启动 Qdrant如果你通过公司内网、WireGuard、Tailscale 等 VPN 连接服务器可以先使用下面这个较易操作的方案docker run-d \--name qdrant \--restart unless-stopped \-p127.0.0.1:6333:6333\-p6334:6334\-v qdrant-storage:/qdrant/storage \-e QDRANT__SERVICE__API_KEY你的高强度密钥\ qdrant/qdrant:固定版本号请把 固定版本号 换成你准备使用的具体版本例如 v1.17.0不要长期使用 latest。具体docker run-d \--name qdrant \--restart unless-stopped \-p127.0.0.1:6333:6333\-p6334:6334\-v qdrant-storage:/qdrant/storage \-e QDRANT__SERVICE__API_KEYXgrPnZzZK6lcozGO3rK63zn5Ox5sl6Oq0YxtefB7/tWAV2Hq0gS0PyTwEhCVS0/5\ qdrant/qdrant:v1.17.0或者docker run-d \--name qdrant \--restart unless-stopped \-p127.0.0.1:6333:6333\-p6334:6334\-v/data_4/googosoft_file/AAA_agent/qdrant-storage:/qdrant/storage \-e QDRANT__SERVICE__API_KEY你的真实API密钥\ qdrant/qdrant:v1.17.0参数含义6334AgentDesk 实际连接的 Qdrant gRPC 端口。127.0.0.1:6333:6333REST/API/Web UI 只允许在服务器本机访问不暴露到公网。qdrant-storageQdrant 持久化数据卷。QDRANT__SERVICE__API_KEY要求所有请求携带密钥。–restart unless-stopped服务器重启后自动恢复。检查容器docker ps在服务器本机验证 REST 服务和 API Keycurl-Hapi-key: 你的高强度密钥http://127.0.0.1:6333/collections# 例如curl -H api-key: XgrPnZzZK6lcozGO3rK63zn5Ox5sl6Oq0YxtefB7/tWAV2Hq0gS0PyTwEhCVS0/5 http://127.0.0.1:6333/collections正常时会返回 JSON而不是 Unauthorized 或连接失败。3、处理远程访问安全3、下载并配置 Windows 本地项目进入项目目录Set-Location E:\googosoft\agent-desk-main先检查配置文件是否已存在Test-Path.\config\config.yaml如果输出 False复制模板Copy-Item.\config\config.example copy.yaml.\config\config.yaml然后用 VS Code 或记事本打开code.\config\config.yaml找到并修改 vectorDB 部分。VPN / 内网 Qdrant 配置示例vectorDB:type:qdrant qdrant:host:10.10.10.20grpcPort:6334apiKey:填写你刚才保存的 API KeyuseTls:false把 10.10.10.20 换成远程 Qdrant 服务器的内网或 VPN IP。公网 TLS Qdrant 配置示例vectorDB:type:qdrant qdrant:host:qdrant.example.com grpcPort:6334apiKey:填写你刚才保存的 API KeyuseTls:true这里建议使用域名和受 Windows 信任的 TLS 证书。项目当前只暴露 useTls 开关并没有提供单独配置自签名证书 CA 文件的位置初次部署不建议使用自签名证书。同时确认本地 SQLite 保持如下设置即可db:type:sqlite dsn:file:./data/app.db?_busy_timeout5000这样本地会自动创建data/app.db data/storage/4、先测试 Windows 到 Qdrant 的网络在 Windows PowerShell 中执行Test-NetConnection10.10.10.20-Port6334把 IP 换成实际 Qdrant 地址。如果是 False先不要启动 AgentDesk优先检查host 是否正确Docker 容器是否运行远程服务器是否开放 6334云安全组是否允许访问VPN 是否已连接Windows 是否被公司网络策略限制出站连接。5、安装前端依赖仍在项目根目录时执行Set-Location.\web pnpm install首次安装会比较久。成功后应出现 node_modules且命令正常结束。然后返回项目根目录Set-Location..6、启动后端在第一个 PowerShell 窗口中确保当前目录是项目根目录Set-Location E:\googosoft\agent-desk-main执行go run-tags dev./cmd/server看到类似“服务启动于 8083 端口”的日志后不要关闭此窗口。浏览器访问http://127.0.0.1:8083/api/health
