# ZStack **Repository Path**: ckstack-hci/zstack ## Basic Information - **Project Name**: ZStack - **Description**: 遵循私有云4S标准，功能强大、轻量部署、核心开源，丰富的版本规划满足多种客户的业务需求，提供强大的私有云功能及弹性裸金属管理、企业管理、高性能负载均衡实例等增值服务。 https://www.zstack-cloud.com/(国际） - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://www.zstack.io/ - **GVP Project**: No ## Statistics - **Stars**: 9 - **Forks**: 0 - **Created**: 2023-04-04 - **Last Updated**: 2025-09-08 ## Categories & Tags **Categories**: cloud **Tags**: None ## README # ZStack: the IaaS software you have been looking for. [https://zstack.org](https://zstack.org) ZStack is open source IaaS(infrastructure as a service) software aiming to automate datacenters, managing resources of compute, storage, and networking all by APIs. Users can setup ZStack environments in a download-and-run manner, spending 5 minutes building a POC environment all on a single Linux machine, or 30 minutes building a multi-node production environment that can scale to hundreds of thousands of physical servers. ZStack provides the capability of managing everything in a datacenter by APIs, fulfilling the goal of software-defined datacenter. Users control their clouds using either web UI or command line tool both of which interact with ZStack management nodes; **NO** scattered configurations, dependent software installation, services HA, and thirdparty monitoring are needed, all of them are taken care of by ZStack itself, which provides a great simplicity for stable long-term operation. ## Why ZStack? ZStack is designed to tackle two problems -- complexity and stability -- that users building clouds based on open source IaaS software have been suffered for a long time. In terms of complexity, ZStack sticks to the design principles of APIs managing everything, full automation, self-managed services, no hardware lockin, and user-friendly query APIs, providing a software easy to setup and long-term operation. In terms of stability, ZStack was born with a plugin system that adding or removing features will not impact existing codes, a workflow engine that can rollback completed changes on error, a cascade framework that can spread an operation from a resource to dependent resources, and three rigorous automated testing systems that guard every single feature, solving the stability issue in architectural designs. Besides, ZStack is extremely scalable that a single management node is capable of managing hundreds of thousands of physical servers, managing millions of virtual machines, and serving tens of thousands of concurrent API requests, particular suitable for building large-scale public clouds. ## Key Strength #### Scalable A single management node is capable of managing **hundreds of thousands** of physical servers, managing **millions** of virtual machines, and serving **tens of thousands** of concurrent API requests. #### Fast Operations are **extremely fast**, see below performance data of creating VMs.
VM NUMBER TIME COST  
1 0.51 seconds
10 1.55 seconds
100 11.33 seconds
1000 103 seconds
10000 23 minutes
#### Network functions virtualization The default networking model is built on **NFV(network functions virtualization)**, which provides every tenant a dedicated networking node implemented by a virtual appliance VM. The whole networking model is self-contained and self-managed, administrators need neither to purchase special hardware nor to deploy networking servers in front of computing servers. #### Comprehensive query APIs Users can query everything everywhere by about **4,000,000** query conditions and countless query combinations. You will never need to write ad-hoc scripts or directly access database to search a resource, it's all handled by APIs. >> QueryVmInstance vmNics.eip.guestIp=16.16.16.16 zone.name=west-coast >> QueryHost fields=name,uuid,managementIp hypervisorType=KVM vmInstance.allVolumes.size>=549755813888000 vmInstance.state=Running start=0 limit=10 #### Easy to deploy and upgrade Installation and upgrade are as simple as deploying a **Java WAR file**. A POC environment can be installed in **5 minutes** with a bootstrap script; A multi-node production environment can be deployed in **30 minutes** including the time you read the documentation. Quick access: * [Product download page(CN)](https://www.zstack.io/product/product_downloads/) * [Product download page(EN)](https://www.zstack-cloud.com/product/product_downloads/) #### Full automation **Everything is managed by APIs**, no manual, scattered configurations in your cloud. And the seamless, transparent integration with Ansible liberates you from installing, configuring, and upgrading agents on massive hardware. #### Versatile plugin system The core orchestration is built on an Eclipse and OSGI like **plugin system** that everything is a plugin. ZStack affirms that adding or removing features will not impact the core orchestration, promising a robust software the cloud users deserve. #### Rigorous testing system **Three full-automated, rigorous testing systems** ensure the quality of every feature. ## Installation Installation of ZStack is super easy; users can choose different methods depending on their needs to install the first ZStack environment: * For users wanting to try out quickly, see [Quick Installation](https://www.zstack-cloud.com/help/en/tutorials/quick_install_guide/v4/). * For users wanting to deploy a production environment, see [Manual Installation](https://zstack.org/installation/manual.html). * For users wanting to deploy a multi-node environment, see [Multi-node Installation](https://www.zstack-cloud.com/help/en/tutorials/double_mn_ha_solution/v4/). Once the installation is done, users can follow one of getting started guides: * [Getting Started With Quick Installation](https://www.zstack-cloud.com/help/en/tutorials/quick_install_guide/v4/3.html). * [Getting Started With Manual Installation](https://zstack.org/documentation/getstart-manual.html). * [Getting Started With Multi-node Installation](https://www.zstack-cloud.com/help/en/tutorials/double_mn_ha_solution/v4/2.html). ## Tutorials Six tutorials are prepared for your first journey in ZStack, building classic cloud deployments all on one single Linux machine: ##### Elastic IP: * [Web UI](https://www.zstack-cloud.com/help/en/tutorials/vpc_tutorial/v4/3.html#chapter-3-7-Elastic-IP) * [Command Line Tool](https://zstack.org/tutorials/ec2-cli.html) ##### Flat Network: * [Web UI](https://www.zstack-cloud.com/help/en/tutorials/flat_tutorial/v4/) * [Command Line Tool](https://zstack.org/tutorials/flat-network-cli.html) ##### Three Tiered Network: * [Web UI](https://zstack.org/tutorials/three-tiered-ui.html) * [Command Line Tool](https://zstack.org/tutorials/three-tiered-cli.html) ##### Security Group: * [Web UI](https://www.zstack-cloud.com/help/en/tutorials/vpc_tutorial/v4/3.html#chapter-3-6-Security-Group) * [Command Line Tool](https://zstack.org/tutorials/security-group-cli.html) ##### Port Forwarding: * [Web UI](https://www.zstack-cloud.com/help/en/tutorials/vpc_tutorial/v4/3.html#chapter-3-8-Port-Forwarding) * [Command Line Tool](https://zstack.org/tutorials/elastic-port-forwarding-cli.html) ##### Snapshots: * [Web UI](https://www-zstack-io.translate.goog/help/tutorials/volume_snapshot_tutorial/v4/1.html?_x_tr_sl=zh-CN&_x_tr_tl=en&_x_tr_hl=en&_x_tr_pto=wapp) * [Command Line Tool](https://zstack.org/tutorials/snapshot-cli.html) ## Under the hood Under the hood, ZStack is built on an architecture explained by following articles: ##### Scalability: [ZStack's Scalability Secrets Part 1: Asynchronous Architecture](https://zstack.org/blog/asynchronous-architecture.html) [ZStack's Scalability Secrets Part 2: Stateless Services](https://zstack.org/blog/stateless-clustering.html) [ZStack's Scalability Secrets Part 3: Lock-free Architecture](https://zstack.org/blog/lock-free.html) ##### Plugin Architecture: [The In-Process Microservices Architecture](https://zstack.org/blog/microservices.html) [The Versatile Plugin System](https://zstack.org/blog/plugin.html) [The Tag System](https://zstack.org/blog/tag.html) [The Workflow Engine](https://zstack.org/blog/workflow.html) [The Cascade Framework](https://zstack.org/blog/cascade.html) ##### Query API: [The Query API](https://zstack.org/blog/query.html) ##### Automation: [Full Automation By Ansible](https://zstack.org/blog/ansible.html) ##### Storage And Network: [Networking Model 1: L2 and L3 Network](https://zstack.org/blog/network-l2.html) [Networking Model 2: Virtual Router Network Service Provider](https://zstack.org/blog/virtual-router.html) [Storage Model: Primary Storage and Backup Storage](https://zstack.org/blog/storage.html) ##### Testing: [The Automation Testing System 1: Integration Testing](https://zstack.org/blog/integration-testing.html) [The Automation Testing System 2: System Testing](https://zstack.org/blog/system-testing.html) [The Automation Testing System 3: Model-based Testing](https://zstack.org/blog/model-based-testing.html) ## More Documentation Resources [ZStack documentation](https://www.zstack-cloud.com/help/en/product_manuals/index.html) ## License Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.