Virtual DSM 技术使用手册

Virtual DSM 技术使用手册

virtual-dsm Virtual DSM in a docker container. 项目地址: https://gitcode.com/gh_mirrors/vi/virtual-dsm

安装指南

Virtual DSM 是一个封装在 Docker 容器中的 Synology DSM 系统，允许用户在一个虚拟化的环境中体验 DSM 的全部功能。本指南旨在详细指导用户完成从安装到使用的全过程。

系统要求

确保您的主机支持 Docker，并开启 KVM 加速。运行以下命令检查是否支持 KVM：

sudo apt install cpu-checker
sudo kvm-ok

如果您的系统满足条件，您可以继续下一步。

项目的使用说明

通过 Docker Compose 安装

编辑或创建一个名为 docker-compose.yml 的文件，加入以下内容以配置 Virtual DSM：

version: '3'
services:
  dsm:
    container_name: dsm
    image: vdsm/virtual-dsm
    environment:
      DISK_SIZE: "16G"
    devices:
      - /dev/kvm
    cap_add:
      - NET_ADMIN
    ports:
      - 5000:5000
    volumes:
      - /var/dsm:/storage
    stop_grace_period: 2m

运行 Docker Compose 来启动容器：

docker-compose up -d

通过 Docker CLI 安装

如果您不使用 Docker Compose，可以直接使用 Docker CLI：

docker run -it --rm -p 5000:5000 --device=/dev/kvm --cap-add NET_ADMIN --stop-timeout 120 vdsm/virtual-dsm

Kubernetes 部署

对于 Kubernetes 用户，需要准备并应用一个适当的 YAML 文件，例如 kubernetes.yml，包含对应的资源配置。

kubectl apply -f kubernetes.yml

API 使用文档

请注意，Virtual DSM 主要作为一个完整的操作系统模拟，其API直接使用的是Synology DSM的标准Web接口和服务，而不是提供独立的RESTful API。管理 DSM 功能主要通过Web界面进行，对于自动化管理，可通过Synology提供的官方API包，如通过Synology API文档进行操作或利用DSM的应用编程接口（API），具体详情需参考Synology官方开发者文档。

自定义配置

改变存储位置与大小

• 存储位置：通过修改 volumes 映射，如上述示例所示。
• 磁盘大小：调整 DISK_SIZE 环境变量值，例如设为 32G。
• 创建多磁盘：增加额外的 DISKx_SIZE 变量，x为序号，以及相应的卷映射。
• 动态增长磁盘：设置 DISK_FMT 为 qcow2。
• CPU和RAM调整：通过 CPU_CORES 和 RAM_SIZE 环境变量定制。

KVM加速与网络配置

确保系统启用 KVM 并通过 -e 参数指定。对于网络，推荐使用默认桥接或自定义 macvlan 网络配置以分配固定 IP。

注意事项

• 运行在非Synology硬件上可能违反Synology的EULA。
• 确保遵循Synology的所有许可规定，并理解Synology Virtual DSM的限制，比如缺少对Virtual Machine Manager的支持。
• 对于高级特性，如GPU传递，需确保物理硬件支持且配置正确。

这个技术文档概述了如何部署和基础配置 Virtual DSM，对于更深入的管理和特定应用场景，请参考Synology DSM的官方文档和社区资源。

virtual-dsm Virtual DSM in a docker container. 项目地址: https://gitcode.com/gh_mirrors/vi/virtual-dsm