ronivay/xen-orchestra

Xen-Orchestra Docker容器

https://github.com/ronivay/xen-orchestra-docker/actions/workflows/build.yml/badge.svg?branch=master](https://github.com/ronivay/xen-orchestra-docker/actions?query=workflow%3Abuild)

镜像概述和主要用途

本仓库包含构建Xen-Orchestra社区版Docker容器的文件，该容器安装了所有功能和插件。Latest标签是基于Xen Orchestra源码master分支的每周构建，镜像也会根据xo-server版本进行标记。

Xen-Orchestra是用于管理现有XenServer基础设施的Web界面工具（[***] appliance版本（非Docker运行）。

核心功能和特性

• 完整集成Xen-Orchestra社区版所有功能和插件
• 支持数据持久化存储（通过挂载卷实现）
• 可配置HTTP/HTTPS端口及自动重定向
• 支持自定义SSL证书或自动生成自签名证书
• 提供灵活的部署选项（Docker run或docker-compose）

使用场景和适用范围

• 个人或小型团队管理XenServer基础设施
• 开发/测试环境中的XenServer管理
• 需要快速部署和迁移的XenOrchestra实例
• 对基础设施资源占用有要求的场景

详细使用方法和配置说明

安装

方法1：手动构建镜像

bash
# 克隆仓库
git clone https://github.com/ronivay/xen-orchestra-docker

# 进入目录并构建
cd xen-orchestra-docker
docker build -t xen-orchestra .

方法2：从Docker Hub拉取

bash
docker pull ronivay/xen-orchestra

运行容器

测试环境（默认配置）

bash
docker run -itd -p 80:80 ronivay/xen-orchestra

Xen-Orchestra将可通过 [] 访问，默认凭据：/admin

生产环境（推荐配置）

建议挂载数据路径以持久化数据，并添加必要的权限和停止超时设置：

bash
docker run -itd \
  --stop-timeout 60 \
  --restart unless-stopped \
  --cap-add sys_admin \
  --cap-add dac_read_search \
  --security-opt apparmor:unconfined \
  -p 80:80 \
  -v /path/to/data/xo-server:/var/lib/xo-server \
  -v /path/to/data/redis:/var/lib/redis \
  ronivay/xen-orchestra

使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
    xen-orchestra:
        restart: unless-stopped
        image: ronivay/xen-orchestra:latest
        container_name: xen-orchestra
        stop_grace_period: 1m
        ports:
            - "80:80"
            #- "443:443"  # 如需HTTPS，取消注释并配置
        environment:
            - HTTP_PORT=80
            #- HTTPS_PORT=443  # 启用HTTPS需设置此端口
            #- REDIRECT_TO_HTTPS=true  # 仅在HTTPS_PORT定义时生效
            #- CERT_PATH='/cert.pem'  # 自定义证书路径（需挂载）
            #- KEY_PATH='/cert.key'   # 自定义密钥路径（需挂载）
        cap_add:
          - SYS_ADMIN
          - DAC_READ_SEARCH
        security_opt:
          - apparmor:unconfined
        volumes:
          - xo-data:/var/lib/xo-server
          - redis-data:/var/lib/redis
          - vddk-lib:/usr/local/lib/vddk
          #- /path/to/cert.pem:/cert.pem  # 挂载自定义证书
          #- /path/to/cert.key:/cert.key   # 挂载自定义密钥
          #- /path/to/ca.pem:/host-ca.pem  # 挂载自定义CA证书
        logging: &default_logging
            driver: "json-file"
            options:
                max-size: "1M"
                max-file: "2"
        # 如需文件恢复功能，取消以下注释
        #devices:
        #  - "/dev/fuse:/dev/fuse"
        #  - "/dev/loop-control:/dev/loop-control"
        #  - "/dev/loop0:/dev/loop0"

volumes:
  xo-data:
  redis-data:
  vddk-lib:

启动服务：

bash
docker-compose up -d

环境变量说明

注意：若设置HTTPS_PORT但未指定CERT_PATH和KEY_PATH，容器将自动生成自签名证书。

配置自定义

xo-server配置文件仅在首次启动且配置文件不存在时基于环境变量生成。如需手动自定义配置：

1. 挂载配置目录到容器内/etc/xo-server路径：

bash
docker run -itd -p 80:80 -v /path/to/xo-config:/etc/xo-server ronivay/xen-orchestra

2. 容器首次启动后，配置文件将生成在/path/to/xo-config/config.toml
3. 编辑配置文件后重启容器使修改生效