入门
快速开始指南
先安装客户端。选择出租算力或两者都要时，出租机需要先安装 Docker Desktop，再安装 WSL2
最后更新：2026 年 9 月 28 日
1. 客户端安装指南
- 本指南适用于 Windows 10 64 位和 Windows 11。打开本站「下载客户端」页，下载 Windows 桌面客户端 SuanliClient-Setup.exe，双击安装即可。安装程序使用当前用户安装，程序位于 %LOCALAPPDATA%\SuanliClient（一般是 C:\Users\你的用户名\AppData\Local\SuanliClient），里面已经带有主机 Agent。一般情况不要再单独下载 suanli-agent.exe。
- 安装完成后，从开始菜单打开「算力云享」。第一次启动会进入内置设置向导，依次完成登录、使用模式、工作区和网站地址。只有选择「出租算力」或「两者都要」时，向导才会多出主机绑定。
- 只选择「租用算力」的电脑，不需要安装 Docker Desktop，也不需要安装 WSL2。准备把本机显卡出租出去的电脑，必须先按后面的步骤安装 Docker Desktop，安装完成后再安装 WSL2。
2. 首次设置向导
- 登录：已有账号时，用邮箱或用户名和密码登录。还没有账号时，切换到「前往网站注册」，在浏览器里注册完成，再回到客户端登录。可以勾选「自动登录」。会话会加密保存在本机，下次启动不用再输入密码；密码本身不会写入配置文件。
- 使用模式有三个选项。「租用算力」用来选购远程 GPU、创建实例，并把结果同步到本地工作区。「出租算力」用来共享本机 GPU。「两者都要」表示同一台电脑既租用远程 GPU，也出租本机算力。
- 工作区请选一个不在 C 盘的目录，例如 D:\SuanliWorkspace。可用空间至少 10 GB。目录还不存在时，客户端会自动创建。选择「租用算力」或「两者都要」时，批任务和模型输出会同步到这个目录（包含 output/batch）。建议勾选「实例断线后自动尝试重连」和「开机自动启动客户端」。
- 网站地址填写 https://www.suanliyunxiang.com，平台 API 地址填写 https://api.suanliyunxiang.com。不要填写 localhost 或 127.0.0.1。
- 出租配置只在「出租算力」和「两者都要」时出现。填写主机显示名，例如「台式机-RTX4090」，然后点击「一键绑定主机」。运行方式选「托盘进程（推荐）」：只有当前 Windows 用户登录后才运行，关闭客户端就会下线。「系统服务」是高级选项，用于开机自动上线、崩溃后自动重启。
- 最后一页核对使用模式、工作区和地址，点击「完成并开始使用」。以后要修改模式、工作区或地址，打开客户端主面板的「设置」，再进入「客户端设置」，改完后点「保存设置」。
3. 出租机安装 Docker Desktop
- 只有使用模式选择「出租算力」或「两者都要」的那台 Windows 电脑需要本节。只租用远程 GPU 的电脑跳过本节和下一节。
- 先安装 NVIDIA 显卡驱动，Game Ready 或 Studio 都可以。装好后打开 PowerShell，执行 nvidia-smi。能列出本机显卡，再继续安装 Docker。
- 然后下载并安装 Docker Desktop for Windows，安装说明见 https://docs.docker.com/desktop/setup/install/windows-install/ 。安装向导如果询问后端，选择 WSL 2，不要选择 Hyper-V。
- Docker Desktop 安装结束以后先不要开始接单。下一步必须再安装 WSL2。没有 WSL2 时，Docker 引擎无法启动，客户端会提示 Docker 未安装或未启动。
4. 安装 WSL2 并启动 Docker
- Docker Desktop 安装完成后，用管理员身份打开 PowerShell，执行 wsl --install。这条命令会启用「适用于 Linux 的 Windows 子系统」和「虚拟机平台」，并安装默认的 Ubuntu。微软的安装说明见 https://learn.microsoft.com/zh-cn/windows/wsl/install 。
- 命令执行完成后重启电脑。重启后如果 Ubuntu 第一次打开，按提示设置 Linux 用户名和密码。
- 如果 Docker Desktop 提示需要 WSL2 内核更新，按弹窗中的链接安装微软的 WSL2 Linux 内核更新包，然后再打开一次 Docker Desktop。
- 打开 Docker Desktop，等到状态变为 Running。进入 Settings → Resources → WSL Integration，打开刚才安装的 Ubuntu。
- 回到 PowerShell，执行 docker version。Client 和 Server 都出现版本号，才说明引擎已经连上。如果提示无法连接引擎，在 Docker Desktop 中使用 Troubleshoot → Restart，并确认主板 BIOS 里已经打开虚拟化。
- 容器里要使用显卡时，在 WSL 的 Ubuntu 中安装 NVIDIA Container Toolkit，并确认 Docker Desktop 已打开该发行版的 WSL 集成。然后在 PowerShell 执行 docker run --rm --gpus all nvidia/cuda:12.2.0-base-ubuntu22.04 nvidia-smi。容器里能看到显卡后，这台机器才适合开始出租。
5. 绑定主机并开始接单
- Docker Desktop 显示 Running 之后，回到算力云享客户端，完成「一键绑定主机」。绑定成功后让客户端留在系统托盘里，主机才会持续向平台发送心跳并可以接单。
- 关闭客户端，或在「设置」里选择「退出登录并下线」，这台机器就不再接新单。向导里勾选了开机自动启动时，下次登录 Windows 会自动恢复托盘。
- 主机控制台长时间没有心跳时，先确认 Docker Desktop 仍是 Running，再确认客户端还在托盘中。桌面客户端已经包含 Agent。只有明确只要无界面程序时，才单独下载 suanli-agent.exe。
6. 安装完成后的使用方式
- 租用：用同一个账号打开网站，在钱包按当前已启用的支付渠道充值，再到 GPU 市场按显卡配置租用。实例就绪后，在实例详情页使用 SSH 或 Jupyter。任务输出会同步到向导里选择的工作区。
- 出租：保持托盘中的客户端在线。本机正在使用电脑时，可以在主机控制台调整共享策略。收益在主机控制台查看，达到提现条件后再申请提现。
- 两者都要：本机按出租机的要求安装 Docker Desktop 和 WSL2，并保持客户端在线；远程 GPU 仍从 GPU 市场租用。工作区继续放在非 C 盘目录。
7. 租用 GPU（5 步）
- 注册账户并选择「租用 GPU」，完成邮箱验证。
- 进入钱包，按页面当前已启用的支付渠道完成充值。
- 打开 GPU 市场，按型号、价格、显存筛选，点击「创建实例」。
- 选择当前已启用的环境模板、SLA 等级与预计时长（模板与框架版本以目录展示为准）。
- 实例就绪后，在详情页复制 SSH 或 Jupyter 链接开始开发。
8. 计费说明
- 计费模式：预付费按秒/分钟累计，价格以 GPU 市场公示的「元/小时」换算为每秒扣费。
- 创建实例时冻结约 1 小时预估费用；运行中每分钟从余额扣减，不足时实例自动停止。
- 停止后未释放工作区的实例在 24 小时内仍可能占用存储相关资源，恢复继续计费。
- 充值金额不可提现，消费明细可在「账户 → 交易记录」导出；企业用户可申请增值税发票。
- 出租方收益按订单分成结算，提现门槛与手续费见主机控制台说明。
9. 环境模板
- 创建实例时从「当前已启用」的模板目录中选择；名称、框架、CUDA/驱动与显存要求以模板详情为准，库存与版本会随运营变更。
- 常见入口含 CUDA 开发机等基础镜像，可在实例内自行 pip/apt 安装 PyTorch、TensorFlow 等；勿默认每个框架都有固定版本的官方专用镜像。
- 自定义依赖可在启动后安装，或走自定义镜像申请/审核链路（若已开放）；长期复现实验请自行记录实际镜像 digest 或锁定 Dockerfile。
10. 出租 GPU（概要）
- Windows 出租机请先完成本页「客户端安装指南」：安装桌面客户端后，再安装 Docker Desktop，然后安装 WSL2。只租用远程 GPU 不需要这两项。
- 注册为出租方，在「注册主机」获取 host_key，在物理机安装 Agent 并配置 GPU 共享策略。
- 办公模式：本地键鼠活跃时自动让出 GPU；均衡/激进模式提高利用率但可能影响本地体验。
- 收益按成功订单结算，主机离线期间不接新单，已有 protected/critical 订单可能触发迁移出您的机器。