UmbrelOS 在 Docker 容器中的使用教程

UmbrelOS 在 Docker 容器中的使用教程

1. 项目介绍

UmbrelOS 是一个基于 Docker 容器的操作系统，旨在为自托管服务提供一个便捷的运行环境。它消除了对专用硬件或虚拟机的需求，使得用户可以在任何系统上运行 UmbrelOS。

2. 项目快速启动

以下是使用 Docker Compose 快速启动 UmbrelOS 的步骤：

version: '3'

services:
  umbrel:
    image: dockurr/umbrel
    container_name: umbrel
    pid: host
    ports:
      - "80:80"
    volumes:
      - ./umbrel:/data
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
    stop_grace_period: 1m

使用 Docker CLI 的启动命令如下：

docker run -it --rm --name umbrel --pid=host -p 80:80 -v "${PWD:-.}/umbrel:/data" -v "/var/run/docker.sock:/var/run/docker.sock" --stop-timeout 60 dockurr/umbrel

确保将 ./umbrel 替换为你希望存储数据的文件夹路径。

3. 应用案例和最佳实践

存储位置变更

如果你需要更改存储位置，你可以在 compose 文件中包含以下绑定挂载：

volumes:
  - /path/to/your/desired/storage/folder:/data

将示例路径 /path/to/your/desired/storage/folder 替换为你想要的存储文件夹或命名卷。

使用场景

• 个人服务器：将 UmbrelOS 作为个人服务器，运行你的应用和服务。
• 开发环境：创建一个隔离的开发环境，用于测试和调试应用。

4. 典型生态项目

UmbrelOS 的生态系统包括多种自托管应用，以下是一些典型的项目：

• Home Assistant：用于智能家居控制的开源平台。
• Nextcloud：提供文件同步和共享服务的私有云平台。
• Matrix：一个开源的通信平台，用于构建实时通信应用。

通过这些项目，你可以构建一个完全自托管的生态系统，以保护你的隐私和数据安全。