# Cloud Lab

**Repository Path**: tinylab/cloud-lab

## Basic Information

- **Project Name**: Cloud Lab
- **Description**: 云实验室 —— 基于 Docker 的云实验室管理系统，支持远程桌面、远程 SSH 控制台；社区制作了多款免安装的随身Linux系统盘，某宝检索”泰晓 Linux"快速体验
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: http://tinylab.org/cloud-lab
- **GVP Project**: No

## Statistics

- **Stars**: 102
- **Forks**: 26
- **Created**: 2019-06-17
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

**Subscribe Wechat, Learn Project Status**：
![Wechat Public](images/tinylab-wechat.jpg)

# Cloud Lab

[Cloud Lab][003] is a Docker based online lab center, it integrates many popular computer
science courses and provides a Docker based experiment environment as-is.

Cloud Lab is open source with no warranty – use at your own risk.

## Quickstart

If really a Linux newbie or simply don't want to spend time on boring installation, buy the instant [Linux Lab Disk](https://shop155917374.taobao.com).

### Install docker

Cload Lab is docker based, please make sure docker environment is installed with [Docker CE][001], Docker CE support Mac, Windows, Ubuntu, Debian, Fedora, CentOS, Azure and AWS, we have tested Cloud Lab with Docker CE in Ubuntu and Mac.

The old install method for Windows and Mac OSX is [Docker Toolbox][002].

### Configure docker

In order to run docker without password, please make sure your user is added in the docker group:

    $ sudo usermod -aG docker $USER

In order to speedup docker images downloading, please configure a local docker mirror in `/etc/default/docker`, for example:

    $ grep registry-mirror /etc/default/docker
    DOCKER_OPTS="$DOCKER_OPTS --registry-mirror=https://docker.mirrors.ustc.edu.cn"
    $ service docker restart

In order to avoid network ip address conflict, please try following changes and restart docker:

    $ grep bip /etc/default/docker
    DOCKER_OPTS="$DOCKER_OPTS --bip=10.66.0.10/16"
    $ service docker restart

If the above changes not work, try something as following:

    $ grep dockerd /lib/systemd/system/docker.service
    ExecStart=/usr/bin/dockerd -H fd:// --bip=10.66.0.10/16 --registry-mirror=https://docker.mirrors.ustc.edu.cn
    $ service docker restart

If installed via Docker Toolbox, to access the Lab page, we must get and use the `eth1` ip address, just replace 'localhost' with this ip in the Lab page url:

    $ ifconfig eth1 | grep 'inet addr' | tr -s ' ' | tr ':' ' ' | cut -d' ' -f4
    192.168.99.100

If the Linux system is installed on Virtualbox by ourselves, to access the Lab page outside, we must add the eth1 network device at first via setting: 'Network -> Adapter2 -> Host-only Adapter'.

### Choose a working directory

If installed via Docker Toolbox, please enter into the `/mnt/sda1` directory of the `default` system on Virtualbox, otherwise, after poweroff, the data will be lost for the default `/root` directory is only mounted in DRAM.

    $ cd /mnt/sda1

For Linux or Mac OSX, please simply choose one directory in `~/Downloads` or `~/Documents`.

    $ cd ~/Documents

### Download cloud-lab

    $ git clone https://github.com/tinyclub/cloud-lab.git

### Choose a Lab

    $ tools/docker/choose

    Current Lab is: linux-lab

    Available Labs:

         1	cs630-qemu-lab
         2	linux-0.11-lab
         3	linux-lab
         4	markdown-lab
         5	tinylab.site

    Choose the lab number: 3
         3	linux-lab

    Download the lab...

### Run the Lab

    $ tools/docker/run

### Remove the Lab

    $ tools/docker/rm

### Stop the Lab

    $ tools/docker/stop

### Start the Lab

    $ tools/docker/start

### Run as root without password

If get syntax error under `/etc/sudoers*`, please use `pkexec visudo` to fix up it.

    $ sudo -s
    $ echo "$SUDO_USER ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/$SUDO_USER

[001]: https://store.docker.com/search?type=edition&offering=community
[002]: https://www.docker.com/docker-toolbox
[003]: https://tinylab.org/cloud-lab