DeployPilot

DeployPilot 是一款通过 SSH 部署和管理远程 Linux 服务器服务的桌面工具。Windows 用户可以直接下载完整离线版，解压后双击 DeployPilot.exe 使用，无需安装 Python。

下载即用

下载最新版 DeployPilot.zip · 查看 Release 版本与发布说明

完整离线版约 1.40 GB，已包含 Windows 桌面程序、运行依赖，以及部署所需的 Docker 和服务离线资源。

1. 下载 Release 附件中的 DeployPilot.zip。
2. 将压缩包完整解压到本机目录。
3. 打开解压后的 DeployPilot 文件夹，双击 DeployPilot.exe。
4. 阅读首次启动的使用说明，点击「同意并使用」，填写目标服务器的 SSH 连接信息。

DeployPilot/
├── DeployPilot.exe       ← 双击启动
├── _internal/            ← 程序依赖与离线资源，请完整保留
└── 使用说明.txt

请保留整个 DeployPilot 文件夹，不要单独移动 EXE，也不要直接在压缩包中运行。GitHub 自动生成的 Source code (zip) 和 Source code (tar.gz) 是源码；直接使用请下载上方的 DeployPilot.zip。

离线部署仍需要本机能通过 SSH 连接目标服务器。首次连接时，请核对服务器的主机密钥指纹。

功能介绍

• 服务器连接：测试连接、确认主机指纹、建立和断开 SSH 会话。
• 离线部署：Docker、MariaDB、Redis、Nginx、Elasticsearch + Kibana、Milvus、Qdrant、RabbitMQ。
• 服务操作：查看服务状态、版本、端口、数据路径与连接信息，执行启动、停止和重启。
• 本地记录：服务快照保存在本机 SQLite；桌面端保存的连接凭据使用 Windows 凭据管理器。
• 部署保护：安装前检查依赖、端口和已有服务，保留已有实例的配置与数据。

Milvus 整套部署包含 Milvus、Etcd、MinIO 和 Attu；Elasticsearch 与 Kibana 作为一套安装。

使用步骤与环境要求

桌面程序在 Windows 上运行，无需安装 Python、uv 或本机 Docker。离线镜像面向 Linux x86_64 / amd64 目标服务器。

目标服务器需要 SSH、systemd、bash、flock、timeout 和 xz 等基础工具；安装时使用 root 或具有免密 sudo 权限的账号。缺失依赖会在安装前提示，不会自动联网下载补齐。

1. 在「服务器连接」中填写主机、SSH 端口、用户名和密码，确认连接。
2. 在「服务部署」中安装 Docker，再选择需要的服务进行部署。
3. 在「服务操作」中查看安装结果、访问地址、账号信息及服务状态。

新部署的服务数据与配置默认位于服务器的 /data/deploypilot/ 下。离线包包含部分服务的初始账号配置，部署后请按实际用途修改默认密码并限制服务端口的访问范围。

更多连接、部署、配置和接口说明见 详细使用说明。

校验下载文件

每个 Release 提供 SHA256SUMS.txt。在下载目录运行以下 PowerShell 命令，将输出与该文件中的 SHA256 对比：

Get-FileHash -Algorithm SHA256 .\DeployPilot.zip

从源码运行

需要 Python 3.11+ 和 uv，在项目根目录执行：

uv sync
uv run python desktop.py

桌面端会按需启动配套的本地后端。也可单独运行：

uv run python main.py

本地后端接口文档：http://127.0.0.1:8000/docs。

大型离线镜像不放入 Git 源码仓库。需要从源码执行离线部署或构建完整离线版时，下载同版本 Release 的 DeployPilot.zip，将解压后 DeployPilot/_internal/app/resources/ 中的 .tar.xz 归档按原目录复制到源码的 app/resources/。保留源码中的脚本和配置，无需解压这些镜像归档。

Windows 打包

先按上文准备同版本离线资源，再在项目根目录执行：

& .\tools\build_exe.ps1

输出为 dist/DeployPilot/DeployPilot.exe。分发时打包整个 dist/DeployPilot 文件夹。

可使用已有的发布工具生成完整包、轻量主程序和按需资源包：

uv run python tools/package_release.py dist/DeployPilot releases/local-build

本项目首个 GitHub Release 提供的 DeployPilot.zip 为完整离线版，直接下载即可使用。

项目结构

app/desktop/       桌面界面、本地后端管理与 API 客户端
app/api/           接口路由与请求模型
app/services/      SSH 会话、部署和服务操作
app/dao/           本地服务缓存
app/resources/     部署脚本、配置与资源目录
docs/usage.md      详细使用说明
packaging/         分发包内的使用说明
tests/             自动化测试与验收工具
tools/             构建、打包和验证工具
desktop.py         桌面入口
main.py            后端入口

贡献

欢迎提交 Issue 和 Pull Request，参与方式与本地验证说明见 CONTRIBUTING.md。

许可证

本项目原创源码采用 MIT License。分发包中的第三方运行库与离线镜像分别遵循各自的许可证，相关许可不会因本项目的 MIT 许可而改变。