RoqueOS Server 安装
将 RoqueOS 转变为强大的自托管云计算平台。使用 Docker 安装，解锁 Linux 终端、远程浏览器、App Store Docker、文件管理器等等。
前提条件
前提条件
您需要一台运行 Linux（推荐 Ubuntu/Debian）或 macOS/Windows 并安装了 Docker 和 Docker Compose 的机器。
没有 Docker？在继续之前 安装 Docker Engine。
推荐安装（一键命令）
快速方式 — install.sh（Linux/macOS）和 install.ps1（Windows）处理所有内容: pull 镜像、生成加密 secrets、配置卷、启动容器并显示 admin 欢迎面板。
curl -fsSL https://roqueos.com.br/install.sh | bashirm https://roqueos.com.br/install.ps1 | iex约 2 分钟内服务器将在 http://localhost:27021 运行。flags 完整详情（--update、--with-roqueclaw、--with-android-gaming、自动回滚）: Linux/macOS 安装程序 或 Windows。
💡 下一步
服务器运行后，通过 Add Server Wizard 将其连接到您的 RoqueOS web。或者，如果您想在不安装任何东西的情况下测试 Server Mode，请使用已预配置的 公共演示服务器。
手动安装（高级 — 回退）
高级
此部分用于上面一键命令不涵盖的场景（例如: 没有 GitHub Container Registry 访问权限的网络、阻止 curl | bash 的企业策略、隔离环境）。对于 99% 的用户，请使用 上面的一键命令，它自动化了此处描述的所有内容。
此处的手动说明可能过时 — install.sh 是正确流程的真实来源。
对于想要自己管理容器的人。
1. 生成安全密钥
服务器在生产中需要三个加密密钥。在继续之前使用 Node.js 生成它们:
node -e "console.log('JWT_SECRET=' + require('crypto').randomBytes(32).toString('hex'))"
node -e "console.log('ENCRYPTION_KEY=' + require('crypto').randomBytes(32).toString('hex'))"
node -e "console.log('GUACAMOLE_CRYPT_KEY=' + require('crypto').randomBytes(16).toString('hex'))"或者，如果您喜欢 OpenSSL:
echo "JWT_SECRET=$(openssl rand -hex 32)"
echo "ENCRYPTION_KEY=$(openssl rand -hex 32)"
echo "GUACAMOLE_CRYPT_KEY=$(openssl rand -hex 16)"复制三个值并替换以下 docker-compose.yml 文件中的 COLE_AQUI。
保管好您的密钥
在生产中丢失 JWT_SECRET 或 ENCRYPTION_KEY 需要重新创建所有 API Keys 并重新连接前端。将它们存储在密码管理器中或版本控制外的 .env 文件中。
技术说明 — GUACAMOLE_CRYPT_KEY
远程桌面使用 AES-256-CBC，需要正好 32 字节。randomBytes(16) 命令生成 16 个随机字节，表示为 32 个十六进制字符 — 在 UTF-8 中正好等于 32 字节。对此特定密钥始终使用 randomBytes(16)。
2. 从 DockerHub 下载镜像
docker pull roqueribeiro1988/roqueos-server:latest
docker pull roqueribeiro1988/roqueos-server-ubuntu:latest3. 创建 docker-compose.yml 文件
version: '3.8'
services:
roqueos-server:
image: roqueribeiro1988/roqueos-server:latest
container_name: roqueos-server
restart: unless-stopped
ports:
- '27021:27021'
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- roqueos-users:/data/roqueos/users
- roqueos-shared:/data/roqueos/shared
- roqueos-db:/app/data
- roqueos-transcode-cache:/app/transcode-cache
cap_add:
- SYS_ADMIN
shm_size: 1gb
environment:
- TZ=America/Sao_Paulo
- NODE_ENV=production
- JWT_SECRET=COLE_AQUI
- ENCRYPTION_KEY=COLE_AQUI
- GUACAMOLE_CRYPT_KEY=COLE_AQUI
- UBUNTU_IMAGE=roqueribeiro1988/roqueos-server-ubuntu:latest
- GUACD_HOST=guacd
- GUACD_PORT=4822
networks:
- roqueos-network
guacd:
image: guacamole/guacd:1.6.0
container_name: roqueos-guacd
restart: unless-stopped
networks:
- roqueos-network
volumes:
roqueos-users:
roqueos-shared:
roqueos-db:
roqueos-transcode-cache:
networks:
roqueos-network:
driver: bridge4. 启动服务器
docker compose up -d自适应媒体流（HLS）
从 v1.0.5 开始，服务器自动检测可用硬件并配置视频流管道:
| 配置文件 | CPU / RAM | 可用质量 | 编码器 |
|---|---|---|---|
| low | ≤ 2 cores 或 ≤ 2 GB RAM | 480p | 软件 (libx264 ultrafast) |
| mid | 4 cores + 4 GB RAM | 480p + 720p | 软件或硬件 |
| high | ≥ 6 cores + 8 GB RAM | 480p + 720p + 1080p | 优先硬件 |
HLS 段缓存位于卷 roqueos-transcode-cache 中，并在重启之间持久化。
AI 代理 — RoqueClaw（v1.0.6+）
RoqueClaw 是集成到 RoqueOS 的带 AI 的视觉自动化代理。要启用它，在 roqueos-server 服务的 environment 部分的 docker-compose.yml 中添加:
- ENABLE_ROQUECLAW=true
- OPENCLAW_IMAGE=roqueribeiro1988/roqueos-openclaw:latest服务器将在第一次运行时自动下载代理镜像。
更新到新版本
当新版本发布到 Docker Hub 时，您可以以三种方式更新:
推荐
在 RoqueOS 中使用 Server Admin → 版本 → "立即更新"。向导检测您的安装方法、显示确切的命令并自动跟踪重启。
docker compose pull && docker compose up -d --force-recreate roqueos-servercurl -fsSL https://roqueos.com.br/install.sh | bash -s -- --update& ([scriptblock]::Create((irm https://roqueos.com.br/install.ps1))) -Update您的数据是安全的
Docker 命名卷（roqueos-users、roqueos-shared、roqueos-db、roqueos-transcode-cache）在更新期间保留。数据库、配置和文件不受影响。
验证安装
curl http://localhost:27021/health预期结果:
{ "status": "ok", "timestamp": "2026-03-05T00:00:00.000Z", "version": "2.1.0" }管理面板
安装后，管理面板可在以下位置访问:
http://localhost:27021/api下一步
- VPS & Cloud — 在远程服务器上安装以获得 24/7 访问
- 卷（磁盘） — 将本地文件夹映射到文件管理器
- App Store Docker — 一键安装 Docker 应用程序