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歓迎パネルを表示します。

Linux / macOSWindows

bash

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

powershell

irm https://roqueos.com.br/install.ps1 | iex

~2分でサーバーが http://localhost:27021 で動作します。フラグの完全な詳細（--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. セキュリティキーを生成

サーバーは本番で3つの暗号鍵を必要とします。Node.jsで生成してから続行:

bash

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を好む場合:

bash

echo "JWT_SECRET=$(openssl rand -hex 32)"
echo "ENCRYPTION_KEY=$(openssl rand -hex 32)"
echo "GUACAMOLE_CRYPT_KEY=$(openssl rand -hex 16)"

3つの値をコピーして、以下の docker-compose.yml ファイルの COLE_AQUI を置き換えます。

キーを保管してください

本番で JWT_SECRET または ENCRYPTION_KEY を失うと、すべてのAPI Keysを再作成し、frontendを再接続する必要があります。パスワードマネージャーまたはバージョン管理外の .env ファイルに保存してください。

技術的注意 — GUACAMOLE_CRYPT_KEY

Remote DesktopはAES-256-CBCを使用し、正確に32バイトを必要とします。randomBytes(16) コマンドは、32の16進文字として表される16ランダムバイトを生成します — UTF-8で正確に32バイトに相当します。この特定のキーには常に randomBytes(16) を使用してください。

2. DockerHubからイメージをダウンロード

bash

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

3. `docker-compose.yml` ファイルを作成

yaml

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: bridge

4. サーバーを起動

bash

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 に追加:

yaml

- ENABLE_ROQUECLAW=true
- OPENCLAW_IMAGE=roqueribeiro1988/roqueos-openclaw:latest

サーバーは最初の実行時にエージェントイメージを自動的にダウンロードします。

新しいバージョンへの更新

新しいバージョンがDocker Hubに公開されたら、3つの方法で更新できます:

推奨

RoqueOS内の Server Admin → バージョン → 「今すぐ更新」 を使用します。ウィザードはインストール方法を検出し、正確なコマンドを表示し、再起動を自動的に追跡します。

Docker Composeインストールスクリプト (Linux/macOS)インストールスクリプト (Windows)

bash

docker compose pull && docker compose up -d --force-recreate roqueos-server

bash

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

powershell

& ([scriptblock]::Create((irm https://roqueos.com.br/install.ps1))) -Update

データは安全です

Dockerの名前付きボリューム（roqueos-users、roqueos-shared、roqueos-db、roqueos-transcode-cache）は更新中に保持されます。データベース、設定、ファイルは影響を受けません。

インストールの確認

bash

curl http://localhost:27021/health

期待される結果:

json

{ "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アプリケーションを1クリックでインストール

RoqueOS Serverのインストール ​

前提条件 ​

推奨インストール（ワンライナー） ​

手動インストール（高度な — フォールバック） ​

1. セキュリティキーを生成 ​

2. DockerHubからイメージをダウンロード ​

3. docker-compose.yml ファイルを作成 ​

4. サーバーを起動 ​

アダプティブメディアストリーミング（HLS） ​

AIエージェント — RoqueClaw（v1.0.6+） ​

新しいバージョンへの更新 ​

インストールの確認 ​

管理パネル ​

次のステップ ​

RoqueOS Serverのインストール

前提条件

推奨インストール（ワンライナー）

手動インストール（高度な — フォールバック）

1. セキュリティキーを生成

2. DockerHubからイメージをダウンロード

3. `docker-compose.yml` ファイルを作成

4. サーバーを起動

アダプティブメディアストリーミング（HLS）

AIエージェント — RoqueClaw（v1.0.6+）

新しいバージョンへの更新

インストールの確認

管理パネル

次のステップ