下载
客户端装进你每天用的电脑，服务端装上你的服务器；填入服务器地址，指引按它逐字定制——从下载到第一名数字员工上岗，一个下午。
客户端出厂不带任何内置配置；首次启动时，把这个地址填进服务器地址栏即可连上。
先填上面的服务器地址，下面的指引会替换成专属于你的那一台。
在服务器上安装服务端
一条命令装上单文件 magicfrog-server，无需容器与额外依赖。
curl -fsSL https://www.magicfrog.ai/install-server | bash下载客户端
客户端装在你日常工作的那台电脑上，与 CLI 同一安装脚本。
curl -fsSL https://www.magicfrog.ai/install | bash首次启动填服务器地址
客户端不带任何内置配置；首次启动，把这个地址填进服务器地址栏即连。
让 agent 替你部署
把提示词发给你的 agent，它会按部署文档把服务端装好。
Deploy a MagicFrog server for me. 1. Fetch the deploy skill document at https://www.magicfrog.ai/agent-deploy/ (raw markdown at https://www.magicfrog.ai/agent-deploy.md). 2. Follow it exactly: install the single-file magicfrog-server, export the required environment, start it on port 4096, and finish the admin bootstrap and forced password change. 3. SSH connection details for the target server are provided by me: <fill in: host, port, user, key or password> 4. Stop and report back if any step fails; never substitute an undocumented command or skip a required environment variable. 5. When you finish, report the server URL (default http://localhost:4096) and the admin identifier so I can connect my client with --server <serverUrl>.
填入地址后，提示词会自动带上你的那台服务器地址。
六平台客户端产物
覆盖 Linux、macOS 与 Windows，x64 与 arm64 双架构。
六平台客户端产物
| 平台 | 架构 | 产物坐标 |
|---|---|---|
| Linux x64 | x64 | cli-linux-x64-${VERSION}.tgz |
| Linux arm64 | arm64 | cli-linux-arm64-${VERSION}.tgz |
| macOS x64 | x64 | cli-darwin-x64-${VERSION}.tgz |
| macOS arm64 | arm64 | cli-darwin-arm64-${VERSION}.tgz |
| Windows x64 | x64 | cli-windows-x64-${VERSION}.tgz |
| Windows arm64 | arm64 | cli-windows-arm64-${VERSION}.tgz |
| 版本元数据 | https://${download_base_url}/latest.json |
桌面客户端产物
Windows 安装器与 Linux 三种包，双击安装或交给包管理器。
| 平台 | 架构 | 产物坐标 |
|---|---|---|
| Windows x64 | x64 | magicfrog-desktop-win-x64.exe |
| Linux x64 (AppImage) | x64 | magicfrog-desktop-linux-x86_64.AppImage |
| Linux x64 (deb) | x64 | magicfrog-desktop-linux-amd64.deb |
| Linux x64 (rpm) | x64 | magicfrog-desktop-linux-x86_64.rpm |
| 版本元数据 | https://${download_base_url}/latest-desktop.json |
按你的平台选产物坐标；对象键与版本号以版本元数据为准。
部署前清单
五分钟过一遍，少踩一半的坑。
- 1
一台能跑 Linux 的 VPS 或你自己的服务器——单文件服务端，无需容器
- 2
生成字段加密密钥：openssl rand -hex 32，随数据目录一起备份
- 3
四个必需环境变量齐备：连接密码、管理员账号、初始密码、字段密钥
- 4
首启改密完成前，业务端点全部拒绝——改完再分发客户端
- 5
安装包未签名属合法交付，按 SHA-256 与字节大小校验即可
清单五条对应五个最常见的安装失败原因。照着核对，第一次部署通常一次过。
下载与安装，四个常见问题
安装包为什么没有签名？
未签名产物属于合法交付，系统提示不是产品故障；每个产物都带 SHA-256 与字节大小校验，下载后核对摘要即可。
Windows 上怎么运行安装命令？
在 Git Bash（MSYS）里运行，安装脚本会检测 MSYS/Cygwin 环境；客户端与服务端同一脚本。
服务器和客户端必须在同一台机器吗？
不必。异机是标准场景：服务端默认监听 0.0.0.0 就是为了跨设备可达，客户端填入服务器地址即可连。
版本升级怎么处理？
对象键与版本号以版本元数据（latest.json）为准；数据目录与 SQLite 文件升级时原样保留，先备份再升级。