静的ファイルホスティング

rojiは設定ファイルの static_sites セクションを使って、Dockerコンテナなしで静的ファイルを配信できます。

設定#

~/.config/roji/config.yaml にエントリを追加：

static_sites:
  - host: docs                    # -> docs.dev.localhost
    root: ~/projects/docs/build
    # index: true                 # ディレクトリ一覧（デフォルト: 有効）
  - host: private.example.com     # FQDN（ドットを含む）
    root: /var/www/private
    index: false                  # ディレクトリ一覧を無効化

ホスト名解決#

• ドットなし: {host}.{ROJI_DOMAIN} に展開（例: docs → docs.dev.localhost）
• ドットあり: FQDNとしてそのまま使用

ディレクトリ一覧#

• index: true（デフォルト）— index.html がない場合にApache/nginx風のディレクトリ一覧を表示
• index: false — index.html なしのディレクトリアクセスに403 Forbiddenを返す

変更の適用#

再起動は不要です。以下のいずれかで適用：

roji config reload

またはダッシュボードの Reload Config ボタンをクリック。

認証の追加#

BASIC認証で静的サイトを保護：

static_sites:
  - host: docs.dev.localhost
    root: ~/projects/docs/build
    auth:
      basic:
        user: admin
        pass: secret
        realm: Documentation   # 任意

詳細は BASIC認証ガイドを参照。

ダッシュボード連携#

静的サイトはDockerベースのルートと並んでダッシュボードに表示されます。ダッシュボードでは：

• ディレクトリ一覧の状態アイコン
• Reload Configボタンで再起動なしに変更を適用