Grok bot平替开源项目部署指南，可接任意模型

Grok bot平替开源项目部署指南，可接任意模型

想找个能自己干活的 AI 助手，又不想被单一平台的订阅和模型绑死？开源的 Rakazo 是个很能打的平替方案。它最大的特点是自带云端电脑（Docker 沙盒） ，而且不挑模型 ------不管你是接 OpenAI、Anthropic、OpenRouter 的 API，还是直接用现成的 ChatGPT Plus/Pro 账号授权白嫖 Codex 额度，都能跑起来。部署好之后，网页、Windows 桌面端、手机 App 全平台互通，还能拉 AI 群聊、设每日定时任务。这篇教程面向第一次买云服务器、第一次用 SSH 的 Windows 用户。不用懂太多 Linux 原理，跟着复制命令，就能搭好一套只属于你自己的云端 AI 工作台。

上手前先分清"两台电脑"（核心概念）：

云端 Docker 电脑：跑在你买的 Linux 云服务器上。只要服务器开着，你本地的 Windows 关机拔电源，AI 依然能在云端写代码、跑任务。
Windows 本机电脑：只有你在桌面客户端里明确点了授权，AI 才能碰你的本地文件。电脑一关机，它就离线。注：本教程核对日期为 2026 年 11 月 1 日（Rakazo 仍处 Beta 阶段），仅限个人或可信成员自用，不建议对陌生人开放注册。

官方架构示意图：客户端、服务端、Docker 电脑与模型服务之间的关系。图片来源：Rakazo 自建部署说明。

准备 4 样东西

Rakazo 软件本身开源免费，但跑它需要基础的硬件和模型，丰俭由人：

一台 Windows 10/11 电脑（用来操作部署）。
一台云服务器 ：推荐 Ubuntu Server 26.04 LTS（64位 AMD64），起步选 2 vCPU、8 GiB 内存、60 GB SSD，带固定公网 IPv4（模型走云端 API，不需要买带 GPU 的机器）。地域选能顺畅访问 GitHub 和对应模型服务的节点。
一个域名 ：手机 App 连接自建服务器必须走 HTTPS，有个域名最省事（下文统一拿 ai.example.com 举例，操作时记得换成你自己的）。
任意 AI 模型渠道 ：
- 路线 A（省钱省事）：现成的 ChatGPT Plus / Pro 账号，直接用 OAuth 授权调用套餐内的 Codex 额度，不用额外掏 API 的钱。
- 路线 B（自由度高）：准备 OpenAI、Anthropic 或 OpenRouter 等平台的 API Key，按量计费。

第一阶段：搞定服务器与域名

1. 域名解析（绑定 IP）

买好云服务器、拿到固定公网 IPv4 后，去你的域名注册商后台打开 DNS 管理，加一条 A 记录：

类型	主机记录	记录值	TTL
A	`@`	你的服务器公网 IPv4	自动/默认
注意：如果列表里有默认的 AAAA 记录但服务器没配 IPv6，直接删掉，免得设备连错地址。
配好后，打开 Windows 的 PowerShell 验证一下：

bash 复制代码

nslookup ai.example.com

能返回你服务器的公网 IP，就说明通了。

2. 生成 SSH 密钥并登录服务器

为了安全，我们用密钥登录服务器。在 Windows PowerShell 里运行：

bash 复制代码

ssh-keygen -t ed25519 -C "rakazo-server"

一路回车（如果提示 Overwrite (y/n)? 就选 n 并换个文件名，别覆盖了你以前的密钥）。生成后，把公钥内容打印出来复制：

bash 复制代码

Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub"

把这段公钥粘贴到云厂商控制台的"SSH 密钥"里绑定给服务器。然后直接登录（用户名一般是 root 或 ubuntu）：

bash 复制代码

ssh root@服务器公网IPv4

看到类似 root@...:~# 的提示符，就说明你已经进到云服务器的 Linux 终端里了。顺手更一下系统：

bash 复制代码

sudo apt update && sudo apt -y upgrade
cat /etc/os-release

确认输出里有 VERSION_ID="26.04" 即可。

3. 配好防火墙（只留必要入口）

防火墙的原则很简单：除了 SSH（22端口）和网页访问（80/443端口），其他端口一律不对外开放。 先去云厂商控制台的安全组/防火墙页面，放行以下入站规则：

协议	端口	来源	用途
TCP	22	你的当前公网 IP	SSH 远程管理
TCP	80	`0.0.0.0/0`	申请证书及跳转
TCP	443	`0.0.0.0/0`	HTTPS 网页和手机连接
UDP	443	`0.0.0.0/0`	可选，支持 HTTP/3
切记：千万不要在安全组里开放 3100、5173、5432 或 Docker 端口。
接着在 SSH 终端里配置 Ubuntu 本机防火墙（注意顺序，先放行 OpenSSH 再启用，免得把自己锁外面）：

bash 复制代码

sudo apt install -y ufw
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw status
sudo ufw enable

提示确认时输入 y。不放心的话，新开一个 PowerShell 窗口试试还能不能 SSH 登进去。

第二阶段：部署 Rakazo 与云端电脑

4. 安装 Docker

Rakazo 依赖 Docker Engine 26+。在服务器终端里分两步执行，添加官方源并安装：

bash 复制代码

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

bash 复制代码

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<'EOF'
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: resolute
Components: stable
Architectures: amd64
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin openssl

跑个测试看看装好没：

bash 复制代码

sudo docker --version
sudo docker compose version
sudo docker run --rm hello-world

5. 安装并启动 Rakazo

建个专用目录，拉取官方脚本生成配置文件：

bash 复制代码

mkdir -p /opt/rakazo && cd /opt/rakazo
curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh
bash install-images.sh --prepare-only

脚本会自动生成 .env 环境变量文件（里面包含数据库密码和加密密钥，千万别泄露）。我们用编辑器打开它修改域名配置：

bash 复制代码

nano .env

找到对应变量修改（没有就加到文件末尾），把 ai.example.com 全换成你的域名：

bash 复制代码

RAKAZO_HOST=ai.example.com
BETTER_AUTH_URL=https://ai.example.com
WEB_ORIGIN=https://ai.example.com
API_URL=https://ai.example.com
SIGNUPS_ENABLED=false
SANDBOX_PROVIDER=docker
SANDBOX_IDLE_MS=0

关键参数说明：

四个域名必须一模一样。
SIGNUPS_ENABLED=false：关闭网页公开注册，防止陌生人进来蹭你的服务器和模型额度。
SANDBOX_PROVIDER=docker：启用本机的 Docker 沙盒作为 AI 的云端电脑。
SANDBOX_IDLE_MS=0：让云端电脑保持待命，不因为空闲自动休眠。

按 Ctrl+O 回车保存，按 Ctrl+X 退出。然后锁一下文件权限，直接启动服务：

bash 复制代码

chmod 600 .env
bash install-images.sh

拉取镜像需要点时间。跑完后用 sudo docker compose -f docker-compose.images.yml ps 看一眼，所有服务状态都是 Up 或 running 就稳了（万一有问题，用 sudo docker compose -f docker-compose.images.yml logs --tail=100 看日志排错）。

6. 用 Caddy 配好 HTTPS

Rakazo 默认只在服务器本地监听 5173 端口。我们装个 Caddy 做反向代理，顺便让它全自动申请和续期 HTTPS 证书。安装 Caddy：

bash 复制代码

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install -y caddy

修改配置文件 sudo nano /etc/caddy/Caddyfile，把里面的内容全删了，换成这三行（记得改域名）：

bash 复制代码

ai.example.com {
    reverse_proxy 127.0.0.1:5173
}

保存退出，重载 Caddy：

bash 复制代码

sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy

等一两分钟，用浏览器打开 https://ai.example.com。看到地址栏有安全锁、页面跳出 Rakazo 登录框，最难的基建部分就大功告成了。

第三阶段：建号与接入任意模型（重头戏）

7. 用命令行创建你的专属账号

因为前面我们关掉了网页注册，也没配发信邮箱，所以直接在服务器的 /opt/rakazo 目录下，用官方脚本建第一个账号：

bash 复制代码

read -r -p "Account email: " OWNER_EMAIL
read -r -s -p "Account password (at least 16 characters): " OWNER_PASSWORD
export OWNER_EMAIL OWNER_PASSWORD
docker compose --env-file .env -f docker-compose.images.yml exec -e OWNER_EMAIL -e OWNER_PASSWORD api node dist/cli/bootstrap-owner.js
unset OWNER_EMAIL OWNER_PASSWORD

按提示输入你的邮箱和至少 16 位的密码。建好后，直接去网页端登录。

8. 接入模型：API Key 或 ChatGPT 订阅二选一

进到后台，打开 Settings → Models （或 Connect a model ），这里就是它比很多闭源 bot 爽的地方------想接什么模型你自己说了算。

官方界面示意图。图片来源：Rakazo 自建部署说明。

玩法一：接入各家 API Key（最灵活）

如果你用 OpenAI、Anthropic 或 OpenRouter 的 API，直接选对应服务商，填进 API Key 就行。

建议去模型平台后台设个月度额度上限，防超支。
如果要让 AI 看网页截图、操作图形桌面，记得选支持视觉（图像输入）的模型。

玩法二：用 ChatGPT Plus / Pro 账号免 Key 接入（推荐）

不用掏 API 的钱，直接消耗你 ChatGPT 订阅里的 Codex/Work 额度（注意：受套餐额度限制，不是无限刷；且服务器和账号所在地区需支持 OpenAI 服务）。

在 Settings → Models 里点 Add provider。
选 ChatGPT subscription （旧版叫 OpenAI Codex ），点 Sign in with ChatGPT。
页面会给你一个一次性授权码和网址，按提示去浏览器登录 OpenAI 官方页面完成授权。
回到 Rakazo，状态变成已连接后，从动态列表里挑个模型绑给机器人即可。

Codex 常用模型怎么选（以你列表实际显示的为准）：

模型	适用场景	备注
GPT-6.1 Sol	主力写代码、复杂推理分析	逐步开放中，列表里有就优先当主力用
GPT-6.1 Terra / GPT-6 Sol	日常开发与通用任务	稳妥备选
GPT-6 Luna	日常短任务、快问快答	源码默认推荐项，省额度、响应快
GPT-6 Astra	高难度复杂任务	视套餐与工作区权限开放
排错小贴士：如果绑完列表里没模型，确认你选的是 `OpenAI Codex` 而不是 `OpenAI API`，并检查服务器 `.env` 里的 `RAKAZO_LIVE_MODEL_CATALOG` 没有被设成 `off`。

关于 Claude 订阅的避坑提醒： 虽然界面上有 Claude subscription 入口，但 Anthropic 官方条款明确禁止第三方应用调用个人 Free/Pro/Max 的 OAuth 凭据（仅限官方 Claude Code 等使用）。为了账号安全，要用 Claude 模型请老老实实走 Anthropic API Key ，别用个人订阅授权。详情可核对 Anthropic 认证条款、Rakazo 订阅说明及 OpenAI 计划说明。

9. 测试云端 Docker 电脑

模型通了，试试它的动手能力。新建或打开一个机器人，确认它的 Computer 选的是云端 Docker 电脑，发一句测试指令：

请在你的云端电脑工作目录创建 rakazo-check.txt，写入 cloud-ok，再读取并回复文件内容。不要连接或访问我的 Windows 电脑。

机器人干脆利落地回复 cloud-ok，说明云端沙盒已经在替你干活了。

第四阶段：多端连接与进阶玩法

10. 装 Windows 桌面端（及本地授权）

去 Rakazo 官网下载 Windows 客户端。首次打开时千万别选错：

选 Existing instance （连接已有服务器）。不要选 This computer，否则它会在你本地重装一套。
地址填 https://ai.example.com，点 Check connection ，然后登录。（万一选错了，在左上角菜单点 Change Rakazo Server... 改回来就行）。

【可选】授权 AI 操作你的 Windows 本机： 平时用云端电脑就够了。哪天真需要它改你本地硬盘的代码，再去桌面端的 Settings → General → Computers ，打开 Let bots use this computer。安全建议：授权后 AI 拥有你当前 Windows 账户的权限。建议在 Windows 里单独建个标准权限小号来跑客户端，只把测试目录暴露给它。

11. 手机 App 随时遥控

iPhone ：去 App Store 下载 Rakazo（认准开发者 Inbox Zero Inc.，需 iOS 16.4+）。
Android ：下载官方 GitHub 的 APK 直链（发布页核对）。

打开 App，在登录页点 Use a custom server ，填入 https://ai.example.com 登录。出门在外就能用手机随时看进度、传文件、在群里指挥机器人了。

12. 组建 AI 群聊 & 设定时任务（Routines）

拉群干活 ：点侧边栏顶部的 + Create → New group chat ，拉几个不同分工的机器人进群。平时用 @机器人名 点名干活，或者 @everyone 一起讨论（注意：多个机器人同时跑桌面环境很吃内存，2C8G 的机器别一次拉太多并发）。
定时例行任务 ：打开某个机器人的 Routines ，设个简单的只读任务试试水------比如"每天 09:00（时区选 Asia/Shanghai）检查测试项目有没有 README 并汇报，不要修改文件"。跑顺了再慢慢放开写文件的权限。

官方例行任务界面示意图。图片来源：Rakazo 自建部署说明。

13. 终极验证：关掉 Windows，让云端继续跑

最后验一下货。确保机器人的设备选在云端 Docker computer，用手机或网页发个延时任务：

在云端工作区创建文件，等 1 分钟后写入 cloud-after-1m.txt，完成后向我报告。

发完指令，立刻退出 Windows 客户端甚至直接把 Windows 电脑关机。等 1 分钟后看一眼手机 App------消息照常弹出来、文件顺利生成，这套 24 小时待命的私人 AI 工作站就算真正跑通了。

附：日常维护与急救包

常用维护命令（在 `/opt/rakazo` 目录下运行）

看服务状态 ：sudo docker compose -f docker-compose.images.yml ps
看报错日志 ：sudo docker compose -f docker-compose.images.yml logs --tail=100
更新版本 ：先去云厂商后台给硬盘打个快照备份！然后直接重跑 bash install-images.sh 即可（脚本会自动保留你的 .env 配置）。 ⚠️ 警告：任何时候都不要手欠运行 docker compose down -v，那个 -v 会把你的数据库和聊天记录删得干干净净。

常见卡点排查

重装服务器系统后，SSH 连不上报 REMOTE HOST IDENTIFICATION HAS CHANGED？ 重装系统换了指纹。在 Windows PowerShell 跑一句 ssh-keygen -R 服务器公网IPv4 清掉旧记录就能连了。
浏览器打不开域名 / 提示证书错误？ 检查域名 A 记录对不对、多余的 AAAA 记录删了没；检查云厂商安全组和本机 ufw 有没有放行 80 和 443 端口；用 sudo journalctl -u caddy --no-pager -n 80 看 Caddy 申请证书卡在哪一步。
页面能打开，但登录/注册报错？ 检查 .env 里那四个域名是不是完全一致的 https:// 地址。改过 .env 后必须重跑一次 bash install-images.sh 才能生效。
机器人提示没有云端电脑 / 设备 Offline？ 去 Settings → General → Computers 看一眼，你是不是误选了已经关机的 Windows 本机。如果云端 Docker 电脑也没出现，检查 .env 里是不是写了 SANDBOX_PROVIDER=docker 且 SANDBOX_SUPERVISOR_TOKEN 有值。

Grok bot平替开源项目部署指南，可接任意模型