RoqueOS 服务器安装

将 RoqueOS 转变为强大的自托管云计算平台。使用 Docker 安装以解锁 Linux 终端、远程浏览器、Docker 应用商店、文件管理器等等。

---

先决条件

先决条件

您需要一台运行 Linux（推荐 Ubuntu/Debian）或 macOS/Windows 的机器，并且已安装 Docker 和 Docker Compose。

没有 Docker？在继续之前，请先安装 Docker Engine。

---

选项 1：自动安装（推荐）

这是最简单、最快的方法。脚本将为您下载并配置一切。

Linux / macOS

curl -fsSL https://roqueos.com.br/install.sh | bash

Windows

iwr -useb https://roqueos.com.br/install.ps1 | iex

执行后，服务器将运行并准备好接收来自前端的连接。

---

选项 2：手动安装

适用于那些更喜欢自行管理容器的用户。

1. 从 DockerHub 下载镜像

docker pull roqueribeiro1988/roqueos-server:latest
docker pull roqueribeiro1988/roqueos-server-ubuntu:latest

2. 创建 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:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai

3. 启动服务器

docker compose up -d

---

验证安装

curl http://localhost:27021/health

预期结果：

{ "status": "ok", "timestamp": "2026-03-05T00:00:00.000Z", "version": "2.1.0" }

---

管理面板

安装完成后，可以通过以下地址访问管理面板：

http://localhost:27021/api

在面板中，您可以：

• 创建和管理 API 密钥 以连接前端
• 监控正在运行的容器和服务
• 配置 Cloudflare 隧道以实现安全的外部访问

---

连接到前端

1. 在 roqueos.com.br 或原生应用中打开 RoqueOS。
2. 转到 设置 → 服务器。
3. 输入服务器 URL（例如，http://localhost:27021 或 https://your-tunnel.trycloudflare.com）。
4. 粘贴在管理面板中生成的 API 密钥。
5. 点击 连接。

---

下一步

• VPS 与云配置 — 安装在远程服务器上实现全天候 24/7 访问
• 卷（磁盘） — 在文件管理器中映射您的本地文件夹
• Docker 应用商店 — 一键安装 Docker 应用程序